Screen has the following command-line options:
screenmust redraw parts of the display in order to implement a function.
screenmay try to restore its old window sizes when attaching to resizable terminals (those with `WS' in their descriptions, e.g.
suncmdor some varieties of
screen, but instead detach a
screensession running elsewhere (see section Detach). `-d' has the same effect as typing C-a d from the controlling terminal for the session. `-D' is the equivalent to the power detach key. If no session can be detached, this option is ignored. The combination
screen -D -rcan be used to log out from a remote terminal and transport the session running there to your current terminal. Note: It is a good idea to check the status of your sessions with
screen -listbefore using this option.
screensession, this option sets the default command caracter. In a multiuser session all users added will start off with this command character. But when attaching to an already running session, this option only changes the command character of the attaching user. This option is equivalent to the commands
escaperespectively. (see section Command Character).
defflowcommand (see section Flow Control).
defscrollbackcommand (see section Copying).
interruptargument to the
defflowcommand (see section Flow Control). Its use is discouraged.
deflogincommand (see section Login).
screen, but instead print a list of session identification strings (usually of the form pid.tty.host; see section Session Name). Sessions marked `detached' can be resumed with
screen -r. Those marked `attached' are running and have a controlling terminal. Sessions marked as `dead' should be thoroughly checked and removed. Ask your system administrator if you are not sure why they died. Remove sessions with the `-wipe' option.
screenthat your auto-margin terminal allows programs to write to the last column of the last row of the screen without scrolling. This can also be set in your `.screenrc' by specifying `xn' in a
termcapcommand (see section Termcap).
screento ignore the
$STYenvironment variable. When this option is used, a new session will always be created, regardless of whether
screenis being called from within another
screensession or not.
screensession. No other options (except `-d' or `-D') may be specified, though the session name (see section Session Name) may be needed to distinguish between multiple detached
screensessions. The second form is used to connect to another users screen session which runs in multi-user mode. This indicates that screen should look for sessions in another users directory. This requires setuid-root.
screensession. If successful, all other command-line options are ignored. If no detached session exists, start a new session using the specified options, just as if `-R' had not been specified. This option is set by default if screen is run as a login-shell.
screenuses the value of the environment variable
$SHELL, or `/bin/sh' if it is not defined. This option is equivalent to the
shellcommand (see section Shell).
screen -rcommands. This option is equivalent to the
sessionnamecommand (see section Session Name).
shelltitlecommand (see section Shell).
screen -ls, but remove destroyed sessions instead of marking them as `dead'.