    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 exe-
         cution  host  (e.g.   users currently logged in) or the com-
         plete 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 spe-
            cial name "global".

         o  The second part is the symbolic name of the load value as
            defined  in  the  host  or  global complex list (see com-
            plex(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 com-
                        munication 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 com-
                        munication 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 pass-
         word  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  permis-
         sions.