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
       order.

       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)