latcp - LAT Control Program
latcp is the control program for latd(8).
- -s
- 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.
- -h
- Halts latd. This will kill any active sessions without warning.
- -A
- 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.
- -D
- 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
- -i
- 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.
- -j
- 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??
- -J
- Disables service responder.
- -Y
- Purges the list of known services from latd's internal tables.
- -x
- 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.
- -n
- Change the system's current node name (Note this affects latd only, not
DECnet nor TCP/IP)
latcp -n <nodename>
- -r
- 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.
- -m
- 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.
- -k
- 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.
- -d
- 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.
- -G
- 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.
- -g
- Disable groups using syntax as above.
- -U
- 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.
- -u
- Remove groups from the user groups list.