source: general/sysutils/at.xml@ cede1f0

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since cede1f0 was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 18 months ago

Remove sect1info tags

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