← Back to branch summary

~ubuntu-branches/ubuntu/trusty/screen/trusty-backports

« back to all changes in this revision

Viewing changes to doc/screen.texinfo

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2007-10-23 17:36:30 UTC
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20071023173630-6q4agogsxuzujhwd
Tags: 4.0.3-7ubuntu1
* Merge with Debian; remaining Ubuntu changes:
  - 07_norootpassword.dpatch: When locking a root-owned screen, check that
    root has a password set. If not, ask for an unlocking key. (LP#6760)
  - debian/preinst: Remove obsolete init script 'screen' on
    upgrades. The script is called 'screen-cleanup' in Debian and thus
    should be called the same in Ubuntu to avoid a permanent and pointless
    delta. This needs to be kept until after the next LTS.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/screen.texinfo
176
176
variable) who will use it to create the new window.  The above example would 
177
177
start the @code{emacs} editor (editing @file{prog.c}) and switch to its window.
178
178
 
179
 
If @file{/var/run/utmp} is writable by @code{screen}, an appropriate record
 
179
If @file{/etc/utmp} is writable by @code{screen}, an appropriate record
180
180
will be written to this file for each window, and removed when the
181
181
window is closed.  This is useful for working with @code{talk},
182
182
@code{script}, @code{shutdown}, @code{rsend}, @code{sccs} and other
305
305
 
306
306
@item -l
307
307
@itemx -ln
308
 
Turn login mode on or off (for @file{/var/run/utmp} updating).  This option
 
308
Turn login mode on or off (for @file{/etc/utmp} updating).  This option
309
309
is equivalent to the @code{deflogin} command (@pxref{Login}).
310
310
 
311
311
@item -ls [@var{match}]
447
447
@cindex screenrc
448
448
When @code{screen} is invoked, it executes initialization commands from
449
449
the files @file{.screenrc} in the user's home directory and
450
 
@file{/etc/screenrc}.  These defaults can be overridden in the 
 
450
@file{/usr/local/etc/screenrc}.  These defaults can be overridden in the 
451
451
following ways:
452
452
For the global screenrc file @code{screen} searches for the environment
453
453
variable @code{$SYSSCREENRC} (this override feature may be disabled at
997
997
@item logfile @var{filename}
998
998
Place where to collect logfiles.  @xref{Log}.
999
999
@item login [@var{state}]
1000
 
Log the window in @file{/var/run/utmp}.  @xref{Login}.
 
1000
Log the window in @file{/etc/utmp}.  @xref{Login}.
1001
1001
@item logtstamp [@var{state}]
1002
1002
Configure logfile time-stamps.  @xref{Log}.
1003
1003
@item mapdefault
1900
1900
* Naming Windows::              Control the name of the window
1901
1901
* Console::                     See the host's console messages
1902
1902
* Kill::                        Destroy an unwanted window
1903
 
* Login::                       Control @file{/var/run/utmp} logging
 
1903
* Login::                       Control @file{/etc/utmp} logging
1904
1904
* Mode::                        Control the file mode of the pty
1905
1905
* Monitor::                     Watch for activity in a window
1906
1906
* Windows::                     List the active windows
2109
2109
@kindex L
2110
2110
@deffn Command login [state]
2111
2111
(@kbd{C-a L})@*
2112
 
Adds or removes the entry in @file{/var/run/utmp} for the current window.
 
2112
Adds or removes the entry in @file{/etc/utmp} for the current window.
2113
2113
This controls whether or not the window is @dfn{logged in}.  In addition
2114
2114
to this toggle, it is convenient to have ``log in'' and ``log out''
2115
2115
keys.  For instance, @code{bind I login on} and @code{bind O 
4962
4962
global initialization files.
4963
4963
 
4964
4964
@item @code{$SYSSCREENRC}
4965
 
@itemx /etc/screenrc
 
4965
@itemx /local/etc/screenrc
4966
4966
@code{screen} initialization commands
4967
4967
 
4968
4968
@item @code{$SCREENRC}
4969
4969
@itemx @code{$HOME}/.iscreenrc
4970
4970
@itemx @code{$HOME}/.screenrc
4971
 
Read in after /etc/screenrc
 
4971
Read in after /local/etc/screenrc
4972
4972
 
4973
4973
@item @code{$SCREENDIR}/S-@var{login}
4974
4974
 
4975
 
@item /var/run/screen/S-@var{login}
 
4975
@item /local/screens/S-@var{login}
4976
4976
Socket directories (default)
4977
4977
 
4978
4978
@item /usr/tmp/screens/S-@var{login}
4995
4995
@itemx /etc/termcap
4996
4996
Terminal capability databases
4997
4997
 
4998
 
@item /var/run/utmp
 
4998
@item /etc/utmp
4999
4999
Login records
5000
5000
 
5001
5001
@item @code{$LOCKPRG}
5100
5100
in order to be able to
5101
5101
correctly change the owner of the tty device file for each window.
5102
5102
Special permission may also be required to write the file
5103
 
@file{/var/run/utmp}.
 
5103
@file{/etc/utmp}.
5104
5104
 
5105
5105
@item
5106
 
Entries in @file{/var/run/utmp} are not removed when @code{screen} is killed
 
5106
Entries in @file{/etc/utmp} are not removed when @code{screen} is killed
5107
5107
with SIGKILL.  This will cause some programs (like "w" or "rwho") to
5108
5108
advertise that a user is logged on who really isn't.
5109
5109
 
5184
5184
@cindex socket directory
5185
5185
 
5186
5186
The socket directory defaults either to @file{$HOME/.screen} or simply to 
5187
 
@file{/tmp/screens} or preferably to @file{/var/run/screen} chosen at 
 
5187
@file{/tmp/screens} or preferably to @file{/usr/local/screens} chosen at 
5188
5188
compile-time. If @code{screen} is installed
5189
5189
setuid root, then the administrator should compile screen with an
5190
5190
adequate (not NFS mounted) @code{SOCKDIR}. If @code{screen} is not