Skip Navigation Links | |
Exit Print View | |
System Administration Guide: Advanced Administration Oracle Solaris 10 8/11 Information Library |
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)
Port Monitor Service Administration (pmadm)
TTY Monitor and Network Listener Port Monitors
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)
Service Access Facility Administration (Reference)
Files That Are Associated With the SAF
4. Managing System Resources (Overview)
5. Displaying and Changing System Information (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)
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)
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.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.
# 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.
Specifies the add port monitor status flag.
Specifies the pmtag mbmon as the port monitor tag.
Specifies the svctag a as the port monitor service tag.
Specifies the identity to be assigned to svctag when the service runs.
Specifies the version number of the port monitor.
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:
Specifies the bidirectional port flag.
Specifies the inactive (disabled) response message.
Specifies which TTY label in the /etc/ttydefs file to use.
Specifies the STREAMS modules to push before invoking this service.
Specifies the full path name to the device to use for the TTY port.
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 in this procedure to list the status of a TTY port or all the ports that are associated with a port monitor.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.
# pmadm -l -p mbmon -s a
Lists service information on the system.
Specifies the pmtag mbmon as the port monitor tag.
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 FLGS ID <PMSPECIFIC> mbmon ttymon a - root /dev/term/a - - /usr/bin/login - contty ldterm,ttcompat login: Terminal disabled tvi925 y #
Identifies the port monitor name, mbmon, that is set by using the pmadm -p command.
Identifies the port monitor type, ttymon.
Indicates the service tag value that is set by using the pmadm -s command.
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.
Indicates the identity assigned to the service when it is started. This value is set by using the pmadm -i command.
Information
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.
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.
Identifies the TTY label in the /etc/ttydefs file. This value is set by using the ttyadm -l command.
Identifies the STREAMS modules to be pushed. These modules are set by using the ttyadmin -m command.
Identifies an inactive message to be displayed when the port is disabled. This message is set by using the ttyadm -i command.
Identifies the terminal type, if set, by using the ttyadm -T command. The terminal type is tvi925 in this example.
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.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.
# pmadm -e -p mbmon -s a
Specifies the enable flag.
Specifies the pmtag mbmon as the port monitor tag.
Specifies the svctag a as the port monitor service tag.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.
# pmadm -d -p mbmon -s a
Specifies the disable flag.
Specifies the pmtag mbmon as the port monitor tag.
Specifies the svctag a as the port monitor service tag.