# $EPIC: logctl,v 1.2 2005/03/12 05:23:23 jnelson Exp $
Synopsis:
   $logctl(REFNUMS [ACTIVE|INACTIVE|ALL])
   $logctl(REFNUM <log-desc>)
   $logctl(ADD log-desc [target])
   $logctl(DELETE log-desc [target])
   $logctl(GET <refnum> [ITEM])
   $logctl(SET <refnum> [ITEM] [VALUE])
   $logctl(MATCH [pattern])
   $logctl(PMATCH [pattern])

Technical:
   $logctl(REFNUMS ALL)
   - Returns refnums of all logfiles
   $logctl(REFNUMS ACTIVE)
   - Returns refnums of all active ("on") logfiles
   $logctl(REFNUMS INACTIVE)
   - Returns refnums of all inactive ("off") logfiles
   $logctl(REFNUM <log-desc>)
   - Return refnum of logfile given its refnum or name.
   $logctl(CURRENT)
   - Return refnum of logfile we're currently writing to,
     or -1 when we're not writing to a logfile.

   $logctl(MATCH [pattern])
   - Return empty string (unimplemented for now)
   $logctl(PMATCH [pattern])
   - Return empty string (unimplemented for now)

   $logctl(ADD log-desc [target])
   - Add a target to be logged to an existing logfile
   $logctl(DELETE log-desc [target])
   - Remove a target to be logged from an existing logfile
   $logctl(GET <refnum> [ITEM])
   $logctl(SET <refnum> [ITEM] [VALUE])
   - Supported [ITEM]s
      REFNUM (GET only)		The logfile's refnum
      NAME			The logfile's name
      FILENAME			The file we're saving the log to
      SERVER			The server we're logging.
      TARGETS			All of the target's we're logging
      LEVEL			The levels we're filtering the logfile on
      REWRITE			How we're rewriting each line of the log
      MANGLE			How we're mangling each line of the log
      STATUS			0 if "off", 1 if "on"
      TYPE			What we're logging: "SERVER", "WINDOW" 
                                                 or "TARGET"
      ACTIVITY                  The last $time() the logfile was written to.

See Also:
   log(1)

History:
   The $logctl() function first appeared in EPIC4-1.1.8.
   ACTIVITY and REFNUMS first appeared in EPIC4-1.1.11.