source: general/sysutils/at.xml@ 427b46a

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 427b46a was 66d551c, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tag a lot of utilities and libraries

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