NAME

sm_egd - Solstice SyMON event generator

SYNOPSIS

/opt/SUNWsymon/sbin/sm_egd [ -i interval ] [ -d debug-level ] [ -h log-file ] [ -H event-history-file ] [ -R rules-file ] [ -I init-file ] [ -l shared-object -f shared-function ] [ -r export-root ]

[ -D AIL-debug-value ] [ -B event-directory ] [ -t target-machine ] [ -S ] [ P ] [ -L Tcl-directory ] [ -U username ]

[ -n RPC-number ] [ -V run-directory ]

AVAILABILITY

SUNWsymon

DESCRIPTION

Monitors other symon agents and reports events based on Tcl rules defined in rules files.

OPTIONS

-i

Specify the polling interval (in seconds) when data is collected and rules are run.

-d

Specify a debug flag for the event generator. The following numbers can be added together to specify several debug options:

1=Provides debugging on the initialization.

2=Provides some basic Tcl debugging.

4=Provides debuggin information on basic calls to rules and AIL. 8=Provides data on the rules as understood by the event generator. 16=Provides debugging on AIL callbacks.

32=Provides debugging on building match lists for MULTI rules. 64=Provides debugging on agent births and deaths.

-h

Specify the location of the event generator logfile.

-H

Specify a file used by the event generator to track event numbers.

-R

Specify a rules file. This file must contain the Rules variable in Tcl.

-I

Specify a file to initialize Tcl procedures.

-l

Specify a shared object to be loaded. This option must be used in conjunction with the -f option.

-f

Specifies the function within a shared object that will be called when this object is loaded. This option must be used in conjunction with the -l option.

-r

Specifies the name of the root for the outgoing hierarchy..

-D

Specifies an AIL debugging flag. The following numbers can be added together to specify several AIL debug options:

1=Print AIP version.

2=List of hierarchy updates.

4=Trace requests and connections.

8=Tell if replacing an existing node.

16=Debug pruning.

32=Trace memory use.

64=Report sm_symond traffic.

128=Sleep 30 seconds before starting.

256=Fake server death if /tmp/dead exists.

512=Print out strings used.

1024=Print messages showing time for AIP transactions.

-B

Specifies the directory for storing the event database.

-t

Specifies the target machine to be polled.

-S

Specifies that core dumps are allowed.

-P

Specifes that process data should be polled.

-L

Specifies the location of a Tcl library.

-U

Specifies a user name under which to run the event generator program.

Specifies an RPC number for connecting to
           symond.

-V

Specifies a directory for running the event generator. (This can override the location set by the -t option. However, the -h, -H, or -B flag can override the location specified in the -V flag.)

FILES

rules.tcl

Specifies the rules, in Tcl, for the event generator. Located in

                      /etc/opt/SUNWsymon.

event_gen.tcl

The initialization file for the event generator. Located in

                      /etc/opt/SUNWsymon.
event_log             The log file for events. Located in /var/opt/SUNWsymon/target.
EG_events             Stores the last event number. Located in
                      /var/opt/SUNWsymon/target.
events/*              Each event in the all events hierarchy. Located in
                      /var/opt/SUNWsymon/target.

SEE ALSO

symon(1), sm_configd(1M), sm_confsymon(1M), sm_control(1M), sm_krd(1M), sm_logscand(1M), sm_symond (1M),auth_checker.tcl(4), auth_list.tcl(4), event_gen.tcl(4), logscan.tcl(4), rules.tcl(4), sm_symond.conf (4)