FreeBSD Manual Pages
runargs(8) runtools runargs(8) NAME runargs - run a program with arguments read from an argument file SYNOPSIS runargs [-hV] [-i] argfile program [ args ... ] DESCRIPTION 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 argu- ments taken from argfile. The -i option may be used to invert this or- der. If program does not contain a ``/'' slash character, runargs will per- form 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 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 com- mand-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 sta- tus. CAVEATS In most cases, the arguments specified in argfile will not normally want to follow the shell-protecting quoting conventions as might other- wise be used when running program in a shell environment. AUTHOR Wayne Marshall, http://b0llix.net/perp/ SEE ALSO runtools_intro(8), runargv0(8), runchoom(8), rundetach(8), rundeux(8), runenv(8), runfile(8), runlimit(8), runlock(8), runpause(8), runsession(8), runtool(8), runtrap(8), runuid(8) runtools-2.07 January 2013 runargs(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | CAVEATS | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=runargs&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>