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 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.

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

LAT Server                                      September 10 2002                                       LATCP(8)