stty(1) 						      General Commands Manual							   stty(1)

NAME

       stty - Sets terminal characteristics

SYNOPSIS

       stty [-a  | -g] [-f special-device]

       stty [-f special-device] [argument...]

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       stty:  XCU5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

OPTIONS

       Writes to standard output all the current settings for the terminal.  [Tru64 UNIX]  Allows you to specify an alternate terminal or teletype
       device.	Normally, the stty command works on standard input.  Writes to standard output the current settings in an  unspecified	form  that
       can be used as arguments to another stty utility on the same system.

DESCRIPTION

       The stty utility sets or reports on terminal I/O characteristics for the device that is its standard input.

       The -dsusp switch works only when the terminal settings are set to the BSD clist options in the sysconfigtab file.

       The stty -status command is no longer supported.

       Without	options  or  arguments specified, stty reports the settings of certain characteristics, usually those that differ from implementa-
       tion-defined defaults; otherwise, stty modifies the terminal state according to the specified arguments.  Some  combinations  of  arguments
       are mutually exclusive on some terminal types.

       Sections  marked  with  (I18N)  describe  features  that  are available when: The Tru64 UNIX optional subsets for Asian country support are
       installed on your system.  The Asian or Thai terminal interface has been enabled.

   Control Modes
       The following arguments are available to set the terminal characteristics: Enables (disables) parity generation and detection.  Selects odd
       (even) parity.  Selects character size, if possible.  Sets terminal baud rate to the number given, if possible.	If the baud rate is set to
       zero, modem control is no longer asserted.  Sets terminal input baud rate to the number given, if possible.   If  zero  is  specified,  the
       input  baud  rate  is set to be the same as the output baud rate.  Sets terminal output baud rate to the number given, if possible.  If the
       output baud rate is set to zero, modem control is no longer asserted.  Stops asserting modem control (does not stop  asserting  modem  con-
       trol)  on  last	close.	Same as hupcl (-hupcl).  Uses two (one) stop bits per character.  Enables (disables) the receiver.  Assumes a line
       without (with) modem control.  [Tru64 UNIX]  Enables (disables) hardware flow control using the Request to Send (RTS)  and  Clear  to  Send
       (CTS)  signals.	 [Tru64  UNIX]	Disables  (enables) the printing of kernel-generated status information when the info control character is
       entered.

   Input Modes
       [Tru64 UNIX]  Echoes control characters as ^X and <Delete> as ^?.  Prints two backspaces following  the	End-of-File  character.   (Special
       characters  are	echoed as themselves.)	Ignores (does not ignore) break on input.  Signals (does not signal) INTR on break.  Ignores (does
       not ignore) parity errors.  Marks (does not mark) parity errors.  Enables (disables) input parity checking.  Strips (does not strip)  input
       characters  to  seven  bits.  Maps (does not map) newline to carriage-return on input.  Ignores (does not ignore) carriage-return on input.
       Maps (does not map) carriage-return to newline on input.  [Tru64 UNIX]  Does (does not) ring bell on terminal when input  buffer  is  full.
       Maps (does not map) uppercase alphabetic characters to lowercase.  Enables (disables) Start/Stop output control.  Output from the system is
       stopped when the system receives Stop and started when the system receives Start.  Allows any character (allows only <Ctrl-q>)  to  restart
       output.	Requests that the system send (not send) Start/Stop characters when the input queue is nearly empty/full.

   Output Modes
       Post-processes  output (does not post-process output; ignores all other output modes).  Maps (does not map) lowercase alphabetic characters
       to uppercase on output.	[Tru64 UNIX]  Discards (keeps) End-of-Text on output.  [Tru64 UNIX]  Maps (does not  map)  newline  characters	to
       carriage-return/newline	characters.  Maps (does not map) carriage-return/newline characters to newline characters.  Does not (does) output
       carriage-return characters at column 0 (zero).  Causes (does not cause) newline to perform the carriage-return function	on  the  terminal.
       Uses  fill  characters (uses timing) for delays.  Uses Delete (uses Null) characters for fill characters.  [Tru64 UNIX]	Maintains (expands
       to spaces) any tab characters in the output.  Selects style of delay for carriage-return characters.  Selects style of  delay  for  newline
       characters.   Selects  style  of delay for horizontal tabs.  Selects style of delay for backspaces.  Selects style of delay for form feeds.
       Selects style of delay for vertical tabs.  [Tru64 UNIX]	Specifies the number of lines this display can hold.  [Tru64 UNIX]  Specifies  the
       number of characters per display line.

   Local Modes
       [Tru64  UNIX]  Uses  (does not use) the altwerase mode, which defines a word as containing only alphanumeric characters and _ (underscore).
       Enables (disables) the checking of characters against the special control characters INTR, QUIT, and SUSP.   Enables  (disables)  canonical
       input  (Erase  and  Kill  processing).	[Tru64	UNIX]  Echoes  (does not echo) the Kill character by erasing the line in place like echoe.
       [Tru64 UNIX]  Uses (does not use) carrier as a flow control flag rather than sending a  HANGUP  signal.	 [Tru64  UNIX]	Prints	(does  not
       print) erased characters backwards within  (backslash) and / (slash).  Stops (allows) output from background jobs to the terminal.  [Tru64
       UNIX]  Echoes (does not echo) uppercase characters on input, and displays uppercase characters on output with a	preceding    (backslash).
       Enables	(disables)  any  implementation-defined special control-characters not currently controlled by icanon, isig, or ixon.  Echoes back
       (does not echo back) every character typed.  Causes the Erase character to (to not) visually erase the last character in the  current  line
       from  the  display, if possible.  Echoes (does not echo) newline after the Kill character.  Echoes (does not echo) newline, even if echo is
       disabled.  Disables (enables) flush after INTR, QUIT, SUSP.

   Control Assignments
       Sets special-character to string. The special character is set to the first character in string and subsequent characters are ignored, with
       the  following  exceptions: The strings undef and ^- set the special character to {_POSIX_VDISABLE} if it is in effect for the device.  The
       string ^?  sets the special character to <Delete>.  Any other string beginning with the character ^ sets the special character to the  con-
       trol  character	corresponding  to the second character of string (subsequent characters are ignored).  For example, the string ^c sets the
       special character to ^C; the string ^zq sets the special character to ^Z.

	      Note that you can set a special character to a control character in two ways:  by entering the control character itself or by enter-
	      ing  ^ and another character.  This allows you to enter a control characters that is already assigned to a special character without
	      entering that special character; for example, you can enter ^C, even if it is already assigned to the  intr  special  character,	by
	      entering ^ and then c.

	      Recognized  special-characters include dsusp, eof, eol, eol2, erase, discard, status, intr, kill, lnext, quit, reprint, start, stop,
	      susp, and werase.  Sets the current terminal characteristics to the saved settings produced by the -g option.  Sets the value of min
	      or  time to number.  MIN and TIME are used in Non-Canonical mode input processing (-icanon).  Sets the line discipline to the speci-
	      fied number.

   Combination Modes
       Enables parenb and cs7; disables parodd.  Enables parenb, cs7, and parodd.  Disables parenb, and sets cs8.  Enables  (disables)	raw  input
       and  output  (no ERASE, KILL, INTR, QUIT, EOT, or output processing).  Enables (disables) icrnl and onlcr.  The -nl mode also unsets inlcr,
       igncr ocrnl, and onlret.  Sets (unsets) xcase, iuclc, and olcuc.  (Used for terminals with uppercase characters only.)  Resets all modes to
       some reasonable values.

   Asian Line Discipline Setup (I18N)
       Sets  the  current  line  discipline  to Asian and sets up the processing environment for Asian codesets other than those for Japanese. The
       application code is set to the codeset defined in the current locale. The terminal code may also be  set  to  the  same	codeset  when  not
       defined.   Sets the current line discipline to Asian and sets up the processing environment for Japanese codesets.  Terminal code is always
       be set to dec, but the application code depends on the current local setting. If a valid Japanese codeset is found in the  current  locale,
       the application code is set to that codeset.  Otherwise, the application code is set to eucJP.

       Do not select the adec or jdec line discipline for a console that is using the KEBUG driver.  Doing so may cause the console to hang.

   Modes for Terminal and Application Code (I18N)
       Sets the application code to codeset.  Sets the terminal code to codeset.  Sets both the terminal code and the application code to codeset.
       Enables (disables) codeset conversion between the internal code and the application and terminal codes.	Codeset conversion must be enabled
       in  order  for  Asian  terminal features to work.  Codeset conversion should be disabled only under certain circumstances that do not allow
       modification of data passing through the terminal lines.  One such circumstance would be running an 8-bit binary  file  transfer  protocol,
       such as kermit and sz (zmodem).

   Japanese Input Modes (I18N)
       Sets  the  input mode for 8-bit code or Hankaku Kana code from the terminal.  The following keywords can be used for the mode argument: The
       8-bit code from the terminal is treated as a part of the Kanji code when the terminal code is set to dec.  The 8-bit  code  (when  terminal
       code  is  dec)  or the Hankaku Kana code from the terminal is converted to the 16-bit Hiragana code.  The 8-bit code (when terminal code is
       dec) or the Hankaku Kana code from the terminal is converted to the 16-bit Katakana code.  The 8-bit code (when terminal code  is  dec)	or
       the  Hankaku  Kana  code from the terminal is converted to the 8-bit Hankaku Kana code.	Enables (disables) the Japanese input method.  The
       Kana-Kanji conversion daemon, kkcd, is spawned (ikk) or killed (-ikk).  The kkseq key map information is derived  from  the  following  (in
       priority order): The file specified by the JSYKKSEQ environment variable The ~/.jsykkseq file

	      Dictionary  names  are  derived  from the following (in priority order): The files specified by the JSYTANGO, JSYKOJIN, and JSYLEARN
	      environment variables The /usr/i18n/jsy/jsytango.dic, ~/jsykojin.dic, and ~/.jsylearn files.  Sets  the  character  or  sequence	of
	      characters  that	enters	Kana-Kanji  conversion	mode  when  using the STREAMS terminal driver.	Sets the JIS Kanji shift-in escape
	      sequence for the JIS terminal.  Sets the JIS Kanji shift-out escape sequence for the JIS terminal.   Sets  the  character  attribute
	      used  to	mark  a  clause  that  is the result of the Kana-Kanji conversion.  The four possible values for mode are bold, underline,
	      reverse, or none.  The sequences that determine these values are taken from the terminfo database.  The bold sequence is taken  from
	      "md" and "me", reverse is taken from "mr" and "me", and underline is taken from "us" and "ue".  Sets the character attribute used to
	      mark a Henkan region that is the result of the Kana-Kanji conversion.  The four  possible  values  for  mode  are  bold,	underline,
	      reverse,	or  none.  The sequences that determine these values are taken from the terminfo database.  The old sequence is taken from
	      "md" and "me", reverse is taken from "mr" and "me", and underline is taken from "us" and "ue".  Sets the Kana-Kanji  conversion  key
	      map  file  for the terminal.  Displays the current Kana-Kanji conversion key map, a traversal tree with a maximum sequence length of
	      15 characters.  Uses one (uses two) backspaces to erase one Kanji character on the terminal.  Uses (does not use)  a  single  2-byte
	      zenkaku space (two ASCII spaces) to blank out one Kanji character on the terminal.  If terminal code is either jis7 or jis8, changes
	      (does not change) the terminal state to shift out whenever a newline code is output.  Enables  (disables)  the  extended	Kana-Kanji
	      conversion mode. The char value sets or resets the character that toggles in and out of extended Kana-Kanji conversion mode.

   Modes for Software On-Demand Loading (I18N)
       Enables	(disables)  the Software On-Demand Loading (SoftODL) service.  Sets the maximum size, in characters, of the ODL buffer.  This size
       should be the same as the terminal's font cache size.  The default size is 256.	Sets the type of the ODL buffer replacement strategy.  The
       type  arguments	can  be  either fifo (First-In-First-Out) or lru (Least-Recently-Used).  Sets the path to the ODL database files.  If this
       path is not specified, the default path is the one for the user's private database (if private databases are allowed on the system)  or	to
       the systemwide ODL database.  Resets the ODL service and clears the internal ODL buffers.  Displays the current ODL service attributes.

   Modes for the Software Phrase Input Method (I18N)
       Enables	(disables)  the Software Phrase Input Method (SIM) service.  Specifies the key that toggles in and out of phrase input mode.  Sets
       the current class name for locating the appropriate phrase in the phrase database.  Sets the path of the phrase database.  Sets the display
       mode  of  the SIM service.  The two supported mode values are offspot (default) and onspot.  In offspot mode, the input phrase name is dis-
       played at the 26th line of your terminal, if supported.	In onspot mode, the phrase name is displayed at the current cursor position.  With
       DECterm, xterm, or other terminal emulators that do not support the 26th display line, specify the onspot mode value.  Displays the current
       SIM service attributes.

   Miscellaneous Asian Terminal Modes (I18N)
       Enables (disables) the history mechanism.  The key value sets or resets the key used to toggle in and out of history mode. Note	that  com-
       mand lines that are fewer than three characters long are not recorded in the history list.

   Thai Terminal Modes (I18N)
       Sets  the current line discipline to Thai.  Sets the WTT Input Sequence Check (ISC) mode. Valid mode values are 0, 1, or 2, which stand for
       pass-through, basic check, or strict mode, respectively.  Enables or disables input reordering.	Enables (disables) the history	mechanism.
       The  key  value sets or resets the key used to toggle in and out of history mode. Note that command lines that are fewer than three charac-
       ters long are not recorded in the history list.

   Compatibility Modes
       Resets Erase and Kill characters back to the system defaults.  Same as echok.  Same as ixon (-ixon).  Same  as  ixoff  (-ixoff).   Same	as
       ixany  (-ixany).  Sets all modes suitable for terminals developed by Digital Equipment Corporation (now Compaq Computer Corporation).  (The
       control-character Erase is set to ^?).

	      (I18N) For the Asian (atty) and Thai (ttty) terminal interfaces, dec also switches the line discipline back to the  default  TTYDISC
	      line  discipline.   Same	as  echoe  (-echoe).  Same as echoctl (-echoctl).  Sets (clears) echoe, echoke, and echoctl.  Sends output
	      characters with no (with) output processing.  Expands (does not expand) tabs to spaces.  Same as ofill (-ofill).	Same as -a.   Does
	      not  (does)  send HANGUP signal if carrier drops.  Does character fill and uses Null character.  Does character fill and uses Delete
	      character.  Sets modes suitable for the Teletype Corporation Model 33 terminal.  Sets modes suitable for	the  Teletype  Corporation
	      Model 37 terminal.  Sets modes suitable for the Digital Equipment Corporation Model VT05 terminal.  Sets modes suitable for the Gen-
	      eral Electric TermiNet 300.  Sets modes suitable for the Texas Instruments 700 series.  Sets modes suitable for the  Tektronix  4014
	      terminal.  Prints only the line speed and a trailing semicolon (;).  Prints only the terminal size.

       If no options are specified, an unspecified subset of the information displayed for the -a option is displayed.

       If the terminal input speed and output speed are the same, the speed information is displayed as follows: speed	speed  baud

       Otherwise, speeds are displayed as follows: ispeed  ispeed  baud; ospeed  ospeed  baud;

       Control-characters are displayed as follows: control-character = value

       In  this  display,  value is either the character, some visual representation of the character if it is nonprinting, or the string undef if
       the character is disabled.

EXIT STATUS

       The stty utility exits with one of the following values: The terminal options were read or set successfully.  An error occurred.

ENVIRONMENT VARIABLES

       The following environment variables affect the execution of stty: Provides a default value for the internationalization variables that  are
       unset  or null. If LANG is unset or null, the corresponding value from the default locale is used. If any of the internationalization vari-
       ables contain an invalid setting, the utility behaves as if none of the variables had been defined.  If set to a  non-empty  string  value,
       overrides  the  values of all the other internationalization variables.	Determines the locale for the interpretation of sequences of bytes
       of text data as characters (for example, single-byte as opposed to multibyte characters in arguments).  Determines the locale for the  for-
       mat  and  contents  of  diagnostic messages written to standard error.  Determines the location of message catalogues for the processing of
       LC_MESSAGES.

SEE ALSO

       Commands:  tty(1)

       Functions:  ioctl(2)

       Routines:  curses(3), tcgetattr(3), tcsetattr(3), ttyname(3)

       Files:  termios(4), atty(7), tty(7), ttty(7)

       Standards:  standards(5)

       Others:	Chinese(5), i18n_intro(5), iconv_intro(5), Japanese(5), Korean(5), Thai(5)

																	   stty(1)