NAME

      RtapEnvLookup - RTAP environment directory name server

SYNOPSIS

      RtapEnvLookup [-e RTAP environment name] [-r root directory] [-c]


DESCRIPTION

      RtapEnvLookup provides a method for processes to  determine  where  an
      RTAP environment is running.

      On startup, RtapEnvLookup parses in the RtapEnvList(4) file.

      When a request for an environment directory is received  a  lookup  in
      memory is performed and the directory is returned (NULL if not found).

      Since the lookup is performed in memory, the time required to  satisfy
      an environment directory lookup is much quicker.

      If a  SIGHUP  signal  is  received,  the  process  will  re-parse  the
      RtapEnvList file.

      The -e <environment name> argument specifies the environment to  which
      RtapEnvLookup  is  to  attach  itself (see rtRegisterForDebug(3)).  If
      this option is omitted,  the  contents  of  the  environment  variable
      RTAPENV are used instead.

      The -r <root directory> argument specifies the RTAP root directory. If
      this  option  is  omitted,  the  contents  of the environment variable
      RTAPROOT is used instead.

      The -c argument causes a SIGHUP signal to be sent to the RtapEnvLookup
      process  registered  in  the RTAP environment. Note that the following
      environment variables must be set before executing this program  using
      this   option:  RTAPDIR,  RTAPENV,  and  RTAPROOT.  The  program  then
      terminates once the signal has been sent.

DIAGNOSTICS

      RtapEnvLookup uses RtapMonitor(1) to log diagnostic messages.

AUTHOR

      RtapEnvLookup was developed by tesserNet Systems Inc.