latcp(8) — Maintenance
NAME
latcp − Local Area Transport (LAT) Control Program
SYNOPSIS
/usr/sbin/latcp [ flags ]
The following list provides the syntax for the flags and the subordinate flags you can use with the latcp command. For more information, see the FLAGS section. latcp -s latcp -h latcp -A -aservice [-idescription] [-o | -ptty_list] latcp -A -ptty -Hremote_node {-Rremote_port |
-Vremote_service} [-Q] [-wpassword | -W] latcp -D {-aservice | -ptty_list} latcp -ptty_list -aservice latcp -Ptty_list -aservice latcp -idescription -aservice latcp -glist -aservice latcp -Glist -aservice latcp -xrating -aservice latcp -nnode latcp -mtime latcp -d [-C | -N | -S | -P [-ptty_list | -L | -I] ] latcp -eadapter latcp -Eadapter latcp -z latcp -r
FLAGS
This section provides information on the flags you can use with the latcp command.
Some of the flags require that you specify a name for the service, node, or port. The names can contain 1 to 16 of the following ASCII characters:
•Uppercase letters A to Z
•Lowercase letters a to z
Lowercase letters are converted to uppercase.
•Digits 0 to 9
•Period (.)
•Underscore (_)
•Hyphen (-)
You cannot use a hyphen as the first character.
-sStarts LAT and enables connections from LAT terminal servers to the host. If the following LAT parameters have not been set, they take on the default values:
•Node name — The default value is the host name.
•Multicast timer — The default value is 60 seconds.
•Network adapter — The default is all network adapters connected to broadcast media.
•Service name — The default value is taken from the LAT node name parameter. This default service is an unbound interactive service.
The following parameters are set to the following defaults for each service, unless specified:
—
Service description — The default value is “Digital UNIX Version X.X LAT SERVICE.”
—
Rating — The default is dynamic rating.
—
Group code — The default value is 0.
-hShuts down LAT and disables connections from LAT terminal servers to the host.
-AAdds a service or maps an application port on the host node.
When you use the -A flag you must specify either a service name (using the -a flag) or an application port (using the
-p flag). The -a and -p subordinate flags are mutually exclusive.
-aservice
Specifies the name of the service to add. The service name must conform to the rules specified at the beginning of this section.
This subordinate flag is required if you do not specify -p. The -a and -p flags are mutually exclusive.
The syntax for a latcp command with the -A and -a flags is as follows: latcp -A -aservice [-idescription]
[-o | -ptty_list]
The -i, -o, and -p flags are subordinate to the -a flag. The -o and -p flags are mutually exclusive.
-idescription
Sets the service identification to the value specified by the description field. The description field can contain up to 64 characters. If the field contains more than one word, you must enclose the string in double quotation marks ("). This subordinate flag is optional. If you do not specify a value for the description field, the default identification string (“Digital UNIX Version X.X LAT Service”) is used.
-oIndicates that the service you are adding is an optional or dedicated service (such as an application service). For example, you must use the -o flag when adding the service used for the LAT/Telnet gateway.
Services that are added without the -o flag are default services and are used for making interactive connections to the Digital UNIX LAT host through getty entries that are spawned in the /etc/inittab file. Optional services that are added with the -o flag are used along with specialized applications. For more information, refer to the Network Configuration manual.
-ptty_list
Identifies that this service will be a bound interactive service and that the specified LAT terminal devices are bound to the named service. See the lat_intro(7) reference page for a description of bound services.
The tty_list can be a single LAT terminal device or a list of LAT terminal devices separated by commas with no spaces. The LAT terminal device name syntax is only restricted by the name of the LAT terminal device in the device directory.
-ptty
Identifies the LAT terminal device to be mapped to an application port. The LAT terminal device name syntax is only restricted by the name of the LAT terminal device in the device directory.
The syntax for a latcp command with the -A and -p flags is as follows: latcp -A -ptty -Hremote_node
{-Rremote_port | -Vremote_service} [-Q]
[-wpassword | -W]
This subordinate flag is required if you do not specify -a.
Application ports are typically not mapped using a LAT terminal device that is also used in the /etc/inittab file. This is only done if a dedicated terminal device (tty) on a specific terminal is desired. For information on how to provide a dedicated tty on a terminal, see the Network Configuration manual.
You must also specify the application port name (-p) and the remote node (server) name (-H) and either the server port name (-R) or remote service name (-V). If a connection is to be made to a specific port for a service, specify the server port name. No default values are available for the input fields when creating an application port.
The -H, -R, -V, -Q and -w or -W flags are subordinate to the -p flag.
-Hremote_node
Identifies the remote node (terminal server) to be mapped to the LAT terminal device specified by -ptty. The -H flag is required with the -p flag. The remote node name must conform to the rules for names specified at the beginning of this section.
-Rremote_port
Identifies the name of the remote port on a server that is to be mapped to the LAT terminal device specified by -ptty. The remote port name must conform to the rules for names specified at the beginning of this section.
-Vremote_service
Identifies the service name offered by the server that is to be mapped to the LAT terminal device specified by -ptty. The service name must conform to the rules for names specified at the beginning of this section.
-QSpecifies that the type of access requested is nonqueued. There are two types of access requests: queued and nonqueued. A queued or nonqueued request is accepted by the server if the remote port is free. If the remote port is busy and queuing is enabled on the server, then a queued request is queued on the server until the port becomes available while a nonqueued request is rejected immediately.
If you do not specify the -Q flag, the application port is set to queued by default.
-wpassword | -W
Allows the user to specify the password for the remote service which will be accessed through the mapped application port. When the remote service to be accessed has password checking enabled, this password is needed or the connection is rejected. The password is not case sensitive and spaces are disallowed.
When using the -w option, the password is specified on the command line and is visible. When the -W option is used, the user will be prompted for the password and it will not be echoed.
The -w option should be used when adding this command to the LAT /etc/latstartup.conf startup file. When you use this method, it is recommended that the /etc/latstartup.conf file have read and write permission for root only.
To change (or remove) the password, delete the application port (latcp -D -ptty) and add it back with the new password (or without a password).
-DDeletes a service or unmaps an application port from the host node. You must specify either a service (-a) or a port (-p) with the -D flag.
The syntax for a latcp command with the -D flag is as follows: latcp -D {-aservice | -ptty_list}
When a service is deleted, it is no longer available to terminal server users. If a service name is not specified, an error message is generated.
When you delete a bound interactive service the ttys bound to it are unbound. If the ttys remain in the /etc/inittab file they will become associated with any existing unbound interactive services. For more information, see the description of the latcp -Ptty_list option.
If there is only one unbound interactive service running on the system, you cannot delete it.
When an application port is unmapped, any active session is stopped and the port is unmapped from its associated virtual terminal line.
The -a and -p flags are explained in the following list:
-aservice
Specifies the service to be deleted.
-ptty_list
Unmaps the specified list of LAT terminal devices from the application port to which they were bound. The list can be a single LAT terminal device or a list of LAT terminal devices separated by commas.
-ptty_list | -Ptty_list
Binds (-p) or unbinds (-P) the specified list of LAT terminal devices to the specified bound interactive service. The list can be a single LAT terminal device or a list of LAT terminal devices separated by commas.
When you bind LAT terminal devices to a service, they cannot be used by other services. The syntax for the latcp -p command is as follows: latcp -ptty_list -aservice
When LAT terminal devices are unbound from a bound interactive service, the devices should be removed from the /etc/inittab file before you unbind them. If the entries remain in the /etc/inittab file after you unbind them from the service, the getty process running on that device exits and is respawned. When the getty process is respawned, the device becomes associated with the existing unbound interactive services. If this behavior is not desired, remove the entries from the /etc/inittab file.
The syntax for the latcp -P command is as follows: latcp -Ptty_list -aservice
-idescription
Sets the service identification to the specified value. The description field can contain up to 64 characters. If the field contains more than one word, you must enclose the string in double quotation marks (").
The -aservice is subordinate to the -i flag and is required. You use it to change the service identification for the named service. The service name must conform to the rules specified at the beginning of this section.
-glist | -Glist
Enables (-g) and disables (-G) the service node groups specified in the list. Group codes can range from 0 to 255. Group 0 is enabled by default for all service nodes and servers.
The -aservice flag is required to enable or disable service node groups. It identifies a service name. The service name must conform to the rules specified at the beginning of this section.
The syntax for a latcp command with the -g flag is as follows: latcp -glist -aservice For example:
# latcp -g 128 -asiteapp
This example specifies a single node group of 128 for the service siteapp. If you enter a group list, use commas (,) to separate individual groups. The following example shows multiple node groups being specified for the service transapp:
# latcp -g 56,5,102,10,20,30,40,50,60,...,
110,150,200,210,255 -atransapp
If the string exceeds the width of the screen, it must wrap to the following line. You cannot use a carriage return to break a string. Note that the individual group codes are separated by commas with no spaces.
The syntax for a latcp command with the -G flag is as follows: latcp -Glist -aservice
-xratingSpecifying a rating of −1 causes service ratings to be calculated dynamically based on the node’s activity. The service ratings are placed in service announcement messages multicasted to all LAT nodes.
Specifying a rating of 0 through 255 causes the rating to be static for the named service. Specifying a service rating of 0 makes the service less available to users; specifying 255 makes the services highly available.
You must specify a service (-aservice) with the -x flag.
The default rating is dynamic.
-nnodeSets the node name to the name specified with the name argument. The node name specifies the name by which the node will be known. The node name must be unique within the LAT network and must conform to the rules specified at the beginning of this section.
The default node name is the value of the utsname.nodename field defined in <sys/utsname.h>. If the utsname.nodename field contains a period (.), the LAT node name will be truncated to contain only the characters that come before the first period and truncated to 16 characters.
-mtimeSets multicast transmission timer to the specified time in seconds. A node advertises its presence to the LAT terminal servers by sending out a multicast message over the network. The multicast timer determines the time between the multicast messages. Valid intervals range from 10 to 180 seconds. (The default is 60 seconds.)
-dDisplay characteristics of the host node. This flag can be combined with other flags to display detailed information (such as node counter information, virtual circuit counter information, virtual circuit information, and application port information).
The syntax for a latcp command with the -d flag is as follows: latcp -d [-C | -N | -S | -P [-ptty_list | -L | -I] ]
This command shows the LAT parameters at their current setting. For example:
# /usr/sbin/latcp -d
Node name: NODE
Multicast timer: 60 seconds
LAT version: 5 ECO: 2
Selected Interface Name(s): ln0
LAT Protocol is active
Service information
Service name: SERVICE1
Service ID: DEC OSF/1 Version X3.0 LAT SERVICE
Rating: Dynamic 255
Groups: 0
Service information
Service name: BOUNDSVC (Bound)
Service ID: DEC OSF/1 Version X3.0 LAT SERVICE
Rating: Dynamic 255
Groups: 0
Ports: TTY02
Service information
Service name: DEDICATED (Optional)
Service ID: DEC OSF/1 Version X3.0 LAT SERVICE
Rating: Dynamic 255
Groups: 0
A service without Bound or Optional next to the name is an unbound interactive service. For bound services, the display includes a Ports entry that shows the LAT terminal devices (ttys) that are bound to the bound interactive service.
The -C, -N, -S, and -P flags are subordinate to the -d flag. These flags are mutually exclusive.
-CDisplays counter information for the remote nodes with which the host currently has a virtual circuit. For example:
# /usr/sbin/latcp -d -C
LATCP Server Counters for SERVER1
120 Seconds since last reset 0 Retransmitted messages
22 Run messages received 0 Bad circuit messages
26 Run messages transmitted 0 Bad circuit slots
20 Slots received 0 Accepted host-initiated
22 Slots transmitted 0 Rejected host-initiated
104 Bytes received 0 Multiple nodes seen
0 Duplicate messages
-NDisplays counter information for the local host node. For example:
# /usr/sbin/latcp -d -N
LATCP Node Counters
160020 Seconds since last reset 0 Retransmitted messages
283 Run messages received 0 Bad circuit messages
301 Run messages transmitted 0 Bad circuit slots
191 Slots received 0 Accepted host-initiated
191 Slots transmitted 0 Rejected host-initiated
937 Bytes received 0 Multiple nodes seen
0 Duplicate messages
LATCP Node Statistics
2 Circuits created 0 Circuit timeouts
9 Sessions created 2826 Service messages xmit
285 Frames received 2826 Service messages recv
3130 Frames transmitted 2826 Service messages used
0 Illegal frames
LATCP Node Errors
0 Circuit Start 0 HIC Solicit
0 Circuit Run 0 HIC Response
0 Circuit Halt 0 HIC Command
0 Service Announcement 0 HIC Status
0 Other Message
-SDisplays the address of the remote nodes and the number of sessions with which the host currently has a virtual circuit. For example:
# /usr/sbin/latcp -d -S
LATCP Server Characteristics for MABBAM
Ethernet address: 08-00-2B-a3-90-85
Number of Active Sessions: 1
-PDisplays the characteristics for ports on the host node. If this flag is issued without an argument, all application ports and any active interactive sessions on the host node are displayed.
The -p, -L, and -I flags are subordinate to the -P flag. These flags are mutually exclusive.
-ptty_list
Identifies the LAT terminal devices for which data is to be printed. The list can be a single LAT terminal device or a list of LAT terminal devices separated by commas.
-LSets the display of port characteristics to display all application ports.
-ISets the display of port characteristics to display all interactive ports.
-eadapter | -Eadapter
Adds (-e) or removes (-E) the specified adapter to or from the list of adapters over which LAT can run.
All active sessions running over the adapter being deleted are terminated.
If there is only one adapter on the system, you cannot delete it.
-zSets to zero all counters displayed by the -d -C and -d -N options. You can test system performance over time by setting the counters to zero and observing the information that accumulates.
-rResets the LAT parameters to the default values. See the -s option for information.
All services (except the default service) are deleted. If that service was an optional service, it is reset to a default service. The default service is an unbound interactive service (added without the -o or -ptty_list flags) which has the same name as the LAT node name. This service is used for incoming interactive connections to the Digital UNIX LAT host through getty routines that are spawned in the /etc/inittab file.
DESCRIPTION
The latcp utility provides the essential functions for LAT control and management. It allows nonprivileged users to display host, port, circuit, and server information and privileged users to perform the following tasks:
•Add, delete, change, and display service and port attributes
•Add and delete network interface adapters
•Bind and unbind LAT devices to specific services
•Change the node name
•Enable and disable node group codes
•Change service rating
•Display and reset counter information
•Start and stop the LAT driver
When LAT automatic startup and shutdown is enabled, the /sbin/init.d/lat script is executed upon reaching run level 3. When this script is executed, it reads and executes the latcp commands in the /etc/latstartup.conf file (if it exists). LAT automatic startup and shutdown can be enabled or disabled with the latsetup utility. See the Network Configuration manual for additional information.
The latcp program only effects one operation per invocation. Therefore, you can only specify one command on a command line.
For introductory information on LAT, see the lat_intro(7) reference page.
Changing Adapters
The latcp -E command removes an adapter in use and the latcp -e command specifies another adapter. After changing an adapter, issue a latcp -s command to force a service announcement message.
FILES
/dev/streams/lat
Specifies the LAT control device.
RELATED INFORMATION
lat_intro(7), lat_manual_setup(7), latsetup(8)
Network Configuration , Network Administration