NAME

SYNOPSIS

DESCRIPTION

An argfile is a plain text file with zero or more lines. Each line read is setup as an individual argument to program in the same order as it is read. Any leading and/or trailing whitespace is trimmed. Empty lines and lines beginning with the `#' character are ignored.

If argfile is given as a `-' character, arguments will be taken from stdin.

Normally any arguments specified in args are setup to precede the arguments taken from argfile. The -i option may be used to invert this order.

If program does not contain a ``/'' slash character, runargs will perform a shell-like search for the executable using the PATH variable in the current environment.

OPTIONS

-h

Help. Print a brief usage message to stderr and exit.

-i

Insert. Normally runargs sets up program with any arguments given in args before those given in argfile. The -i option may be used to invert this order, and insert the arguments taken from argfile before any specified in args.

-V

Version. Print the version number to stderr and exit.

EXIT STATUS

0

program was invoked and completed successfully. In this case, the exit code is returned by the program, rather than by runargs itself.

100

runargs failed because of a usage error, such as an invalid command-line option or argument. In this case, runargs prints a brief error message and usage help to stderr on exit.

111

runargs failed due to some system or resource error. In this case, runargs prints a brief diagnostic message to stderr on exit.

1-127

program was invoked and failed with its own non-zero exit status.

CAVEATS

AUTHOR

SEE ALSO