👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for stty (opensolaris section 1)

stty(1) 				  User Commands 				  stty(1)

NAME
       stty - set the options for a terminal

SYNOPSIS
       /usr/bin/stty [-a] [-g]

       /usr/bin/stty [modes]

       /usr/xpg4/bin/stty [-a | -g]

       /usr/xpg4/bin/stty [modes]

       /usr/xpg6/bin/stty [-a | -g]

       /usr/xpg6/bin/stty [modes]

DESCRIPTION
       The  stty  utility  sets  certain  terminal I/O options for the device that is the current
       standard input. Without arguments, stty reports the settings of certain options.

       In this report, if a character is preceded by a caret (^), then the value of  that  option
       is  the	corresponding  control character (for example, ^h is CTRL-h. In this case, recall
       that CTRL-h is the same as the BACKSPACE key). The sequence ^@ means that an option has	a
       null value.

       See  termio(7I) for detailed information about the modes listed from Control Modes through
       Local Modes. For detailed information about the modes listed under Hardware  Flow  Control
       Modes and Clock Modes, see termiox(7I).

       Operands  described  in the Combination Modes section are implemented using options in the
       earlier sections. Notice that many combinations of options make no sense,  but  no  sanity
       checking  is  performed.  Hardware  flow control and clock modes options might not be sup-
       ported by all hardware interfaces.

OPTIONS
       The following options are supported:

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

       -g     Reports current settings in a form that can be used as an argument to another  stty
	      command. Emits termios-type output if the underlying driver supports it. Otherwise,
	      it emits termio-type output.

OPERANDS
       The following mode operands are supported:

   Control Modes
       parenb(-parenb)		Enable (disable) parity generation and detection.

       parext(-parext)		Enable (disable) extended parity  generation  and  detection  for
				mark and space parity.

       parodd(-parodd)		Select	odd  (even)  parity,  or mark (space) parity if parext is
				enabled.

       cs5 cs6 cs7 cs8		Select character size (see termio(7I)).

       0			Hang up line immediately.

       hupcl (-hupcl)		Hang up (do not hang up) connection on last close.

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

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

       cread (-cread)		Enable (disable) the receiver.

       crtscts (-crtscts)	Enable output hardware flow control. Raise the	RTS  (Request  to
				Send) modem control line. Suspends output until the CTS (Clear to
				Send) line is raised.

       crtsxoff (-crtsxoff)	Enable input hardware flow control. Raise  the	RTS  (Request  to
				Send) modem control line to receive data. Suspends input when RTS
				is low.

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

       defeucw			Set the widths of multibyte characters to the values  defined  in
				the  current  locale  specified by LC_CTYPE. Internally, width is
				expressed in terms of bytes per character, and screen or  display
				columns per character.

       110 300 600 1200 1800
       2400 4800 9600 19200
       38400 357600 76800 115200
       153600 230400 307200 460800

	   Set terminal baud rate to the number given, if possible. (All speeds are not supported
	   by all hardware interfaces.)

       ispeed 0 110 300 600 1200
       1800 2400 4800 9600 19200
       38400 57600 76800 115200
       153600 230400 307200 460800

	   Set terminal input baud rate to the number given, if possible. (Not all hardware  sup-
	   ports  split  baud  rates.) If the input baud rate is set to 0, the input baud rate is
	   specified by the value of the output baud rate.

       ospeed 0 110 300 600 1200
       1800 2400 4800 9600 19200
       38400 57600 76800 115200
       153600 230400 307200 460800

	   Set terminal output baud rate to the number given, if possible. (Not all hardware sup-
	   ports  split  baud  rates.)	If  the output baud rate is set to 0, the line is hung up
	   immediately.

   Input Modes
       ignbrk (-ignbrk)       Ignore (do not ignore) break on input.

       brkint (-brkint)       Signal (do not signal) INTR on break.

       ignpar (-ignpar)       Ignore (do not ignore) parity errors.

       parmrk (-parmrk)       Mark (do not mark) parity errors (see termio(7I)).

       inpck (-inpck)	      Enable (disable) input parity checking.

       istrip (-istrip)       Strip (do not strip) input characters to seven bits.

       inlcr (-inlcr)	      Map (do not map) NL to CR on input.

       igncr (-igncr)	      Ignore (do not ignore) CR on input.

       icrnl (-icrnl)	      Map (do not map) CR to NL on input.

       iuclc (-iuclc)	      Map (do not map) upper-case alphabetics to lower case on input.

       ixon (-ixon)	      Enable (disable) START/STOP output control. Output  is  stopped  by
			      sending  STOP  control  character  and started by sending the START
			      control character.

       ixany (-ixany)	      Allow any character (only DC1) to restart output.

       ixoff (-ixoff)	      Request that the system send (not send) START/STOP characters  when
			      the input queue is nearly empty/full.

       imaxbel (-imaxbel)     Echo  (do not echo) BEL when the input line is too long. If imaxbel
			      is set, the ASCII BEL character (07 hex) is  echoed  if  the  input
			      stream  overflows.  Further  input  is   not  stored, but any input
			      already present is not disturbed. If -imaxbel is set, no BEL  char-
			      acter is echoed, and all unread input present in the input queue is
			      discarded if the input stream overflows.

   Output Modes
       opost (-opost)	      Post-process output (do not post-process output; ignore  all  other
			      output modes).

       olcuc (-olcuc)	      Map (do not map) lower-case alphabetics to upper case on output.

       onlcr (-onlcr)	      Map (do not map) NL to CR-NL on output.

       ocrnl (-ocrnl)	      Map (do not map) CR to NL on output.

       onocr (-onocr)	      Do not (do) output CRs at column zero.

       onlret (-onlret)       On the terminal NL performs (does not perform) the CR function.

       ofill (-ofill)	      Use fill characters (use timing) for delays.

       ofdel (-ofdel)	      Fill characters are DELs (NULs).

       cr0 cr1 cr2 cr3	      Select style of delay for carriage returns (see termio(7I)).

       nl0 nl1		      Select style of delay for line-feeds (see termio(7I)).

       tab0 tab1 tab2 tab3    Select style of delay for horizontal tabs (see termio(7I)).

       bs0 bs1		      Select style of delay for backspaces (see termio(7I)).

       ff0 ff1		      Select style of delay for form-feeds (see termio(7I)).

       vt0 vt1		      Select style of delay for vertical tabs (see termio(7I)).

   Local Modes
       isig(-isig)	      Enable  (disable)  the  checking	of characters against the special
			      control characters INTR, QUIT, SWTCH, and SUSP. For information  on
			      SWTCH, see NOTES.

       icanon (-icanon)       Enable  (disable) canonical input (ERASE and KILL processing). Does
			      not set MIN or TIME.

       xcase (-xcase)	      Canonical (unprocessed) upper/lower-case presentation.

       echo (-echo)	      Echo back (do not echo back) every character typed.

       echoe (-echoe)	      Echo (do not echo) ERASE character as  a	backspace-space-backspace
			      string.  This  mode erases the ERASEed character on many CRT termi-
			      nals; however, it does not keep track of column position and, as	a
			      result,  it  might  be  confusing for escaped characters, tabs, and
			      backspaces.

       echok(-echok)	      Echo (do not echo) NL after KILL character.

       lfkc (-lfkc)	      The same as echok(-echok); obsolete.

       echonl (-echonl)       Echo (do not echo) NL.

       noflsh (-noflsh)       Disable (enable) flush after INTR, QUIT, or SUSP.

       stwrap (-stwrap)       Disable (enable) truncation of lines longer than 79 characters on a
			      synchronous line.

       tostop (-tostop)       Send  (do  not send) SIGTTOU when background processes write to the
			      terminal.

       echoctl (-echoctl)     Echo (do not echo) control characters as ^char, delete as ^?.

       echoprt (-echoprt)     Echo (do not echo) erase character as character is ``erased''.

       echoke (-echoke)       BS-SP-BS erase (do not BS-SP-BS erase) entire line on line kill.

       flusho (-flusho)       Output is (is not) being flushed.

       pendin (-pendin)       Retype (do not retype) pending input at next read or input  charac-
			      ter.

       iexten (-iexten)       Enable  (disable)  special  control  characters  not currently con-
			      trolled by icanon, isig, ixon, or ixoff:	VEOL,  VSWTCH,	VREPRINT,
			      VDISCARD, VDSUSP, VWERASE, and VLNEXT.

       stflush (-stflush)     Enable (disable) flush on a synchronous line after every write(2).

       stappl (-stappl)       Use application mode (use line mode) on a synchronous line.

   Hardware Flow Control Modes
       rtsxoff (-rtsxoff)     Enable (disable) RTS hardware flow control on input.

       ctsxon (-ctsxon)       Enable (disable) CTS hardware flow control on output.

       dtrxoff (-dtrxoff)     Enable (disable) DTR hardware flow control on input.

       cdxon (-cdxon)	      Enable (disable) CD hardware flow control on output.

       isxoff (-isxoff)       Enable (disable) isochronous hardware flow control on input.

   Clock Modes
       xcibrg	    Get transmit clock from internal baud rate generator.

       xctset	    Get  the  transmit	clock from transmitter signal element timing (DCE source)
		    lead, CCITT V.24 circuit 114, EIA-232-D pin 15.

       xcrset	    Get transmit clock from receiver signal element  timing  (DCE  source)  lead,
		    CCITT V.24 circuit 115, EIA-232-D pin 17.

       rcibrg	    Get receive clock from internal baud rate generator.

       rctset	    Get  receive  clock from transmitter signal element timing (DCE source) lead,
		    CCITT V.24 circuit 114, EIA-232-D pin 15.

       rcrset	    Get receive clock from receiver signal  element  timing  (DCE  source)  lead,
		    CCITT V.24 circuit 115, EIA-232-D pin 17.

       tsetcoff     Transmitter signal element timing clock not provided.

       tsetcrbrg    Output  receive baud rate generator on transmitter signal element timing (DTE
		    source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.

       tsetctbrg    Output transmit baud rate generator on transmitter signal element timing (DTE
		    source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.

       tsetctset    Output  transmitter  signal element timing (DCE source) on transmitter signal
		    element timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.

       tsetcrset    Output receiver signal element timing (DCE source) on transmitter signal ele-
		    ment timing (DTE source) lead, CCITT V.24 circuit 113, EIA-232-D pin 24.

       rsetcoff     Receiver signal element timing clock not provided.

       rsetcrbrg    Output  receive  baud  rate  generator on receiver signal element timing (DTE
		    source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.

       rsetctbrg    Output transmit baud rate generator on receiver signal  element  timing  (DTE
		    source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.

       rsetctset    Output transmitter signal element timing (DCE source) on receiver signal ele-
		    ment timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.

       rsetcrset    Output receiver signal element timing (DCE source) on receiver signal element
		    timing (DTE source) lead, CCITT V.24 circuit 128, no EIA-232-D pin.

   Control Assignments
       control-character c     Set control-character to c, where:

			       control-character     is  ctab,	discard,  dsusp,  eof, eol, eol2,
						     erase, intr,  kill,  lnext,  quit,  reprint,
						     start, stop, susp, swtch, or werase (ctab is
						     used  with  -stappl,  see	termio(7I)).  For
						     information on swtch, see NOTES.

			       c		     If  c  is	a  single  character, the control
						     character is set to that character.

						     In the POSIX locale, if c is preceded  by	a
						     caret  (^)  indicating  an  escape  from the
						     shell and is one of those listed in  the  ^c
						     column  of  the  following  table,  then its
						     value used (in the Value column) is the cor-
						     responding  control  character (for example,
						     ``^d'' is a CTRL-d). ``^?''  is  interpreted
						     as  DEL  and  ``^-'' is interpreted as unde-
						     fined.

       +-----------------------------------------------------------------------+
       |   ^c	      Value	   ^c	      Value	    ^c	       Value   |
       |a, A	    <SOH>	l, L	    <FF>	 w, W	     <ETB>     |
       |b, B	    <STX>	m, M	    <CR>	 x, X	     <CAN>     |
       |c, C	    <ETX>	n, N	    <SO>	 y, Y	     <EM>      |
       |d, D	    <EOT>	o, O	    <SI>	 z, Z	     <SUB>     |
       |e, E	    <ENQ>	p, P	    <DLE>	 [	     <ESC>     |
       |f, F	    <ACK>	q, Q	    <DC1>	 \	     <FS>      |
       |g, G	    <BEL>	r, R	    <DC2>	 ]	     <GS>      |
       |h, H	    <BS>	s, S	    <DC3>	 ^	     <RS>      |
       |i, I	    <HT>	t, T	    <DC4>	 _	     <US>      |
       |j, J	    <LF>	u, U	    <NAK>	 ?	     <DEL>     |
       |k, K	    <VT>	v, V	    <SYN>			       |
       +-----------------------------------------------------------------------+

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

       line i	       Set line discipline to i ( 0< i <127).

   Combination Modes
       saved settings	       Set  the  current  terminal  characteristics to the saved settings
			       produced by the -g option.

       evenp or parity	       Enable parenb and cs7, or disable parodd.

       oddp		       Enable parenb, cs7, and parodd.

       spacep		       Enable parenb, cs7, and parext.

       markp		       Enable parenb, cs7, parodd, and parext.

       -parity, or -evenp      Disable parenb, and set cs8.

       -oddp		       Disable parenb and parodd, and set cs8.

       -spacep		       Disable parenb and parext, and set cs8.

       -markp		       Disable parenb, parodd, and parext, and set cs8.

       raw (-raw or cooked)    Enable (disable) raw input and output. Raw mode is  equivalent  to
			       setting:

				 stty cs8 -icanon min 1 time 0 -isig -xcase \
				     -inpck -opost

   /usr/bin/stty, /usr/xpg6/bin/stty
       nl (-nl)    Unset (set) icrnl, onlcr. In addition -nl unsets inlcr, igncr, ocrnl, and onl-
		   ret.

   /usr/xpg4/bin/stty
       nl (-nl) 	       Set (unset) icrnl. In addition, -nl unsets  inlcr,  igncr,  ocrnl,
			       and onlret; -nl sets onlcr, and nl unsets onlcr.

       lcase (-lcase)	       Set (unset) xcase, iuclc, and olcuc.

       LCASE (-LCASE)	       Same as lcase (-lcase).

       tabs (-tabs or tab3)    Preserve (expand to spaces) tabs when printing.

       ek		       Reset  ERASE  and  KILL	characters back to normal DEL and CTRL-u,
			       respectively.

       sane		       Reset all modes to some reasonable values.

       term		       Set all modes suitable for the terminal type term, where  term  is
			       one of tty33, tty37, vt05, tn300, ti700, or tek.

       async		       Set  normal  asynchronous  communications where clock settings are
			       xcibrg, rcibrg, tsetcoff and rsetcoff.

   Window Size
       rows n	    Set window size to n rows.

       columns n    Set window size to n columns.

       cols n	    Set window size to n columns. cols is a shorthand alias for columns.

       ypixels n    Set vertical window size to n pixels.

       xpixels n    Set horizontal window size to n pixels.

USAGE
       The -g flag is designed to facilitate the saving and restoring of terminal state from  the
       shell level. For example, a program can:

	 saveterm="$(stty -g)"	    # save terminal state
	 stty (new settings)	    # set new state
	 ...			    # ...
	 stty $saveterm 	    # restore terminal state

       Since  the  -a format is so loosely specified, scripts that save and restore terminal set-
       tings should use the -g option.

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following environment  variables	that  affect  the
       execution of stty: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0      Successful completion.

       >0     An error occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

   /usr/bin/stty
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

   /usr/xpg4/bin/stty
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWxcu4			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

   /usr/xpg6/bin/stty
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWxcu6			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       tabs(1),   ioctl(2),  write(2),	getwidth(3C),  attributes(5),  environ(5),  standards(5),
       ldterm(7M), termio(7I), termiox(7I)

NOTES
       Solaris does not support any of the actions implied by swtch, which was used  by  the  sxt
       driver  on System V release 4. Solaris allows the swtch value to be set, and prints it out
       if set, but it does not perform the swtch action.

       The job switch functionality on Solaris is actually handled by job control.  susp  is  the
       correct setting for this.

SunOS 5.11				   14 Feb 2005					  stty(1)


All times are GMT -4. The time now is 05:09 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password