source: xsoft/other/xscreensaver.xml@ 779b3223

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 779b3223 was 779b3223, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Update to gdl-3.40.0.
Also:
Change order of elogind recommended dependencies to emphasize PAM.
Typo in xscreensaver-time

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