source: general/genutils/screen.xml@ a1dd01c

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY screen-download-http "http://ftp.gnu.org/pub/gnu/screen/screen-&screen-version;.tar.gz">
<!ENTITY screen-download-ftp "ftp://ftp.gnu.org/pub/gnu/screen/screen-&screen-version;.tar.gz">
<!ENTITY screen-size "825 KB">
<!ENTITY screen-buildsize "5.8 MB">
<!ENTITY screen-time "0.17 SBU">
]>

<sect1 id="screen" xreflabel="Screen-&screen-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="screen.html"?>
<title>Screen-&screen-version;</title>
<indexterm zone="screen">
<primary sortas="a-Screen">Screen</primary>
</indexterm>

<sect2>
<title>Introduction to <application>Screen</application></title>

<para><application>Screen</application> is a terminal multiplexor that
runs several separate processes, typically interactive shells, on a
single physical character-based terminal. Each virtual terminal emulates
a <acronym>DEC</acronym> VT100 plus several <acronym>ANSI</acronym>
X3.64 and <acronym>ISO</acronym> 2022 functions and also supports
configurable input and output translation, serial port support,
configurable logging, multi-user support, and <acronym>UTF</acronym>-8
character encoding support (currently not supported by
<acronym>LFS</acronym>). Screen sessions can be detached and resumed
later on a different terminal.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): 
<ulink url="&screen-download-http;"/></para></listitem>
<listitem><para>Download (FTP): 
<ulink url="&screen-download-ftp;"/></para></listitem>
<listitem><para>Download size: 
&screen-size;</para></listitem>
<listitem><para>Estimated disk space required: 
&screen-buildsize;</para></listitem>
<listitem><para>Estimated build time: 
&screen-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title><application>Screen</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="Linux_PAM"/></para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>Screen</application></title>

<para>Install <application>Screen</application> by running the
following commands:</para>

<screen><userinput><command>./configure --prefix=/usr --with-socket-dir=/var/run/screen \
    --with-sys-screenrc=/etc/screenrc &amp;&amp;
sed -i -e "s%/usr/local/etc/screenrc%/etc/screenrc%" {etc,doc}/* &amp;&amp;
make</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install &amp;&amp;
install -m 644 etc/etcscreenrc /etc/screenrc</command></userinput></screen>

</sect2>

<sect2>
<title>Configuring <application>Screen</application></title>

<sect3 id ="screen-config"><title>Config files</title>
<para><filename>/etc/screenrc</filename> and 
<filename>~/.screenrc</filename>
</para>
<indexterm zone="screen screen-config">
<primary sortas="e-AA.screenrc">~/.screenrc</primary></indexterm>
<indexterm zone="screen screen-config">
<primary sortas="e-etc-screenrc">/etc/screenrc</primary></indexterm>
</sect3>

<sect3><title>Configuration Information</title>
<para>You may want to look at the example configuration file that was 
installed and customize it for your needs.</para>
</sect3>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>

<seglistitem>
<seg>screen</seg>
<seg>None</seg>
<seg>/var/run/screen</seg>
</seglistitem>
</segmentedlist>

<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>

<varlistentry id="screen-prog">
<term><command>screen</command></term>
<listitem><para>is a terminal multiplexor with VT100/<acronym>ANSI</acronym> 
terminal emulation.</para>
<indexterm zone="screen screen-prog">
<primary sortas="b-screen">screen</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
</sect2>

</sect1>