summaryrefslogtreecommitdiff
path: root/doc/screen.info-4
blob: f466b1ae46b2343258d2f7dcee3ecf805ff337b9 (plain)
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
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 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: 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 latest beta testing release of `screen' is available from
`ftp.uni-erlangen.de (131.188.1.43)', in the directory
`pub/utilities/screen'.


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 777 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 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.
* 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.
* 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.
* activity:                             Monitor.
* allpartial:                           Redisplay.
* at:                                   At.
* autodetach:                           Detach.
* autonuke:                             Autonuke.
* bell_msg:                             Bell.
* bind:                                 Bind.
* bindkey:                              Bindkey.
* break:                                Break.
* bufferfile:                           Screen-Exchange.
* c1:                                   Character Processing.
* 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.
* 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.
* defwrap:                              Wrap.
* defwritelock:                         Writelock.
* defzombie:                            Zombie.
* detach:                               Detach.
* digraph:                              Digraph.
* dumptermcap:                          Dump Termcap.
* echo:                                 echo.
* escape:                               Command Character.
* exec:                                 Exec.
* flow:                                 Flow.
* 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.
* number:                               Number.
* obuflimit:                            Obuflimit.
* other:                                Other Window.
* partial:                              Redisplay.
* password:                             Detach.
* paste:                                Paste.
* pastefont:                            Paste.
* pow_break:                            Break.
* pow_detach:                           Power Detach.
* pow_detach_msg:                       Power Detach.
* prev:                                 Next and Previous.
* printcmd:                             Printcmd.
* process:                              Registers.
* quit:                                 Quit.
* readbuf:                              Screen-Exchange.
* readreg:                              Paste.
* redisplay:                            Redisplay.
* register:                             Registers.
* 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.
* startup_message:                      Startup Message.
* stuff:                                Registers.
* suspend:                              Suspend.
* term:                                 Term.
* termcap:                              Termcap Syntax.
* termcapinfo:                          Termcap Syntax.
* terminfo:                             Termcap Syntax.
* time:                                 Time.
* title:                                Title Command.
* unsetenv:                             Setenv.
* vbell:                                Bell.
* vbellwait:                            Bell.
* vbell_msg:                            Bell.
* 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.
* .:                                    Dump Termcap.
* 0...9:                                Select.
* ::                                    Colon.
* <:                                    Screen-Exchange.
* =:                                    Screen-Exchange.
* >:                                    Screen-Exchange.
* ?:                                    Help.
* {:                                    History.
* a:                                    Command Character.
* A:                                    Title Command.
* c:                                    Screen Command.
* C:                                    Clear.
* 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:                                    Power Detach.
* d:                                    Detach.
* ESC:                                  Copy.
* f:                                    Flow.
* H:                                    Log.
* h:                                    Hardcopy.
* i:                                    Info.
* k:                                    Kill.
* L:                                    Login.
* l:                                    Redisplay.
* m:                                    Last Message.
* M:                                    Monitor.
* N:                                    Number.
* n:                                    Next and Previous.
* p:                                    Next and Previous.
* q:                                    XON/XOFF.
* r:                                    Wrap.
* s:                                    XON/XOFF.
* SPC:                                  Next and Previous.
* t:                                    Time.
* v:                                    Version.
* w:                                    Windows.
* W:                                    Window Size.
* x:                                    Lock.
* Z:                                    Reset.
* z:                                    Suspend.
* [:                                    Copy.
* ]:                                    Paste.