Use the pmadm command to add services, list the services of one or more ports associated with a port monitor, and enable or disable a service.
How to Add a Service
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Add a standard terminal service to the mbmon port
monitor.
#pmadm -a -p mbmon -s a -i root -v `ttyadm -V` -m "`ttyadm -i 'Terminaldisabled' -l contty -m ldterm,ttcompat -S y -d /dev/term/a-s /usr/bin/login`"
In this example, the input wraps automatically to the next line. Do not use a Return key or line feed.
a
Specifies 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 the service runs.
v
Specifies the version number of
the port monitor.
m
Specifies the ttymon-specific configuration
data formatted by ttyadm.
The preceding pmadm command contains an embedded ttyadm command. The options in this embedded command are as follows:
b
Specifies the bidirectional port flag.
i
Specifies the inactive (disabled)
response message.
l
Specifies which TTY label in the /etc/ttydefs file 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 (“).
How to View the Status of a TTY Port Service
Use the pmadm command as shown in this procedure to list the status of a TTY port or all the ports that are associated with a port monitor.
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
List one service of a port monitor.
# pmadm -l -p mbmon -s a
l
Lists service information on the system.
p
Specifies the pmtag mbmon as
the port monitor tag.
s
Specifies the svctag a as
the port monitor service tag.
Example 10.2. Viewing the Status of a TTY Port Monitor Service
This example lists all services of a port monitor.
# 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 tvi925 y #
PMTAG
Identifies the port monitor name, mbmon,
that is set by using the pmadm -p command.
PMTYPE
Identifies the port monitor type, ttymon.
SVCTAG
Indicates the service tag value that is set by using the pmadm -s command.
FLAGS
Identifies whether the following flags are set by using the pmadm -f command.
x — Do not enable the service.
u — Create a utmpx entry for the
service.
dash (-) — No flags are set.
ID
Indicates the identity assigned to the service when it is started. This value is set by using the pmadm -i command.
<PMSPECIFIC>
Information
/dev/term/a
Indicates the TTY port path name that is set by using the ttyadm -d command.
-
Indicates whether the following flags are set by using the ttyadm -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.
dash (-) — No flags are set.
-
Indicates a value that is set by using the ttyadm
-r count
option. This option determines
when ttymon displays a prompt after receiving data from
a port. If count is 0, ttymon waits
until it receives any character. If count is greater
than 0, ttymon waits until count new
lines have been received. No value is set in this example.
/usr/bin/login
Identifies the full path name of the service to be invoked when a connection is received. This value is set by using the ttyadm -s command.
-
Identifies the ttyadm -t command's time-out
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 time-out 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
-T command. The terminal type is tvi925 in this
example.
y
Identifies the software carrier value that is set by using the ttyadm -S command. n turns the software carrier off. y turns the software carrier on. The software carrier is turned on in this example.
#
Identifies any comment specified with the pmadm -y command. There is no comment in this example.
How to Enable a Port Monitor Service
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Enable a disabled port monitor service.
# pmadm -e -p mbmon -s a
e
Specifies 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
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Disable a port monitor service.
# pmadm -d -p mbmon -s a
d
Specifies the disable flag.
p
Specifies the pmtag mbmon as
the port monitor tag.
s
Specifies the svctag a as
the port monitor service tag.