source: general/genutils/screen.xml@ 81f86f9e

10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 81f86f9e was 81f86f9e, checked in by Douglas R. Reno <renodr@…>, 22 months ago

Add security patch for screen
Initial 10.1 tags from me

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24239 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 6.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY screen-download-http "&gnu-http;/screen/screen-&screen-version;.tar.gz">
8 <!ENTITY screen-download-ftp "&gnu-ftp;/screen/screen-&screen-version;.tar.gz">
9 <!ENTITY screen-md5sum "d276213d3acd10339cd37848b8c4ab1e">
10 <!ENTITY screen-size "836 KB">
11 <!ENTITY screen-buildsize "7.4 MB">
12 <!ENTITY screen-time "0.1 SBU">
13]>
14
15<sect1 id="screen" xreflabel="Screen-&screen-version;">
16 <?dbhtml filename="screen.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Screen-&screen-version;</title>
24
25 <indexterm zone="screen">
26 <primary sortas="a-Screen">Screen</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Screen</title>
31
32 <para>
33 <application>Screen</application> is a terminal multiplexor that runs
34 several separate processes, typically interactive shells, on a single
35 physical character-based terminal. Each virtual terminal emulates a DEC
36 VT100 plus several ANSI X3.64 and ISO 2022 functions and also provides
37 configurable input and output translation, serial port support,
38 configurable logging, multi-user support, and many character encodings,
39 including UTF-8. Screen sessions can be detached and resumed
40 later on a different terminal.
41 </para>
42
43 &lfs101_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>
49 Download (HTTP): <ulink url="&screen-download-http;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download (FTP): <ulink url="&screen-download-ftp;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download MD5 sum: &screen-md5sum;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download size: &screen-size;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated disk space required: &screen-buildsize;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated build time: &screen-time;
75 </para>
76 </listitem>
77 </itemizedlist>
78
79 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
80 <itemizedlist spacing="compact">
81 <listitem>
82 <para>
83 Required patch:
84 <ulink url="&patch-root;/screen-&screen-version;-upstream_fixes-1.patch"/>
85 </para>
86 </listitem>
87 </itemizedlist>
88
89 <bridgehead renderas="sect3">Screen Dependencies</bridgehead>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="optional">
93 <xref linkend="linux-pam"/>
94 </para>
95
96 <para condition="html" role="usernotes">User Notes:
97 <ulink url="&blfs-wiki;/screen"/></para>
98
99 </sect2>
100
101 <sect2 role="installation">
102 <title>Installation of Screen</title>
103
104 <para>
105 First, apply a patch from upstream that fixes a security vulnerability:
106 </para>
107
108<screen><userinput remap="pre">patch -Np1 -i ../screen-&screen-version;-upstream_fixes-1.patch</userinput></screen>
109
110 <para>
111 Install <application>Screen</application> by running the
112 following commands:
113 </para>
114
115<screen><userinput>./configure --prefix=/usr \
116 --infodir=/usr/share/info \
117 --mandir=/usr/share/man \
118 --with-socket-dir=/run/screen \
119 --with-pty-group=5 \
120 --with-sys-screenrc=/etc/screenrc &amp;&amp;
121
122sed -i -e "s%/usr/local/etc/screenrc%/etc/screenrc%" {etc,doc}/* &amp;&amp;
123make</userinput></screen>
124
125 <para>
126 This package does not come with a test suite.
127 </para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>make install &amp;&amp;
134install -m 644 etc/etcscreenrc /etc/screenrc</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <para>
142 <parameter>--with-socket-dir=/run/screen</parameter>: This option
143 places the per-user sockets in a standard location.
144 </para>
145
146 <para>
147 <parameter>--with-sys-screenrc=/etc/screenrc</parameter>: This option
148 places the global screenrc file in <filename
149 class='directory'>/etc</filename>.
150 </para>
151
152 <para>
153 <parameter>--with-pty-group=5</parameter>: This option sets the gid
154 to the value used by LFS.
155 </para>
156
157 <para>
158 <command>sed -i -e "s%/usr/local/etc/screenrc%/etc/screenrc%"
159 {etc,doc}/*</command>: This command corrects the configuration and
160 documentation files to the location that is used here for the global
161 screenrc file.
162 </para>
163
164 </sect2>
165
166 <sect2 role="configuration">
167 <title>Configuring Screen</title>
168
169 <sect3 id ="screen-config">
170 <title>Config Files</title>
171
172 <para>
173 <filename>/etc/screenrc</filename> and
174 <filename>~/.screenrc</filename>
175 </para>
176
177 <indexterm zone="screen screen-config">
178 <primary sortas="e-AA.screenrc">~/.screenrc</primary>
179 </indexterm>
180
181 <indexterm zone="screen screen-config">
182 <primary sortas="e-etc-screenrc">/etc/screenrc</primary>
183 </indexterm>
184
185 </sect3>
186
187 <sect3>
188 <title>Configuration Information</title>
189
190 <para>
191 You may want to look at the example configuration file that was
192 installed and customize it for your needs.
193 </para>
194
195 </sect3>
196
197 </sect2>
198
199 <sect2 role="content">
200 <title>Contents</title>
201
202 <segmentedlist>
203 <segtitle>Installed Program</segtitle>
204 <segtitle>Installed Libraries</segtitle>
205 <segtitle>Installed Directory</segtitle>
206
207 <seglistitem>
208 <seg>screen (symlink) and screen-&screen-version;</seg>
209 <seg>None</seg>
210 <seg>/usr/share/screen and /run/screen</seg>
211 </seglistitem>
212 </segmentedlist>
213
214 <variablelist>
215 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
216 <?dbfo list-presentation="list"?>
217 <?dbhtml list-presentation="table"?>
218
219 <varlistentry id="screen-prog">
220 <term><command>screen</command></term>
221 <listitem>
222 <para>
223 is a terminal multiplexor with VT100/ANSI terminal emulation
224 </para>
225 <indexterm zone="screen screen-prog">
226 <primary sortas="b-screen">screen</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 </variablelist>
232
233 </sect2>
234
235</sect1>
Note: See TracBrowser for help on using the repository browser.