source: xsoft/other/xscreensaver.xml@ b4cbe50

10.1 11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b4cbe50 was b4cbe50, checked in by Douglas R. Reno <renodr@…>, 7 months ago

Tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24273 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 "dffe3be6c0db7468f1620873ec03a32e">
10 <!ENTITY xscreensaver-size "26 MB">
11 <!ENTITY xscreensaver-buildsize "384 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> package is a modular screen
34 saver 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 &lfs101_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="gdk-pixbuf-xlib"/>,
85 <xref linkend="libglade"/>, and
86 <xref linkend="xorg7-app"/>
87 </para>
88
89 <bridgehead renderas="sect4">Recommended</bridgehead>
90 <para role="recommended">
91 <xref linkend="glu"/>
92 </para>
93
94 <bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <xref linkend="gdm"/>,
97 <xref linkend="mitkrb"/>,
98 <ulink url="http://linas.org/gle/">GLE</ulink> and
99 <xref linkend="linux-pam"/>
100 </para>
101
102 <bridgehead renderas="sect4">Optional (runtime)</bridgehead>
103 <para role="optional">
104 The adobe-100dpi font, with libXfont and bdftopcf from
105 <xref role="runtime" linkend="xorg7-legacy"/> (to enlarge the splash
106 screen, error messages, and password prompt)
107 </para>
108
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url="&blfs-wiki;/xscreensaver"/>
111 </para>
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of XScreenSaver</title>
116
117 <para revision="sysv">
118 Change a harcoded library name, which prevents using the settings found
119 by <command>configure</command>:
120 </para>
121
122<screen revision="sysv"><userinput>sed -i 's/-lsystemd/-lelogind/' driver/Makefile.in</userinput></screen>
123
124 <para>
125 Install <application>XScreenSaver</application> by running the following
126 commands:
127 </para>
128
129<screen><userinput>./configure --prefix=/usr &amp;&amp;
130make</userinput></screen>
131
132 <para>
133 This package does not come with a test suite.
134 </para>
135
136 <!-- EDITORS NOTE: Use install_prefix instead of DESTDIR -->
137 <para>
138 Now, as the <systemitem class="username">root</systemitem> user:
139 </para>
140
141<screen role="root"><userinput>make install</userinput></screen>
142
143 </sect2>
144
145 <sect2 role="commands">
146 <title>Command Explanations</title>
147
148 <para>
149 <option>--with-setuid-hacks</option>: This switch allows some demos
150 to be installed setuid <systemitem class="username">root</systemitem>
151 which is needed in order to ping other hosts.
152 </para>
153
154 </sect2>
155
156 <sect2 role="configuration">
157 <title>Configuring XScreenSaver</title>
158
159 <sect3 id="xscreensaver-config">
160 <title>Config Files</title>
161
162 <para>
163 <filename>/etc/X11/app-defaults/XScreenSaver</filename> and
164 <filename>~/.xscreensaver</filename>
165 </para>
166
167 <indexterm zone="xscreensaver xscreensaver-config">
168 <primary sortas="e-etc-X11-app-defaults-XScreenSaver">/etc/X11/app-defaults/XScreenSaver</primary>
169 </indexterm>
170 <indexterm zone="xscreensaver xscreensaver-config">
171 <primary sortas="e-AA.xscreensaver">~/.xscreensaver</primary>
172 </indexterm>
173
174 </sect3>
175
176 <sect3>
177 <title>Linux PAM Configuration</title>
178
179 <para>
180 If <application>XScreenSaver</application> has been built with
181 <application>Linux PAM</application> support, you need to create a
182 <application>PAM</application> configuration file, to get it working
183 correctly with BLFS.
184 </para>
185
186 <para>
187 Issue the following commands as the <systemitem
188 class="username">root</systemitem> user to create the configuration
189 file for <application>Linux PAM</application>:
190 </para>
191
192<screen role="root"><userinput>cat &gt; /etc/pam.d/xscreensaver &lt;&lt; "EOF"
193<literal># Begin /etc/pam.d/xscreensaver
194
195auth include system-auth
196account include system-account
197
198# End /etc/pam.d/xscreensaver</literal>
199EOF</userinput></screen>
200
201 </sect3>
202
203 </sect2>
204
205 <sect2 role="content">
206 <title>Contents</title>
207
208 <segmentedlist>
209 <segtitle>Installed Programs</segtitle>
210 <segtitle>Installed Libraries</segtitle>
211 <segtitle>Installed Directories</segtitle>
212
213 <seglistitem>
214 <seg>
215 xscreensaver, xscreensaver-command, xscreensaver-demo, xscreensaver-getimage,
216 xscreensaver-getimage-file, xscreensaver-getimage-video,
217 xscreensaver-gl-helper and xscreensaver-text
218 </seg>
219 <seg>
220 None
221 </seg>
222 <seg>
223 /usr/libexec/xscreensaver and
224 /usr/share/xscreensaver
225 </seg>
226 </seglistitem>
227 </segmentedlist>
228
229 <variablelist>
230 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
231 <?dbfo list-presentation="list"?>
232 <?dbhtml list-presentation="table"?>
233
234 <varlistentry id="xscreensaver-prog">
235 <term><command>xscreensaver</command></term>
236 <listitem>
237 <para>
238 is a screen saver and locker daemon
239 </para>
240 <indexterm zone="xscreensaver xscreensaver-prog">
241 <primary sortas="b-xscreensaver">xscreensaver</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="xscreensaver-command">
247 <term><command>xscreensaver-command</command></term>
248 <listitem>
249 <para>
250 controls a running <command>xscreensaver</command>
251 process by sending it client messages
252 </para>
253 <indexterm zone="xscreensaver xscreensaver-command">
254 <primary sortas="b-xscreensaver-command">xscreensaver-command</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="xscreensaver-demo">
260 <term><command>xscreensaver-demo</command></term>
261 <listitem>
262 <para>
263 is a graphical front-end for setting the parameters used
264 by the background <command>xscreensaver</command> daemon
265 </para>
266 <indexterm zone="xscreensaver xscreensaver-demo">
267 <primary sortas="b-xscreensaver-demo">xscreensaver-demo</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="xscreensaver-getimage">
273 <term><command>xscreensaver-getimage</command></term>
274 <listitem>
275 <para>
276 is a helper program for the <command>xscreensaver</command>
277 modules that manipulate images
278 </para>
279 <indexterm zone="xscreensaver xscreensaver-getimage">
280 <primary sortas="b-xscreensaver-getimaage">xscreensaver-getimage</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="xscreensaver-getimage-file">
286 <term><command>xscreensaver-getimage-file</command></term>
287 <listitem>
288 <para>
289 is a helper program for the <command>xscreensaver</command>
290 modules that manipulate images
291 </para>
292 <indexterm zone="xscreensaver xscreensaver-getimage-file">
293 <primary sortas="b-xscreensaver-getimaage-file">xscreensaver-getimage-file</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="xscreensaver-getimage-video">
299 <term><command>xscreensaver-getimage-video</command></term>
300 <listitem>
301 <para>
302 is a helper program for the <command>xscreensaver</command>
303 modules that manipulate images
304 </para>
305 <indexterm zone="xscreensaver xscreensaver-getimage-video">
306 <primary sortas="b-xscreensaver-getimaage-video">xscreensaver-getimage-video</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="xscreensaver-gl-helper">
312 <term><command>xscreensaver-gl-helper</command></term>
313 <listitem>
314 <para>
315 is a helper program for the <command>xscreensaver</command>
316 OpenGL modules
317 </para>
318 <indexterm zone="xscreensaver xscreensaver-gl-helper">
319 <primary sortas="b-xscreensaver-gl-helper">xscreensaver-gl-helper</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="xscreensaver-text">
325 <term><command>xscreensaver-text</command></term>
326 <listitem>
327 <para>
328 prints some text to stdout, for use by screen savers
329 </para>
330 <indexterm zone="xscreensaver xscreensaver-text">
331 <primary sortas="b-xscreensaver-text">xscreensaver-text</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 </variablelist>
337
338 </sect2>
339
340</sect1>
Note: See TracBrowser for help on using the repository browser.