source: general/sysutils/at.xml@ 45ab6c7

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 6 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 9.0 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 at-download-http "http://software.calhariz.com/at/at_&at-version;.orig.tar.gz">
8 <!ENTITY at-download-ftp " ">
9 <!ENTITY at-md5sum "518a1c1782c8434869bb0824f1d84520">
10 <!ENTITY at-md5sum "">
11 <!ENTITY at-size "125 KB">
12 <!ENTITY at-buildsize "1.8 MB including tests">
13 <!ENTITY at-time "less than 0.1 SBU">
14]>
15
16<sect1 id="at" xreflabel="At-&at-version;">
17 <?dbhtml filename="at.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>at-&at-version;</title>
24
25 <indexterm zone="at">
26 <primary sortas="a-at">at</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to at</title>
31
32 <para>
33 The <application>at</application> package provide delayed job execution
34 and batch processing. It is required for Linux Standards Base (LSB)
35 conformance.
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&at-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&at-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &at-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &at-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &at-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &at-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">at Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 An <xref linkend="server-mail"/>
79 </para>
80
81 <bridgehead renderas="sect4">Optional</bridgehead>
82 <para role="optional">
83 <xref linkend="linux-pam"/>
84 </para>
85
86 <para condition="html" role="usernotes">User Notes:
87 <ulink url="&blfs-wiki;/at"/></para>
88
89 </sect2>
90
91 <sect2 role="installation">
92 <title>Installation of at</title>
93
94 <para>
95 Before building <application>at</application>, as the
96 <systemitem class="username">root</systemitem> user you should create
97 the group and user <systemitem class="username">atd</systemitem> which
98 will run the <command>atd</command> daemon:
99 </para>
100
101<screen role="root"><userinput>groupadd -g 17 atd &amp;&amp;
102useradd -d /dev/null -c "atd daemon" -g atd -s /bin/false -u 17 atd</userinput></screen>
103
104 <para>
105 Install <application>at</application> with the following
106 commands:
107 </para>
108
109 <screen revision="sysv"><userinput>./configure --with-daemon_username=atd \
110 --with-daemon_groupname=atd \
111 --with-jobdir=/var/spool/atjobs \
112 --with-atspool=/var/spool/atspool \
113 SENDMAIL=/usr/sbin/sendmail &amp;&amp;
114make -j1</userinput></screen>
115
116 <screen revision="systemd"><userinput>./configure --with-daemon_username=atd \
117 --with-daemon_groupname=atd \
118 SENDMAIL=/usr/sbin/sendmail \
119 --with-jobdir=/var/spool/atjobs \
120 --with-atspool=/var/spool/atspool \
121 --with-systemdsystemunitdir=/lib/systemd/system &amp;&amp;
122make -j1</userinput></screen>
123
124 <para>
125 To test the results, issue: <command>make test</command>.
126 </para>
127
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>make install docdir=/usr/share/doc/at-&at-version; \
134 atdocdir=/usr/share/doc/at-&at-version;</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="configuration">
139 <title>Configuring at</title>
140
141 <sect3 id="at-config">
142 <title>Config Files</title>
143
144 <para>
145 <filename>/etc/at.allow</filename> and
146 <filename>/etc/at.deny</filename> determines who can submit jobs via at
147 or batch.
148 </para>
149
150 <indexterm zone="at at-config">
151 <primary sortas="e-etc-at.allow">/etc/at.allow</primary>
152 </indexterm>
153
154 <indexterm zone="at at-config">
155 <primary sortas="e-etc-at.deny">/etc/at.deny</primary>
156 </indexterm>
157
158 </sect3>
159
160 <sect3>
161 <title>Linux PAM Configuration</title>
162
163 <para>
164 If <application>At</application> has been built with
165 <application>Linux PAM</application> support, you need to create a
166 <application>PAM</application> configuration file, to get it working
167 correctly with BLFS.
168 </para>
169
170 <para>
171 Issue the following commands as the <systemitem
172 class="username">root</systemitem> user to create the configuration
173 file for <application>Linux PAM</application>:
174 </para>
175
176<screen role="root"><userinput>cat &gt; /etc/pam.d/atd &lt;&lt; "EOF"
177<literal># Begin /etc/pam.d/atd
178
179auth required pam_unix.so
180account required pam_unix.so
181password required pam_unix.so
182session required pam_unix.so
183
184# End /etc/pam.d/atd</literal>
185EOF</userinput></screen>
186
187 </sect3>
188
189 <sect3 id="at-init">
190 <title><phrase revision="sysv">Boot Script</phrase>
191 <phrase revision="systemd">Systemd Unit</phrase></title>
192
193 <para revision="sysv">
194 Install the <filename>/etc/init.d/atd</filename>
195 init script from the <xref linkend="bootscripts"/> package.
196 </para>
197
198 <para revision="systemd">
199 To start the <command>atd</command> daemon at boot,
200 enable the previously installed systemd unit by
201 running the following command as the
202 <systemitem class="username">root</systemitem> user:
203 </para>
204
205 <indexterm zone="at at-init">
206 <primary sortas="f-at">at</primary>
207 </indexterm>
208
209<screen role="root" revision="sysv"><userinput>make install-atd</userinput></screen>
210
211<screen role="root" revision="systemd"><userinput>systemctl enable atd</userinput></screen>
212
213 </sect3>
214
215 </sect2>
216
217 <sect2 role="content">
218 <title>Contents</title>
219
220 <segmentedlist>
221 <segtitle>Installed Programs</segtitle>
222 <segtitle>Installed Libraries</segtitle>
223 <segtitle>Installed Directories</segtitle>
224
225 <seglistitem>
226 <seg>
227 at, atd, atq (symlink), atrm (symlink), atrun, and batch
228 </seg>
229 <seg>
230 None
231 </seg>
232 <seg>
233 /usr/share/doc/at-&at-version;
234 </seg>
235 </seglistitem>
236 </segmentedlist>
237
238 <variablelist>
239 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
240 <?dbfo list-presentation="list"?>
241 <?dbhtml list-presentation="table"?>
242
243 <varlistentry id="at-prog">
244 <term><command>at</command></term>
245 <listitem>
246 <para>
247 queues, examines or deletes jobs for later execution
248 </para>
249 <indexterm zone="at at-prog">
250 <primary sortas="b-at">at</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="atd">
256 <term><command>atd</command></term>
257 <listitem>
258 <para>
259 is the daemon that runs jobs queued for later execution
260 </para>
261 <indexterm zone="at atd">
262 <primary sortas="b-atd">atd</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="atq">
268 <term><command>atq</command></term>
269 <listitem>
270 <para>
271 lists the user's pending jobs, or all jobs, if superuser
272 </para>
273 <indexterm zone="at atq">
274 <primary sortas="b-atq">atq</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="atrm">
280 <term><command>atrm</command></term>
281 <listitem>
282 <para>
283 deletes jobs, identified by their job number
284 </para>
285 <indexterm zone="at atrm">
286 <primary sortas="b-atrm">atrm</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="atrun">
292 <term><command>atrun</command></term>
293 <listitem>
294 <para>
295 runs jobs queued for later execution
296 </para>
297 <indexterm zone="at atrun">
298 <primary sortas="b-atrun">atrun</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 <varlistentry id="batch">
304 <term><command>batch</command></term>
305 <listitem>
306 <para>
307 is a script that executes commands when system load levels permit
308 </para>
309 <indexterm zone="at batch">
310 <primary sortas="b-batch">batch</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 </variablelist>
316
317 </sect2>
318
319</sect1>
Note: See TracBrowser for help on using the repository browser.