unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



stty(1)								      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 indus-
  try standards	and associated tags.

OPTIONS

  -a  Writes to	standard output	all the	current	settings for the terminal.

  -f special-device
      [Tru64 UNIX]  Allows you to specify an alternate terminal	or teletype
      device.  Normally, the stty command works	on standard input.

  -g  Writes to	standard output	the current settings in	an unspecified form
      that can be used as arguments to another stty utility on the same	sys-
      tem.

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 cer-
  tain characteristics,	usually	those that differ from implementation-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:

  parenb (-parenb)
      Enables (disables) parity	generation and detection.

  parodd (-parodd)
      Selects odd (even) parity.

  cs5 cs6 cs7 cs8
      Selects character	size, if possible.

  number
      Sets terminal baud rate to the number given, if possible.	 If the	baud
      rate is set to zero, modem control is no longer asserted.

  ispeed number
      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.

  ospeed number
      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.

  hupcl	(-hupcl)
      Stops asserting modem control (does not stop asserting modem control)
      on last close.

  hup (-hup)
      Same as hupcl (-hupcl).

  cstopb (-cstopb)
      Uses two (one) stop bits per character.

  cread	(-cread)
      Enables (disables) the receiver.

  clocal (-clocal)
      Assumes a	line without (with) modem control.

  crtscts (-crtscts)
      [Tru64 UNIX]  Enables (disables) hardware	flow control using the
      Request to Send (RTS) and	Clear to Send (CTS) signals.

  nokerninfo (-nokerninfo)
      [Tru64 UNIX]  Disables (enables) the printing of kernel-generated
      status information when the info control character is entered.









  Input	Modes


  echoctl (-echoctl)
      [Tru64 UNIX]  Echoes control characters as ^X and	<&lt;Delete>&gt; as ^?.
      Prints two backspaces following the End-of-File character.  (Special
      characters are echoed as themselves.)

  ignbrk (-ignbrk)
      Ignores (does not	ignore)	break on input.

  brkint (-brkint)
      Signals (does not	signal)	INTR on	break.

  ignpar (-ignpar)
      Ignores (does not	ignore)	parity errors.

  parmrk (-parmrk)
      Marks (does not mark) parity errors.

  inpck	(-inpck)
      Enables (disables) input parity checking.

  istrip (-istrip)
      Strips (does not strip) input characters to seven	bits.

  inlcr	(-inlcr)
      Maps (does not map) newline to carriage-return on	input.

  igncr	(-igncr)
      Ignores (does not	ignore)	carriage-return	on input.

  icrnl	(-icrnl)
      Maps (does not map) carriage-return to newline on	input.

  imaxbel (-imaxbel)
      [Tru64 UNIX]  Does (does not) ring bell on terminal when input buffer
      is full.

  iuclc	(-iuclc)
      Maps (does not map) uppercase alphabetic characters to lowercase.

  ixon (-ixon)
      Enables (disables) Start/Stop output control.  Output from the system
      is stopped when the system receives Stop and started when	the system
      receives Start.

  ixany	(-ixany)
      Allows any character (allows only	<&lt;Ctrl-q>&gt;) to restart output.

  ixoff	(-ixoff)
      Requests that the	system send (not send) Start/Stop characters when the
      input queue is nearly empty/full.

  Output Modes


  opost	(-opost)
      Post-processes output (does not post-process output; ignores all other
      output modes).

  olcuc	(-olcuc)
      Maps (does not map) lowercase alphabetic characters to uppercase on
      output.

  onoeot (-onoeot)
      [Tru64 UNIX]  Discards (keeps) End-of-Text on output.

  onlcr	(-onlcr)
      [Tru64 UNIX]  Maps (does not map)	newline	characters to carriage-
      return/newline characters.

  ocrnl	(-ocrnl)
      Maps (does not map) carriage-return/newline characters to	newline	char-
      acters.

  onocr	(-onocr)
      Does not (does) output carriage-return characters	at column 0 (zero).

  onlret (-onlret)
      Causes (does not cause) newline to perform the carriage-return function
      on the terminal.

  ofill	(-ofill)
      Uses fill	characters (uses timing) for delays.

  ofdel	(-ofdel)
      Uses Delete (uses	Null) characters for fill characters.

  tabs (-tabs)
      [Tru64 UNIX]  Maintains (expands to spaces) any tab characters in	the
      output.

  cr0 cr1 cr2 cr3
      Selects style of delay for carriage-return characters.

  nl0 nl1 nl2 nl32
      Selects style of delay for newline characters.

  tab0 tab1 tab2 tab3
      Selects style of delay for horizontal tabs.

  bs0 bs1
      Selects style of delay for backspaces.

  ff0 ff1
      Selects style of delay for form feeds.

  vt0 vt1
      Selects style of delay for vertical tabs.

  rows number
      [Tru64 UNIX]  Specifies the number of lines this display can hold.

  columns number (or cols number)
      [Tru64 UNIX]  Specifies the number of characters per display line.

  Local	Modes


  altwerase (-altwerase)
      [Tru64 UNIX]  Uses (does not use)	the altwerase mode, which defines a
      word as containing only alphanumeric characters and _ (underscore).

  isig (-isig)
      Enables (disables) the checking of characters against the	special	con-
      trol characters INTR, QUIT, and SUSP.

  icanon (-icanon)
      Enables (disables) canonical input (Erase	and Kill processing).

  crtkill (-crtkill)
      [Tru64 UNIX]  Echoes (does not echo) the Kill character by erasing the
      line in place like echoe.

  mdmbuf (-mdmbuf)
      [Tru64 UNIX]  Uses (does not use)	carrier	as a flow control flag rather
      than sending a HANGUP signal.

  prterase (-prterase)
      [Tru64 UNIX]  Prints (does not print) erased characters backwards
      within \ (backslash) and / (slash).

  tostop (-tostop)
      Stops (allows) output from background jobs to the	terminal.

  xcase	(-xcase)
      [Tru64 UNIX]  Echoes (does not echo) uppercase characters	on input, and
      displays uppercase characters on output with a preceding \ (backslash).

  iexten (-iexten)
      Enables (disables) any implementation-defined special control-
      characters not currently controlled by icanon, isig, or ixon.

  echo (-echo)
      Echoes back (does	not echo back) every character typed.

  echoe	(-echoe)
      Causes the Erase character to (to	not) visually erase the	last charac-
      ter in the current line from the display,	if possible.

  echok	(-echok)
      Echoes (does not echo) newline after the Kill character.

  echonl (-echonl)
      Echoes (does not echo) newline, even if echo is disabled.

  noflsh (-noflsh)
      Disables (enables) flush after INTR, QUIT, SUSP.

  Control Assignments


  special-character string
      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 <&lt;Delete>&gt;.

	+  Any other string beginning with the character ^ sets	the special
	   character to	the control 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
	   entering ^ and another character.  This allows you to enter a con-
	   trol	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	char-
	   acter, 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.

  saved	settings
      Sets the current terminal	characteristics	to the saved settings
      produced by the -g option.

  min number

  time number
      Sets the value of	min or time to number.	MIN and	TIME are used in
      Non-Canonical mode input processing (-icanon).

  line number
      Sets the line discipline to the specified	number.

  Combination Modes


  evenp	or parity
      Enables parenb and cs7; disables parodd.

  oddp
      Enables parenb, cs7, and parodd.

  parity, evenp, oddp
      Disables parenb, and sets	cs8.

  raw (-raw | cooked)
      Enables (disables) raw input and output (no ERASE, KILL, INTR, QUIT,
      EOT, or output processing).

  nl (-nl)
      Enables (disables) icrnl and onlcr.  The -nl mode	also unsets inlcr,
      igncr ocrnl, and onlret.

  lcase	(-lcase)

  LCASE	(-LCASE)
      Sets (unsets) xcase, iuclc, and olcuc.  (Used for	terminals with upper-
      case characters only.)

  sane
      Resets all modes to some reasonable values.

  Asian	Line Discipline	Setup (I18N)


  adec
      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.

  jdec
      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 applica-
      tion 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)


  acode	codeset
      Sets the application code	to codeset.

  tcode	codeset
      Sets the terminal	code to	codeset.

  code codeset
      Sets both	the terminal code and the application code to codeset.

  conv (-conv)
      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 modifi-
      cation of	data passing through the terminal lines.  One such cir-
      cumstance	would be running an 8-bit binary file transfer protocol, such
      as kermit	and sz (zmodem).

  Japanese Input Modes (I18N)


  imode	mode
      Sets the input mode for 8-bit code or Hankaku Kana code from the termi-
      nal.  The	following keywords can be used for the mode argument:

      kanji
	  The 8-bit code from the terminal is treated as a part	of the Kanji
	  code when the	terminal code is set to	dec.

      hiragana
	  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.

      katakana
	  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.

      hankaku
	  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.

  ikk (-ikk)
      Enables (disables) the Japanese input method.  The Kana-Kanji conver-
      sion daemon, kkcd, is spawned (ikk) or killed (-ikk).  The kkseq key
      map information is derived from the following (in	priority order):

       1.  The file specified by the JSYKKSEQ environment variable

       2.  The ~/.jsykkseq file

      Dictionary names are derived from	the following (in priority order):

       1.  The files specified by the JSYTANGO,	JSYKOJIN, and JSYLEARN
	   environment variables

       2.  The /usr/i18n/jsy/jsytango.dic, ~/jsykojin.dic, and ~/.jsylearn
	   files.

  jinkey char-sequence
      Sets the character or sequence of	characters that	enters Kana-Kanji
      conversion mode when using the STREAMS terminal driver.

  kin esc-seq
      Sets the JIS Kanji shift-in escape sequence for the JIS terminal.

  kout esc-seq
      Sets the JIS Kanji shift-out escape sequence for the JIS terminal.

  clause mode
      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".

  henkan mode
      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".

  kkseq	file
      Sets the Kana-Kanji conversion key map file for the terminal.

  kkmap
      Displays the current Kana-Kanji conversion key map, a traversal tree
      with a maximum sequence length of	15 characters.

  knj.bs1 (-knj.bs1)
      Uses one (uses two) backspaces to	erase one Kanji	character on the ter-
      minal.

  knj.sp (-knj.sp)
      Uses (does not use) a single 2-byte zenkaku space	(two ASCII spaces) to
      blank out	one Kanji character on the terminal.

  esc.alw (-esc.alw)
      If terminal code is either jis7 or jis8, changes (does not change) the
      terminal state to	shift out whenever a newline code is output.

  jx char (-jx)
      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)


  odl (-odl)
      Enables (disables) the Software On-Demand	Loading	(SoftODL) service.

  odlsize size
      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.

  odltype type
      Sets the type of the ODL buffer replacement strategy.  The type argu-
      ments can	be either fifo (First-In-First-Out) or lru (Least-Recently-
      Used).

  odldb	path
      Sets the path to the ODL database	files.	If this	path is	not speci-
      fied, 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.

  odlreset
      Resets the ODL service and clears	the internal ODL buffers.

  odlall
      Displays the current ODL service attributes.

  Modes	for the	Software Phrase	Input Method (I18N)


  sim (-sim)
      Enables (disables) the Software Phrase Input Method (SIM)	service.

  simkey key
      Specifies	the key	that toggles in	and out	of phrase input	mode.

  simclass class
      Sets the current class name for locating the appropriate phrase in the
      phrase database.

  simdb	path
      Sets the path of the phrase database.

  simmode dmode
      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 displayed at the 26th line	of your	terminal, if sup-
      ported.  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.

  simall
      Displays the current SIM service attributes.

  Miscellaneous	Asian Terminal Modes (I18N)


  history key (-history)
      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 characters long are not recorded in the
      history list.

  Thai Terminal	Modes (I18N)


  tdec
      Sets the current line discipline to Thai.

  isc mode
      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.

  reorder (-reorder)
      Enables or disables input	reordering.

  thistory key (-thistory)
      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 characters long are not recorded in the
      history list.




  Compatibility	Modes


  ek  Resets Erase and Kill characters back to the system defaults.

  lfkc (-lfkc)
      Same as echok.

  flow (-flow)
      Same as ixon (-ixon).

  tandem (-tandem)
      Same as ixoff (-ixoff).

  decctlq (-decctlq)
      Same as ixany (-ixany).

  dec 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 dis-
      cipline.

  crterase (-crterase)

  crtbs	(-crtbs)
      Same as echoe (-echoe).

  ctlecho (-ctlecho)
      Same as echoctl (-echoctl).

  crt (-crt)

  newcrt (-newcrt)
      Sets (clears) echoe, echoke, and echoctl.

  litout (-litout)
      Sends output characters with no (with) output processing.

  xtabs	(-xtabs)

  oxtabs (-oxtabs)
      Expands (does not	expand)	tabs to	spaces.

  fill (-fill)
      Same as ofill (-ofill).

  all

  everything
      Same as -a.

  echoke (-echoke)

  nohang (-nohang)
      Does not (does) send HANGUP signal if carrier drops.

  nul-fill
      Does character fill and uses Null	character.

  del-fill
      Does character fill and uses Delete character.

  tty33
      Sets modes suitable for the Teletype Corporation Model 33	terminal.

  tty37
      Sets modes suitable for the Teletype Corporation Model 37	terminal.

  vt05
      Sets modes suitable for the Digital Equipment Corporation	Model VT05
      terminal.

  tn300
      Sets modes suitable for the General Electric TermiNet 300.

  ti700
      Sets modes suitable for the Texas	Instruments 700	series.

  tek Sets modes suitable for the Tektronix 4014 terminal.

  speed
      Prints only the line speed and a trailing	semicolon (;).

  size
      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 infor-
  mation 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:

  0   The terminal options were	read or	set successfully.

  >&gt;0  An error occurred.

ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of stty:

  LANG
      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
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  NLSPATH
      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)