1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
|
This is Info file screen.info, produced by Makeinfo-1.55 from the input
file ./screen.texinfo.
This file documents the `Screen' virtual terminal manager.
Copyright (c) 1993-1995 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of
this manual under the conditions for verbatim copying, provided that
the entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be stated in a
translation approved by the Foundation.
File: screen.info, Node: Credits, Next: Bugs, Prev: Files, Up: Top
Credits
*******
Authors
=======
Originally created by Oliver Laumann, this
latest version was produced by Wayne Davison, Juergen Weigert and
Michael Schroeder.
Contributors
============
Ken Beal (kbeal@amber.ssd.csd.harris.com),
Rudolf Koenig (rfkoenig@informatik.uni-erlangen.de),
Toerless Eckert (eckert@informatik.uni-erlangen.de),
Wayne Davison (davison@borland.com),
Patrick Wolfe (pat@kai.com, kailand!pat),
Bart Schaefer (schaefer@cse.ogi.edu),
Nathan Glasser (nathan@brokaw.lcs.mit.edu),
Larry W. Virden (lvirden@cas.org),
Howard Chu (hyc@hanauma.jpl.nasa.gov),
Tim MacKenzie (tym@dibbler.cs.monash.edu.au),
Markku Jarvinen (mta@{cc,cs,ee}.tut.fi),
Marc Boucher (marc@CAM.ORG),
Doug Siebert (dsiebert@isca.uiowa.edu),
Ken Stillson (stillson@tsfsrv.mitre.org),
Ian Frechett (frechett@spot.Colorado.EDU),
Brian Koehmstedt (bpk@gnu.ai.mit.edu),
Don Smith (djs6015@ultb.isc.rit.edu),
Frank van der Linden (vdlinden@fwi.uva.nl),
Martin Schweikert (schweik@cpp.ob.open.de),
David Vrona (dave@sashimi.lcu.com),
E. Tye McQueen (tye%spillman.UUCP@uunet.uu.net),
Matthew Green (mrg@mame.mu.oz.au),
Christopher Williams (cgw@unt.edu),
Matt Mosley (mattm@access.digex.net),
Gregory Neil Shapiro (gshapiro@wpi.WPI.EDU),
Jason Merrill (jason@jarthur.Claremont.EDU).
Version
=======
This manual describes version 3.8.0 of the
`screen' program. Its roots are a merge of a custom version 2.3PR7 by
Wayne Davison and several enhancements to Oliver Laumann's version 2.0.
Note that all versions numbered 2.x are copyright by Oliver Laumann.
See also *Note Availability::.
File: screen.info, Node: Bugs, Next: Installation, Prev: Credits, Up: Top
Bugs
****
Just like any other significant piece of
software, `screen' has a few bugs and missing features. Please send in
a bug report if you have found a bug not mentioned here.
* Menu:
* Known Bugs:: Problems we know about.
* Reporting Bugs:: How to contact the maintainers.
* Availability:: Where to find the lastest screen version.
File: screen.info, Node: Known Bugs, Next: Reporting Bugs, Up: Bugs
Known Bugs
==========
* `dm' (delete mode) and `xs' are not handled
correctly (they are ignored). `xn' is treated
as a magic-margin indicator.
* `screen' has no clue about double-high or
double-wide characters. But this is the only
area where `vttest' is allowed to fail.
* It is not possible to change the environment
variable `$TERMCAP' when reattaching under a
different terminal type.
* The support of terminfo based systems is very
limited. Adding extra capabilities to
`$TERMCAP' may not have any effects.
* `screen' does not make use of hardware tabs.
* `screen' must be installed setuid root in
order to be able to correctly change the owner
of the tty device file for each window.
Special permission may also be required to
write the file `/etc/utmp'.
* Entries in `/etc/utmp' are not removed when
`screen' is killed with SIGKILL. This will
cause some programs (like "w" or "rwho") to
advertise that a user is logged on who really
isn't.
* `screen' may give a strange warning when your
tty has no utmp entry.
* When the modem line was hung up, `screen' may
not automatically detach (or quit) unless the
device driver sends a HANGUP signal. To detach
such a `screen' session use the -D or -d
command line option.
* If a password is set, the command line options
-d and -D still detach a session without
asking.
* Read permission on windows is never checked
for. All users that can attach to the session
can read window contents.
* Both `breaktype' and `defbreaktype' change the
break generating method used by all terminal
devices. The first should change a window
specific setting, where the latter should
change only the default for new windows.
* When attaching to a multiuser session, the
user's `.screenrc' file is not sourced. Each
users personal settings have to be included in
the `.screenrc' file from which the session is
booted, or have to be changed manually.
* A weird imagination is most useful to gain
full advantage of all the features.
File: screen.info, Node: Reporting Bugs, Next: Availability, Prev: Known Bugs, Up: Bugs
Reporting Bugs
==============
If you find a bug in `Screen', please send
electronic mail to `screen@uni-erlangen.de', and also to
`bug-gnu-utils@prep.ai.mit.edu'. Include the version number of
`Screen' which you are using. Also include in your message the
hardware and operating system, the compiler used to compile, a
description of the bug behavior, and the conditions that triggered the
bug. Please recompile `screen' with the `-DDEBUG -DTMPTEST' options
enabled, reproduce the bug, and have a look at the debug output written
to the directory `/tmp/debug'. If necessary quote suspect passages from
the debug output and show the contents of your `config.h' if it matters.
File: screen.info, Node: Availability, Prev: Reporting Bugs, Up: Bugs
Availability
============
`Screen' is available under the `GNU' copyleft.
The latest official release of `screen'
available via anonymous ftp from `prep.ai.mit.edu', `nic.funet.fi' or
any other `GNU' distribution site. The home site of `screen' is
`ftp.uni-erlangen.de (131.188.1.43)', in the directory
`pub/utilities/screen'. The subdirectory `private' contains the latest
beta testing release. If you want to help, send a note to
screen@uni-erlangen.de.
File: screen.info, Node: Installation, Next: Concept Index, Prev: Bugs, Up: Top
Installation
************
Since `screen' uses pseudo-ttys, the select
system call, and UNIX-domain sockets/named pipes, it will not run under
a system that does not include these features of 4.2 and 4.3 BSD UNIX.
* Menu:
* Socket Directory:: Where screen stores its handle.
* Compiling Screen::
File: screen.info, Node: Socket Directory, Next: Compiling Screen, Up: Installation
Socket Directory
================
The socket directory defaults either to
`$HOME/.screen' or simply to `/tmp/screens' or preferably to
`/usr/local/screens' chosen at compile-time. If `screen' is installed
setuid root, then the administrator should compile screen with an
adequate (not NFS mounted) `SOCKDIR'. If `screen' is not running
setuid-root, the user can specify any mode 700 directory in the
environment variable `$SCREENDIR'.
File: screen.info, Node: Compiling Screen, Prev: Socket Directory, Up: Installation
Compiling Screen
================
To compile and install screen:
The `screen' package comes with a `GNU Autoconf'
configuration script. Before you compile the package run
`sh ./configure'
This will create a `config.h' and `Makefile' for
your machine. If `configure' fails for some reason, then look at the
examples and comments found in the `Makefile.in' and `config.h.in'
templates. Rename `config.status' to `config.status.MACHINE' when you
want to keep configuration data for multiple architectures. Running `sh
./config.status.MACHINE' recreates your configuration significantly
faster than rerunning `configure'.
Read through the "User Configuration" section of
`config.h', and verify that it suits your needs. A comment near the
top of this section explains why it's best to install screen setuid to
root. Check for the place for the global `screenrc'-file and for the
socket directory.
Check the compiler used in `Makefile', the prefix
path where to install `screen'. Then run
`make'
If `make' fails to produce one of the files
`term.h', `comm.h' or `tty.c', then use `FILENAME.X.dist' instead. For
additional information about installation of `screen' refer to the file
`INSTALLATION', coming with this package.
File: screen.info, Node: Concept Index, Next: Command Index, Prev: Installation, Up: Top
Concept Index
*************
* Menu:
* .screenrc: Startup Files.
* availability: Availability.
* binding: Key Binding.
* bug report: Reporting Bugs.
* bugs: Bugs.
* capabilities: Special Capabilities.
* Command Character: Command Character.
* command line options: Invoking Screen.
* command summary: Command Summary.
* compiling screen: Compiling Screen.
* control sequences: Control Sequences.
* copy and paste: Copy and Paste.
* customization: Customization.
* environment: Environment.
* Escape Character: Command Character.
* files: Files.
* flow control: Flow Control.
* input translation: Input Translation.
* installation: Installation.
* introduction: Getting Started.
* invoking: Invoking Screen.
* key binding: Key Binding.
* marking: Copy.
* message line: Message Line.
* multiuser session: Multiuser Session.
* options: Invoking Screen.
* overview: Overview.
* regions: Regions.
* screenrc: Startup Files.
* scrollback: Copy.
* socket directory: Socket Directory.
* terminal capabilities: Special Capabilities.
* title: Naming Windows.
File: screen.info, Node: Command Index, Next: Keystroke Index, Prev: Concept Index, Up: Top
Command Index
*************
This is a list of all the commands supported by
`screen'.
* Menu:
* acladd: Acladd.
* aclchg: Aclchg.
* acldel: Acldel.
* aclgrp: Aclgrp.
* aclumask: Umask.
* activity: Monitor.
* addacl: Acladd.
* allpartial: Redisplay.
* at: At.
* autodetach: Detach.
* autonuke: Autonuke.
* bell_msg: Bell.
* bind: Bind.
* bindkey: Bindkey.
* break: Break.
* breaktype: Break.
* bufferfile: Screen-Exchange.
* c1: Character Processing.
* chacl: Aclchg.
* charset: Character Processing.
* chdir: Chdir.
* clear: Clear.
* colon: Colon.
* command: Command Character.
* console: Console.
* copy: Copy.
* copy_reg: Registers.
* crlf: Line Termination.
* debug: Debug.
* defautonuke: Autonuke.
* defbreaktype: Break.
* defc1: Character Processing.
* defcharset: Character Processing.
* defescape: Command Character.
* defflow: Flow.
* defgr: Character Processing.
* defhstatus: Hardstatus.
* defkanji: Character Processing.
* deflogin: Login.
* defmode: Mode.
* defmonitor: Monitor.
* defobuflimit: Obuflimit.
* defscrollback: Scrollback.
* defshell: Shell.
* defsilence: Silence.
* defslowpaste: Paste.
* defwrap: Wrap.
* defwritelock: Writelock.
* defzombie: Zombie.
* detach: Detach.
* digraph: Digraph.
* displays: Displays.
* dumptermcap: Dump Termcap.
* echo: echo.
* escape: Command Character.
* exec: Exec.
* flow: Flow.
* focus: Focus.
* gr: Character Processing.
* hardcopy: Hardcopy.
* hardcopydir: Hardcopy.
* hardcopy_append: Hardcopy.
* hardstatus: Hardware Status Line.
* height: Window Size.
* help: Help.
* history: History.
* info: Info.
* ins_reg: Registers.
* kanji: Character Processing.
* kill: Kill.
* lastmsg: Last Message.
* license: License.
* lockscreen: Lock.
* log: Log.
* logfile: Log.
* login: Login.
* mapdefault: Bindkey Control.
* mapnotnext: Bindkey Control.
* maptimeout: Bindkey Control.
* markkeys: Copy Mode Keys.
* meta: Command Character.
* monitor: Monitor.
* msgminwait: Message Wait.
* msgwait: Message Wait.
* multiuser: Multiuser.
* nethack: Nethack.
* next: Next and Previous.
* nonblock: Nonblock.
* number: Number.
* obuflimit: Obuflimit.
* one: One.
* other: Other Window.
* partial: Redisplay.
* password: Detach.
* paste: Paste.
* pastefont: Paste.
* pow_break: Break.
* pow_detach: Power Detach.
* pow_detach_msg: Power Detach.
* preselect: Select.
* prev: Next and Previous.
* printcmd: Printcmd.
* process: Registers.
* quit: Quit.
* readbuf: Screen-Exchange.
* readreg: Paste.
* redisplay: Redisplay.
* register: Registers.
* remove: Remove.
* removebuf: Screen-Exchange.
* reset: Reset.
* screen: Screen Command.
* scrollback: Scrollback.
* select: Select.
* sessionname: Session Name.
* setenv: Setenv.
* shell: Shell.
* shelltitle: Shell.
* silence: Silence.
* silencewait: Silence.
* sleep: sleep.
* slowpaste: Paste.
* sorendition: Sorendition.
* split: Split.
* startup_message: Startup Message.
* stuff: Registers.
* su: Su.
* suspend: Suspend.
* term: Term.
* termcap: Termcap Syntax.
* termcapinfo: Termcap Syntax.
* terminfo: Termcap Syntax.
* time: Time.
* title: Title Command.
* umask: Umask.
* unsetenv: Setenv.
* vbell: Bell.
* vbellwait: Bell.
* vbell_msg: Bell.
* verbose: Verbose.
* version: Version.
* wall: Wall.
* width: Window Size.
* windows: Windows.
* wrap: Wrap.
* writebuf: Screen-Exchange.
* writelock: Writelock.
* xoff: XON/XOFF.
* xon: XON/XOFF.
* zombie: Zombie.
File: screen.info, Node: Keystroke Index, Prev: Command Index, Up: Top
Keystroke Index
***************
This is a list of the default key bindings.
The leading escape character (*note Command
Character::.) has been omitted from the key sequences, since it is the
same for all bindings.
* Menu:
* ": Select.
* ': Select.
* *: Displays.
* .: Dump Termcap.
* 0...9: Select.
* :: Colon.
* <: Screen-Exchange.
* =: Screen-Exchange.
* >: Screen-Exchange.
* ?: Help.
* {: History.
* A: Title Command.
* a: Command Character.
* C: Clear.
* c: Screen Command.
* C-a: Other Window.
* C-c: Screen Command.
* C-d: Detach.
* C-f: Flow.
* C-g: Bell.
* C-h: Hardcopy.
* C-i: Info.
* C-k: Kill.
* C-l: Redisplay.
* C-m: Last Message.
* C-n: Next and Previous.
* C-p: Next and Previous.
* C-q: XON/XOFF.
* C-r: Wrap.
* C-s: XON/XOFF.
* C-t: Time.
* C-v: Digraph.
* C-w: Windows.
* C-x: Lock.
* C-z: Suspend.
* C-[: Copy.
* C-\: Quit.
* C-]: Paste.
* d: Detach.
* D: Power Detach.
* ESC: Copy.
* F: Focus.
* f: Flow.
* h: Hardcopy.
* H: Log.
* i: Info.
* k: Kill.
* L: Login.
* l: Redisplay.
* M: Monitor.
* m: Last Message.
* n: Next and Previous.
* N: Number.
* p: Next and Previous.
* q: XON/XOFF.
* Q: One.
* r: Wrap.
* s: XON/XOFF.
* S: Split.
* SPC: Next and Previous.
* t: Time.
* v: Version.
* W: Window Size.
* w: Windows.
* x: Lock.
* X: Remove.
* z: Suspend.
* Z: Reset.
* [: Copy.
* ]: Paste.
|
