]>
Commit | Line | Data |
---|---|---|
8ffc42de | 1 | --- screen-3.9.9/doc/screen.texinfo.orig Fri May 25 16:40:02 2001 |
2 | +++ screen-3.9.9/doc/screen.texinfo Mon Jun 11 02:40:05 2001 | |
3 | @@ -8,9 +8,14 @@ | |
4 | @c %**end of header | |
5 | @set version 3.9.9 | |
6 | ||
7 | +@ifinfo | |
8 | +@format | |
9 | +@dircategory Shell utilities: | |
10 | @direntry | |
11 | -* Screen: (screen). Full-screen window manager. | |
12 | +* Screen: (screen). Full-screen window manager | |
13 | @end direntry | |
14 | ++@end format | |
15 | +@end ifinfo | |
16 | ||
17 | @c For examples, use a literal escape in info. | |
18 | @ifinfo | |
19 | @@ -72,6 +77,15 @@ | |
bed77180 JR |
20 | by the Foundation. |
21 | @end titlepage | |
22 | ||
23 | +@ifinfo | |
24 | +@format | |
25 | +@dircategory Miscellaneous: | |
26 | +@direntry | |
9f6079b4 | 27 | +* screen: (screen). Terminal multiplexer |
bed77180 JR |
28 | +@end direntry |
29 | +@end format | |
30 | +@end ifinfo | |
31 | + | |
32 | @node Top, Overview, (dir), (dir) | |
33 | ||
34 | @ifinfo | |
8ffc42de | 35 | @@ -175,7 +189,7 @@ |
c122dd4c | 36 | variable) who will use it to create the new window. The above example would |
37 | start the @code{emacs} editor (editing @file{prog.c}) and switch to its window. | |
38 | ||
39 | -If @file{/etc/utmp} is writable by @code{screen}, an appropriate record | |
40 | +If @file{/var/run/utmp} is writable by @code{screen}, an appropriate record | |
41 | will be written to this file for each window, and removed when the | |
42 | window is closed. This is useful for working with @code{talk}, | |
43 | @code{script}, @code{shutdown}, @code{rsend}, @code{sccs} and other | |
8ffc42de | 44 | @@ -304,7 +318,7 @@ |
c122dd4c | 45 | |
46 | @item -l | |
47 | @itemx -ln | |
48 | -Turn login mode on or off (for @file{/etc/utmp} updating). This option | |
49 | +Turn login mode on or off (for @file{/var/run/utmp} updating). This option | |
50 | is equivalent to the @code{deflogin} command (@pxref{Login}). | |
51 | ||
52 | @item -ls [@var{match}] | |
8ffc42de | 53 | @@ -356,7 +370,7 @@ |
c122dd4c | 54 | In all other cases @samp{-q} has no effect. |
55 | ||
56 | @item -r [@var{pid.sessionname}] | |
57 | -@itemx -r @var{sessionowner/[pid.sessionname]} | |
58 | +@itemx -r @var{sessionowner/pid.sessionname} | |
59 | Resume a detached @code{screen} session. No other options (except | |
60 | combinations with @samp{-d} or @samp{-D}) may be specified, though | |
61 | the session name | |
8ffc42de | 62 | @@ -438,7 +452,7 @@ |
c122dd4c | 63 | @cindex screenrc |
64 | When @code{screen} is invoked, it executes initialization commands from | |
65 | the files @file{.screenrc} in the user's home directory and | |
66 | -@file{/usr/local/etc/screenrc}. These defaults can be overridden in the | |
67 | +@file{/etc/screenrc}. These defaults can be overridden in the | |
68 | following ways: | |
69 | For the global screenrc file @code{screen} searches for the environment | |
70 | variable @code{$SYSSCREENRC} (this override feature may be disabled at | |
8ffc42de | 71 | @@ -787,9 +801,9 @@ |
c122dd4c | 72 | Change a user's permissions. @xref{Multiuser Session}. |
73 | @item acldel @var{username} | |
74 | Disallow other user in this session. @xref{Multiuser Session}. | |
75 | -@item aclgrp @var{usrname [groupname]} | |
8ffc42de | 76 | +@item aclgrp @var{usrname} [@var{groupname}] |
c122dd4c | 77 | Inherit permissions granted to a group leader. @xref{Multiuser Session}. |
8ffc42de | 78 | -@item aclumask @var{[users]+/-bits ...} |
79 | +@item aclumask [@var{users}]+/-@var{bits} ... | |
c122dd4c | 80 | Predefine access to new windows. @xref{Umask}. |
81 | @item activity @var{message} | |
82 | Set the activity notification message. @xref{Monitor}. | |
8ffc42de | 83 | @@ -797,37 +811,37 @@ |
84 | Synonym to @code{acladd}. @xref{Multiuser Session}. | |
85 | @item allpartial @var{state} | |
86 | Set all windows to partial refresh. @xref{Redisplay}. | |
87 | -@item at @var{[ident][@kbd{#}@var{|}@kbd{*}@var{|}@kbd{%}] command [args]} | |
88 | +@item at [@var{ident}][@kbd{#}@var{|}@kbd{*}@var{|}@kbd{%}] @var{command} [@var{args}] | |
89 | Execute a command at other displays or windows. @xref{At}. | |
90 | -@item attrcolor @var{attrib [attribute/color-modifier]} | |
91 | +@item attrcolor @var{attrib} [@var{attribute/color-modifier}] | |
92 | Map attributes to colors. @xref{Attrcolor}. | |
93 | @item autodetach @var{state} | |
94 | Automatically detach the session on SIGHUP. @xref{Detach}. | |
95 | @item autonuke @var{state} | |
96 | Enable a clear screen to discard unwritten output. @xref{Autonuke}. | |
97 | -@item bce @var{[state]} | |
98 | +@item bce [@var{state}] | |
99 | Change background color erase. @xref{Character Processing}. | |
100 | -@item bell_msg @var{[message]} | |
101 | +@item bell_msg [@var{message}] | |
102 | Set the bell notification message. @xref{Bell}. | |
103 | -@item bind @var{key [command [args]]} | |
104 | +@item bind @var{key} [@var{command} [@var{args}]] | |
105 | Bind a command to a key. @xref{Bind}. | |
106 | -@item bindkey @var{[opts] [string [cmd args]]} | |
107 | +@item bindkey [@var{opts}] [@var{string} [@var{cmd args}]] | |
108 | Bind a string to a series of keystrokes. @xref{Bindkey}. | |
109 | -@item break @var{[duration]} | |
110 | +@item break [@var{duration}] | |
111 | Send a break signal to the current window. @xref{Break}. | |
112 | -@item breaktype @var{[tcsendbreak | TCSBRK | TIOCSBRK]} | |
113 | +@item breaktype [@var{tcsendbreak | TCSBRK | TIOCSBRK}] | |
114 | Specify how to generate breaks. @xref{Break}. | |
115 | -@item bufferfile @var{[exchange-file]} | |
116 | +@item bufferfile [@var{exchange-file}] | |
117 | Select a file for screen-exchange. @xref{Screen-Exchange}. | |
118 | -@item c1 @var{[state]} | |
119 | +@item c1 [@var{state}] | |
120 | Change c1 code processing. @xref{Character Processing}. | |
121 | -@item caption @var{mode} @var{[string]} | |
122 | +@item caption @var{mode} [@var{string}] | |
123 | Change caption mode and string. @xref{Regions}. | |
124 | @item chacl @var{usernames permbits list} | |
125 | Synonym to @code{aclchg}. @xref{Multiuser Session}. | |
126 | @item charset @var{set} | |
127 | Change character set slot designation. @xref{Character Processing}. | |
128 | -@item chdir @var{[directory]} | |
129 | +@item chdir [@var{directory}] | |
130 | Change the current directory for future windows. @xref{Chdir}. | |
131 | @item clear | |
132 | Clear the window screen. @xref{Clear}. | |
133 | @@ -835,13 +849,13 @@ | |
c122dd4c | 134 | Enter a @code{screen} command. @xref{Colon}. |
135 | @item command | |
136 | Simulate the screen escape key. @xref{Command Character}. | |
137 | -@item compacthist @var{[state]} | |
138 | +@item compacthist @var{state} | |
139 | Selects compaction of trailing empty lines. @xref{Scrollback}. | |
140 | -@item console @var{[state]} | |
141 | +@item console @var{state} | |
142 | Grab or ungrab console output. @xref{Console}. | |
143 | @item copy | |
144 | Enter copy mode. @xref{Copy}. | |
145 | -@item copy_reg @var{[key]} | |
146 | +@item copy_reg @var{key} | |
147 | Removed. Use @code{paste} instead. @xref{Registers}. | |
148 | @item crlf @var{state} | |
149 | Select line break behavior for copying. @xref{Line Termination}. | |
8ffc42de | 150 | @@ -851,11 +865,11 @@ |
151 | Select default autonuke behavior. @xref{Autonuke}. | |
152 | @item defbce @var{state} | |
153 | Select background color erase. @xref{Character Processing}. | |
154 | -@item defbreaktype @var{[tcsendbreak | TCSBRK | TIOCSBRK]} | |
155 | +@item defbreaktype [@var{tcsendbreak | TCSBRK | TIOCSBRK}] | |
156 | Specify the default for generating breaks. @xref{Break}. | |
157 | @item defc1 @var{state} | |
158 | Select default c1 processing behavior. @xref{Character Processing}. | |
159 | -@item defcharset @var{[set]} | |
160 | +@item defcharset [@var{set}] | |
161 | Change defaul character set slot designation. @xref{Character Processing}. | |
162 | @item defescape @var{xy} | |
163 | Set the default command and @code{meta} characters. @xref{Command Character}. | |
164 | @@ -863,7 +877,7 @@ | |
c122dd4c | 165 | Select default flow control behavior. @xref{Flow}. |
166 | @item defgr @var{state} | |
167 | Select default GR processing behavior. @xref{Character Processing}. | |
168 | -@item defhstatus @var{[status]} | |
169 | +@item defhstatus @var{status} | |
170 | Select default window hardstatus line. @xref{Hardstatus}. | |
171 | @item defkanji @var{wtype} | |
172 | Select default GR processing behavior. @xref{Character Processing}. | |
8ffc42de | 173 | @@ -889,7 +903,7 @@ |
c122dd4c | 174 | Set default line-wrapping behavior. @xref{Wrap}. |
175 | @item defwritelock @var{on|off|auto} | |
176 | Set default writelock behavior. @xref{Multiuser Session}. | |
177 | -@item defzombie @var{[keys]} | |
178 | +@item defzombie @var{keys} | |
179 | Keep dead windows. @xref{Zombie}. | |
180 | @item detach | |
181 | Disconnect @code{screen} from the terminal. @xref{Detach}. | |
8ffc42de | 182 | @@ -905,15 +919,15 @@ |
c122dd4c | 183 | Display a message on startup. @xref{Startup}. |
184 | @item escape @var{xy} | |
185 | Set the command and @code{meta} characters. @xref{Command Character}. | |
186 | -@item exec @var{[[fdpat] command [args ...]]} | |
187 | +@item exec @var{fdpat command args ...} | |
188 | Run a subprocess (filter). @xref{Exec}. | |
189 | @item fit | |
190 | Change window size to current display size. @xref{Window Size}. | |
191 | -@item flow @var{[fstate]} | |
192 | +@item flow @var{fstate} | |
193 | Set flow control behavior. @xref{Flow}. | |
194 | @item focus | |
195 | Move focus to next region. @xref{Regions}. | |
196 | -@item gr @var{[state]} | |
197 | +@item gr @var{state} | |
198 | Change GR charset processing. @xref{Character Processing}. | |
199 | @item hardcopy | |
200 | Write out the contents of the current window. @xref{Hardcopy}. | |
8ffc42de | 201 | @@ -921,9 +935,9 @@ |
c122dd4c | 202 | Append to hardcopy files. @xref{Hardcopy}. |
203 | @item hardcopydir @var{directory} | |
204 | Place, where to dump hardcopy files. @xref{Hardcopy}. | |
205 | -@item hardstatus @var{[state]} | |
8ffc42de | 206 | +@item hardstatus [@var{state}] |
c122dd4c | 207 | Use the hardware status line. @xref{Hardware Status Line}. |
8ffc42de | 208 | -@item height @var{[lines [cols]]} |
209 | +@item height [@var{lines} [@var{cols}]] | |
c122dd4c | 210 | Set display height. @xref{Window Size}. |
211 | @item help | |
212 | Display current key bindings. @xref{Help}. | |
8ffc42de | 213 | @@ -933,9 +947,9 @@ |
c122dd4c | 214 | Change the window's hardstatus line. @xref{Hardstatus}. |
215 | @item info | |
8ffc42de | 216 | Display window settings. @xref{Info}. |
c122dd4c | 217 | -@item ins_reg @var{[key]} |
8ffc42de | 218 | +@item ins_reg [@var{key}] |
c122dd4c | 219 | Removed, use @code{paste} instead. @xref{Registers}. |
220 | -@item kanji @var{wtype [dtype]} | |
8ffc42de | 221 | +@item kanji @var{wtype} [@var{dtype}] |
c122dd4c | 222 | Set the kanji type of a window. @xref{Character Processing}. |
223 | @item kill | |
224 | Destroy the current window. @xref{Kill}. | |
8ffc42de | 225 | @@ -945,13 +959,13 @@ |
226 | Display licensing information. @xref{Startup}. | |
227 | @item lockscreen | |
228 | Lock the controlling terminal. @xref{Lock}. | |
229 | -@item log @var{[state]} | |
230 | +@item log [@var{state}] | |
231 | Log all output in the current window. @xref{Log}. | |
c122dd4c | 232 | @item logfile @var{filename} |
233 | Place where to collect logfiles. @xref{Log}. | |
8ffc42de | 234 | -@item login @var{[state]} |
c122dd4c | 235 | -Log the window in @file{/etc/utmp}. @xref{Login}. |
8ffc42de | 236 | -@item logtstamp @var{[state]} |
237 | +@item login [@var{state}] | |
c122dd4c | 238 | +Log the window in @file{/var/run/utmp}. @xref{Login}. |
8ffc42de | 239 | +@item logtstamp [@var{state}] |
c122dd4c | 240 | Configure logfile time-stamps. @xref{Log}. |
241 | @item mapdefault | |
8ffc42de | 242 | Use only the default mapping table for the next keystroke. @xref{Bindkey Control}. |
243 | @@ -963,7 +977,7 @@ | |
c122dd4c | 244 | Rebind keys in copy mode. @xref{Copy Mode Keys}. |
245 | @item meta | |
246 | Insert the command character. @xref{Command Character}. | |
247 | -@item monitor @var{[state]} | |
248 | +@item monitor @var{state} | |
249 | Monitor activity in window. @xref{Monitor}. | |
250 | @item msgminwait @var{sec} | |
251 | Set minimum message wait. @xref{Message Wait}. | |
8ffc42de | 252 | @@ -977,9 +991,9 @@ |
c122dd4c | 253 | Switch to the next window. @xref{Selecting}. |
254 | @item nonblock @var{state} | |
255 | Disable flow control to the current display. @xref{Nonblock}. | |
256 | -@item number @var{[n]} | |
257 | +@item number @var{n} | |
258 | Change/display the current window's number. @xref{Number}. | |
259 | -@item obuflimit @var{[limit]} | |
260 | +@item obuflimit @var{limit} | |
261 | Select output buffer limit. @xref{Obuflimit}. | |
262 | @item only | |
263 | Kill all other regions. @xref{Regions}. | |
8ffc42de | 264 | @@ -987,29 +1001,29 @@ |
c122dd4c | 265 | Switch to the window you were in last. @xref{Selecting}. |
266 | @item partial @var{state} | |
267 | Set window to partial refresh. @xref{Redisplay}. | |
268 | -@item password @var{[crypted_pw]} | |
8ffc42de | 269 | +@item password [@var{crypted_pw}] |
c122dd4c | 270 | Set reattach password. @xref{Detach}. |
271 | -@item paste @var{[src_regs [dest_reg]]} | |
8ffc42de | 272 | +@item paste [@var{src_regs} [@var{dest_reg}]] |
c122dd4c | 273 | Paste contents of paste buffer or registers somewhere. @xref{Paste}. |
274 | -@item pastefont @var{[state]} | |
8ffc42de | 275 | +@item pastefont [@var{state}] |
c122dd4c | 276 | Include font information in the paste buffer. @xref{Paste}. |
277 | @item pow_break | |
278 | Close and Reopen the window's terminal. @xref{Break}. | |
279 | @item pow_detach | |
280 | Detach and hang up. @xref{Power Detach}. | |
281 | -@item pow_detach_msg @var{[message]} | |
8ffc42de | 282 | +@item pow_detach_msg [@var{message}] |
c122dd4c | 283 | Set message displayed on @code{pow_detach}. @xref{Power Detach}. |
284 | @item prev | |
285 | Switch to the previous window. @xref{Selecting}. | |
286 | -@item printcmd @var{[cmd]} | |
8ffc42de | 287 | +@item printcmd [@var{cmd}] |
c122dd4c | 288 | Set a command for VT100 printer port emulation. @xref{Printcmd}. |
289 | -@item process @var{[key]} | |
8ffc42de | 290 | +@item process [@var{key}] |
c122dd4c | 291 | Treat a register as input to @code{screen}. @xref{Registers}. |
292 | @item quit | |
293 | Kill all windows and exit. @xref{Quit}. | |
8ffc42de | 294 | -@item readbuf @var{[filename]} |
295 | +@item readbuf [@var{filename}] | |
c122dd4c | 296 | Read the paste buffer from the screen-exchange file. @xref{Screen-Exchange}. |
297 | -@item readreg @var{[reg [file]]} | |
8ffc42de | 298 | +@item readreg [@var{reg} [@var{file}]] |
c122dd4c | 299 | Load a register from paste buffer or file. @xref{Registers}. |
300 | @item redisplay | |
301 | Redisplay the current window. @xref{Redisplay}. | |
8ffc42de | 302 | @@ -1023,21 +1037,21 @@ |
c122dd4c | 303 | Reset the terminal settings for the window. @xref{Reset}. |
8ffc42de | 304 | @item resize [(+/-)lines] |
305 | Grow or shrink a region | |
c122dd4c | 306 | -@item screen @var{[opts] [n] [cmd [args]]} |
8ffc42de | 307 | +@item screen [@var{opts}] [@var{n}] [@var{cmd} [@var{args}]] |
c122dd4c | 308 | Create a new window. @xref{Screen Command}. |
309 | @item scrollback @var{num} | |
310 | Set size of scrollback buffer. @xref{Scrollback}. | |
311 | -@item select @var{[n]} | |
8ffc42de | 312 | +@item select [@var{n}] |
c122dd4c | 313 | Switch to a specified window. @xref{Selecting}. |
314 | -@item sessionname @var{[name]} | |
8ffc42de | 315 | +@item sessionname [@var{name}] |
c122dd4c | 316 | Name this session. @xref{Session Name}. |
317 | -@item setenv @var{[var [string]]} | |
8ffc42de | 318 | +@item setenv [@var{var} [@var{string}]] |
c122dd4c | 319 | Set an environment variable for new windows. @xref{Setenv}. |
320 | @item shell @var{command} | |
321 | Set the default program for new windows. @xref{Shell}. | |
322 | @item shelltitle @var{title} | |
323 | Set the default name for new windows. @xref{Shell}. | |
324 | -@item silence @var{[state|seconds]} | |
8ffc42de | 325 | +@item silence [@var{state|seconds}] |
c122dd4c | 326 | Monitor a window for inactivity. @xref{Silence}. |
327 | @item silencewait @var{seconds} | |
328 | Default timeout to trigger an inactivity notify. @xref{Silence}. | |
8ffc42de | 329 | @@ -1045,7 +1059,7 @@ |
c122dd4c | 330 | Pause during startup. @xref{Startup}. |
331 | @item slowpaste @var{msec} | |
332 | Slow down pasting in windows. @xref{Paste}. | |
333 | -@item sorendition @var{[attr [color]]} | |
334 | +@item sorendition @var{attr color} | |
335 | Change text highlighting. @xref{Sorendition}. | |
336 | @item split | |
337 | Split region into two parts. @xref{Regions}. | |
8ffc42de | 338 | @@ -1053,31 +1067,31 @@ |
c122dd4c | 339 | Display copyright notice on startup. @xref{Startup}. |
340 | @item stuff @var{string} | |
341 | Stuff a string in the input buffer of a window. @xref{Paste}. | |
342 | -@item su @var{[username [password [password2]]]} | |
8ffc42de | 343 | +@item su [@var{username} [@var{password} [@var{password2}]]] |
c122dd4c | 344 | Identify a user. @xref{Multiuser Session}. |
345 | @item suspend | |
346 | Put session in background. @xref{Suspend}. | |
347 | @item term @var{term} | |
348 | Set @code{$TERM} for new windows. @xref{Term}. | |
349 | -@item termcap @var{term terminal-tweaks [window-tweaks]} | |
8ffc42de | 350 | +@item termcap @var{term terminal-tweaks} [@var{window-tweaks}] |
c122dd4c | 351 | Tweak termcap entries for best performance. @xref{Termcap Syntax}. |
352 | -@item terminfo @var{term terminal-tweaks [window-tweaks]} | |
8ffc42de | 353 | +@item terminfo @var{term terminal-tweaks} [@var{window-tweaks}] |
c122dd4c | 354 | Ditto, for terminfo systems. @xref{Termcap Syntax}. |
355 | -@item termcapinfo @var{term terminal-tweaks [window-tweaks]} | |
8ffc42de | 356 | +@item termcapinfo @var{term terminal-tweaks} [@var{window-tweaks}] |
c122dd4c | 357 | Ditto, for both systems. @xref{Termcap Syntax}. |
358 | @item time | |
359 | Display time and load average. @xref{Time}. | |
360 | -@item title @var{[windowtitle]} | |
8ffc42de | 361 | +@item title [@var{windowtitle}] |
c122dd4c | 362 | Set the name of the current window. @xref{Title Command}. |
8ffc42de | 363 | -@item umask @var{[users]+/-bits ...} |
364 | +@item umask [@var{users}]+/-@var{bits} ... | |
c122dd4c | 365 | Synonym to @code{aclumask}. @xref{Umask}. |
366 | @item unsetenv @var{var} | |
367 | Unset environment variable for new windows. @xref{Setenv}. | |
8ffc42de | 368 | -@item utf8 @var{[state [dstate]]} |
369 | +@item utf8 [@var{state} [@var{dstate}]] | |
370 | Select character encoding of the current window. @xref{Character Processing}. | |
c122dd4c | 371 | -@item vbell @var{[state]} |
8ffc42de | 372 | +@item vbell [@var{state}] |
c122dd4c | 373 | Use visual bell. @xref{Bell}. |
374 | -@item vbell_msg @var{[message]} | |
8ffc42de | 375 | +@item vbell_msg [@var{message}] |
c122dd4c | 376 | Set vbell message. @xref{Bell}. |
377 | @item vbellwait @var{sec} | |
378 | Set delay for vbell message. @xref{Bell}. | |
8ffc42de | 379 | @@ -1085,13 +1099,13 @@ |
c122dd4c | 380 | Display @code{screen} version. @xref{Version}. |
381 | @item wall @var{message} | |
382 | Write a message to all displays. @xref{Multiuser Session}. | |
8ffc42de | 383 | -@item width @var{[cols [lines]]} |
384 | +@item width [@var{cols} [@var{lines}]] | |
c122dd4c | 385 | Set the width of the window. @xref{Window Size}. |
386 | @item windows | |
387 | List active windows. @xref{Windows}. | |
388 | -@item wrap @var{[state]} | |
8ffc42de | 389 | +@item wrap [@var{state}] |
c122dd4c | 390 | Control line-wrap behavior. @xref{Wrap}. |
8ffc42de | 391 | -@item writebuf @var{[filename]} |
392 | +@item writebuf [@var{filename}] | |
c122dd4c | 393 | Write paste buffer to screen-exchange file. @xref{Screen-Exchange}. |
8ffc42de | 394 | @item writelock @var{on|off|auto} |
395 | Grant exclusive write permission. @xref{Multiuser Session}. | |
396 | @@ -1099,7 +1113,7 @@ | |
c122dd4c | 397 | Send an XOFF character. @xref{XON/XOFF}. |
398 | @item xon | |
399 | Send an XON character. @xref{XON/XOFF}. | |
400 | -@item zombie @var{[keys]} | |
401 | +@item zombie @var{keys} | |
402 | Keep dead windows. @xref{Zombie}. | |
403 | @end table | |
404 | ||
8ffc42de | 405 | @@ -1472,13 +1486,12 @@ |
c122dd4c | 406 | @kindex C-x |
407 | @deffn Command lockscreen | |
408 | (@kbd{C-a x}, @kbd{C-a C-x})@* | |
409 | -Call a screenlock program (@file{/local/bin/lck} or @file{/usr/bin/lock} | |
410 | -or a builtin, if no other is available). Screen does not accept any | |
411 | -command keys until this program terminates. Meanwhile processes in the | |
412 | -windows may continue, as the windows are in the detached state. | |
413 | -The screenlock program may be changed through the environment variable | |
414 | -@code{$LOCKPRG} (which must be set in the shell from which @code{screen} | |
415 | -is started) and is executed with the user's uid and gid. | |
416 | +Call a screenlock program (@file{/usr/bin/lck} or a builtin, if no other is | |
417 | +available). Screen does not accept any command keys until this program | |
418 | +terminates. Meanwhile processes in the windows may continue, as the windows | |
419 | +are in the detached state. The screenlock program may be changed through the | |
420 | +environment variable @code{$LOCKPRG} (which must be set in the shell from | |
421 | +which @code{screen} is started) and is executed with the user's uid and gid. | |
422 | ||
423 | Warning: When you leave other shells unlocked and have no password set | |
424 | on @code{screen}, the lock is void: One could easily re-attach from an | |
8ffc42de | 425 | @@ -1570,7 +1583,7 @@ |
c122dd4c | 426 | |
427 | @node Aclgrp, Displays, Acldel, Multiuser Session | |
428 | @subsection Aclgrp | |
429 | -@deffn Command aclgrp @var{username [groupname]} | |
430 | +@deffn Command aclgrp @var{username groupname} | |
431 | (none)@* | |
432 | Creates groups of users that share common access rights. The | |
433 | name of the group is the username of the group leader. Each | |
8ffc42de | 434 | @@ -1594,8 +1607,8 @@ |
c122dd4c | 435 | |
436 | @node Umask, Wall, Displays, Multiuser Session | |
437 | @subsection aclumask | |
438 | -@deffn Command aclumask @var{[[users]+bits |[users]-bits .... ]} | |
439 | -@deffnx Command umask @var{[[users]+bits |[users]-bits .... ]} | |
440 | +@deffn Command aclumask @var{users+bits |users-bits .... } | |
441 | +@deffnx Command umask @var{users+bits |users-bits .... } | |
442 | (none)@* | |
443 | This specifies the access other users have to windows that | |
444 | will be created by the caller of the command. @var{Users} may be no, | |
8ffc42de | 445 | @@ -1642,7 +1655,7 @@ |
c122dd4c | 446 | |
447 | @node Su, , Writelock, Multiuser Session | |
448 | @subsection Su | |
449 | -@deffn Command su @var{[username [password [password2]]]} | |
450 | +@deffn Command su @var{username password password2} | |
451 | (none)@* | |
452 | Substitute the user of a display. The command prompts for | |
453 | all parameters that are omitted. If passwords are specified | |
8ffc42de | 454 | @@ -1660,7 +1673,7 @@ |
c122dd4c | 455 | |
456 | @node Session Name, Suspend, Multiuser Session, Session Management | |
457 | @section Session Name | |
458 | -@deffn Command sessionname @var{[name]} | |
459 | +@deffn Command sessionname @var{name} | |
460 | (none)@* | |
461 | Rename the current session. Note that for @code{screen -list} the name | |
462 | shows up with the process-id prepended. If the argument @var{name} is | |
8ffc42de | 463 | @@ -1756,7 +1769,7 @@ |
c122dd4c | 464 | |
8ffc42de | 465 | @node Resize, Caption, Remove, Regions |
466 | @section Resize | |
467 | -@deffn Command resize @var{[(+/-)lines]} | |
468 | +@deffn Command resize [(+/-)@var{lines}] | |
469 | (none)@* | |
470 | Resize the current region. The space will be removed from or added to | |
471 | the region below or if there's not enough space from the region above. | |
472 | @@ -1811,7 +1824,7 @@ | |
c122dd4c | 473 | * Naming Windows:: Control the name of the window |
474 | * Console:: See the host's console messages | |
475 | * Kill:: Destroy an unwanted window | |
476 | -* Login:: Control @file{/etc/utmp} logging | |
477 | +* Login:: Control @file{/var/run/utmp} logging | |
478 | * Mode:: Control the file mode of the pty | |
479 | * Monitor:: Watch for activity in a window | |
480 | * Windows:: List the active windows | |
8ffc42de | 481 | @@ -1975,7 +1988,7 @@ |
c122dd4c | 482 | |
483 | @node Console, Kill, Naming Windows, Window Settings | |
484 | @section Console | |
485 | -@deffn Command console @var{[state]} | |
486 | +@deffn Command console @var{state} | |
487 | (none)@* | |
488 | Grabs or un-grabs the machines console output to a window. When the argument | |
489 | is omitted the current state is displayed. | |
8ffc42de | 490 | @@ -2020,7 +2033,7 @@ |
c122dd4c | 491 | @kindex L |
492 | @deffn Command login [state] | |
493 | (@kbd{C-a L})@* | |
494 | -Adds or removes the entry in @file{/etc/utmp} for the current window. | |
495 | +Adds or removes the entry in @file{/var/run/utmp} for the current window. | |
496 | This controls whether or not the window is @dfn{logged in}. In addition | |
497 | to this toggle, it is convenient to have ``log in'' and ``log out'' | |
498 | keys. For instance, @code{bind I login on} and @code{bind O | |
8ffc42de | 499 | @@ -3097,7 +3110,7 @@ |
c122dd4c | 500 | |
501 | @node Exec, Using Exec, , Subprocess Execution | |
502 | @section Exec | |
503 | -@deffn Command exec @var{[[fdpat] newcommand [args ... ]]} | |
504 | +@deffn Command exec @var{fdpat newcommand args ... } | |
505 | (none)@* | |
506 | Run a unix subprocess (specified by an executable path @var{newcommand} and | |
507 | its optional arguments) in the current window. The flow of data between | |
8ffc42de | 508 | @@ -3306,7 +3319,7 @@ |
c122dd4c | 509 | |
510 | @node Bindkey, Bindkey Examples, Help, Key Binding | |
511 | @section Bindkey | |
512 | -@deffn Command bindkey @var{[opts] [string [cmd args]]} | |
8ffc42de | 513 | +@deffn Command bindkey [@var{opts}] [@var{string} [@var{cmd args}]] |
c122dd4c | 514 | (none)@* |
515 | This command manages screen's input translation tables. Every | |
516 | entry in one of the tables tells screen how to react if a certain | |
8ffc42de | 517 | @@ -3851,7 +3864,7 @@ |
c122dd4c | 518 | |
519 | @node Obuflimit, Character Translation, Autonuke, Termcap | |
520 | @section Obuflimit | |
521 | -@deffn Command obuflimit @var{[limit]} | |
522 | +@deffn Command obuflimit @var{limit} | |
523 | (none)@* | |
524 | If the output buffer contains more bytes than the specified limit, no | |
525 | more data will be read from the windows. The default value is 256. If | |
8ffc42de | 526 | @@ -4290,7 +4303,7 @@ |
c122dd4c | 527 | @node Number, Silence, Nonblock, Miscellaneous |
528 | @section Number | |
529 | @kindex N | |
530 | -@deffn Command number @var{[n]} | |
531 | +@deffn Command number @var{n} | |
532 | (@kbd{C-a N})@* | |
533 | Change the current window's number. If the given number @var{n} is already | |
534 | used by another window, both windows exchange their numbers. If no argument is | |
8ffc42de | 535 | @@ -4299,7 +4312,7 @@ |
c122dd4c | 536 | |
537 | @node Silence, Time, Number, Miscellaneous | |
538 | @section Silence | |
539 | -@deffn Command silence @var{[state|sec]} | |
540 | +@deffn Command silence @var{state|sec} | |
541 | (none)@* | |
542 | Toggles silence monitoring of windows. When silence is turned on and an | |
543 | affected window is switched into the background, you will receive the | |
8ffc42de | 544 | @@ -4350,8 +4363,8 @@ |
c122dd4c | 545 | |
546 | @node Zombie, Printcmd, Version, Miscellaneous | |
547 | @section Zombie | |
548 | -@deffn Command zombie @var{[keys]} | |
549 | -@deffnx Command defzombie @var{[keys]} | |
550 | +@deffn Command zombie @var{keys} | |
551 | +@deffnx Command defzombie @var{keys} | |
552 | (none)@* | |
553 | Per default windows are removed from the window list as soon as the | |
554 | windows process (e.g. shell) exits. When a string of two keys is | |
8ffc42de | 555 | @@ -4370,7 +4383,7 @@ |
c122dd4c | 556 | |
557 | @node Printcmd, Sorendition, Zombie, Miscellaneous | |
558 | @section Printcmd | |
559 | -@deffn Command printcmd @var{[cmd]} | |
560 | +@deffn Command printcmd @var{cmd} | |
561 | (none)@* | |
562 | If @var{cmd} is not an empty string, screen will not use the terminal | |
563 | capabilities @code{po/pf} for printing if it detects an ansi print | |
8ffc42de | 564 | @@ -4386,7 +4399,7 @@ |
c122dd4c | 565 | |
8ffc42de | 566 | @node Sorendition, Attrcolor, Printcmd, Miscellaneous |
c122dd4c | 567 | @section Sorendition |
568 | -@deffn Command sorendition @var{[attr [color]]} | |
569 | +@deffn Command sorendition @var{attr color} | |
570 | (none)@* | |
571 | Change the way screen does highlighting for text marking and printing | |
572 | messages. | |
8ffc42de | 573 | @@ -4398,7 +4411,7 @@ |
574 | ||
575 | @node Attrcolor, , Sorendition, Miscellaneous | |
576 | @section Attrcolor | |
577 | -@deffn Command attrcolor @var{attrib [attribute/color-modifier]} | |
578 | +@deffn Command attrcolor @var{attrib} [@var{attribute/color-modifier}] | |
579 | (none)@* | |
580 | This command can be used to highlight attributes by changing the color of | |
581 | the text. If the attribute | |
582 | @@ -4621,22 +4634,19 @@ | |
c122dd4c | 583 | global initialization files. |
584 | ||
585 | @item @code{$SYSSCREENRC} | |
586 | -@itemx /local/etc/screenrc | |
587 | +@itemx /etc/screenrc | |
588 | @code{screen} initialization commands | |
589 | ||
590 | @item @code{$SCREENRC} | |
591 | @itemx @code{$HOME}/.iscreenrc | |
592 | @itemx @code{$HOME}/.screenrc | |
593 | -Read in after /local/etc/screenrc | |
594 | +Read in after /etc/screenrc | |
595 | ||
596 | @item @code{$SCREENDIR}/S-@var{login} | |
597 | ||
598 | -@item /local/screens/S-@var{login} | |
599 | +@item /tmp/screens/S-@var{login} | |
600 | Socket directories (default) | |
601 | ||
602 | -@item /usr/tmp/screens/S-@var{login} | |
603 | -Alternate socket directories. | |
604 | - | |
605 | @item @var{socket directory}/.termcap | |
606 | Written by the @code{dumptermcap} command | |
607 | ||
8ffc42de | 608 | @@ -4654,7 +4664,7 @@ |
c122dd4c | 609 | @itemx /etc/termcap |
610 | Terminal capability databases | |
611 | ||
612 | -@item /etc/utmp | |
613 | +@item /var/run/utmp | |
614 | Login records | |
615 | ||
616 | @item @code{$LOCKPRG} | |
8ffc42de | 617 | @@ -4757,10 +4767,10 @@ |
c122dd4c | 618 | in order to be able to |
619 | correctly change the owner of the tty device file for each window. | |
620 | Special permission may also be required to write the file | |
621 | -@file{/etc/utmp}. | |
622 | +@file{/var/run/utmp}. | |
623 | ||
624 | @item | |
625 | -Entries in @file{/etc/utmp} are not removed when @code{screen} is killed | |
626 | +Entries in @file{/var/run/utmp} are not removed when @code{screen} is killed | |
627 | with SIGKILL. This will cause some programs (like "w" or "rwho") to | |
628 | advertise that a user is logged on who really isn't. | |
629 | ||
8ffc42de | 630 | @@ -4841,8 +4851,7 @@ |
c122dd4c | 631 | @cindex socket directory |
632 | ||
633 | The socket directory defaults either to @file{$HOME/.screen} or simply to | |
634 | -@file{/tmp/screens} or preferably to @file{/usr/local/screens} chosen at | |
635 | -compile-time. If @code{screen} is installed | |
8ffc42de | 636 | +@file{/tmp/screens} chosen at compile-time. If @code{screen} is installed |
c122dd4c | 637 | setuid root, then the administrator should compile screen with an |
638 | adequate (not NFS mounted) @code{SOCKDIR}. If @code{screen} is not | |
639 | running setuid-root, the user can specify any mode 700 directory in the |