ultrix man page for lcp

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

Name
       lcp - Local Area Transport server (LAT) control program

Syntax
       /etc/lcp [ options ]

Description
       The  LAT control program, provides the essential functions to control and manage LAT terminal service.  It allows you to start and stop LAT
       service, modify and display configuration characteristics, and display and set error counters to zero.  The following  command  is  usually
       included in the file to automatically restart LAT service during reboot:
       lcp -s

Options
       The following options can be set with

       -s	      Starts LAT service. Enables connections from LAT terminal servers to host. If LAT parameters have not been set, they take on
		      default values specified in the option.

       -r	      Resets LAT parameters to the following default values:
		      multicast timer: 30 seconds
		      nodename: hostname
		      node description: ``ULTRIX''
		      servicename: hostname
		      service description: ``ULTRIX LAT SERVICE''

       -g	      Sets groups to grp1, grp2, ... , grpn.  A number or string of numbers can be used to set groups.	The numbers used for  each
		      group must be less than or equal to 255.	For example:
		      lcp -g 128

		      or

		      lcp -g 56,5,102,10,20,30,40,50,60,...,
		      110,150,200,210,255
		      A  string  of groups must be separated by commas with no spaces.	If the string exceeds the width of the screen it must wrap
		      over to the following line.  You cannot use a backslash () or a carriage return to break a string.

       -h	      Sets a list of ttys (next argument) as being available only for host-initiated connections.  A string of ttys must be  sepa-
		      rated  by  commas  with  no spaces.  If the string exceeds the width of the screen, it must wrap over to the following line.
		      You cannot use a backslash () or a carriage return to break a string.  Each tty can optionally be associated  with  a  spe-
		      cific  port on a specific terminal server by following the tty name by the name of the server and port, separated by colons.
		      For example, the following command associates tty15 with the port named "PORT7" on the terminal server named "LAT_SERVER".
		      /etc/lcp -h /dev/tty15:LAT_SERVER:PORT7

       -H	      Sets a list of ttys (next argument) as being available only for terminal server initiated connections.   A  string  of  ttys
		      must  be separated by commas with no spaces.  If the string exceeds the width of the screen it must wrap over to the follow-
		      ing line.  You cannot use a backslash () or a carriage return to break a string.

       -m	      Sets multicast transmission timer to the specified time (next argument).	A node advertises its presence to the LAT  servers
		      by sending out a multicast message over the network. The time variable sets the interval between transmissions. Valid inter-
		      vals range from 10 to 255 seconds, with a default of 30 seconds.

       -n	      Sets node to the specified name (next argument).	Specifies the name that your node will be known by. Although the  Terminal
		      Server  keeps track of nodes without an associated nodename, a LAT node must have a nodename in order for a terminal user to
		      establish a connection. A node can have a list of associated services and service ratings, specified by up  to  16  alphanu-
		      meric  characters.  Dollar  ($)  and  underscore	(_)  characters are valid, but leading underscores and trailing colons are
		      removed. The nodename must be unique on the Ethernet. The Terminal Server displays the nodename as a service if you type the
		      command, and as a node if you type the command. The nodename default is the hostname.

       -N	      Sets  node description to the specified message (next argument).	The node description allows for a short message to be dis-
		      played to LAT users, providing news or additional node information.  Specify up to 64 alphanumeric characters.   Dollar  ($)
		      and  underscore  (_)  characters are valid, but leading underscores and trailing colons are removed.  Leading ampersands (&)
		      are not allowed. The default is ``ULTRIX''.  You must enclose the string in double quotation marks (" ") if it contains  one
		      or more spaces.

       -v	      A  service node advertises one or more services.	By default the single service offered is the node name.  For example, node
		      by default offers service The option lets you change this default.  It also lets you cause the  service  node  to  advertise
		      more than one service and associate a given set of LAT ttys with each service by appending a list of minor device numbers to
		      the service name. For example, the following command causes the node to offer two additional services, "SERV1" and "SERV2":
		      /etc/lcp -v microv -v SERV1:/dev/tty15,/dev/tty16
		      -v SERV2:/dev/tty17,/dev/tty18,/dev/tty19
		      Devices tty15 and tty16 are used for SERV1.  Devices tty17, tty18, and tty19 are used for SERV2.	All  other  LAT  ttys  are
		      used for the default service,

       Note that normal LAT service is always associated with the first option to appear.  Therefore, if you wish to advertise additional services
       you must define the service name for normal lat, even if you still want the default service name, as in the above example.

       Every time you issue a new lcp command with the option, the new set of services that you define completely replaces any previously  defined
       services.   To discontinue a previously defined service, reissue lcp with the option without specifying that service.  For example, to dis-
       continue the SERV1 service, use the following command:
       /etc/lcp -v microv 
       -v SERV2:dev/tty17,dev/tty18,dev/tty19

       -V	      Sets service description to specified message (next argument).  It can be up to 64 characters in length.	You  must  enclose
		      the string in double quotation marks (" ") if it contains one or more spaces.  If you are defining multiple services a given
		      description applies to the service name defined by the corresponding option (the	first  option  corresponds  to	the  first
		      option, and so on). For example, the following command associates the description "ULTRIX LAT service" with the service name
		      and description "service 1" with service name "SERV1".
		      /etc/lcp -v microv -v SERV1:dev/tty15,dev/tty16
		      -V "ULTRIX LAT service" -V "service 1"

       -t	      Stops LAT service. Disable connections from LAT terminal servers to host.

       -d	      Displays LAT characteristics. Shows the LAT parameters at their current setting. The following is an example of  the  output
		      of the option:
		      % /etc/lcp -d

		      Node name: NODE	  Service name: NODE
		      Node Identification: ULTRIX LAT service
		      Service Identification: ULTRIX
		      Groups: 0
		      Multicast timer: 30 seconds
		      LAT version: 5 eco: 0  LAT Protocol is active

       -z	      Reinitializes  (zeroes out) error counters.  To test system performance over a period of time, zero the counters and observe
		      the information that accumulates.

       -c	      Displays error counters in vertical format.  If an interval also is specified (next argument), displays  error  counters	in
		      horizontal format every interval seconds.  The following is an example of the output of the option:
		      % /etc/lcp -c
		      67413 Frames received (rcv)
			 32 Duplicate frames received (rcvdup)
		      89005 Frames transmitted (xmit)
			 62 Retransmissions (rexmit)
			  0 Illegal messages received (illmesg)
			  0 Illegal slots received (illslots)

       interval       Continuously  displays error counters in horizontal format, waiting interval seconds between each iteration. Quit by sending
		      a keyboard interrupt.  The following is an example of the output of the interval option:
		      % /etc/lcp 10
		      rcv     rcvdup  xmit    rexmit  illmesg  illslots
		      67474   32      89066   62      0        0
		      67483   32      89067   62      0        0
		      67491   32      89073   62      0        0
		      67502   32      89089   62      0        0

       -p	      Shows which LAT server/port combination a specific LAT tty device is connected to.  For example the following  command  dis-
		      plays which terminal server and port are associated with tty15.
		      /etc/lcp -p /dev/tty15

Restrictions
       The service and node names cannot be more than 16 characters long.

       The user must have read and write access to a terminal.

Error Counters
       The meaning of each error counter is explained below.

       rcv	      Number of Ethernet LAT messages

       rcvdup	      Number of duplicate messages received (normally indicates a system slowdown)

       xmit	      Number of transmitted Ethernet LAT messages

       rexmit	      Number of transmit frames that are sent more than once

       illmesg	      Number of bad messages flagged by the LAT driver

       illslots       Number of bad transmission slots flagged by the driver

Diagnostics
       Messages indicating that user is not privileged or that LAT service is not loaded

Files
       See Also
	      lta(4), ttys(5)

																	    lcp(8)