System Administration Guide: Advanced Administration

Administering `ttymon` Services

Use pmadm to add services, list the services of one or more ports associated with a port monitor, and enable or disable a service.

Note –

You must be superuser to perform the following procedures.

How to Add a Service

To add a standard terminal service to the mbmon port monitor, type the following:

# 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`"

Note –

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 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 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 the following:

# 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 the following:

# pmadm -l

`-l`	Lists service information

To list all services of a port monitor, type the following:

# pmadm -l -p mbmon

`-l`	Lists service information
`-p`	Specifies the `pmtag` `mbmon` as the port monitor tag

Example—Viewing the Status of a TTY Port Monitor Service

# 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 `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.
`-`	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 -T`command. 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).

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.