Copyright 1989 AT&T Copyright (c) 1997 Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
/usr/sbin/sttydefs -a ttylabel [-b] [-f final-flags] [-i initial-flags] [-n nextlabel]
/usr/sbin/sttydefs -l [ttylabel]
/usr/sbin/sttydefs -r ttylabel
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 the super-user. sttydefs with -l may be invoked by any user on the system.
The following options are supported: -a ttylabel
Add 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:
Enable autobaud. 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.
Specify 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(4I) 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(4I) flags 9600 and sane.
Specify 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(4I) flag 9600.
Specify the value to be used in the nextlabel field in /etc/ttydefs. If this option is not specified, sttydefs will set nextlabel equal to ttylabel.
If a ttylabel is specified, sttydefs displays the record from /etc/ttydefs whose TTY label matches the specified ttylabel. If no ttylabel is specified, sttydefs displays the entire contents of /etc/ttydefs. sttydefs verifies that each entry it displays is correct and that the entry's nextlabel field references an existing
Remove any record in the ttydefs file that has ttylabel as its label.
If successful, sttydefs will exit with a status of 0. sttydefs -l will generate the requested information and send it to standard output.
Example 1 A sample of sttydefs command.
The following command lists all the entries in the ttydefs file and prints an error message for each invalid entry that is detected.
example# sttydefs -l
The following shows a command that requests information for a single label and its output:
example# 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"
termio (4I), attributes (7)