source: xsoft/other/xscreensaver.xml@ 193af65

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 193af65 was 193af65, checked in by Ken Moffat <ken@…>, 14 months ago

Tags.

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

  • Property mode set to 100644
File size: 10.8 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 xscreensaver-download-http "https://www.jwz.org/xscreensaver/xscreensaver-&xscreensaver-version;.tar.gz">
8 <!ENTITY xscreensaver-download-ftp " ">
9 <!ENTITY xscreensaver-md5sum "9f764e561f9939f8684a66ec98b27cba">
10 <!ENTITY xscreensaver-size "26 MB">
11 <!ENTITY xscreensaver-buildsize "251 MB">
12 <!ENTITY xscreensaver-time "1.0 SBU">
13]>
14
15<sect1 id="xscreensaver" xreflabel="XScreenSaver-&xscreensaver-version;">
16 <?dbhtml filename="xscreensaver.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>XScreenSaver-&xscreensaver-version;</title>
24
25 <indexterm zone="xscreensaver">
26 <primary sortas="a-XScreenSaver">XScreenSaver</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to XScreenSaver</title>
31
32 <para>
33 The <application>XScreenSaver</application> is a modular screen saver
34 and locker for the X Window System. It is highly customizable and
35 allows the use of any program that can draw on the root window as a
36 display mode. The purpose of <application>XScreenSaver</application> is
37 to display pretty pictures on your screen when it is not in use, in
38 keeping with the philosophy that unattended monitors should always be
39 doing something interesting, just like they do in the movies. However,
40 <application>XScreenSaver</application> can also be used as a screen
41 locker, to prevent others from using your terminal while you are away.
42 </para>
43
44 &lfs10_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&xscreensaver-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&xscreensaver-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &xscreensaver-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &xscreensaver-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &xscreensaver-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &xscreensaver-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">XScreenSaver Dependencies</bridgehead>
81
82 <bridgehead renderas="sect4">Required</bridgehead>
83 <para role="required">
84 <xref linkend="libglade"/> and
85 <xref linkend="xorg7-app"/>
86 </para>
87
88 <bridgehead renderas="sect4">Recommended</bridgehead>
89 <para role="recommended">
90 <xref linkend="glu"/>
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <phrase revision="sysv"><ulink url="&gnome-download-http;/gdm/">GDM</ulink></phrase>
96 <phrase revision="systemd"><xref linkend="gdm"/></phrase>,
97 <ulink url="http://linas.org/gle/">GLE</ulink> and
98 <xref linkend="linux-pam"/>
99 </para>
100
101 <bridgehead renderas="sect4">Optional (runtime)</bridgehead>
102 <para role="optional">
103 The adobe-100dpi font, with libXfont and bdftopcf from
104 <xref role="runtime" linkend="xorg7-legacy"/> (to enlarge the splash
105 screen, error messages, and password prompt)
106 </para>
107
108 <para condition="html" role="usernotes">User Notes:
109 <ulink url="&blfs-wiki;/xscreensaver"/>
110 </para>
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of XScreenSaver</title>
115
116 <para revision="sysv">
117 Change a harcoded library name, which prevents using the settings found
118 by <command>configure</command>:
119 </para>
120
121<screen revision="sysv"><userinput>sed -i 's/-lsystemd/-lelogind/' driver/Makefile.in</userinput></screen>
122
123 <para>
124 Install <application>XScreenSaver</application> by running the following
125 commands:
126 </para>
127
128<screen><userinput>./configure --prefix=/usr &amp;&amp;
129make</userinput></screen>
130
131 <para>
132 This package does not come with a test suite.
133 </para>
134
135 <para>
136 Now, as the <systemitem class="username">root</systemitem> user:
137 </para>
138
139<screen role="root"><userinput>make install</userinput></screen>
140
141 </sect2>
142
143 <sect2 role="commands">
144 <title>Command Explanations</title>
145
146 <para>
147 <option>--with-setuid-hacks</option>: This switch allows some demos
148 to be installed setuid <systemitem class="username">root</systemitem>
149 which is needed in order to ping other hosts.
150 </para>
151
152 </sect2>
153
154 <sect2 role="configuration">
155 <title>Configuring XScreenSaver</title>
156
157 <sect3 id="xscreensaver-config">
158 <title>Config Files</title>
159
160 <para>
161 <filename>/etc/X11/app-defaults/XScreenSaver</filename> and
162 <filename>~/.xscreensaver</filename>
163 </para>
164
165 <indexterm zone="xscreensaver xscreensaver-config">
166 <primary sortas="e-etc-X11-app-defaults-XScreenSaver">/etc/X11/app-defaults/XScreenSaver</primary>
167 </indexterm>
168 <indexterm zone="xscreensaver xscreensaver-config">
169 <primary sortas="e-AA.xscreensaver">~/.xscreensaver</primary>
170 </indexterm>
171
172 </sect3>
173
174 <sect3>
175 <title>Linux PAM Configuration</title>
176
177 <para>
178 If <application>XScreenSaver</application> has been built with
179 <application>Linux PAM</application> support, you need to create a
180 <application>PAM</application> configuration file, to get it working
181 correctly with BLFS.
182 </para>
183
184 <para>
185 Issue the following commands as the <systemitem
186 class="username">root</systemitem> user to create the configuration
187 file for <application>Linux PAM</application>:
188 </para>
189
190<screen role="root"><userinput>cat &gt; /etc/pam.d/xscreensaver &lt;&lt; "EOF"
191<literal># Begin /etc/pam.d/xscreensaver
192
193auth include system-auth
194account include system-account
195
196# End /etc/pam.d/xscreensaver</literal>
197EOF</userinput></screen>
198
199 </sect3>
200
201 </sect2>
202
203 <sect2 role="content">
204 <title>Contents</title>
205
206 <segmentedlist>
207 <segtitle>Installed Programs</segtitle>
208 <segtitle>Installed Libraries</segtitle>
209 <segtitle>Installed Directories</segtitle>
210
211 <seglistitem>
212 <seg>
213 xscreensaver, xscreensaver-command, xscreensaver-demo, xscreensaver-getimage,
214 xscreensaver-getimage-file, xscreensaver-getimage-video,
215 xscreensaver-gl-helper and xscreensaver-text
216 </seg>
217 <seg>
218 None
219 </seg>
220 <seg>
221 /usr/libexec/xscreensaver and
222 /usr/share/xscreensaver
223 </seg>
224 </seglistitem>
225 </segmentedlist>
226
227 <variablelist>
228 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
229 <?dbfo list-presentation="list"?>
230 <?dbhtml list-presentation="table"?>
231
232 <varlistentry id="xscreensaver-prog">
233 <term><command>xscreensaver</command></term>
234 <listitem>
235 <para>
236 is a screen saver and locker daemon.
237 </para>
238 <indexterm zone="xscreensaver xscreensaver-prog">
239 <primary sortas="b-xscreensaver">xscreensaver</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="xscreensaver-command">
245 <term><command>xscreensaver-command</command></term>
246 <listitem>
247 <para>
248 controls a running <command>xscreensaver</command>
249 process by sending it client messages.
250 </para>
251 <indexterm zone="xscreensaver xscreensaver-command">
252 <primary sortas="b-xscreensaver-command">xscreensaver-command</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="xscreensaver-demo">
258 <term><command>xscreensaver-demo</command></term>
259 <listitem>
260 <para>
261 is a graphical front-end for setting the parameters used
262 by the background <command>xscreensaver</command> daemon.
263 </para>
264 <indexterm zone="xscreensaver xscreensaver-demo">
265 <primary sortas="b-xscreensaver-demo">xscreensaver-demo</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="xscreensaver-getimage">
271 <term><command>xscreensaver-getimage</command></term>
272 <listitem>
273 <para>
274 is a helper program for the <command>xscreensaver</command>
275 modules that manipulate images.
276 </para>
277 <indexterm zone="xscreensaver xscreensaver-getimage">
278 <primary sortas="b-xscreensaver-getimaage">xscreensaver-getimage</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="xscreensaver-getimage-file">
284 <term><command>xscreensaver-getimage-file</command></term>
285 <listitem>
286 <para>
287 is a helper program for the <command>xscreensaver</command>
288 modules that manipulate images.
289 </para>
290 <indexterm zone="xscreensaver xscreensaver-getimage-file">
291 <primary sortas="b-xscreensaver-getimaage-file">xscreensaver-getimage-file</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="xscreensaver-getimage-video">
297 <term><command>xscreensaver-getimage-video</command></term>
298 <listitem>
299 <para>
300 is a helper program for the <command>xscreensaver</command>
301 modules that manipulate images.
302 </para>
303 <indexterm zone="xscreensaver xscreensaver-getimage-video">
304 <primary sortas="b-xscreensaver-getimaage-video">xscreensaver-getimage-video</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="xscreensaver-gl-helper">
310 <term><command>xscreensaver-gl-helper</command></term>
311 <listitem>
312 <para>
313 is a helper program for the <command>xscreensaver</command>
314 OpenGL modules.
315 </para>
316 <indexterm zone="xscreensaver xscreensaver-gl-helper">
317 <primary sortas="b-xscreensaver-gl-helper">xscreensaver-gl-helper</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="xscreensaver-text">
323 <term><command>xscreensaver-text</command></term>
324 <listitem>
325 <para>
326 prints some text to stdout, for use by screen savers.
327 </para>
328 <indexterm zone="xscreensaver xscreensaver-text">
329 <primary sortas="b-xscreensaver-text">xscreensaver-text</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 </variablelist>
335
336 </sect2>
337
338</sect1>
Note: See TracBrowser for help on using the repository browser.