JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
System Administration Guide: Advanced Administration
search filter icon
search icon

Document Information

Preface

1.  Managing Terminals and Modems (Overview)

2.  Setting Up Terminals and Modems (Tasks)

3.  Managing Serial Ports With the Service Access Facility (Tasks)

Managing Serial Ports (Task Map)

Using the Service Access Facility

Overall SAF Administration (sacadm)

Service Access Controller (SAC Program)

SAC Initialization Process

Port Monitor Service Administration (pmadm)

ttymon Port Monitor

Port Initialization Process

Bidirectional Service

TTY Monitor and Network Listener Port Monitors

TTY Port Monitor (ttymon)

ttymon and the Console Port

ttymon-Specific Administrative Command (ttyadm)

Network Listener Service (listen)

Special listen-Specific Administrative Command (nlsadmin)

Administering ttymon Port Monitors

How to Set the ttymon Console Terminal Type

How to Set the Baud Rate Speed on the ttymon Console Terminal

How to Add a ttymon Port Monitor

How to View ttymon Port Monitor Status

How to Stop a ttymon Port Monitor

How to Start a ttymon Port Monitor

How to Disable a ttymon Port Monitor

How to Enable a ttymon Port Monitor

How to Remove a ttymon Port Monitor

Administering ttymon services (Task Map)

Administering ttymon Services

How to Add a Service

How to View the Status of a TTY Port Service

How to Enable a Port Monitor Service

How to Disable a Port Monitor Service

Service Access Facility Administration (Reference)

Files That Are Associated With the SAF

/etc/saf/_sactab File

/etc/saf/pmtab/_pmtab File

Service States

Port Monitor States

Port States

4.  Managing System Resources (Overview)

5.  Displaying and Changing System Information (Tasks)

6.  Managing Disk Use (Tasks)

7.  Managing UFS Quotas (Tasks)

8.  Scheduling System Tasks (Tasks)

9.  Managing System Accounting (Tasks)

10.  System Accounting (Reference)

11.  Managing System Performance (Overview)

12.  Managing System Processes (Tasks)

13.  Monitoring System Performance (Tasks)

14.  Troubleshooting Software Problems (Overview)

15.  Managing System Messages

16.  Managing Core Files (Tasks)

17.  Managing System Crash Information (Tasks)

18.  Troubleshooting Miscellaneous Software Problems (Tasks)

19.  Troubleshooting File Access Problems (Tasks)

20.  Resolving UFS File System Inconsistencies (Tasks)

21.  Troubleshooting Software Package Problems (Tasks)

Index

Administering ttymon Services

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

  1. 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.

  2. Add a standard terminal service to the mbmon port monitor.
    # 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 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.

  1. 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.

  2. 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 3-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

  1. 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.

  2. 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

  1. 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.

  2. 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.