Chapter 4. eventmond Command-line Options

Use the eventmond command to configure the eventmond daemon or to send commands to tasks that eventmond is running.


Note: The task interface is complex and remains proprietary until SGI thoroughly tests it. When the task interface becomes available for general use, this document will be revised to provide more information about the task interface and how to write tasks that use it. SGI recommends that you do not attempt to create and load custom tasks at this time.


Configuring the Daemon

Use the following command-line options to configure how the eventmond daemon behaves:

eventmond [-p <port_number>] [-s <socket_name>] [-c <subscription_file_name>] [-B-] 

Table 4-1. eventmond Command-line Options to Configure the Daemon

Option

Description

-p <port_number>

Specifies the TCP/IP port that eventmond uses to send and receive event information (default: 5553)

-s <socket_name>

Specifies the UNIX domain socket that eventmond uses for the command execution interface (load task, run task, and so on) (default: /tmp/s.eventmond)

-c <subscription_file_name>

Specifies a file in which eventmond saves the current subscription data so consumers do not have to resubscribe events if the eventmond daemon is stopped and restarted

-B-

Specifies that eventmond should not run as a daemon


Sending Commands to Tasks

Use the following command-line options to send commands to tasks that the Event Manager is running:

eventmond [-L <taskname> -P <parameters>] [-U <taskname> -P <parameters>]
  [-S <taskname> -P <parameters>] [-Q <taskname> -P <parameters>]
  [-I <taskname> -P <parameters>] [-C <taskname> -P <parameters>]
  [-M <taskname> -P <parameters>]

Table 4-2. eventmond Command-line Options to Start and Stop Tasks

Option[a]

Description[b]

-C <taskname> -P <parameters>

Sends a command to a running task

-I <taskname> -P <parameters>

Returns information about a running task

-L <taskname> -P <parameters>

Loads a task into the Event Manager and starts it

-M <taskname> -P <parameters>

Sends a message to a running task

-Q <taskname> -P <parameters>

Stops a running task

-S <taskname> -P <parameters>

Starts a loaded task

-T [A|I]

Lists the loaded tasks and shows the current status of each task

Use -T A to show all active tasks. Use -T I to show all idle tasks. Use -T to show all tasks.

-U <taskname> -P <parameters>

Stops a running task and unloads it

[a] <taskname> is either the name of the task (for example, syslog) or the full DSO name (for example,
). The full pathname (for example, /usr/lib/syslog) of the DSO is not required.

[b] The commands are not applicable to all tasks. For example, the syslog task uses only the load task and un load task commands.


Displaying Help

Use the -h command-line option to display information about the command-line options that are available:

eventmond -h