LATCP(8)						      System Manager's Manual							  LATCP(8)

NAME

       latcp - LAT Control Program

SYNOPSIS

       latcp [options]

DESCRIPTION

       latcp is the control program for latd(8).

   OPTIONS
       -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 con-
	      nect 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 num-
	      ber 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 sec-
	      onds.  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 ver-
	      bose 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 seperated 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.

   SEE ALSO
       latd(8),  latd.conf(5), moprc(8), llogin(1)

LAT Server							 September 10 2002							  LATCP(8)