runargs − run a program with arguments read from an argument file
runargs [−hV] [−i] argfile program [ args ... ]
runargs runs program with arguments read from argfile.
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.
|
−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. |
runargs exits with one of the following values:
|
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. |
In most cases, the arguments specified in argfile will not normally want to follow the shell−protecting quoting conventions as might otherwise be used when running program in a shell environment.
@@PERP_AUTHOR@@
runtools_intro(8), runargv0(8), rundetach(8), rundeux(8), runenv(8), runfile(8), runlimit(8), runlock(8), runpause(8), runsession(8), runtool(8), runtrap(8), runuid(8)