How to Enable a Port Monitor Service
To enable a disabled port monitor service, type the following:
# pmadm -e -p mbmon -s a |
-e | The enable flag. |
-p | Specifies the pmtag mbmon as the port monitor tag. |
-s | Specifies the svctag a as the port monitor service tag. |
How to Disable a Port Monitor Service
To disable a port monitor service, type the following:
# pmadm -d -p mbmon -s a |
-d | The disable flag. |
-p | Specifies the pmtag mbmon as the port monitor tag. |
-s | Specifies the svctag a as the port monitor service tag. |
Service Access Facility Administration (Reference)
Files Associated With SAF
SAF uses configuration files which can be modified by using the sacadm and pmadm commands. You should not need to edit them manually.
File Name | Description |
|---|---|
/etc/saf/_sysconfig | Per-system configuration script. |
/etc/saf/_sactab | SAC's administrative file that contains configuration data for the port monitors that the SAC controls. |
/etc/saf/pmtag | Home directory for port monitor pmtag. |
/etc/saf/pmtag/_config | Per-port monitor configuration script for port monitor pmtag if it exists. |
/etc/saf/pmtag/_pmtab | Port monitor pmtag's administrative file that contains port monitor-specific configuration data for the services pmtag provides. |
/etc/saf/pmtag/svctag | Per-service configuration script for service svctag. |
/var/saf/log | SAC's log file. |
/var/saf/pmtag | Directory for files created by pmtag, for example, log files. |
The /etc/saf/_sactab File
The /etc/saf/_sactab looks like this:
# VERSION=1 zsmon:ttymon::0:/usr/lib/saf/ttymon # |
# VERSION=1 | Indicates the Service Access Facility version number. |
zsmon | Is the name of the port monitor. |
ttymon | Is the type of port monitor. |
:: | Indicates whether the following two flags are set: d, do not enable the port monitor x, do not start the port monitor. No flags are set in this example. |
0 | Indicates the return code value. A return count of 0 indicates that the port monitor is not be restarted if it fails. |
/usr/lib/saf/ttymon | Indicates the port monitor pathname. |
The /etc/saf/pmtab/_pmtab File
The /etc/saf/pmtab/_pmtab file, such as /etc/saf/zsmon/_pmtab, looks similar to the following:
# VERSION=1 ttya:u:root:reserved:reserved:reserved:/dev/term/a:I::/usr/bin/login::9600: ldterm,ttcompat:ttya login\: ::tvi925:y:# |
# VERSION=1 | Indicates the Service Access Facility version number. |
ttya | Indicates the service tag. |
x,u | Identifies whether the following flags are set: x, which means do not enable the service. u, which means create a utmpx entry for the service. |
root | Indicates the identity assigned to the service tag. |
reserved | This field is reserved. |
reserved | This field is reserved. |
reserved | This field is reserved. |
/dev/term/a | Indicates the TTY port pathname. |
/usr/bin/login | Identifies the full pathname of the service to be invoked when a connection is received. |
:c,b,h,I,r: | Indicates whether the following flags are set: c, sets the connect on carrier flag for the port b, sets the port as bidirectional, allowing both incoming and outgoing traffic h, suppresses an automatic hangup immediately after an incoming call is received I, initializes the port r, forces ttymon to wait until it receives a character from the port before it prints the login: message. |
9600 | Identifies the TTY label defined in /etc/ttydefs file. |
ldterm,ttcompat | Identifies the STREAMS modules to be pushed. |
ttya login\: | Identifies the prompt to be displayed. |
:y/n: |
|
message | Identifies any inactive (disabled) response message. |
tvi925 | Identifies the terminal type. |
y | Indicates whether software carrier is set (y/n). |
Service States
The sacadm command controls the states of services. The following table describes the possible states of services.
State | Description |
|---|---|
Enabled | Default state - When the port monitor is added, the service operates. |
Disabled | Default state - When the port monitor is removed, the service stops. |
To determine the state of any particular service, use the following:
# pmadm -l -p portmon_name -ssvctag |
Port Monitor States
The sacadm command controls the states of ttymon and listen port monitors. The following table describes the possible port monitor states.
State | Description |
|---|---|
Started | Default state - When the port monitor is added, it is automatically started. |
Enabled | Default state - When the port monitor is added, it is automatically ready to accept requests for service. |
Stopped | Default state - When the port monitor is removed, it is automatically stopped. |
Disabled | Default state - When the port monitor is removed, it automatically continues existing services and refuses to add new services. |
Starting | Intermediate state - The port monitor is in the process of starting. |
Stopping | Intermediate state - The port monitor has been manually terminated, but it has not completed its shutdown procedure. It is on the way to becoming stopped. |
Notrunning | Inactive state - The port monitor has been killed. All ports previously monitored are inaccessible. An external user cannot tell whether a port is disabled or notrunning. |
Failed | Inactive state - The port monitor is unable to start and remain running. |
To determine the state of any particular port monitor, use the following:
# sacadm -l -p portmon_name |
Port States
Ports can be enabled or disabled depending on the state of the port monitor that controls them.
State | Description | |
|---|---|---|
Serial (ttymon) Port States | ||
| Enabled | The ttymon port monitor sends a prompt message to the port and provides login service to it. |
| Disabled | Default state of all ports if ttymon is killed or disabled. If you specify this state, ttymon will send out the disabled message when it receives a connection request. |