stty(1)stty(1)NAMEstty - 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 sup‐
port 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 supe‐
ruser. This is supported only on spe‐
cific 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. How‐
ever, it does not keep track of column
position and, as a result, may not cor‐
rectly 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 inter‐
face. 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 sym‐
bol; it represents the value of
the corresponding control char‐
acter. For example,
represents NUL.
or represents or EOT.
represents DEL.
sets control-character to unde‐
fined.
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 fea‐
ture is available only on specific
hardware.
Control Character Default Assignments
The control characters are assigned default values when the ter‐
minal 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 assign‐
ment will not work with the system console because the system
console is never closed while the system is running, and there‐
fore cannot be reopened.
Care should be exercised when re-assigning the control character
defaults. Control character values should be tested with appli‐
cations 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 variable. 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 unre‐
liable 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 ALSOshl(1), tabs(1), getty(1M), ioctl(2), termio(7), termiox(7).
STANDARDS CONFORMANCEstty(1)