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