runtool(8)                         runtools                         runtool(8)



NAME
       runtool - run a program in a configured process environment

SYNOPSIS
       runtool  [-hV]  [-0  argv0]  [<-a | -A> argfile] [-c chdir] [-C chroot]
       [-d] [<-e | -E> envfile] [-F fdset] [-L [:]lockfile  |  -P  [:]pidlock]
       [-m  umask] [-R <a|c|d|f|m|o|p|r|s|t>=<num|!>[:...]] [- s] [-S altpath]
       [-u user] [-U user] [-W] [-z secs] program [ args ...]

DESCRIPTION
       runtool modifies a process environment according to its  options,  then
       runs program with any additional args.

       If  program does not contain a ``/'' slash character, runtool will per-
       form a shell-like search for the executable using the PATH variable  in
       the current environment.

OPTIONS
       runtool  combines the functions of several individual runtools_intro(8)
       into a single utility.  The corresponding  utility  is  noted  in  each
       option  description,  and  may  be  referenced  there for more complete
       information.

       -0 argv0
              runargv0(8).  Sets up program to run with an argv[0] of argv0.

       <-a|-A> argfile
              runargs(8).  Runs program with arguments specified  in  argfile.
              The  -a  form  of  the  option  sets up any arguments taken from
              argfile to preceed any arguments given by args.  The -A form  of
              the  option  inverts  this order, so that any options taken from
              argfile will follow any arguments given by args.

       -c chdir
              chdir(2).  Changes the current working directory to chdir before
              running program.

       -C chroot
              chroot(2).   Sets up the root directory to chroot before running
              program.

       -d     rundetach(8).  Detaches from the  controlling  terminal  to  run
              program in the background.

       <-e|-E> envfile
              runenv(8).   Sets  up the environmental variables in the process
              of program according to definitions in envfile.  The -e form  of
              the  option  merges  any  variables  defined in envfile with the
              existing environment.  The -E form of the option defines the new
              environment  exclusively  according  to  envfile and ignores any
              existing environment.  As with runenv(8), the  argument  envfile
              may be either a file or a directory.

       -F fdset
              Sets  up  file descriptors according to the specification fdset,
              given as a single contiguous string in the form:

                     <fd> <op> <target> [: ...]

              Where:

              fd:    single ascii file descriptor numeral, 0..9

              op:    a single character from the set `<', `>', '+', or '='

              target:
                     Depends on op as follows: If op is  redirection  operator
                     '<',  `>',  or  '+', target is an absolute pathname (must
                     begin with `