runargv0(8)                        runtools                        runargv0(8)



NAME
       runargv0 - run a program with a different 0th argument

SYNOPSIS
       runargv0 [-hV] realprog alias [ args ...  ]

DESCRIPTION
       runargv0 runs realprog with the 0th argument set to alias.  Any options
       and/or arguments for realprog may be given in args.

       If realprog does not contain a ``/''  slash  character,  runargv0  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.

       -V     Version.  Print the version number to stderr and exit.

EXIT STATUS
       runargv0 exits with one of the following values:

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

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

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

       1-127  program was invoked and failed with its own non-zero  exit  sta-
              tus.

AUTHOR
       Wayne Marshall, http://b0llix.net/perp/

SEE ALSO
       runtools_intro(8),  runargs(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                      runargv0(8)