Update IOF redirection options

[rhc54]

Provide both "--output-directory" and "--output-filename" options but do
not allow both to be given at the same time. Output-directory allows
specification of a directory, with output redirected into files of form
"<directory>/<jobid>/rank.<vpid>/stdout[err]". This option also supports two
directives: nojobid (removes the jobid directory layer) and nocopy (do
not copy the output to the terminal).

Output-filename is the "old" behavior that names the output files as
"<filename>.<rank>" with both stdout and stderr redirected into it. This
option only supports one directive: nocopy (do not copy the output to
the terminal).

Fix both the --help and man documentation.

Fixes #7095
Refs #7133

Signed-off-by: Ralph Castain rhc@pmix.org

[jsquyres]

@gpaulsen @hppritcha Do you want to bring this to v4.0.x?

On the one hand, it's an enhancement.

On the other hand, it's restoring old behavior (admittedly: that behavior was from the v2.x series -- I believe the current behavior has been this way since v3.0.0).

[vipulk1947]

I have one comment on this change. For finding ":" character, please use strrchr() function instead of strchr(). This is useful because in Linux, ":" is a valid character for directory/file names. In fact, people add current date/time in automatically generated directory names, so it occurs frequently.

Using strrchr() ensures that the parsing of the --output-directory field works correctly in such directory path. Otherwise, it gets messed up and gets created at random places (or fails to create due to permission issues).