


STTY(1L)                                                 STTY(1L)


NNAAMMEE
       stty - change and print terminal line settings

SSYYNNOOPPSSIISS
       ssttttyy [-ag] [--all] [--save] [setting...]

DDEESSCCRRIIPPTTIIOONN
       This  manual  page  documents the GNU version of ssttttyy.  If
       given no arguments, ssttttyy prints the baud rate, line disci-
       pline  number  (on systems that support it), and line set-
       tings that have been changed from the values set by  `stty
       sane'.   Mode reading and setting are performed on the tty
       line connected to the standard input.

       ssttttyy  accepts  the  following  non-option  arguments  that
       change  aspects  of  the terminal line operation.  A `[-]'
       before a capability means that it can  be  turned  off  by
       preceding it with a `-'.  Some arguments are not available
       on all systems, since they are non-POSIX extensions.

       Control settings:


       [-]parenb
              Generate parity bit in output and expect parity bit
              in input.

       [-]parodd
              Set odd parity (even with `-').

       cs5 cs6 cs7 cs8
              Set character size to 5, 6, 7, or 8 bits.

       [-]hupcl [-]hup
              Send  a  hangup signal when the last process closes
              the tty.

       [-]cstopb
              Use two stop bits per character (one with `-').

       [-]cread
              Allow input to be received.

       [-]clocal
              Disable modem control signals.

       [-]crtscts
              Enable RTS/CTS handshaking.

       Input settings:


       [-]ignbrk
              Ignore breaks.



                                                                1





STTY(1L)                                                 STTY(1L)


       [-]brkint
              Breaks cause an interrupt signal.

       [-]ignpar
              Ignore parity errors.

       [-]parmrk
              Mark  parity   errors   (with   a   255-0-character
              sequence).

       [-]inpck
              Enable input parity checking.

       [-]istrip
              Clear high (8th) bit of input characters.

       [-]inlcr
              Translate newline to carriage return.

       [-]igncr
              Ignore carriage return.

       [-]icrnl
              Translate carriage return to newline.

       [-]ixon
              Enable XON/XOFF flow control.

       [-]ixoff [-]tandem
              Enable  sending  of  stop character when the system
              input buffer is almost full,  and  start  character
              when it becomes almost empty again.

       [-]iuclc
              Translate uppercase characters to lowercase.

       [-]ixany
              Allow  any  character  to  restart output (only the
              start character with `-').

       [-]imaxbel
              Enable beeping and not flushing input buffer  if  a
              character arrives when the input buffer is full.

       Output settings:


       [-]opost
              Postprocess output.

       [-]olcuc
              Translate lowercase characters to uppercase.





                                                                2





STTY(1L)                                                 STTY(1L)


       [-]ocrnl
              Translate carriage return to newline.

       [-]onlcr
              Translate newline to carriage return-newline.

       [-]onocr
              Do  not print carriage returns in the first column.

       [-]onlret
              Newline performs a carriage return.

       [-]ofill
              Use fill (padding) characters instead of timing for
              delays.

       [-]ofdel
              Use  delete  characters  for  fill  instead of null
              characters.

       nl1 nl0
              Newline delay style.

       cr3 cr2 cr1 cr0
              Carriage return delay style.

       tab3 tab2 tab1 tab0
              Horizontal tab delay style.

       bs1 bs0
              Backspace delay style.

       vt1 vt0
              Vertical tab delay style.

       ff1 ff0
              Form feed delay style.

       Local settings:


       [-]isig
              Enable interrupt, quit, and suspend special charac-
              ters.

       [-]icanon
              Enable erase, kill, werase, and rprnt special char-
              acters.

       [-]iexten
              Enable non-POSIX special characters.

       [-]echo
              Echo input characters.



                                                                3





STTY(1L)                                                 STTY(1L)


       [-]echoe, [-]crterase
              Echo erase characters as backspace-space-backspace.

       [-]echok
              Echo a newline after a kill character.

       [-]echonl
              Echo  newline even if not echoing other characters.

       [-]noflsh
              Disable flushing after interrupt and  quit  special
              characters.

       [-]xcase
              Enable  input and output of uppercase characters by
              preceding their  lowercase  equivalents  with  `\',
              when icanon is set.

       [-]tostop
              Stop  background jobs that try to write to the ter-
              minal.

       [-]echoprt [-]prterase
              Echo erased characters backward,  between  `\'  and
              '/'.

       [-]echoctl [-]ctlecho
              Echo  control  characters  in  hat  notation (`^c')
              instead of literally.

       [-]echoke [-]crtkill
              Echo the kill special  character  by  erasing  each
              character  on  the line as indicated by the echoprt
              and echoe settings, instead of by the  echoctl  and
              echok settings.

       Combination settings:


       [-]evenp [-]parity
              Same  as  parenb  -parodd  cs7.   With `-', same as
              -parenb cs8.

       [-]oddp
              Same as parenb  parodd  cs7.   With  `-',  same  as
              -parenb cs8.

       [-]nl  Same  as  icrnl.   With  `-', same as -icrnl -inlcr
              -igncr.

       ek     Reset the erase  and  kill  special  characters  to
              their default values.

       sane   Same  as  cread  -ignbrk brkint -inlcr -igncr icrnl



                                                                4





STTY(1L)                                                 STTY(1L)


              -ixoff -iuclc -ixany imaxbel  opost  -olcuc  -ocrnl
              onlcr -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0
              vt0 ff0 isig icanon iexten echo echoe echok -echonl
              -noflsh -xcase -tostop -echoprt echoctl echoke, and
              also sets all special characters to  their  default
              values.

       [-]cooked
              Same  as brkint ignpar istrip icrnl ixon opost isig
              icanon, plus sets the eof  and  eol  characters  to
              their  default  values  if they are the same as the
              min and time characters.  With `-', same as raw.

       [-]raw Same as  -ignbrk  -brkint  -ignpar  -parmrk  -inpck
              -istrip  -inlcr  -igncr  -icrnl -ixon -ixoff -iuclc
              -ixany -imaxbel -opost -isig -icanon -xcase  min  1
              time 0.  With `-', same as cooked.

       [-]cbreak
              Same as -icanon.

       [-]pass8
              Same  as  -parenb  -istrip  cs8.  With `-', same as
              parenb istrip cs7.

       [-]litout
              Same as -parenb -istrip -opost cs8.  With `-', same
              as parenb istrip opost cs7.

       [-]decctlq
              Same as -ixany.

       [-]tabs
              Same as tab0.  With `-', same as tab3.

       [-]lcase [-]LCASE
              Same as xcase iuclc olcuc.

       crt    Same as echoe echoctl echoke.

       dec    Same  as echoe echoctl echoke -ixany, and also sets
              the interrupt special character to Ctrl-C, erase to
              Del, and kill to Ctrl-U.

       Special characters:


       The special characters' default values vary from system to
       system.  They are set with the syntax `name value',  where
       the  names  are  listed  below  and the value can be given
       either literally, in hat notation (`^c'), or as an integer
       which  may start with `0x' to indicate hexadecimal, `0' to
       indicate octal, or any other digit  to  indicate  decimal.
       Giving  a  value  of `^-' or `undef' disables that special



                                                                5





STTY(1L)                                                 STTY(1L)


       character.


       intr   Send an interrupt signal.

       quit   Send a quit signal.

       erase  Erase the last character typed.

       kill   Erase the current line.

       eof    Send an end of file (terminate the input).

       eol    End the line.

       eol2   Alternate character to end the line.

       swtch  Switch to a different shell layer.

       start  Restart the output after stopping it.

       stop   Stop the output.

       susp   Send a terminal stop signal.

       dsusp  Send a terminal  stop  signal  after  flushing  the
              input.

       rprnt  Redraw the current line.

       werase Erase the last word typed.

       lnext  Enter  the  next character typed literally, even if
              it is a special character.

       Special settings:


       min N  Set the minimum number of characters that will sat-
              isfy  a read until the time value has expired, when
              -icanon is set.

       time N Set the number of tenths of a second  before  reads
              time  out  if the min number of characters have not
              been read, when -icanon is set.

       ispeed N
              Set the input speed to N.

       ospeed N
              Set the output speed to N.

       rows N Tell the kernel that the terminal has N rows.




                                                                6





STTY(1L)                                                 STTY(1L)


       cols N columns N
              Tell the kernel that the terminal has N columns.

       size   Print the number of rows and columns that the  ker-
              nel thinks the terminal has.

       line N Use line discipline N.

       speed  Print the terminal speed.

       N      Set the input and output speeds to N.  N can be one
              of: 0 50 75 110 134 134.5 150 200 300 600 1200 1800
              2400  4800 9600 19200 38400 exta extb.  exta is the
              same as 19200; extb is the same as 38400.  0  hangs
              up the line if -clocal is set.

   OOPPTTIIOONNSS
       _-_a _-_-_a_l_l
              Print  all current settings in human-readable form.

       _-_g_, _-_-_s_a_v_e
              Print all current settings in a form  that  can  be
              used  as  an  argument  to  another ssttttyy command to
              restore the current settings.

       The long-named options can be introduced with `+' as  well
       as  `--', for compatibility with previous releases.  Even-
       tually support for `+' will  be  removed,  because  it  is
       incompatible with the POSIX.2 standard.




























                                                                7


