Use pmadm to add services, list the services of one or more ports associated with a port monitor, and enable or disable a service.
You must be superuser to perform the following procedures.
To add a standard terminal service to the mbmon port monitor, type:
# pmadm -a -p mbmon -s a -i root -v `ttyadm -V` -m "`ttyadm -i 'Terminal disabled' -l contty -m ldterm,ttcompat -S y -d /dev/term/a -s /usr/bin/login`" |
In this example, the input wraps to the next line. Do not put a Return or line feed after contty.
-a |
The add port monitor status flag |
-p |
Specifies the pmtag mbmon as the port monitor tag |
-s |
Specifies the svctag a as the port monitor service tag |
-i |
Specifies the identity to be assigned to svctag when it runs |
-v |
Specifies the version number of the port monitor |
-m |
Specifies the ttymon-specific configuration data formatted by ttyadm |
The above pmadm command contains an embedded ttyadm command. The options in this embedded command are as follows:
-b |
The bidirectional port flag |
-i |
Specifies the inactive (disabled) response message |
-l |
Specifies which TTY label in /etc/ttydefs to use |
-m |
Specifies the STREAMS modules to push before invoking this service |
-d |
Specifies the full path name to the device to use for the TTY port |
-s |
Specifies the full path name of the service to invoke when a connection request is received; if arguments are required, enclose the command and its arguments in quotation marks (") |
Use the pmadm command as shown to list the status of a TTY port, or all the ports associated with a port monitor.
To list one service of a port monitor, type:
# pmadm -l -p mbmon -s a |
-l |
Lists service information |
-p |
Specifies the pmtag mbmon as the port monitor tag |
-s |
Specifies the svctag a as the port monitor service tag |
To list all services of all port monitors, type:
# pmadm -l |
-l |
Lists service information |
To list all services of a port monitor, type:
# pmadm -l -p mbmon |
-l |
Lists service information |
-p |
Specifies the pmtag mbmon as the port monitor tag |
# pmadm -l -p mbmon PMTAG PMTYPE SVCTAG FLAGS ID <PMSPECIFIC> mbmon ttymon a - root /dev/term/a - - /usr/bin/login - contty ldterm,ttcompat login: Terminal disabled - y # |
mbmon |
Identifies the port monitor name, mbmon, set by using the pmadm -p command. |
ttymon |
Identifies the port monitor type, ttymon. |
a |
Indicates the service tag value set by using the pmadm -s command. |
- |
Identifies whether the following flags are set by using the pmadm -f command: x, which means do not enable the service; u, which means create a utmpx entry for the service. No flags are set in this example. |
root |
Identifies the ID assigned to the service when its started. This value is set by using the pmadm -i command. |
<PMSPECIFIC> Information |
|
/dev/term/a |
Indicates the TTY port pathname set by using the ttyadm -d command. |
- |
Indicates whether the following flags are set by using the ttadm -c -b -h -I -r command: 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. |
- |
Indicates a value set by using the ttyadm -r option. This option determines when ttymon displays a prompt after receiving data from a port. If count is 0, ttymon will wait until it receives any character. If count is greater than 0, ttymon will wait until count new lines have been received. No value is set in this example. |
/usr/bin/login |
Identifies the full pathname of the service to be invoked when a connected is received. This value is set by using ttyadm -s command. |
- |
Identifies the ttyadm -t command's (timeout) value. This option specifies that ttymon should close a port if the open on the port succeeds, and no input data is received in timeout seconds. There is no timeout value in this example. |
contty |
Identifies the TTY label in the /etc/ttydefs file. This value is set by using the ttyadm -l command. |
ldterm,ttcompat |
Identifies the STREAMS modules to be pushed. These modules are set by using the ttyadmin -m command. |
login: Terminal disabled |
Identifies an inactive message to be displayed when the port is disabled. This message is set by using the ttyadm -i command. |
tvi925 |
Identifies the terminal type, if set, by using the ttyadm -Tcommand. The terminal type is tvi925 in this example . |
y |
Identifies the software carrier value set by using the ttyadm -S command; n will turn software carrier off, y will turn software carrier on. Software carrier is turned on in this example. |
# |
Identifies any comment specified with the pmadm -y command. (There is no comment in this example). |
To enable a disabled port monitor service, type:
# 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 |
To disable a port monitor service, type:
# 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 |