Administering port monitors

Adding a port monitor

New instances of a port monitor can be created by the system administrator or by a package that is being installed.

When you use sacadm to create a port monitor, it automatically creates the supporting directory structure in /etc/saf and /var/saf, as well as the port monitor administrative file. It also adds an entry for the new port monitor to the SAC's administrative file.

To add a new port monitor, use the following command:

sacadm -a -p pmtag -t type -c "cmd" -v ver [options]

The -p option specifies the tag associated with the port monitor.

The -t option specifies the port monitor type

The -c option names the command (for example, /usr/lib/saf/ttymon), that the SAC daemon uses to start the port monitor.

The -v option specifies the version number of the port monitor. The version number may be specified using the -V option to the port monitor's special administrative command, such as ttyadm for ttymon or nlsadmin for listen. The version number is added to the new administrative file as a comment line of the form:

   # VERSION=number
The version number defines the file format and provides a means of synchronizing software releases of port monitors with the appropriately formatted administrative files. See sacadm(1M) for more information.

The following example adds a ``tcp'' port monitor of type listen:

sacadm -a -p tcp -t listen -c "/usr/lib/saf/listen -m inet/tcp0 tcp \
2>/dev/null" -v `nlsadmin -V` -n 3 2>/dev/null

The following example adds a port monitor of type ttymon:

sacadm -a -p ttymon1 -t ttymon -c "/usr/lib/saf/ttymon" -v `ttyadm -V`

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 22 April 2004