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

Service Access Facility Administration (Reference)

This section includes reference information for administration of the Service Access Facility.

Files That Are Associated With the SAF

The SAF uses configuration files that can be modified by using the sacadm and pmadm commands. You should not need to manually edit the configuration files.

File Name
Description
/etc/saf/_sysconfig
Per-system configuration script
/etc/saf/_sactab
The SAC's administrative file that contains configuration data for the port monitors that the SAC controls
/etc/saf/pmtag
Home directory for port monitor pmtag
/etc/saf/pmtag/_config
Per-port monitor configuration script for port monitor pmtag if it exists
/etc/saf/pmtag/_pmtab
Port monitor pmtag's administrative file that contains port monitor-specific configuration data for the services pmtag provides
/etc/saf/pmtag/svctag
Per-service configuration script for service svctag
/var/saf/log
The SAC's log file
/var/saf/pmtag
Directory for files created by pmtag, for example, log files

/etc/saf/_sactab File

The information in the /etc/saf/_sactab file is as follows:

# VERSION=1
zsmon:ttymon::0:/usr/lib/saf/ttymon
#
# VERSION=1

Indicates the Service Access Facility version number.

zsmon

Is the name of the port monitor.

ttymon

Is the type of port monitor.

::

Indicates whether the following two flags are set:

d

Do not enable the port monitor.

x

Do not start the port monitor. No flags are set in this example.

0

Indicates the return code value. A return count of 0 indicates that the port monitor is not be restarted if the port monitor fails.

/usr/lib/saf/ttymon

Indicates the port monitor path name.

/etc/saf/pmtab/_pmtab File

The /etc/saf/pmtab/_pmtab file, such as /etc/saf/zsmon/_pmtab, is similar to the following:

# VERSION=1
ttya:u:root:reserved:reserved:reserved:/dev/term/a:I::/usr/bin/login::9600:
ldterm,ttcompat:ttya login\: ::tvi925:y:# 
# VERSION=1

Indicates the Service Access Facility version number.

ttya

Indicates the service tag.

x,u

Identifies whether the following flags are set:

x

Do not enable the service.

u

Create a utmpx entry for the service.

root

Indicates the identity assigned to the service tag.

reserved

This field is reserved for future use.

reserved

This field is reserved for future use.

reserved

This field is reserved for future use.

/dev/term/a

Indicates the TTY port path name.

/usr/bin/login

Identifies the full path name of the service to be invoked when a connection is received.

:c,b,h,I,r:

Indicates whether the following flags are set:

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 hand-up 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 ttymon prints the login:message.

9600

Identifies the TTY label defined in the /etc/ttydefs file.

ldterm,ttcompat

Identifies the STREAMS modules to be pushed.

ttya login\:

Identifies the prompt to be displayed.

:y/n:

Indicates yes or no response.

message

Identifies any inactive (disabled) response message.

tvi925

Identifies the terminal type.

y

Indicates whether the software carrier is set (y/n).

Service States

The sacadm command controls the states of services. The following list describes the possible states of services.

Enabled

Default state. When the port monitor is added, the service operates.

Disabled

Default state. When the port monitor is removed, the service stops.

To determine the state of any particular service, use the following:

# pmadm -l -p portmon-name -ssvctag

Port Monitor States

The sacadm command controls the states of the ttymon and listen port monitors. The following table describes the possible port monitor states.

State
Description
Started
Default state – When the port monitor is added, it is automatically started.
Enabled
Default state – When the port monitor is added, it is automatically ready to accept requests for service.
Stopped
Default state – When the port monitor is removed, it is automatically stopped.
Disabled
Default state – When the port monitor is removed, it automatically continues existing services and refuses to add new services.
Starting
Intermediate state – The port monitor is in the process of starting.
Stopping
Intermediate state – The port monitor has been manually terminated, but it has not completed its shutdown procedure. The port monitor is on the way to becoming stopped.
Notrunning
Inactive state – The port monitor has been killed. All ports previously monitored are inaccessible. An external user cannot tell whether a port is disabled or notrunning.
Failed
Inactive state – The port monitor is unable to start and remain running.

To determine the state of any particular port monitor, use the following command:

# sacadm -l -p portmon-name

Port States

Ports can be enabled or disabled depending on the state of the port monitor that controls the ports.

State
Description
Serial (ttymon) port states
Enabled
The ttymon port monitor sends a prompt message to the port and provides login service to it.
Disabled
Default state of all ports if ttymon is killed or disabled. If you specify this state, ttymon sends out the disabled message when it receives a connection request.