source: general/sysutils/fcron.xml@ b785ab2

10.0 10.1 11.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b785ab2 was b785ab2, checked in by Bruce Dubbs <bdubbs@…>, 17 years ago

Integrated system uid and gid values

into individual packages.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4550 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY fcron-download-http "http://fcron.free.fr/archives/fcron-&fcron-version;.src.tar.gz">
8 <!ENTITY fcron-download-ftp "ftp://ftp.seul.org/pub/fcron/fcron-&fcron-version;.src.tar.gz">
9 <!ENTITY fcron-md5sum "f408960f4c08ad377e61531ca48669bb">
10 <!ENTITY fcron-size "397 KB">
11 <!ENTITY fcron-buildsize "3.4 MB">
12 <!ENTITY fcron-time "0.10 SBU">
13]>
14
15<sect1 id="fcron" xreflabel="Fcron-&fcron-version;">
16 <?dbhtml filename="fcron.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Fcron-&fcron-version;</title>
24
25 <indexterm zone="fcron">
26 <primary sortas="a-Fcron">Fcron</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Fcron</title>
31
32 <para>The <application>Fcron</application> package contains a periodical
33 command scheduler which aims at replacing <application>Vixie
34 Cron</application>.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&fcron-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&fcron-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &fcron-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &fcron-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &fcron-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &fcron-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">Fcron Dependencies</bridgehead>
59
60 <bridgehead renderas="sect4">Optional</bridgehead>
61 <para><ulink url="../server/mail.html">MTA</ulink>,
62 <xref linkend="Linux_PAM"/>,
63 <ulink url="http://www.nsa.gov/selinux/">SELinux</ulink>,
64 <xref linkend="docbook-utils"/> and
65 <ulink url="../postlfs/editors.html">a text editor</ulink> (default is
66 <xref linkend="vim"/>)</para>
67
68 </sect2>
69
70 <sect2 role="installation">
71 <title>Installation of Fcron</title>
72
73 <para id="fcron-syslog"><application>Fcron</application> uses the cron facility
74 of <command>syslog</command> to log all messages. Since LFS
75 does not set up this facility in <filename>/etc/syslog.conf</filename>, it
76 needs to be done prior to installing <application>Fcron</application>. This
77 command will append the necessary line to the current
78 <filename>/etc/syslog.conf</filename>:</para>
79
80 <indexterm zone="fcron fcron-syslog">
81 <primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary>
82 </indexterm>
83
84<screen role="root"><userinput>cat &gt;&gt; /etc/syslog.conf &lt;&lt; "EOF"
85<literal># Begin fcron addition to /etc/syslog.conf
86
87cron.* -/var/log/cron.log
88
89# End fcron addition</literal>
90EOF</userinput></screen>
91
92 <para>The configuration file has been modified, so reloading the
93 <command>sysklogd</command> daemon will activate the changes.</para>
94
95<screen role="root"><userinput>/etc/rc.d/init.d/sysklogd reload</userinput></screen>
96
97 <para>For security reasons, an unprivileged user and group for
98 <application>Fcron</application> should be created:</para>
99
100<screen role="root"><userinput>groupadd -g 22 fcron &amp;&amp;
101useradd -d /dev/null -c "Fcron User" -g fcron -s /bin/false -u 22 fcron</userinput></screen>
102
103 <para>Install <application>Fcron</application> by running the following
104 commands:</para>
105
106<screen><userinput>./configure --without-sendmail --with-answer-all=no &amp;&amp;
107make</userinput></screen>
108
109 <para>This package does not come with a test suite.</para>
110
111 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
112
113<screen role="root"><userinput>make install</userinput></screen>
114
115 </sect2>
116
117 <sect2 role="commands">
118 <title>Command Explanations</title>
119
120 <para><parameter>--without-sendmail</parameter>:
121 <application>Fcron</application> will use an installed MTA
122 to email you the results of the <command>fcron</command> script. Omit the
123 switch and use
124 <option>--with-sendmail=<replaceable>[/path/to/MTA]</replaceable></option>
125 if you wish to utilize this feature.</para>
126
127 <para><parameter>--with-answer-all=no</parameter>: After the files are
128 installed, the <command>make install</command> script enters into a
129 configuration routine. The first test will be whether to install a boot
130 script in the <filename class="directory">/etc/rc.d/init.d</filename>
131 directory with the appropriate symbolic links in run levels 2, 3, 4, and 5.
132 The second is to stop any current <command>fcron</command> processes
133 and start a new one. Since this is probably your first install and a boot script
134 based upon the BLFS template is desired, answer 'n' to both tests.</para>
135
136 </sect2>
137
138 <sect2 role="configuration">
139 <title>Configuring Fcron</title>
140
141 <sect3 id="fcron-config">
142 <title>Config Files</title>
143
144 <para><filename>/etc/fcron.conf</filename>,
145 <filename>/etc/fcron.allow</filename>, and
146 <filename>/etc/fcron.deny</filename></para>
147
148 <indexterm zone="fcron fcron-config">
149 <primary sortas="e-etc-fcron.conf">/etc/fcron.conf</primary>
150 </indexterm>
151
152 <indexterm zone="fcron fcron-config">
153 <primary sortas="e-etc-fcron.allow">/etc/fcron.allow</primary>
154 </indexterm>
155
156 <indexterm zone="fcron fcron-config">
157 <primary sortas="e-etc-fcron.deny">/etc/fcron.deny</primary>
158 </indexterm>
159
160 </sect3>
161
162 <sect3>
163 <title>Configuration Information</title>
164
165 <para>There are no required changes in any of the config files.
166 Configuration information can be found in the man page for
167 <filename>fcron.conf</filename>.</para>
168
169 <para><command>fcron</command> scripts are written using
170 <command>fcrontab</command>. Refer to the <command>fcrontab</command> man
171 page for proper parameters to address your situation.</para>
172
173 <para id="fcron-pam">If <application>Linux-PAM</application>
174 is installed, two PAM configuration files are installed in
175 <filename class='directory'>/etc/pam.d</filename>. Alternatively if
176 <filename class='directory'>/etc/pam.d</filename> is not used, the installation
177 will append two configuration sections to the exiting
178 <filename>/etc/pam.conf</filename> file. You should ensure the files match your
179 preferences. Modify them as required to suit your needs.</para>
180
181 <indexterm zone="fcron fcron-pam">
182 <primary sortas="e-etc-pam.d">/etc/pam.d/*</primary>
183 </indexterm>
184
185 <indexterm zone="fcron fcron-pam">
186 <primary sortas="e-etc-pam.conf">/etc/pam.conf</primary>
187 </indexterm>
188
189 </sect3>
190
191 <sect3 id="fcron-init">
192 <title>Boot Script</title>
193
194 <para>Install the <filename>/etc/rc.d/init.d/fcron</filename>
195 init script from the <xref linkend="intro-important-bootscripts"/>
196 package.</para>
197
198 <indexterm zone="fcron fcron-init">
199 <primary sortas="f-fcron">fcron</primary>
200 </indexterm>
201
202<screen role="root"><userinput>make install-fcron</userinput></screen>
203
204 </sect3>
205
206 </sect2>
207
208 <sect2 role="content">
209 <title>Contents</title>
210
211 <segmentedlist>
212 <segtitle>Installed Programs</segtitle>
213 <segtitle>Installed Libraries</segtitle>
214 <segtitle>Installed Directories</segtitle>
215
216 <seglistitem>
217 <seg>fcron, fcrondyn, fcronsighup, and fcrontab</seg>
218 <seg>None</seg>
219 <seg>/usr/share/doc/fcron-&fcron-version; and /var/spool/fcron</seg>
220 </seglistitem>
221 </segmentedlist>
222
223 <variablelist>
224 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
225 <?dbfo list-presentation="list"?>
226 <?dbhtml list-presentation="table"?>
227
228 <varlistentry id="fcron-prog">
229 <term><command>fcron</command></term>
230 <listitem>
231 <para>is the scheduling daemon.</para>
232 <indexterm zone="fcron fcron-prog">
233 <primary sortas="b-fcron">fcron</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="fcrondyn">
239 <term><command>fcrondyn</command></term>
240 <listitem>
241 <para>is a user tool intended to interact with a running
242 <command>fcron</command> daemon.</para>
243 <indexterm zone="fcron fcrondyn">
244 <primary sortas="b-fcrondyn">fcrondyn</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="fcronsighup">
250 <term><command>fcronsighup</command></term>
251 <listitem>
252 <para>instructs <command>fcron</command> to reread the
253 <application>Fcron</application> tables.</para>
254 <indexterm zone="fcron fcronsighup">
255 <primary sortas="b-fcronsighup">fcronsighup</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="fcrontab">
261 <term><command>fcrontab</command></term>
262 <listitem>
263 <para>is a program used to install, edit, list and remove the
264 tables used by <command>fcron</command>.</para>
265 <indexterm zone="fcron fcrontab">
266 <primary sortas="b-fcrontab">fcrontab</primary>
267 </indexterm>
268 </listitem>
269 </varlistentry>
270
271 </variablelist>
272
273 </sect2>
274
275</sect1>
Note: See TracBrowser for help on using the repository browser.