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

FreeBSD Manual Pages


home | help
stty(1)								       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 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

       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

       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

       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

       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
				characters INTR	and QUIT.

       Enable (disable)	canonical input	(ERASE and KILL	processing).

       Enable  (disable)  any  implementation-defined  special	control
				not  currently	controlled  by	icanon,
				isig, or ixon.

       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	^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

   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

       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 con-
				trol-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   corresponding  control  character
				(for example,  represents  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  fea-
				ture  is  available  only  on  specific

   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 System V Interface Definition,  Third
       Edition	(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 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  con-
       trol  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, and the changes will not
       become effective	for a particular port until it	is  (re)opened.
       The  default control 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
       defaults.  Control character values should be tested with appli-
       cations 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 vari-
       ables 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
       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.

       Refer  to  the  DEPENDENCIES  section of	termio(7) for a	further
       description 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