source: general/sysutils/at.xml@ 0145208a

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 0145208a was 0145208a, checked in by Bruce Dubbs <bdubbs@…>, 6 months ago

Update to at_3.2.2

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