Changeset 30edc031


Ignore:
Timestamp:
05/06/2005 07:42:57 PM (17 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
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
Children:
bff9ad6b
Parents:
35f3cb4
Message:

Tagged fcron.xml

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

Location:
general/sysutils
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • general/sysutils/apache-ant.xml

    r35f3cb4 r30edc031  
    133133
    134134    <sect3 id="apache-ant-config">
    135       <title>Config files</title>
     135      <title>Config Files</title>
    136136
    137137      <para><filename>/etc/ant/ant.conf</filename>,
  • general/sysutils/fcron.xml

    r35f3cb4 r30edc031  
    55  %general-entities;
    66
    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">
     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">
    1313]>
    1414
    1515<sect1 id="fcron" xreflabel="Fcron-&fcron-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="fcron.html"?>
    21 <title><application>Fcron</application>-&fcron-version;</title>
    22 <indexterm zone="fcron">
    23 <primary sortas="a-Fcron">Fcron</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>Fcron</application></title>
    27 
    28 <para>The <application>Fcron</application> package contains a periodical
    29 command scheduler which aims at replacing <application>Vixie
    30 Cron</application>.</para>
    31 
    32 <sect3><title>Package information</title>
    33 <itemizedlist spacing='compact'>
    34 <listitem><para>Download (HTTP):
    35 <ulink url="&fcron-download-http;"/></para></listitem>
    36 <listitem><para>Download (FTP):
    37 <ulink url="&fcron-download-ftp;"/></para></listitem>
    38 <listitem><para>Download MD5 sum: &fcron-md5sum;</para></listitem>
    39 <listitem><para>Download size: &fcron-size;</para></listitem>
    40 <listitem><para>Estimated disk space required:
    41 &fcron-buildsize;</para></listitem>
    42 <listitem><para>Estimated build time:
    43 &fcron-time;</para></listitem></itemizedlist>
    44 </sect3>
    45 
    46 <sect3><title><application>Fcron</application> dependencies</title>
    47 <sect4><title>Optional</title>
    48 <para><ulink url="../server/mail.html">MTA</ulink>,
    49 <xref linkend="Linux_PAM"/>,
    50 <ulink url="http://www.nsa.gov/selinux/">SELinux</ulink>,
    51 <xref linkend="docbook-utils"/> and
    52 <ulink url="../postlfs/editors.html">a text editor</ulink> (default is
    53 <xref linkend="vim"/>)</para>
    54 </sect4>
    55 </sect3>
    56 
    57 </sect2>
    58 
    59 <sect2>
    60 <title>Installation of <application>Fcron</application></title>
    61 
    62 <para id="fcron-syslog"><application>Fcron</application> uses the cron facility
    63 of <command>syslog</command> to log all messages. Since <acronym>LFS</acronym>
    64 does not set up this facility in <filename>/etc/syslog.conf</filename>, it
    65 needs to be done prior to installing <application>Fcron</application>. This
    66 command will append the necessary line to the current
    67 <filename>/etc/syslog.conf</filename>:</para>
    68 <indexterm zone="fcron fcron-syslog">
    69 <primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary></indexterm>
    70 
    71 <screen><userinput><command>cat &gt;&gt; /etc/syslog.conf &lt;&lt; "EOF"
    72 # Begin fcron addition to /etc/syslog.conf
     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
    7386
    7487cron.* -/var/log/cron.log
    7588
    76 # End fcron addition
    77 EOF</command></userinput></screen>
    78 
    79 <para>The configuration file has been modified, so reloading the
    80 <command>sysklogd</command> daemon will activate the changes.</para>
    81 
    82 <screen><userinput><command>/etc/rc.d/init.d/sysklogd reload</command></userinput></screen>
    83 
    84 <para>For security reasons, an unprivileged user and group for
    85 <application>Fcron</application> should be created:</para>
    86 
    87 <screen><userinput><command>groupadd fcron &amp;&amp;
    88 useradd -d /dev/null -c "Fcron User" -g fcron -s /bin/false fcron</command></userinput></screen>
    89 
    90 <para>Install <application>Fcron</application> by running the following
    91 commands:</para>
    92 
    93 <screen><userinput><command>./configure --without-sendmail --with-answer-all=no &amp;&amp;
    94 make</command></userinput></screen>
    95 
    96 <para>This package does not come with a test suite.</para>
    97 
    98 <para>Now, as the root user:</para>
    99 
    100 <screen><userinput role='root'><command>make install</command></userinput></screen>
    101 
    102 </sect2>
    103 
    104 <sect2>
    105 <title>Command explanations</title>
    106 
    107 <para><parameter>--without-sendmail</parameter>:
    108 <application>Fcron</application> will use an installed <acronym>MTA</acronym>
    109 to email you the results of the <command>fcron</command> script. Omit the
    110 switch and use
    111 <parameter>--with-sendmail=<replaceable>[/path/to/MTA]</replaceable></parameter>
    112 if you wish to utilize this feature.</para>
    113 
    114 <para><parameter>--with-answer-all=no</parameter>: After the files are
    115 installed, the <command>make install</command> script enters into a
    116 configuration routine.  The first test will be whether to install a boot
    117 script in the <filename class="directory">/etc/rc.d/init.d</filename>
    118 directory with the appropriate symbolic links in run levels 2, 3, 4, and 5.
    119 The second is to stop any current <command>fcron</command> processes and start
    120 a new one. Since this is probably your first install and a boot script based
    121 upon the <acronym>BLFS</acronym> template is desired, answer 'n' to both
    122 tests.</para>
    123 
    124 </sect2>
    125 
    126 <sect2>
    127 <title>Configuring <application>Fcron</application></title>
    128 
    129 <sect3 id="fcron-config"><title>Config files</title>
    130 <para><filename>/etc/fcron.conf</filename>,
    131 <filename>/etc/fcron.allow</filename> and
    132 <filename>/etc/fcron.deny</filename></para>
    133 <indexterm zone="fcron fcron-config">
    134 <primary sortas="e-etc-fcron.conf">/etc/fcron.conf</primary></indexterm>
    135 <indexterm zone="fcron fcron-config">
    136 <primary sortas="e-etc-fcron.allow">/etc/fcron.allow</primary></indexterm>
    137 <indexterm zone="fcron fcron-config">
    138 <primary sortas="e-etc-fcron.deny">/etc/fcron.deny</primary></indexterm>
    139 </sect3>
    140 
    141 <sect3><title>Configuration Information</title>
    142 <para>There are no required changes in any of the config files.
    143 Configuration information can be found in the man page for
    144 <filename>fcron.conf</filename>.</para>
    145 
    146 <para><command>fcron</command> scripts are written using
    147 <command>fcrontab</command>. Refer to the <command>fcrontab</command> man
    148 page for proper parameters to address your situation.</para>
    149 
    150 <para id="fcron-init">Install the <filename>/etc/rc.d/init.d/fcron</filename>
    151 init script from the <xref linkend="intro-important-bootscripts"/>
    152 package.</para>
    153 <indexterm zone="fcron fcron-init">
    154 <primary sortas="f-fcron">fcron</primary></indexterm>
    155 
    156 <screen><userinput><command>make install-fcron</command></userinput></screen>
    157 
    158 <para id="fcron-pam">If <application>Linux-<acronym>PAM</acronym></application>
    159 is installed, two <acronym>PAM</acronym> configuration files are installed in
    160 <filename class='directory'>/etc/pam.d</filename>. Alternatively if
    161 <filename class='directory'>/etc/pam.d</filename> is not used, the installation
    162 will append two configuration sections to the exiting
    163 <filename>/etc/pam.conf</filename> file. You should ensure the files match your
    164 preferences. Modify them as required to suit your needs.</para>
    165 <indexterm zone="fcron fcron-pam">
    166 <primary sortas="e-etc-pam.d">/etc/pam.d/*</primary></indexterm>
    167 <indexterm zone="fcron fcron-pam">
    168 <primary sortas="e-etc-pam.conf">/etc/pam.conf</primary></indexterm>
    169 </sect3>
    170 
    171 </sect2>
    172 
    173 <sect2>
    174 <title>Contents</title>
    175 
    176 <segmentedlist>
    177 <segtitle>Installed Programs</segtitle>
    178 <segtitle>Installed Libraries</segtitle>
    179 <segtitle>Installed Directories</segtitle>
    180 
    181 <seglistitem>
    182 <seg>fcron, fcrondyn, fcronsighup and fcrontab</seg>
    183 <seg>None</seg>
    184 <seg>/usr/share/doc/fcron-&fcron-version; and /var/spool/fcron</seg>
    185 </seglistitem>
    186 </segmentedlist>
    187 
    188 <variablelist>
    189 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    190 <?dbfo list-presentation="list"?>
    191 
    192 <varlistentry id="fcron-prog">
    193 <term><command>fcron</command></term>
    194 <listitem><para>is the scheduling daemon.</para>
    195 <indexterm zone="fcron fcron-prog">
    196 <primary sortas="b-fcron">fcron</primary>
    197 </indexterm></listitem>
    198 </varlistentry>
    199 
    200 <varlistentry id="fcrondyn">
    201 <term><command>fcrondyn</command></term>
    202 <listitem><para>is a user tool intended to interact with a running
    203 <command>fcron</command> daemon.</para>
    204 <indexterm zone="fcron fcrondyn">
    205 <primary sortas="b-fcrondyn">fcrondyn</primary>
    206 </indexterm></listitem>
    207 </varlistentry>
    208 
    209 <varlistentry id="fcronsighup">
    210 <term><command>fcronsighup</command></term>
    211 <listitem><para>instructs <command>fcron</command> to reread the
    212 <application>Fcron</application> tables.</para>
    213 <indexterm zone="fcron fcronsighup">
    214 <primary sortas="b-fcronsighup">fcronsighup</primary>
    215 </indexterm></listitem>
    216 </varlistentry>
    217 
    218 <varlistentry id="fcrontab">
    219 <term><command>fcrontab</command></term>
    220 <listitem><para>is a program used to install, edit, list and remove the
    221 tables used by <command>fcron</command>.</para>
    222 <indexterm zone="fcron fcrontab">
    223 <primary sortas="b-fcrontab">fcrontab</primary>
    224 </indexterm></listitem>
    225 </varlistentry>
    226 </variablelist>
    227 
    228 </sect2>
     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 fcron &amp;&amp;
     101useradd -d /dev/null -c "Fcron User" -g fcron -s /bin/false 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>
    229274
    230275</sect1>
Note: See TracChangeset for help on using the changeset viewer.