unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 stty(1)							     stty(1)




 NAME
      stty - set the options for a terminal port

 SYNOPSIS
      stty [-a | -g | options]

 DESCRIPTION
      stty 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:

	   stty		       Report the settings of a system-defined set
			       of options;

	   stty -a	       Report all of current option settings;

	   stty -g	       Report current settings in a form that can be
			       used as an argument to another stty command.

	   stty options	       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
      Hardware 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
      rows number	       Set the terminal window row size equal to
			       number.

      columns number	       Set the terminal window column size (width)
			       equal to number.	 cols can be used as an
			       abbreviation for columns.

      parenb (-parenb)	       Enable (disable) parity generation and
			       detection.

      parodd (-parodd)	       Select odd (even) parity.

      cs5 cs6 cs7 cs8	       Select character size (see termio(7)).

      0			       Hang up phone line immediately.





 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 stty(1)							     stty(1)




      50 75 110 134.5 150 200 300 600 900 1200 1800 2400
      3600 4800 7200 9600 19200 38400 57600 115200 230400 exta extb
			       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.

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

      ospeed number	       Set terminal output baud rate to number.	 If
			       number is zero, the modem control lines are
			       released, which in turn disconnects the line.

      hupcl (-hupcl)	       Hang up (do not hang up) modem connection on
			       last close.

      hup (-hup)	       Same as hupcl (-hupcl).

      cstopb (-cstopb)	       Use two (one) stop bits per character.

      cread (-cread)	       Enable (disable) the receiver.

      crts (-crts)	       Enable (disable) request-to-send.

      clocal (-clocal)	       Assume a line without (with) modem control.

      loblk (-loblk)	       Block (do not block) output from a noncurrent
			       layer.

      +resetGSP		       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
      ignbrk (-ignbrk)	       Ignore (do not ignore) break on input.

      ienqak (-ienqak)	       Enable (disable) ENQ-ACK Handshaking.

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

      inpck (-inpck)	       Enable (disable) input parity checking.




 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 stty(1)							     stty(1)




      istrip (-istrip)	       Strip (do not strip) input characters to
			       seven bits.

      inlcr (-inlcr)	       Map (do not map) newline character to
			       carriage return (CR) on input.

      igncr (-igncr)	       Ignore (do not ignore) CR on input.

      icrnl (-icrnl)	       Map (do not map) CR to a newline character on
			       input.

      iuclc (-iuclc)	       Map (do not map) uppercase alphabetic
			       characters to lowercase on input.

      ixon (-ixon)	       Enable (disable) START/STOP output control.
			       Output is stopped by sending an ASCII DC3 and
			       started by sending an ASCII DC1.

      ixany (-ixany)	       Allow any character (only DC1) to restart
			       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.

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

      olcuc (-olcuc)	       Map (do not map) lowercase alphabetics to
			       uppercase on output.

      onlcr (-onlcr)	       Map (do not map) newline character to a
			       carriage-return/newline character sequence on
			       output.

      ocrnl (-ocrnl)	       Map (do not map) CR to newline character on
			       output.

      onocr (-onocr)	       Do not (do) output CRs at column zero.

      onlret (-onlret)	       On the terminal, a newline character performs
			       (does not perform) the CR function.

      ofill (-ofill)	       Use fill characters (use timing) for delays.

      ofdel (-ofdel)	       Fill characters are DELs ( NULs).




 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 stty(1)							     stty(1)




      cr0 cr1 cr2 cr3	       Select style of delay for carriage returns
			       (see termio(7)).

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

      tab0 tab1 tab2 tab3      Select style of delay for horizontal tabs
			       (see termio(7).

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

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

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

    Local Modes
      isig (-isig)	       Enable (disable) the checking of characters
			       against the special control characters INTR
			       and QUIT.

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

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

      xcase (-xcase)	       Canonical (unprocessed) uppercase and
			       lowercase 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.  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 characters, tabs, and
			       backspaces.

      echok (-echok)	       Echo (do not echo) a newline character after
			       a KILL character.

      lfkc (-lfkc)	       (obsolete) Same as echok (-echok).

      echonl (-echonl)	       Echo (do not echo) newline character.




 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000






 stty(1)							     stty(1)




      noflsh (-noflsh)	       Disable (enable) flush after INTR or QUIT.

      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 output at next
			       read or input character.

      tostop (-tostop)	       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
      support hardware flow control through the termiox interface.  If the
      functionality is supported, this interface must be used.

      rtsxoff (-rtsxoff)       enable (disable) RTS hardware flow control on
			       input (see termiox(7))

      ctsxon (-ctsxon)	       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 erase, kill, intr, quit, eof,
			       eol, eol2, werase, lnext, min,or time (min
			       and time are used with -icanon; see
			       termio(7)).  For systems that support job
			       control, susp and dsusp characters can also
			       be set.	For systems that support shell
			       layers (see shl(1)) swtch 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,
			       ^d represents Ctrl-d); ^?  is interpreted as
			       DEL and ^- is interpreted as undefined.

      line i		       Set line discipline to i where the value of i
			       ranges from zero through 127 decimal (See







 Hewlett-Packard Company	    - 5 -   HP-UX Release 11i: November 2000






 stty(1)							     stty(1)




			       termio(7)).

    Combination Modes
      evenp or parity	       Enable parenb and cs7.

      oddp		       Enable parenb, cs7, and parodd.

      -parity, -evenp, or -oddp
			       Disable parenb and set cs8.

      raw (-raw or cooked)     Enable (disable) raw input and output (no
			       ERASE, KILL, INTR, QUIT, EOT, or output post
			       processing).  See WARNINGS.

      nl (-nl)		       Unset (set) icrnl and onlcr . In addition -nl
			       unsets inlcr, igncr, ocrnl, and onlret.

      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
			       default # and @.

      sane		       Reset all modes to some reasonable values.

      term		       Set all modes suitable for the terminal type
			       term, where term is one of tty33, tty37,
			       vt05, tn300, ti700, hp, or tek.

    Reporting Functions
      size		       Print terminal window size to standard output
			       in a rows-and-columns format.

      +queryGSP		       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
      specified by the System V Interface Definition, Third Edition (SVID3),
      except for the werase and lnext control characters, which are set to
      _POSIX_VDISABLE to maintain binary compatibility with previous
      releases of HP-UX.



 Hewlett-Packard Company	    - 6 -   HP-UX Release 11i: November 2000






 stty(1)							     stty(1)




      The default values for the control characters may be changed by a user
      with root capability by using stty and redirecting stdin to the device
      /dev/ttyconf.  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, stty
      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:

	   stty kill '^X' intr '^C'

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

      The command:

	   stty kill '^X' intr '^C' werase '^W' <&lt&lt&lt;/dev/ttyconf

      sets the default values for the delete-line character to ^X (Ctrl-X),
      the interrupt character to ^C, and the word erase character to ^W.
      Any terminal port opened after this command is issued will see these
      new default values for the kill, intr, and werase control characters.



 Hewlett-Packard Company	    - 7 -   HP-UX Release 11i: November 2000






 stty(1)							     stty(1)




 WARNINGS
      Use of raw 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
      description of capabilities that are not supported.

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

 STANDARDS CONFORMANCE
      stty: SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.2







































 Hewlett-Packard Company	    - 8 -   HP-UX Release 11i: November 2000