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)