NAME

       dl - setting SGE debug tracing information

SYNOPSIS

       source $SGE_ROOT/util/dl.sh
       dl level

DESCRIPTION

       The  dl  shell  script  alias  is  obtained  by  sourcing  one  of  the  scripts  $SGE_ROOT/util/dl.sh or
       $SGE_ROOT/util/dl.csh, for Bourne and C shell respectively.  It provides a convenient way to set  up  the
       environment  to  produce certain SGE debugging information.  It is mostly useful for maintainers, but may
       occasionally be useful to users diagnosing problems.  (In that case it  probably  indicates  a  need  for
       extra user-level messages logged in the spool area or elsewhere, which should be improved.)

       The  level  argument specifies the printing of debugging output by the SGE components as described below,
       or 0 to turn off debugging output and reset the other environment variables concerned.  When  tracing  is
       on,  output goes to the stderr stream.  dl also sets (or, with argument 0, resets) the SGE_ND environment
       variable to make daemon programs run in  the  foreground  rather  than  actually  daemonizing,  and  also
       SGE_ENABLE_COREDUMP,  which enables core dumps from daemons which change user or group.  The trace output
       is most often used for debugging daemons; some is available from client programs but  is  typically  less
       useful.

   Debugging levels
       Debugging  is  specified  in  terms  of "layers", describing particular components of the system, such as
       libraries, indexed by a number:

       TOP (0)
              General information;

       CULL (1)
              List-processing (not used consistently);

       BASIS (2)
              Apparently intended for low-level routines, such as string processing, but used quite generally;

       GUI (3)
              Operations in the qmon graphical client;

       GDI (6)
              Grid Engine Database Interface for dealing with "objects" maintained by the qmaster process;

       PACK (7)
              Packing and unpacking network data.

       The other indices are unused.

       There are also different "classes" which determine the type/amount of information printed, again  indexed
       by a number:

       TRACE (1)
              Tracing function enter/exit (generated by DENTER, DEXIT etc. macros);

       INFOPRINT (2)
              General information (generated by DPRINTF);

       TIMING (16)
              Time taken by execd to start a job;

       LOCK (32)
              Locking/mutex information.

       Other  classes  are  defined,  but  currently  unused.   For those and unused layers, see the source file
       libs/uti/sge_rmon_monitoring_level.h.

       The layers and classes are combined into a number of different "levels" which may be used as the argument
       of dl to select the output layers and classes, as follows:

       ┌───────┬──────────────────────────────┬────────────────────┐
       │Level  │  Layer(s)                    │  Class(es)         │
       ├───────┼──────────────────────────────┼────────────────────┤
       │0      │  -                           │  turn off all      │
       │1      │  TOP                         │  INFOPRINT         │
       │2      │  TOP                         │  TRACE + INFOPRINT │
       │3      │  TOP + CULL + GDI            │  INFOPRINT         │
       │4      │  TOP + CULL + GDI            │  TRACE + INFOPRINT │
       │5      │  TOP + GUI + GDI             │  INFOPRINT         │
       │6      │  TOP + CULL + BASIS + GDI    │  LOCK              │
       │9      │  TOP + CULL + BASIS          │  INFOPRINT         │
       │10     │  TOP + CULL + BASIS + PACK   │  TRACE + INFOPRINT │
       └───────┴──────────────────────────────┴────────────────────┘
       with other levels unused.  10 is not usually interesting.

FILES

       $SGE_ROOT/util/dl.sh,$SGE_ROOT/util/dl.csh

ENVIRONMENT VARIABLES

       SGE_DEBUG_LEVEL, SGE_ND, and SGE_ENABLE_COREDUMP, as above

                                                   2012-01-18                                          sge_dl(8)