Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
stty(1)			    General Commands Manual		       stty(1)

       stty - set the options for a terminal port

       | options]

       sets  or	 reports  current settings of certain terminal I/O options for
       the device that is the current standard input.  The command takes  four

	      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

	      Set terminal I/O options as defined by

       For detailed information	about the  modes  listed  below	 from  Control
       Modes  through  Local  Modes  as	they relate to asynchronous lines, see
       termio(7).  For detailed	information about the modes listed under Hard-
       ware Flow Control Modes below, see termiox(7).

       Options in the Combination Modes	group are implemented using options in
       the previous groups.  Note that many combinations of  options  make  no
       sense, but no sanity checking is	performed.

       options are selected from the following:

   Control Modes
       Set the terminal	window row size	equal to

       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

       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

       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

       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

       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

       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

       Select style of delay for newline characters (see

       Select style of delay for horizontal tabs (see

       Select style of delay for backspaces (see

       Select style of delay for form-feeds (see

       Select style of delay for vertical tabs (see

   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 icanon, isig, 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
				Note:  this  mode erases the ERASEed character
				on many	CRT terminals.	However, it  does  not
				keep  track  of	 column	position and, as a re-
				sult, may not correctly	erase escaped  charac-
				ters, 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	^char,
				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 sup-
       port hardware flow control through the termiox interface.  If the func-
       tionality is supported, this interface must be used.

       enable (disable)	RTS hardware flow control on input (see

       enable (disable)	CTS hardware flow control on output (see

   Control Assignments
       control-character c	Set  control-character	to  c,	where control-
				character is and are used with see termio(7)).
				For  systems  that  support  job  control, and
				characters can also be set.  For systems  that
				support	 shell layers (see shl(1)) can also be
				set.  If c is preceded by an (escaped from the
				shell) circumflex the value used is the	corre-
				sponding control character (for	example,  rep-
				resents	 Ctrl-d); is interpreted as DEL	and is
				interpreted as undefined.

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

       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 spec-
       ified by	the System V Interface Definition, Third Edition (SVID3),  ex-
       cept  for  the and control characters, which are	set to to maintain bi-
       nary compatibility with previous	releases of HP-UX.

       The default values for the control characters may be changed by a  user
       with  root  capability by using and redirecting stdin to	the device Any
       of the four command forms specified in the  Description	section	 above
       may  be used.  However, only the	control	character defaults will	be re-
       ported 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, and the changes will not become  ef-
       fective for a particular	port until it is (re)opened.  The default con-
       trol 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  de-
       faults.	 Control  character  values should be tested with applications
       before assigning	them as	a default value.

   Environment Variables
       LC_CTYPE	determines the valid control characters	for printing.

       If LC_CTYPE is not specified in the environment or is set to the	 empty
       string,	the value of LANG is used as a default for each	unspecified or
       empty variable.	If LANG	is not	specified  or  is  set	to  the	 empty
       string, a default of "C"	(see lang(5)) is used instead of LANG.	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.

       The command:

       sets  the delete-line character to (Ctrl-X) and the interrupt character
       to This command is usually found	in the or file so that and need	not be
       set by the user at each login session.

       The command:

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

       Use of mode produces certain side effects which have  varied  from  re-
       lease  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.

       Refer  to  the DEPENDENCIES section of termio(7)	for a further descrip-
       tion of capabilities that are not supported.

       shl(1), tabs(1),	ioctl(2), termio(7), termiox(7).



Want to link to this manual page? Use this URL:

home | help