Provided by: gridengine-exec_6.2u5-4_i386 bug

NAME

       sge_execd - Sun Grid Engine job execution agent

SYNOPSIS

       sge_execd [ -help ]

DESCRIPTION

       sge_execd  controls  the Sun Grid Engine queues local to the machine on
       which sge_execd is running and executes/controls  the  jobs  sent  from
       sge_qmaster(8) to be run on these queues.

OPTIONS

   -help
       Prints a listing of all options.

LOAD SENSORS

       If a load sensor is configured for sge_execd via either the global host
       configuration or the execution-host-specific cluster configuration (See
       sge_conf(5).),  the  executable  path  of the load sensor is invoked by
       sge_execd on a regular basis and delivers one or multiple load  figures
       for  the  execution  host  (e.g.   users  currently  logged  in) or the
       complete cluster (e.g. free disk space on a network wide  scratch  file
       system).  The  load  sensor  may be a script or a binary executable. In
       either case its handling of  the  STDIN  and  STDOUT  streams  and  its
       control flow must comply to the following rules:

       The  load  sensor  must  be  written  as  an infinite loop waiting at a
       certain point for input from STDIN. If the string "quit" is  read  from
       STDIN,  the  load sensor should exit.  When an end-of-line is read from
       STDIN, a load data retrieval cycle should start. The load  sensor  then
       performs  whatever  operation  is necessary to compute the desired load
       figures.  At the end of the cycle the load sensor writes the result  to
       stdout. The format is as follows:

       o  A  load  value  report starts with a line containing only either the
          word  "start" or the word "begin".

       o  Individual load values are separated by newlines.

       o  Each load value report consists of three parts separated  by  colons
          (":") and containing no blanks.

       o  The first part of a load value information is either the name of the
          host for which load is reported or the special name "global".

       o  The second part is the symbolic name of the load value as defined in
          the  host  or global complex list (see complex(5) for details). If a
          load value is reported for which no entry  in  the  host  or  global
          complex list exists, the reported load value is not used.

       o  The third part is the measured load value.

       o  A load value report ends with a line with only the word "end".

ENVIRONMENTAL VARIABLES

       SGE_ROOT       Specifies  the  location of the Sun Grid Engine standard
                      configuration files.

       SGE_CELL       If set, specifies the default Sun Grid Engine  cell.  To
                      address  a  Sun  Grid Engine cell sge_execd uses (in the
                      order of precedence):

                             The name of the cell specified in the environment
                             variable SGE_CELL, if it is set.

                             The name of the default cell, i.e. default.

       SGE_DEBUG_LEVEL
                      If  set,  specifies  that  debug  information  should be
                      written to stderr. In addition the level  of  detail  in
                      which debug information is generated is defined.

       SGE_QMASTER_PORT
                      If  set,  specifies the tcp port on which sge_qmaster(8)
                      is expected to listen for communication requests.   Most
                      installations  will  use  a  services  map entry for the
                      service "sge_qmaster" instead to define that port.

       SGE_EXECD_PORT If set, specifies the tcp port on which sge_execd(8)  is
                      expected  to  listen  for  communication requests.  Most
                      installations will use a  services  map  entry  for  the
                      service "sge_execd" instead to define that port.

RESTRICTIONS

       sge_execd  usually is started from root on each machine in the Sun Grid
       Engine pool.  If started by a normal user, a spool  directory  must  be
       used  to  which  the user has read/write access. In this case only jobs
       being submitted by that same user are handled correctly by the system.

FILES

       sgepasswd   contains   a   list   of    user    names     and     their
       corresponding  encrypted  passwords.  If  available, the password  file
       will  be   used   by  sge_execd. To change the contents  of  this  file
       please  use  the  sgepasswd  command. It is not advised to  change that
       file manually.
       <sge_root>/<cell>/common/configuration
                       Sun Grid Engine global configuration
       <sge_root>/<cell>/common/local_conf/<host>
                       Sun Grid Engine host specific configuration
       <sge_root>/<cell>/spool/<host>
                       Default execution host spool directory
       <sge_root>/<cell>/common/act_qmaster
                       Sun Grid Engine master host file

SEE ALSO

       sge_intro(1), sge_conf(5), complex(5), sge_qmaster(8).

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.