stty(1) General Commands Manual stty(1)
NAME
stty - set the options for a terminal port
SYNOPSIS
options]
DESCRIPTION
sets or reports current settings of certain terminal I/O options for the device that is the current standard input. The command takes four
forms:
Report the settings of a system-defined set of options;
Report all of current option settings;
Report current settings in a form
that can be used as an argument to another command.
Set terminal I/O options as defined by
options.
For detailed information about the modes listed below in and as they relate to asynchronous lines, see termio(7).
For detailed information about the modes listed below in see termiox(7).
Options in the group are implemented using options in the previous groups. Note that many combinations of options make no sense, but no
sanity checking is performed.
The options are defined in the following groups.
Control Modes
Set the terminal window row size equal to
number.
Set the terminal window column size (width) equal to
number. can be used as an abbreviation for
Enable (disable) parity generation and detection.
Select odd (even) parity.
Select character size (see
termio(7)).
Hang up phone line immediately.
Set terminal baud rate to the number given, if possible
(some hardware interfaces do not support all of the speeds listed here). Speeds above 38400 are supported on
Series 700 only.
Set terminal input baud rate to
number. If number is zero, the input baud rate is set to the value of the output baud rate.
Set terminal output baud rate to
number. If number is zero, the modem control lines are released, which in turn disconnects the line.
Hang up (do not hang up) modem connection on last close.
Same as
Use two (one) stop bits per character.
Enable (disable) the receiver.
Enable (disable) request-to-send.
Assume a line without (with) modem control.
Block (do not block) output from a noncurrent layer.
Reset the Guardian Service Processor (GSP) of the console.
This mode can be used only by the superuser. This is supported only on specific hardware.
Input Modes
Ignore (do not ignore) break on input.
Enable (disable) ENQ-ACK Handshaking.
Signal (do not signal) INTR on break.
Ignore (do not ignore) parity errors.
Mark (do not mark) parity errors (see
termio(7)).
Enable (disable) input parity checking.
Strip (do not strip) input characters to seven bits.
Map (do not map) newline character to carriage return (CR)
on input.
Ignore (do not ignore) CR on input.
Map (do not map) CR to a newline character on input.
Map (do not map) uppercase alphabetic characters to lowercase on input.
Enable (disable) START/STOP
output control. Output is stopped by sending an ASCII DC3 and started by sending an ASCII DC1.
Allow any character (only DC1)
to restart output.
Request that the system send (not send) START/STOP characters
when the input queue is nearly empty/full.
Echo (do not echo) BEL when the input line is too long.
Output Modes
Post-process output (do not post-process output;
ignore all other output modes).
Map (do not map) lowercase alphabetics to uppercase on output.
Map (do not map) newline character to a
carriage-return/newline character sequence on output.
Map (do not map) CR to newline character on output.
Do not (do) output CRs at column zero.
On the terminal, a newline character
performs (does not perform) the CR function.
Use fill characters (use timing) for delays.
Fill characters are DELs ( NULs).
Select style of delay for carriage returns (see
termio(7)).
Select style of delay for newline characters (see
termio(7)).
Select style of delay for horizontal tabs (see
termio(7).
Select style of delay for backspaces (see
termio(7)).
Select style of delay for form-feeds (see
termio(7)).
Select style of delay for vertical tabs (see
termio(7)).
Local Modes
Enable (disable) the checking of characters against the special control
characters INTR and QUIT.
Enable (disable) canonical input (ERASE and KILL processing).
Enable (disable) any implementation-defined special control characters
not currently controlled by or
Canonical (unprocessed) uppercase and lowercase presentation.
Echo back (do not echo back) every character typed.
Echo (do not echo) ERASE character as a backspace-space-backspace string.
Note: this mode erases the ERASEed character on many CRT terminals. However, it does not keep track of column
position and, as a result, may not correctly erase escaped characters, tabs, and backspaces.
Echo (do not echo) a newline character
after a KILL character.
(obsolete) Same as
Echo (do not echo) newline character.
Disable (enable) flush after INTR or QUIT.
Echo (do not echo) control characters as
delete as
Echo (do not echo) erase character as
character is erased.
BS-SP-BS erase (do not BS-SP-BS erase) entire
line on line kill.
Output is (is not) being flushed.
Retype (do not retype) pending output at next
read or input character.
Enable (disable) generation of SIGTTOU
signals when background jobs attempt output.
Hardware Flow Control Modes
The following options are reserved for use with those devices that support hardware flow control through the termiox interface. If the
functionality is supported, this interface must be used.
Enable (disable) RTS hardware flow control on input (see
termiox(7))
Enable (disable) CTS hardware flow control on output (see
termiox(7))
Control Assignments
control-character c Set control-character to character c. See termio(7).
control-character
One of:
or and are used with
or for systems that support job control.
for systems that support shell layers (see shl(1)).
c A character or a character-pair. A character-pair is made up of a circumflex and a letter or symbol; it
represents the value of the corresponding control character. For example,
represents NUL.
or represents or EOT.
represents DEL.
sets control-character to undefined.
Some characters may need to be escaped from the shell (quoted).
Set line discipline to i where the value of i ranges from zero through 127 decimal (See termio(7)).
Combination Modes
Enable and
Enable and
Disable and set
Enable (disable) raw input and output
(no ERASE, KILL, INTR, QUIT, EOT, or output post processing). See
Unset (set) and In addition unsets and
Set (unset) and
Same as
Preserve (expand to spaces) tabs when printing.
Reset ERASE and KILL characters back to default
and
Reset all modes to some reasonable values.
Set all modes suitable for the terminal type
term, where term is one of or
Reporting Functions
Print terminal window size to standard output
in a rows-and-columns format.
Print the status of the Guardian Service Processor (GSP)
of the console. This function can be used only by the superuser. This feature is available only on specific
hardware.
Control Character Default Assignments
The control characters are assigned default values when the terminal port is opened; see termio(7). The default values used are those
specified by the (SVID3), except for the and control characters, which are set to to maintain binary compatibility with previous releases
of HP-UX.
The default values for the control characters may be changed by a privileged user by using and redirecting standard input to the device Any
of the four command forms specified in the section above may be used. However, only the control character defaults will be reported or
altered. It will have no effect on the defaults for any of the other modes.
Note that these defaults will be used for all terminal ports in the system, except the system console (but see getty(1M)), and the changes
will not become effective for a particular port until it is (re)opened. The default control character assignment will not work with the
system console because the system console is never closed while the system is running, and therefore cannot be reopened.
Care should be exercised when re-assigning the control character defaults. Control character values should be tested with applications
before assigning them as a default value.
EXTERNAL INFLUENCES
Environment Variables
determines the valid control characters for printing.
If is not specified in the environment or is set to the empty string, the value of is used as a default for each unspecified or empty vari-
able. If is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of If any internationalization
variable contains an invalid setting, behaves as if all internationalization variables are set to "C". See environ(5).
International Code Set Support
Single-byte character code sets are supported.
EXAMPLES
Example 1
Set the delete-line character to (Ctrl-X) and the interrupt character to
This command is usually found in a or file so that and need not be set by the user at each login session.
Example 2
Set the default values for the delete-line character to (Ctrl-X), the interrupt character to and the word erase character to
Any terminal port opened after this command is issued will see these new default values for the and control characters.
WARNINGS
Use of mode produces certain side effects which have varied from release to release in the past and may vary in the future. Relying on
these side effects in applications can lead to unreliable results in the future and is therefore discouraged.
DEPENDENCIES
Refer to the section of termio(7) for a further description of capabilities that are not supported.
SEE ALSO
shl(1), tabs(1), getty(1M), ioctl(2), termio(7), termiox(7).
STANDARDS CONFORMANCE
stty(1)