latcp(8) LAT Control Program


latcp [options]


latcp is the control program for latd(8).


Start the LAT daemon. This is the only way to start LAT, you should not attempt to run latd directly or you may get unexpected behviour. latcp -s runs the file /etc/latd.conf as a shell script (using /bin/sh). Any customisations you need to do to the LAT system should be put in this file as latcp commands. The latcp command should be invoked using the environment variable $LATCP. An example latd.conf file is shipped with the package and shown in the man page latd.conf(5).
latcp -s passes any extra switches onto latd itself so you can customise latd this way, however latd.conf is recommended.

Halts latd. This will kill any active sessions without warning.

Create a local LAT service or reverse LAT port.
The syntax for creating a login service is:
latcp -A -a service [-i description] [-r rating] [-s] [-C command] [-u user]
The -s flag indicates that the service rating is static. Without this the service rating is regarded as a maximum and will be reduced according the the load average of the machine.
The -C flag indicates a command to run when a user connects to the service - by default this is /bin/login.
The -u flag specifies a user to run the above command as. By default this will be root.
The syntax for creating a reverse LAT port is:
latcp -A -p tty -V learned_service [-R rem_port] [-H rem_node] [-Q] [-8]
The tty name should start /dev/lat and must not exist. The -Q flag indicates that connections to the service is queued. If you connect to a queued service and it is busy then your connection will be forced to wait until it is available. You must use this flag for printer services on DECserver 90L terminal servers, and in this case the service name must also be empty. NOTE that the -Q flag is the opposite way round to that on Tru64 Unix(r).
The -8 flag tells latd not to muck about with the data. Normally latd will transmit a BREAK if a NUL character is typed, -8 disables this behaviour for ports with (eg) printers or modems attached.
Delete a service or port.
latcp -D -a <service> deletes an advertised service created with latcp -A -a.
latcp -D -p <tty> deletes a reverse LAT port created with latcp -A -p

Change the description of an advertised service
latcp -i <description> -a <service> If the description contains spaces or shell metacharacters you should enclose it in quotes.

Enables the service responder. This feature is needed for small terminal servers that do not collect their own service lists. I currently don't have a list of servers that need this feature. can anyone help??

Disables service responder.

Purges the list of known services from latd's internal tables.

Change the rating of an advertised service
latcp -x <rating> [-s] -a <service>
If the -s flag is present the rating is static, otherwise it is treated as the maximum value and will be decreased according to the system load average.

Change the system's current node name (Note this affects latd only, not DECnet nor TCP/IP)
latcp -n <nodename>

Change the retransmit limit. This is the maximum number of times latd will transmit a packet without an acknowlegement. If this number is exceeded then the connection is closed as it is assumed that the remote end has gone away. This value must be between 4 and 120 inclusive, the default is 20.

Sets the multicast timer (in seconds). This timer determines how often services are advertised on the LAN. The default is 60 seconds. This value must be between 10 and 180 inclusive.

Sets the keepalive timer (in seconds). This is the maximum amount of time that a connection can be inactive. When this timer expires an empty message is sent to the remote end. If it does not respond after <retransmit limit> then the connection is closed. This timer is reset every time a packet is sent out. This value must be between 10 and 180 inclusive.

Displays latd configuration or the learned service table. -d on it's own will display the latd configuration and the services that are advertised by this node. -d -l will display the learned service table. Adding -v will show the learned service table in a verbose manner. -n will show the nodes (with MAC addresses) that are associated with serviceless ports (eg reverse LAT ports to DS90L+ servers).

Displays help for using the command.

Add groups to the services advertised. The groups can be numbers separated by commas or a range. eg
latcp -G 1,2,3,10-20
Enables groups 1 2 3 and 10 to 20 inclusive.

Disable groups using syntax as above.

Add to the list of groups that the server will accept when listening for services. this affects the services that are available using the "reverse LAT" feature. See -G for the syntax.
If you are using the "responder" feature it's best make sure that this group list contains all the groups that are likely to be used on the LAN.

Remove groups from the user groups list.