|
|
Each port monitor will have two directories for its exclusive use. The current directory will contain files defined by the SAF (_pmtab, _pid) and the per-service configuration scripts, if they exist. The directory /var/saf/pmtag, where pmtag is the tag of the port monitor, is available for the port monitor's private files.
Each port monitor has its own administrative file. The pmadm command should be used to add, remove, or modify service entries in this file. Each time a change is made using pmadm, the corresponding port monitor rereads its administrative file. Each entry in a port monitor's administrative file defines how the port monitor treats a specific port and what service is to be invoked on that port.
Some fields must be present for all types of port monitors. Each entry must include a unique service tag to identify the service.
The record must also contain port monitor specific data (for example, for a ttymon port monitor, this will include the prompt string which is meaningful to ttymon). Each type of port monitor must provide a command that takes the necessary port monitor-specific data as arguments and outputs this data in a form suitable for storage in the file. The ttyadm(1M) command does this for ttymon, and nlsadmin(1M) does it for listen. For a user-defined port monitor, a similar administrative command must be supplied.
Each service entry in the port monitor administrative file must have the following format and contain the information listed below:
svctag:flgs:id:reserved:reserved:scheme:pmspecific#comment
Note that port monitors may ignore the u flag if creating a utmp entry for the service is not appropriate to the manner in which the service is to be invoked. Some services may not start properly unless utmp entries have been created for them (for example, login).
# VERSION=value
where value is an integer that represents the port monitor's version number. The version number defines the format of the port monitor administrative file. This comment line is created automatically when a port monitor is added to the system. It appears on a line by itself, before the service entries.