runsession(8)                      runtools                      runsession(8)



NAME
       runsession - run a program in a new session/process group

SYNOPSIS
       runsession [-hV] program [ args ...  ]

DESCRIPTION
       runsession sets up a new session and process group with setsid(2), then
       runs program with any additional args.

       If program does not contain a ``/'' slash  character,  runsession  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
       runsession 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 runses-
              sion itself.

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

       111    runsession failed due to some system or resource error.  In this
              case,  runsession 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), runargv0(8), runchoom(8), rundetach(8),
       rundeux(8),    runenv(8),    runfile(8),    runlimit(8),    runlock(8),
       runpause(8), runtool(8), runtrap(8), runuid(8)



runtools-2.07                    January 2013                    runsession(8)