| 1 | .TH STTY 1
|
|---|
| 2 | .SH NAME
|
|---|
| 3 | stty \- set terminal parameters
|
|---|
| 4 | .SH SYNOPSIS
|
|---|
| 5 | .de SP
|
|---|
| 6 | .if t .sp 0.4
|
|---|
| 7 | .if n .sp
|
|---|
| 8 | ..
|
|---|
| 9 | .in +4n
|
|---|
| 10 | .ti -4n
|
|---|
| 11 | .B stty
|
|---|
| 12 | .RB [ \-ag]
|
|---|
| 13 | .SP
|
|---|
| 14 | .ti -4n
|
|---|
| 15 | .B stty
|
|---|
| 16 | .I encoded-form
|
|---|
| 17 | .SP
|
|---|
| 18 | .ti -4n
|
|---|
| 19 | .B stty
|
|---|
| 20 | .I speed
|
|---|
| 21 | .B ispeed
|
|---|
| 22 | .I speed
|
|---|
| 23 | .B ospeed
|
|---|
| 24 | .I speed
|
|---|
| 25 | .B "cs5 cs6 cs7 cs8"
|
|---|
| 26 | .RB [ \- ] parenb
|
|---|
| 27 | .RB [ \- ] parodd
|
|---|
| 28 | .RB [ \- ] hupcl
|
|---|
| 29 | .RB [ \- ] cstopb
|
|---|
| 30 | .RB [ \- ] cread
|
|---|
| 31 | .RB [ \- ] clocal
|
|---|
| 32 | .RB [ \- ] ignbrk
|
|---|
| 33 | .RB [ \- ] brkint
|
|---|
| 34 | .RB [ \- ] ignpar
|
|---|
| 35 | .RB [ \- ] parmrk
|
|---|
| 36 | .RB [ \- ] inpck
|
|---|
| 37 | .RB [ \- ] istrip
|
|---|
| 38 | .RB [ \- ] inlcr
|
|---|
| 39 | .RB [ \- ] igncr
|
|---|
| 40 | .RB [ \- ] icrnl
|
|---|
| 41 | .RB [ \- ] ixon
|
|---|
| 42 | .RB [ \- ] ixoff
|
|---|
| 43 | .RB [ \- ] ixany
|
|---|
| 44 | .RB [ \- ] opost
|
|---|
| 45 | .RB [ \- ] onlcr
|
|---|
| 46 | .RB [ \- ] xtabs
|
|---|
| 47 | .RB [ \- ] onoeot
|
|---|
| 48 | .RB [ \- ] isig
|
|---|
| 49 | .RB [ \- ] icanon
|
|---|
| 50 | .RB [ \- ] iexten
|
|---|
| 51 | .RB [ \- ] echo
|
|---|
| 52 | .RB [ \- ] echoe
|
|---|
| 53 | .RB [ \- ] echok
|
|---|
| 54 | .RB [ \- ] echonl
|
|---|
| 55 | .RB [ \- ] noflsh
|
|---|
| 56 | .RB [ \- ] tostop
|
|---|
| 57 | .RB [ \- ] lflusho
|
|---|
| 58 | .BR eof =\fIc
|
|---|
| 59 | .BR eol =\fIc
|
|---|
| 60 | .BR erase =\fIc
|
|---|
| 61 | .BR erase =\fIc
|
|---|
| 62 | .BR intr =\fIc
|
|---|
| 63 | .BR kill =\fIc
|
|---|
| 64 | .BR quit =\fIc
|
|---|
| 65 | .BR susp =\fIc
|
|---|
| 66 | .BR start =\fIc
|
|---|
| 67 | .BR stop =\fIc
|
|---|
| 68 | .BR rprnt =\fIc
|
|---|
| 69 | .BR lnext =\fIc
|
|---|
| 70 | .BR flush =\fIc
|
|---|
| 71 | .BR min =\fIn
|
|---|
| 72 | .BR time =\fIn
|
|---|
| 73 | .B rows
|
|---|
| 74 | .I n
|
|---|
| 75 | .B cols
|
|---|
| 76 | .I n
|
|---|
| 77 | .B xpixels
|
|---|
| 78 | .I n
|
|---|
| 79 | .B ypixels
|
|---|
| 80 | .I n
|
|---|
| 81 | .B cooked
|
|---|
| 82 | .B raw
|
|---|
| 83 | .RB [ \- ] evenp
|
|---|
| 84 | .RB [ \- ] parity
|
|---|
| 85 | .RB [ \- ] oddp
|
|---|
| 86 | .RB [ \- ] nl
|
|---|
| 87 | .B ek
|
|---|
| 88 | .B sane
|
|---|
| 89 | .in -4n
|
|---|
| 90 | .SH DESCRIPTION
|
|---|
| 91 | .B Stty
|
|---|
| 92 | shows or changes the parameters of the terminal connected to standard input.
|
|---|
| 93 | .B Stty
|
|---|
| 94 | takes a myriad of arguments most of which are mapped directly to
|
|---|
| 95 | the flags and special characters described in
|
|---|
| 96 | .BR tty (4),
|
|---|
| 97 | so we won't describe them here.
|
|---|
| 98 | .PP
|
|---|
| 99 | .B Stty
|
|---|
| 100 | has three forms of operation. First, without any arguments
|
|---|
| 101 | .B stty
|
|---|
| 102 | shows all terminal attributes that are different from the default state.
|
|---|
| 103 | Option
|
|---|
| 104 | .B \-a
|
|---|
| 105 | makes
|
|---|
| 106 | .B stty
|
|---|
| 107 | print all terminal attributes, and
|
|---|
| 108 | .B \-g
|
|---|
| 109 | lets
|
|---|
| 110 | .B stty
|
|---|
| 111 | print the attributes in a special encoded form, a simple row of colon separated
|
|---|
| 112 | hexadecimal numbers.
|
|---|
| 113 | .PP
|
|---|
| 114 | In the second form of operation
|
|---|
| 115 | .B stty
|
|---|
| 116 | takes an encoded form as produced by the
|
|---|
| 117 | .B \-g
|
|---|
| 118 | option and sets the terminals attributes to its decoded value.
|
|---|
| 119 | .PP
|
|---|
| 120 | In the third form
|
|---|
| 121 | .B stty
|
|---|
| 122 | interprets a series of flags and parameters settings and modifies the
|
|---|
| 123 | terminal attributes accordingly. Flags can be given as
|
|---|
| 124 | .B icanon
|
|---|
| 125 | or
|
|---|
| 126 | .B \-icanon
|
|---|
| 127 | for instance, either setting or clearing the
|
|---|
| 128 | .B ICANON
|
|---|
| 129 | flag.
|
|---|
| 130 | Special character values can by set like
|
|---|
| 131 | .B "intr=^C"
|
|---|
| 132 | for example, which sets the interrupt character to CTRL-C. You can either
|
|---|
| 133 | use a real CTRL-C, or the two characters `^' and `C'. In any case
|
|---|
| 134 | it is probably necessary to use quotes to guard it from the shell:
|
|---|
| 135 | .BR "intr='^C'" .
|
|---|
| 136 | .PP
|
|---|
| 137 | A number alone is interpreted as a baud rate setting for both the input and
|
|---|
| 138 | output rate. The input or the output rate can be set separately with use
|
|---|
| 139 | of the
|
|---|
| 140 | .B ispeed
|
|---|
| 141 | and
|
|---|
| 142 | .B ospeed
|
|---|
| 143 | prefixes to the number. The character size can be set with
|
|---|
| 144 | .BR cs5 ,
|
|---|
| 145 | .BR cs6 ,
|
|---|
| 146 | .BR cs7
|
|---|
| 147 | or
|
|---|
| 148 | .BR cs8 .
|
|---|
| 149 | .PP
|
|---|
| 150 | The
|
|---|
| 151 | .B MIN
|
|---|
| 152 | and
|
|---|
| 153 | .B TIME
|
|---|
| 154 | value, the number of rows and columns, and the xpixels and ypixels of the
|
|---|
| 155 | window can also be set using one of the keywords
|
|---|
| 156 | .BR min ,
|
|---|
| 157 | .BR time ,
|
|---|
| 158 | .BR rows ,
|
|---|
| 159 | .BR cols ,
|
|---|
| 160 | .BR xpixels
|
|---|
| 161 | or
|
|---|
| 162 | .BR ypixels ,
|
|---|
| 163 | followed by a decimal number that is the value of the setting.
|
|---|
| 164 | .PP
|
|---|
| 165 | .B Stty
|
|---|
| 166 | accepts several keywords that are not named by corresponding flags or
|
|---|
| 167 | parameters in
|
|---|
| 168 | .BR tty (4).
|
|---|
| 169 | They set several attributes at once:
|
|---|
| 170 | .TP
|
|---|
| 171 | .B cooked
|
|---|
| 172 | Same as
|
|---|
| 173 | .BR "icrnl ixon opost onlcr isig icanon iexten echo" ,
|
|---|
| 174 | setting all the attributes that are needed for line oriented mode.
|
|---|
| 175 | .TP
|
|---|
| 176 | .B raw
|
|---|
| 177 | Same as
|
|---|
| 178 | .BR "\-icrnl \-ixon \-opost \-onlcr \-isig \-icanon \-iexten \-echo" ,
|
|---|
| 179 | setting all the attributes for a raw data channel.
|
|---|
| 180 | .TP
|
|---|
| 181 | .B evenp parity
|
|---|
| 182 | These synonyms are equal to
|
|---|
| 183 | .BR "cs7 parenb \-parodd" ,
|
|---|
| 184 | setting the line to 7 bits even parity.
|
|---|
| 185 | .TP
|
|---|
| 186 | .B oddp
|
|---|
| 187 | Same as
|
|---|
| 188 | .BR "cs7 parenb parodd" ,
|
|---|
| 189 | setting the line to 7 bits odd parity.
|
|---|
| 190 | .TP
|
|---|
| 191 | .B "\-parity \-evenp \-oddp"
|
|---|
| 192 | All synonyms for
|
|---|
| 193 | .BR "cs8 \-parenb" ,
|
|---|
| 194 | setting the line to 8 bits, no parity.
|
|---|
| 195 | .TP
|
|---|
| 196 | .B nl
|
|---|
| 197 | Same as
|
|---|
| 198 | .BR icrnl ,
|
|---|
| 199 | setting carriage return to line feed input translation.
|
|---|
| 200 | .TP
|
|---|
| 201 | .B \-nl
|
|---|
| 202 | Same as
|
|---|
| 203 | .BR "\-icrnl \-inlcr \-igncr" ,
|
|---|
| 204 | disabling any carriage return or line feed handling.
|
|---|
| 205 | .TP
|
|---|
| 206 | .B ek
|
|---|
| 207 | Set the
|
|---|
| 208 | .B ERASE
|
|---|
| 209 | and
|
|---|
| 210 | .B KILL
|
|---|
| 211 | special characters back to the default.
|
|---|
| 212 | .TP
|
|---|
| 213 | .B sane
|
|---|
| 214 | Set all attributes to the default except things like the line speed and
|
|---|
| 215 | parity, because their "sane" value is probably what it is right now.
|
|---|
| 216 | The default values are compiled into
|
|---|
| 217 | .B stty
|
|---|
| 218 | from the <termios.h> include file. Use
|
|---|
| 219 | .B "stty sane; stty -a"
|
|---|
| 220 | to know what they are.
|
|---|
| 221 | .SH FILES
|
|---|
| 222 | .TP 15n
|
|---|
| 223 | .B /etc/ttytab
|
|---|
| 224 | The
|
|---|
| 225 | .B init
|
|---|
| 226 | field of this file may contain an
|
|---|
| 227 | .B stty
|
|---|
| 228 | command to set the attributes to match an attached RS232 terminal or modem.
|
|---|
| 229 | .SH "SEE ALSO"
|
|---|
| 230 | .BR tty (4),
|
|---|
| 231 | .BR ttytab (5).
|
|---|
| 232 | .SH NOTES
|
|---|
| 233 | The
|
|---|
| 234 | .BR cooked ,
|
|---|
| 235 | .BR raw ,
|
|---|
| 236 | .BR rows ,
|
|---|
| 237 | .BR cols ,
|
|---|
| 238 | .BR xpixels
|
|---|
| 239 | and
|
|---|
| 240 | .BR ypixels
|
|---|
| 241 | keywords are MINIX 3 additions beyond the keywords defined by POSIX.
|
|---|
| 242 | .B Rows
|
|---|
| 243 | and
|
|---|
| 244 | .B cols
|
|---|
| 245 | are common UNIX extensions, however.
|
|---|
| 246 | There are more MINIX 3 specific flags that match the MINIX 3 specific attributes
|
|---|
| 247 | described in
|
|---|
| 248 | .BR tty (4).
|
|---|
| 249 | .SH AUTHOR
|
|---|
| 250 | Kees J. Bot <kjb@cs.vu.nl>
|
|---|
