NAME

sttydefs - maintain line settings and hunt sequences for TTY ports

SYNOPSIS

/usr/sbin/sttydefs  -a  ttylabel  [-b]  [-n  nextlabel]  [-i
initial-flags] [-f final-flags]

/usr/sbin/sttydefs -l [ttylabel]
/usr/sbin/sttydefs -r ttylabel

DESCRIPTION

sttydefs is an administrative command that maintains the line settings and hunt sequences for the system's TTY ports by making entries in and deleting entries from the /etc/ttydefs file. sttydefs with a -a or -r option may be invoked only by a privileged user. sttydefs with -l may be invoked by any user on the system. The options have the following meanings:

-l If a ttylabel is specified, sttydefs will display the record from /etc/ttydefs whose TTY label matches the specified ttylabel. If no ttylabel is specified, sttydefs will display the entire contents of /etc/ttydefs. sttydefs will verify that each entry it displays is correct and that the entry's nextlabel field references an existing ttylabel.

-a ttylabel

Adds a record to the ttydefs file, using ttylabel as its label. The following describes the effect of the -b, -n, -i, or -f options when used in conjunction with the -a option:

-b Specifies that autobaud should be enabled. Autobaud allows the system to set the line speed of a given TTY port to the line speed of the device connected to the port without the user's intervention.

-n nextlabel

        Specifies the value to  be  used  in  the  nextlabel
        field in /etc/ttydefs.  If this option is not speci-
        fied, sttydefs will set nextlabel equal to ttylabel.

-i initial-flags

Specifies the value to be used in the initial-flags field in /etc/ttydefs. initial-flags must be in a format recognized by the stty command. These flags are used by ttymon when searching for the correct baud rate. They are set prior to writing the prompt.

If this option is not specified, sttydefs will set initial-flags equal to the termio(7) flag 9600.

-f final-flags

Specifies the value to be used in the final-flags field in /etc/ttydefs. final-flags must be in a format recognized by the stty command. final-flags are the termio(7) settings used by ttymon after receiving a successful connection request and immediately before invoking the service on the port. If this option is not specified, sttydefs will set final-flags equal to the termio(7) flags 9600 and sane.

-r ttylabel

Removes any record in the ttydefs file that has ttylabel as its label.

OUTPUT

If successful, sttydefs will exit with a status of 0. sttydefs -l will generate the requested information and send it to the standard output.

EXAMPLES

The following command will list all the entries in the ttydefs file and print an error message for each invalid entry that is detected.

    sttydefs -l
 The following shows a command that requests information for a
 single label and its output:

   # sttydefs -l 9600
   ------------------------------------------------------------------
   9600:9600 hupcl erase ^h:9600 sane ixany tab3 hupcl erase ^h::4800
   ------------------------------------------------------------------

   ttylabel:       9600
   initial flags:  9600 hupcl erase ^h
   final flags:    9600 sane ixany tab3 hupcl erase ^h
   autobaud:       no
   nextlabel:      4800
The following sequence of commands will add the  labels  1200,
2400, 4800, and 9600 and put them in a circular list:

  sttydefs -a 1200 -n 2400 -i 1200 -f "1200 sane"
  sttydefs -a 2400 -n 4800 -i 2400 -f "2400 sane"
  sttydefs -a 4800 -n 9600 -i 4800 -f "4800 sane"
  sttydefs -a 9600 -n 1200 -i 9600 -f "9600 sane"

FILES

/etc/ttydefs

SEE ALSO

System Administrator's Guide, ``Terminal Line Settings.''