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 argu-
     ments, 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  Con-
     trol 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 san-
     ity  checking  is performed. Hardware flow control and clock
     modes options might not be supported by all hardware  inter-
     faces.


OPTIONS

     The following options are supported:

SunOS 5.11          Last change: 20 May 2009                    1


User Commands                                             stty(1)

     -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. Oth-
           erwise, 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  charac-
                             ter.

     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

SunOS 5.11          Last change: 20 May 2009                    2


User Commands                                             stty(1)

                             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  charac-
                             ters  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 inter-
         faces.)

     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 supports 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 supports split baud rates.)
         If the output baud rate is set to 0, the line is hung up
         immediately.

SunOS 5.11          Last change: 20 May 2009                    3


User Commands                                             stty(1)

  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  check-
                           ing.

     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  alphabet-
                           ics 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 res-
                           tart 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,

SunOS 5.11          Last change: 20 May 2009                    4


User Commands                                             stty(1)

                           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  dis-
                           turbed. If -imaxbel  is  set,  no  BEL
                           character  is  echoed,  and all unread
                           input present in the  input  queue  is
                           discarded  if  the  input stream over-
                           flows.

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

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

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

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

SunOS 5.11          Last change: 20 May 2009                    5


User Commands                                             stty(1)

     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 char-
                           acters  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  terminals;  however, it
                           does not keep track of column position
                           and,  as a result, it might be confus-
                           ing for escaped characters, tabs,  and
                           backspaces.

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

SunOS 5.11          Last change: 20 May 2009                    6


User Commands                                             stty(1)

     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 syn-
                           chronous line.

     tostop (-tostop)      Send (do not send) SIGTTOU when  back-
                           ground  processes  write to the termi-
                           nal.

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

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

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

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

SunOS 5.11          Last change: 20 May 2009                    7


User Commands                                             stty(1)

  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 con-
                           trol on output.

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

  Clock Modes
     xcibrg       Get transmit clock from internal baud rate gen-
                  erator.

     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  gen-
                  erator.

     rctset       Get receive clock from transmitter signal  ele-
                  ment  timing (DCE source) lead, CCITT V.24 cir-
                  cuit 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.

SunOS 5.11          Last change: 20 May 2009                    8


User Commands                                             stty(1)

     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 element timing
                  (DTE source)  lead,  CCITT  V.24  circuit  113,
                  EIA-232-D pin 24.

     rsetcoff     Receiver signal element timing clock  not  pro-
                  vided.

     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 element 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:

SunOS 5.11          Last change: 20 May 2009                    9


User Commands                                             stty(1)

         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  pre-
                              ceded  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
                              corresponding   control   character
                              (for  example, ``^d'' is a CTRL-d).
                              ``^?'' is interpreted  as  DEL  and
                              ``^-'' is interpreted as undefined.

SunOS 5.11          Last change: 20 May 2009                   10


User Commands                                             stty(1)

     ________________________________________________________________________
    |    ^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
     time number    and TIME are used in Non-Canonical mode input
                    processing (-icanon).

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

  Combination Modes
     saved settings          Set  the  current  terminal  charac-
                             teristics to the saved settings pro-
                             duced 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.

SunOS 5.11          Last change: 20 May 2009                   11


User Commands                                             stty(1)

     -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  out-
                             put.  Raw mode is equivalent to set-
                             ting:

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

  /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, respec-
                             tively.

     sane                    Reset all modes to  some  reasonable
                             values.

     term                    Set all modes suitable for the  ter-
                             minal  type  term, where term is one
                             of tty33, tty37, vt05, tn300, ti700,

SunOS 5.11          Last change: 20 May 2009                   12


User Commands                                             stty(1)

                             or tek.

     async                   Set normal  asynchronous  communica-
                             tions   where   clock  settings  are
                             xcibrg, rcibrg, tsetcoff and  rsetc-
                             off.

  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 short-
                  hand 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 restor-
     ing  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 settings 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.

SunOS 5.11          Last change: 20 May 2009                   13


User Commands                                             stty(1)

     >0    An error occurred.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

  /usr/bin/stty
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

  /usr/xpg4/bin/stty
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWxcu4                    |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|

  /usr/xpg6/bin/stty
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWxcu6                    |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


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.

SunOS 5.11          Last change: 20 May 2009                   14


User Commands                                             stty(1)

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

SunOS 5.11          Last change: 20 May 2009                   15


Man(1) output converted with man2html


FhG Schily's Home VED powered