home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / shellutils-1.9.4-bin.lha / man / cat1 / stty.0 < prev    next >
Text File  |  1993-12-07  |  12KB  |  463 lines
  1.  
  2.  
  3.  
  4. STTY(1L)                                                 STTY(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        stty - change and print terminal line settings
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ssttttyy [-ag] [--all] [--save] [setting...]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        This  manual  page  documents the GNU version of ssttttyy.  If
  15.        given no arguments, ssttttyy prints the baud rate, line disci-
  16.        pline  number  (on systems that support it), and line set-
  17.        tings that have been changed from the values set by  `stty
  18.        sane'.   Mode reading and setting are performed on the tty
  19.        line connected to the standard input.
  20.  
  21.        ssttttyy  accepts  the  following  non-option  arguments  that
  22.        change  aspects  of  the terminal line operation.  A `[-]'
  23.        before a capability means that it can  be  turned  off  by
  24.        preceding it with a `-'.  Some arguments are not available
  25.        on all systems, since they use non-POSIX extensions.  Such
  26.        arguments are marked below with `(np)'.
  27.  
  28.        Control settings:
  29.  
  30.  
  31.        [-]parenb
  32.               Generate parity bit in output and expect parity bit
  33.               in input.
  34.  
  35.        [-]parodd
  36.               Set odd parity (even with `-').
  37.  
  38.        cs5 cs6 cs7 cs8
  39.               Set character size to 5, 6, 7, or 8 bits.
  40.  
  41.        [-]hupcl [-]hup
  42.               Send a hangup signal when the last  process  closes
  43.               the tty.
  44.  
  45.        [-]cstopb
  46.               Use two stop bits per character (one with `-').
  47.  
  48.        [-]cread
  49.               Allow input to be received.
  50.  
  51.        [-]clocal
  52.               Disable modem control signals.
  53.  
  54.        [-]crtscts (np)
  55.               Enable RTS/CTS handshaking.
  56.  
  57.        Input settings:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. STTY(1L)                                                 STTY(1L)
  71.  
  72.  
  73.        [-]ignbrk
  74.               Ignore breaks.
  75.  
  76.        [-]brkint
  77.               Breaks cause an interrupt signal.
  78.  
  79.        [-]ignpar
  80.               Ignore parity errors.
  81.  
  82.        [-]parmrk
  83.               Mark   parity   errors   (with   a  255-0-character
  84.               sequence).
  85.  
  86.        [-]inpck
  87.               Enable input parity checking.
  88.  
  89.        [-]istrip
  90.               Clear high (8th) bit of input characters.
  91.  
  92.        [-]inlcr
  93.               Translate newline to carriage return.
  94.  
  95.        [-]igncr
  96.               Ignore carriage return.
  97.  
  98.        [-]icrnl
  99.               Translate carriage return to newline.
  100.  
  101.        [-]ixon
  102.               Enable XON/XOFF flow control.
  103.  
  104.        [-]ixoff [-]tandem
  105.               Enable sending of stop character  when  the  system
  106.               input  buffer  is  almost full, and start character
  107.               when it becomes almost empty again.
  108.  
  109.        [-]iuclc (np)
  110.               Translate uppercase characters to lowercase.
  111.  
  112.        [-]ixany (np)
  113.               Allow any character to  restart  output  (only  the
  114.               start character with `-').
  115.  
  116.        [-]imaxbel (np)
  117.               Enable  beeping  and not flushing input buffer if a
  118.               character arrives when the input buffer is full.
  119.  
  120.        Output settings:
  121.  
  122.  
  123.        [-]opost
  124.               Postprocess output.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. STTY(1L)                                                 STTY(1L)
  137.  
  138.  
  139.        [-]olcuc (np)
  140.               Translate lowercase characters to uppercase.
  141.  
  142.        [-]ocrnl (np)
  143.               Translate carriage return to newline.
  144.  
  145.        [-]onlcr (np)
  146.               Translate newline to carriage return-newline.
  147.  
  148.        [-]onocr (np)
  149.               Do not print carriage returns in the first  column.
  150.  
  151.        [-]onlret (np)
  152.               Newline performs a carriage return.
  153.  
  154.        [-]ofill (np)
  155.               Use fill (padding) characters instead of timing for
  156.               delays.
  157.  
  158.        [-]ofdel (np)
  159.               Use delete characters  for  fill  instead  of  null
  160.               characters.
  161.  
  162.        nl1 nl0 (np)
  163.               Newline delay style.
  164.  
  165.        cr3 cr2 cr1 cr0 (np)
  166.               Carriage return delay style.
  167.  
  168.        tab3 tab2 tab1 tab0 (np)
  169.               Horizontal tab delay style.
  170.  
  171.        bs1 bs0 (np)
  172.               Backspace delay style.
  173.  
  174.        vt1 vt0 (np)
  175.               Vertical tab delay style.
  176.  
  177.        ff1 ff0 (np)
  178.               Form feed delay style.
  179.  
  180.        Local settings:
  181.  
  182.  
  183.        [-]isig
  184.               Enable interrupt, quit, and suspend special charac-
  185.               ters.
  186.  
  187.        [-]icanon
  188.               Enable erase, kill, werase, and rprnt special char-
  189.               acters.
  190.  
  191.        [-]iexten
  192.               Enable non-POSIX special characters.
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. STTY(1L)                                                 STTY(1L)
  203.  
  204.  
  205.        [-]echo
  206.               Echo input characters.
  207.  
  208.        [-]echoe, [-]crterase
  209.               Echo erase characters as backspace-space-backspace.
  210.  
  211.        [-]echok
  212.               Echo a newline after a kill character.
  213.  
  214.        [-]echonl
  215.               Echo newline even if not echoing other  characters.
  216.  
  217.        [-]noflsh
  218.               Disable  flushing  after interrupt and quit special
  219.               characters.
  220.  
  221.        [-]xcase (np)
  222.               Enable input and output of uppercase characters  by
  223.               preceding  their  lowercase  equivalents  with `\',
  224.               when icanon is set.
  225.  
  226.        [-]tostop (np)
  227.               Stop background jobs that try to write to the  ter-
  228.               minal.
  229.  
  230.        [-]echoprt [-]prterase (np)
  231.               Echo  erased  characters  backward, between `\' and
  232.               '/'.
  233.  
  234.        [-]echoctl [-]ctlecho (np)
  235.               Echo control  characters  in  hat  notation  (`^c')
  236.               instead of literally.
  237.  
  238.        [-]echoke [-]crtkill (np)
  239.               Echo  the  kill  special  character by erasing each
  240.               character on the line as indicated by  the  echoprt
  241.               and  echoe  settings, instead of by the echoctl and
  242.               echok settings.
  243.  
  244.        Combination settings:
  245.  
  246.  
  247.        [-]evenp [-]parity
  248.               Same as parenb -parodd  cs7.   With  `-',  same  as
  249.               -parenb cs8.
  250.  
  251.        [-]oddp
  252.               Same  as  parenb  parodd  cs7.   With  `-', same as
  253.               -parenb cs8.
  254.  
  255.        [-]nl  Same as -icrnl -onlcr.  With  `-',  same  as  icrnl
  256.               -inlcr -igncr onlcr -ocrnl -onlret.
  257.  
  258.        ek     Reset  the  erase  and  kill  special characters to
  259.  
  260.  
  261.  
  262.                                                                 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. STTY(1L)                                                 STTY(1L)
  269.  
  270.  
  271.               their default values.
  272.  
  273.        sane   Same as cread -ignbrk brkint  -inlcr  -igncr  icrnl
  274.               -ixoff  -iuclc  -ixany  imaxbel opost -olcuc -ocrnl
  275.               onlcr -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0
  276.               vt0 ff0 isig icanon iexten echo echoe echok -echonl
  277.               -noflsh -xcase -tostop -echoprt echoctl echoke, and
  278.               also  sets  all special characters to their default
  279.               values.
  280.  
  281.        [-]cooked
  282.               Same as brkint ignpar istrip icrnl ixon opost  isig
  283.               icanon,  plus  sets  the  eof and eol characters to
  284.               their default values if they are the  same  as  the
  285.               min and time characters.  With `-', same as raw.
  286.  
  287.        [-]raw Same  as  -ignbrk  -brkint  -ignpar  -parmrk -inpck
  288.               -istrip -inlcr -igncr -icrnl  -ixon  -ixoff  -iuclc
  289.               -ixany  -imaxbel  -opost -isig -icanon -xcase min 1
  290.               time 0.  With `-', same as cooked.
  291.  
  292.        [-]cbreak
  293.               Same as -icanon.
  294.  
  295.        [-]pass8
  296.               Same as -parenb -istrip cs8.   With  `-',  same  as
  297.               parenb istrip cs7.
  298.  
  299.        [-]litout
  300.               Same as -parenb -istrip -opost cs8.  With `-', same
  301.               as parenb istrip opost cs7.
  302.  
  303.        [-]decctlq (np)
  304.               Same as -ixany.
  305.  
  306.        [-]tabs (np)
  307.               Same as tab0.  With `-', same as tab3.
  308.  
  309.        [-]lcase [-]LCASE (np)
  310.               Same as xcase iuclc olcuc.
  311.  
  312.        crt    Same as echoe echoctl echoke.
  313.  
  314.        dec    Same as echoe echoctl echoke -ixany, and also  sets
  315.               the interrupt special character to Ctrl-C, erase to
  316.               Del, and kill to Ctrl-U.
  317.  
  318.        Special characters:
  319.  
  320.  
  321.        The special characters' default values vary from system to
  322.        system.   They are set with the syntax `name value', where
  323.        the names are listed below and  the  value  can  be  given
  324.        either literally, in hat notation (`^c'), or as an integer
  325.  
  326.  
  327.  
  328.                                                                 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. STTY(1L)                                                 STTY(1L)
  335.  
  336.  
  337.        which may start with `0x' to indicate hexadecimal, `0'  to
  338.        indicate  octal,  or  any other digit to indicate decimal.
  339.        Giving a value of `^-' or `undef'  disables  that  special
  340.        character.
  341.  
  342.  
  343.        intr   Send an interrupt signal.
  344.  
  345.        quit   Send a quit signal.
  346.  
  347.        erase  Erase the last character typed.
  348.  
  349.        kill   Erase the current line.
  350.  
  351.        eof    Send an end of file (terminate the input).
  352.  
  353.        eol    End the line.
  354.  
  355.        eol2 (np)
  356.               Alternate character to end the line.
  357.  
  358.        swtch (np)
  359.               Switch to a different shell layer.
  360.  
  361.        start  Restart the output after stopping it.
  362.  
  363.        stop   Stop the output.
  364.  
  365.        susp   Send a terminal stop signal.
  366.  
  367.        dsusp (np)
  368.               Send  a  terminal  stop  signal  after flushing the
  369.               input.
  370.  
  371.        rprnt (np)
  372.               Redraw the current line.
  373.  
  374.        werase (np)
  375.               Erase the last word typed.
  376.  
  377.        lnext (np)
  378.               Enter the next character typed literally,  even  if
  379.               it is a special character.
  380.  
  381.        Special settings:
  382.  
  383.  
  384.        min N  Set the minimum number of characters that will sat-
  385.               isfy a read until the time value has expired,  when
  386.               -icanon is set.
  387.  
  388.        time N Set  the  number of tenths of a second before reads
  389.               time out if the min number of characters  have  not
  390.               been read, when -icanon is set.
  391.  
  392.  
  393.  
  394.                                                                 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. STTY(1L)                                                 STTY(1L)
  401.  
  402.  
  403.        ispeed N
  404.               Set the input speed to N.
  405.  
  406.        ospeed N
  407.               Set the output speed to N.
  408.  
  409.        rows N (np)
  410.               Tell the kernel that the terminal has N rows.
  411.  
  412.        cols N columns N (np)
  413.               Tell the kernel that the terminal has N columns.
  414.  
  415.        size (np)
  416.               Print  the number of rows and columns that the ker-
  417.               nel thinks the terminal has.  (Systems  that  don't
  418.               support  rows  and cols in the kernel typically use
  419.               the  environment  variables   LLIINNEESS   and   CCOOLLUUMMNNSS
  420.               instead;  however,  GNU ssttttyy does not know anything
  421.               about them.)
  422.  
  423.        line N (np)
  424.               Use line discipline N.
  425.  
  426.        speed  Print the terminal speed.
  427.  
  428.        N      Set the input and output speeds to N.  N can be one
  429.               of: 0 50 75 110 134 134.5 150 200 300 600 1200 1800
  430.               2400 4800 9600 19200 38400 exta extb.  exta is  the
  431.               same  as 19200; extb is the same as 38400.  0 hangs
  432.               up the line if -clocal is set.
  433.  
  434.    OOPPTTIIOONNSS
  435.        _-_a_, _-_-_a_l_l
  436.               Print all current settings in human-readable  form.
  437.  
  438.        _-_g_, _-_-_s_a_v_e
  439.               Print  all  current  settings in a form that can be
  440.               used as an argument  to  another  ssttttyy  command  to
  441.               restore the current settings.
  442.  
  443.        The  long-named options can be introduced with `+' as well
  444.        as `--', for compatibility with previous releases.   Even-
  445.        tually  support  for  `+'  will  be removed, because it is
  446.        incompatible with the POSIX.2 standard.
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                                                 7
  461.  
  462.  
  463.