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

FreeBSD Manual Pages

  
 
  

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

NAME
       stty - set the options for a terminal port

SYNOPSIS
       | options]

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

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

	      Set terminal I/O options as defined by
				  options.

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

       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
				termio(7)).

       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
				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 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
				termio(7)).

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

       Use fill	characters (use	timing)	for delays.

       Fill characters are DELs	( NULs).

       Select style of delay for carriage returns (see
				termio(7)).

       Select style of delay for newline characters (see
				termio(7)).

       Select style of delay for horizontal tabs (see
				termio(7).

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

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

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

   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
				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.	However, it  does  not
				keep  track  of	 column	 position  and,	 as  a
				result,	may not	correctly erase	escaped	 char-
				acters,	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
				termiox(7))

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

   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),
       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 control 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 applications
       before assigning	them as	a default value.

EXTERNAL INFLUENCES
   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.

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

WARNINGS
       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  unreliable  results  in
       the future and is therefore discouraged.

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

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

STANDARDS CONFORMANCE
								       stty(1)

NAME | SYNOPSIS | DESCRIPTION | EXTERNAL INFLUENCES | EXAMPLES | WARNINGS | DEPENDENCIES | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=stty&sektion=1&manpath=HP-UX+11.22>

home | help