Changeset ae7f265

Timestamp:

02/26/2005 08:34:33 PM (18 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 6.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/inkscape-core-mods, krejzi/svn, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226

Children:

3891001

Parents:

573088b9

Message:

Added Linux-PAM configuration notes and indexing tags to Fcron instructions

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

Files:

• general/sysutils/fcron.xml (modified) (8 diffs)
• introduction/welcome/changelog.xml (modified) (1 diff)

general/sysutils/fcron.xml

@@ -20 +20 @@
 <?dbhtml filename="fcron.html"?>
 <title><application>Fcron</application>-&fcron-version;</title>
+<indexterm zone="fcron">
+<primary sortas="a-fcron">fcron</primary></indexterm>
 
 <sect2>
@@ -58 +60 @@
 <title>Installation of <application>Fcron</application></title>
 
-<para><application>Fcron</application> uses the cron facility of
-<command>syslog</command> to log all messages. Since <acronym>LFS</acronym> 
+<para id="fcron-syslog"><application>Fcron</application> uses the cron facility 
+of <command>syslog</command> to log all messages. Since <acronym>LFS</acronym> 
 does not set up this facility in <filename>/etc/syslog.conf</filename>, it 
 needs to be done prior to installing <application>Fcron</application>. This 
 command will append the necessary line to the current 
 <filename>/etc/syslog.conf</filename>:</para>
+<indexterm zone="fcron fcron-syslog">
+<primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary></indexterm>
 
 <screen><userinput><command>cat &gt;&gt; /etc/syslog.conf &lt;&lt; "EOF"
@@ -88 +92 @@
 
 <screen><userinput><command>./configure --without-sendmail --with-answer-all=no &amp;&amp;
-make &amp;&amp;
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 
 </sect2>
@@ -96 +103 @@
 <title>Command explanations</title>
 
-<para><parameter>--without-sendmail</parameter>: <application>Fcron</application>
-will use an installed <acronym>MTA</acronym> to email you the results of the
-<command>fcron</command> script. Omit the switch if you wish to utilize
-this feature.</para>
+<para><parameter>--without-sendmail</parameter>: 
+<application>Fcron</application> will use an installed <acronym>MTA</acronym> 
+to email you the results of the <command>fcron</command> script. Omit the 
+switch and use 
+<parameter>--with-sendmail=<replaceable>[/path/to/MTA]</replaceable></parameter> 
+if you wish to utilize this feature.</para>
 
 <para><parameter>--with-answer-all=no</parameter>: After the files are
@@ -106 +115 @@
 script in the <filename class="directory">/etc/rc.d/init.d</filename> 
 directory with the appropriate symbolic links in run levels 2, 3, 4, and 5. 
-The second is to stop any current fcron processes and start a new one. Since 
-this is probably your first install and a boot script based upon the
-<acronym>BLFS</acronym> template is desired, answer 'n' to both tests.</para>
+The second is to stop any current <command>fcron</command> processes and start 
+a new one. Since this is probably your first install and a boot script based 
+upon the <acronym>BLFS</acronym> template is desired, answer 'n' to both 
+tests.</para>
 
 </sect2>
@@ -115 +125 @@
 <title>Configuring <application>Fcron</application></title>
 
-<sect3><title>Config files</title>
-
+<sect3 id="fcron-config"><title>Config files</title>
 <para><filename>/etc/fcron.conf</filename>,
 <filename>/etc/fcron.allow</filename> and 
 <filename>/etc/fcron.deny</filename></para>
-
+<indexterm zone="fcron fcron-config">
+<primary sortas="e-etc-fcron.conf">/etc/fcron.conf</primary></indexterm>
+<indexterm zone="fcron fcron-config">
+<primary sortas="e-etc-fcron.allow">/etc/fcron.allow</primary></indexterm>
+<indexterm zone="fcron fcron-config">
+<primary sortas="e-etc-fcron.deny">/etc/fcron.deny</primary></indexterm>
 </sect3>
 
 <sect3><title>Configuration Information</title>
-
 <para>There are no required changes in any of the config files.
 Configuration information can be found in the man page for
@@ -133 +146 @@
 page for proper parameters to address your situation.</para>
 
-<para>Install the <filename>/etc/rc.d/init.d/fcron</filename>
+<para id="fcron-init">Install the <filename>/etc/rc.d/init.d/fcron</filename> 
 init script from the <xref linkend="intro-important-bootscripts"/> 
 package.</para>
+<indexterm zone="fcron fcron-init">
+<primary sortas="f-fcron">fcron</primary></indexterm>
 
 <screen><userinput><command>make install-fcron</command></userinput></screen>
 
+<para id="fcron-pam">If <application>Linux-<acronym>PAM</acronym></application> 
+is installed, two <acronym>PAM</acronym> configuration files are installed in 
+<filename class='directory'>/etc/pam.d</filename>. Alternatively if 
+<filename class='directory'>/etc/pam.d</filename> is not used, the installation 
+will append two configuration sections to the exiting 
+<filename>/etc/pam.conf</filename> file. You should ensure the files match your 
+preferences. Modify them as required to suit your needs.</para>
+<indexterm zone="fcron fcron-pam">
+<primary sortas="e-etc-pam.d">/etc/pam.d/*</primary></indexterm>
+<indexterm zone="fcron fcron-pam">
+<primary sortas="e-etc-pam.conf">/etc/pam.conf</primary></indexterm>
 </sect3>
 
@@ -146 +172 @@
 <title>Contents</title>
 
-<para>The <application>Fcron</application> package contains
-<command>fcron</command>, <command>fcrontab</command>, 
-<command>fcronsighup</command> and <command>fcrondyn</command>.</para>
-
-</sect2>
-
-<sect2><title>Description</title>
-
-<sect3><title>fcron</title>
-<para><command>fcron</command> is the scheduling daemon.</para></sect3>
-
-<sect3><title>fcrontab</title>
-<para><command>fcrontab</command> is the program used to install, edit, list
-and remove the tables used by <command>fcron</command>.</para></sect3>
-
-<sect3><title>fcronsighup</title>
-<para><command>fcronsighup</command> instructs <command>fcron</command> to
-reread the fcron tables.</para></sect3>
-
-<sect3><title>fcrondyn</title>
-<para><command>fcrondyn</command> is a user tool intended to interact with a
-running <command>fcron</command> daemon.</para></sect3>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
+
+<seglistitem>
+<seg>fcron, fcrondyn, fcronsighup and fcrontab</seg>
+<seg>None</seg>
+<seg>/usr/share/doc/fcron-&fcron-version; and /var/spool/fcron</seg>
+</seglistitem>
+</segmentedlist>
+
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="fcron-prog">
+<term><command>fcron</command></term>
+<listitem><para>is the scheduling daemon.</para>
+<indexterm zone="fcron fcron-prog">
+<primary sortas="b-fcron">fcron</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="fcrondyn">
+<term><command>fcrondyn</command></term>
+<listitem><para>is a user tool intended to interact with a running 
+<command>fcron</command> daemon.</para>
+<indexterm zone="fcron fcrondyn">
+<primary sortas="b-fcrondyn">fcrondyn</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="fcronsighup">
+<term><command>fcronsighup</command></term>
+<listitem><para>instructs <command>fcron</command> to reread the 
+<application>Fcron</application> tables.</para>
+<indexterm zone="fcron fcronsighup">
+<primary sortas="b-fcronsighup">fcronsighup</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="fcrontab">
+<term><command>fcrontab</command></term>
+<listitem><para>is a program used to install, edit, list and remove the 
+tables used by <command>fcron</command>.</para>
+<indexterm zone="fcron fcrontab">
+<primary sortas="b-fcrontab">fcrontab</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>

introduction/welcome/changelog.xml

@@ -27 +27 @@
 instructions to correctly identify the MySQL socket path; added a note to the 
 XFS instructions to ensure E2fsprogs or UUID is installed, as suggested by
-Stef Bon.</para></listitem>
+Stef Bon; added Linux-PAM configuration notes to Fcron.</para></listitem>
 
 <listitem><para>February 25th, 2005 [randy]: Updated to Leafnode-1.10.8;