Changeset 06a0740


Ignore:
Timestamp:
04/30/2005 08:23:06 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 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:
e3353b3
Parents:
fc7e79c
Message:

Tagged fam.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/genlib/fam.xml

    rfc7e79c r06a0740  
    55  %general-entities;
    66
    7 <!ENTITY fam-download-http "http://gd.tuwien.ac.at/opsys/linux/gentoo/distfiles/fam-&fam-version;.tar.gz">
    8 <!ENTITY fam-download-ftp "ftp://oss.sgi.com/projects/fam/download/stable/fam-&fam-version;.tar.gz">
    9 <!ENTITY fam-md5sum "1bf3ae6c0c58d3201afc97c6a4834e39">
    10 <!ENTITY fam-size "301 KB">
    11 <!ENTITY fam-buildsize "7.7 MB">
    12 <!ENTITY fam-time "0.26 SBU">
     7  <!ENTITY fam-download-http "http://gd.tuwien.ac.at/opsys/linux/gentoo/distfiles/fam-&fam-version;.tar.gz">
     8  <!ENTITY fam-download-ftp "ftp://oss.sgi.com/projects/fam/download/stable/fam-&fam-version;.tar.gz">
     9  <!ENTITY fam-md5sum "1bf3ae6c0c58d3201afc97c6a4834e39">
     10  <!ENTITY fam-size "301 KB">
     11  <!ENTITY fam-buildsize "7.7 MB">
     12  <!ENTITY fam-time "0.26 SBU">
    1313]>
    1414
    1515<sect1 id="fam" xreflabel="FAM-&fam-version;">
    16 <sect1info>
    17   <othername>$LastChangedBy$</othername>
    18   <date>$Date$</date>
    19 </sect1info>
    20 
    21 <?dbhtml filename="fam.html"?>
    22 <title>FAM-&fam-version;</title>
    23 
    24 <indexterm zone="fam">
    25   <primary sortas="a-FAM">FAM</primary>
    26 </indexterm>
    27 
    28 <sect2>
    29 <title>Introduction to <application><acronym>FAM</acronym></application></title>
    30 
    31 <para>The <application><acronym>FAM</acronym></application> package contains a
    32 File Alteration Monitor which is useful for notifying applications of
    33 changes to the file system.</para>
    34 
    35 <sect3><title>Package information</title>
    36   <itemizedlist spacing='compact'>
    37   <listitem><para>Download (HTTP): <ulink url="&fam-download-http;"/></para></listitem>
    38   <listitem><para>Download (FTP): <ulink url="&fam-download-ftp;"/></para></listitem>
    39   <listitem><para>Download MD5 sum: &fam-md5sum;</para></listitem>
    40   <listitem><para>Download size: &fam-size;</para></listitem>
    41   <listitem><para>Estimated disk space required: &fam-buildsize;</para></listitem>
    42   <listitem><para>Estimated build time: &fam-time;</para></listitem>
    43 </itemizedlist>
    44 </sect3>
    45 
    46 <sect3>
    47 <title>Additional downloads</title>
    48 <itemizedlist spacing='compact'>
    49   <listitem><para>Dnotify patch (Recommended):
    50     <ulink url="&patch-root;/fam-&fam-version;-dnotify-1.patch"/></para></listitem>
    51 </itemizedlist>
    52 </sect3>
    53 
    54 <sect3>
    55 <title><application><acronym>FAM</acronym></application> dependencies</title>
    56 
    57 <sect4>
    58 <title>Required</title>
    59   <para><xref linkend="portmap"/></para></sect4>
    60 </sect3>
    61 
    62 </sect2>
    63 
    64 <sect2>
    65 <title>Installation of <application><acronym>FAM</acronym></application></title>
    66 
    67 <para>Install <application><acronym>FAM</acronym></application> by running the
    68 following commands:</para>
    69 
    70 <screen><userinput><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch &amp;&amp;
     16  <?dbhtml filename="fam.html"?>
     17 
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22 
     23  <title>FAM-&fam-version;</title>
     24 
     25  <indexterm zone="fam">
     26    <primary sortas="a-FAM">FAM</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to FAM</title>
     31   
     32    <para>The <application>FAM</application> package contains a
     33    File Alteration Monitor which is useful for notifying applications of
     34    changes to the file system.</para>
     35   
     36    <bridgehead renderas="sect3">Package Information</bridgehead>
     37    <itemizedlist spacing="compact">
     38      <listitem>
     39        <para>Download (HTTP): <ulink url="&fam-download-http;"/></para>
     40      </listitem>
     41      <listitem>
     42        <para>Download (FTP): <ulink url="&fam-download-ftp;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download MD5 sum: &fam-md5sum;</para>
     46      </listitem>
     47      <listitem>
     48        <para>Download size: &fam-size;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Estimated disk space required: &fam-buildsize;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated build time: &fam-time;</para>
     55      </listitem>
     56    </itemizedlist>
     57   
     58    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     59    <itemizedlist spacing='compact'>
     60      <listitem>
     61        <para>Dnotify patch (Recommended):
     62        <ulink url="&patch-root;/fam-&fam-version;-dnotify-1.patch"/></para>
     63      </listitem>
     64    </itemizedlist>
     65   
     66    <bridgehead renderas="sect3">FAM Dependencies</bridgehead>
     67   
     68    <bridgehead renderas="sect4">Required</bridgehead>
     69    <para><xref linkend="portmap"/></para>
     70   
     71  </sect2>
     72 
     73  <sect2 role="installation">
     74    <title>Installation of FAM</title>
     75
     76    <para>Install <application>FAM</application> by running the
     77    following commands:</para>
     78
     79<screen><userinput>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch &amp;&amp;
    7180chmod 755 configure &amp;&amp;
    7281autoreconf -f -i &amp;&amp;
    7382./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
    74 make</command></userinput></screen>
    75 
    76 <para>Now, as the root user:</para>
    77  
    78 <screen><userinput role='root'><command>make install</command></userinput></screen>
    79 
    80 </sect2>
    81 
    82 <sect2>
    83 <title>Command Explanations</title>
    84 
    85 <para><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch</command>:
    86 This patch enables <application><acronym>FAM</acronym></application> to use
    87 the Linux kernel dnotify mechanism to inform the calling process of
    88 file modifications, rather than polling the file system for
    89 modifications.</para>
    90 
    91 <para><command>chmod 755 configure</command>: <command>configure</command> is
    92 set to read-only and <command>autoreconf</command> will fail if the
    93 permissions aren't changed.</para>
    94 
    95 <para><command>autoreconf -f -i</command>: The autotools need rebuilding
    96 because the dnotify patch affects <filename>configure.ac</filename> and
    97 <filename>Makefile.am</filename>.</para>
    98 
    99 </sect2>
    100 
    101 <sect2>
    102 <title>Configuring <application>FAM</application></title>
    103 
    104 <sect3 id='fam-config'>
    105 <title>Config files</title>
    106 
    107 <para><filename>/etc/rpc</filename>,
    108  <filename>/etc/fam.conf</filename>,
    109  <filename>/etc/inetd.conf</filename> or
    110  <filename>/etc/xinetd.conf</filename> or
    111  <filename>/etc/xinetd.d/fam</filename>
    112 </para>
    113 
    114  <indexterm zone="fam fam-config">
    115    <primary sortas="e-etc-rpc">/etc/rpc</primary>
    116  </indexterm>
    117  <indexterm zone="fam fam-config">
    118    <primary sortas="e-etc-fam.conf">/etc/fam.conf</primary>
    119  </indexterm>
    120  <indexterm zone="fam fam-config">
    121    <primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary>
    122  </indexterm>
    123  <indexterm zone="fam fam-config">
    124    <primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary>
    125  </indexterm>
    126  <indexterm zone="fam fam-config">
    127    <primary sortas="e-etc-xinetd.d-sgi_fam">/etc/xinetd.d/sgi_fam</primary>
    128  </indexterm>
    129 </sect3>
    130 
    131 <sect3><title>Configuration Information</title>
    132 
    133 <para>Configuring the file alteration monitor.</para>
    134 
    135 <para>If you use <application>inetd</application>, add the
    136 <application><acronym>FAM</acronym></application> entry to
    137 <filename>/etc/inetd.conf</filename> with the following command:</para>
    138 
    139 <screen><userinput><command>echo "sgi_fam/1-2 stream  rpc/tcp wait root /usr/sbin/famd fam" \
    140     &gt;&gt; /etc/inetd.conf</command></userinput></screen>
    141 
    142 <para>If you use <application>xinetd</application>, the following command will
    143 create the <application><acronym>FAM</acronym></application> file as
    144 <filename>/etc/xinetd.d/sgi_fam</filename> (be sure the "nogroup" group
    145 exists):</para>
    146 
    147 <screen><userinput><command>cat &gt;&gt; /etc/xinetd.d/sgi_fam &lt;&lt; "EOF"</command>
    148 # Begin /etc/xinetd.d/sgi_fam
     83make</userinput></screen>
     84   
     85    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     86   
     87<screen role="root"><userinput>make install</userinput></screen>
     88   
     89  </sect2>
     90 
     91  <sect2 role="commands">
     92    <title>Command Explanations</title>
     93
     94    <para><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch</command>:
     95    This patch enables <application>FAM</application> to use
     96    the Linux kernel dnotify mechanism to inform the calling process of
     97    file modifications, rather than polling the file system for
     98    modifications.</para>
     99   
     100    <para><command>chmod 755 configure</command>: <command>configure</command> is
     101    set to read-only and <command>autoreconf</command> will fail if the
     102    permissions aren't changed.</para>
     103   
     104    <para><command>autoreconf -f -i</command>: The autotools need rebuilding
     105    because the dnotify patch affects <filename>configure.ac</filename> and
     106    <filename>Makefile.am</filename>.</para>
     107   
     108  </sect2>
     109 
     110  <sect2 role="configuration">
     111    <title>Configuring FAM</title>
     112
     113    <sect3 id='fam-config'>
     114      <title>Config Files</title>
     115     
     116      <para><filename>/etc/rpc</filename>,
     117      <filename>/etc/fam.conf</filename>,
     118      <filename>/etc/inetd.conf</filename> or
     119      <filename>/etc/xinetd.conf</filename> or
     120      <filename>/etc/xinetd.d/fam</filename></para>
     121     
     122      <indexterm zone="fam fam-config">
     123        <primary sortas="e-etc-rpc">/etc/rpc</primary>
     124      </indexterm>
     125     
     126      <indexterm zone="fam fam-config">
     127        <primary sortas="e-etc-fam.conf">/etc/fam.conf</primary>
     128      </indexterm>
     129     
     130      <indexterm zone="fam fam-config">
     131        <primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary>
     132      </indexterm>
     133     
     134      <indexterm zone="fam fam-config">
     135        <primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary>
     136      </indexterm>
     137     
     138      <indexterm zone="fam fam-config">
     139        <primary sortas="e-etc-xinetd.d-sgi_fam">/etc/xinetd.d/sgi_fam</primary>
     140      </indexterm>
     141   
     142    </sect3>
     143
     144    <sect3>
     145      <title>Configuration Information</title>
     146
     147      <para>Configuring the File Alteration Monitor.</para>
     148     
     149      <para>If you use <application>inetd</application>, add the
     150      <application>FAM</application> entry to
     151      <filename>/etc/inetd.conf</filename> with the following command:</para>
     152
     153<screen role="root"><userinput>echo "sgi_fam/1-2 stream  rpc/tcp wait root /usr/sbin/famd fam" \
     154    &gt;&gt; /etc/inetd.conf</userinput></screen>
     155
     156      <para>If you use <application>xinetd</application>, the following command will
     157      create the <application>FAM</application> file as
     158      <filename>/etc/xinetd.d/sgi_fam</filename> (be sure the "nogroup" group
     159      exists):</para>
     160
     161<screen role="root"><userinput>cat &gt;&gt; /etc/xinetd.d/sgi_fam &lt;&lt; "EOF"
     162<literal># Begin /etc/xinetd.d/sgi_fam
    149163
    150164# description: FAM - file alteration monitor
    … …  
    162176    }
    163177
    164 # End /etc/xinetd.d/sgi_fam
    165 <command>EOF</command></userinput></screen>
    166 
    167 <para id='fam-init'>If you do not have an <command>inetd</command> daemon
    168 installed and have no wish to install one, you can also start
    169 <command>famd</command> during system startup by installing the
    170 <filename>/etc/rc.d/init.d/fam</filename> init script included in the
    171 <xref linkend="intro-important-bootscripts"/> package.</para>
    172 
    173 <screen><userinput><command>make install-fam</command></userinput></screen>
    174 
    175 <indexterm zone="fam fam-init">
    176   <primary sortas="f-fam">fam</primary>
    177 </indexterm>
    178 
    179 </sect3>
    180 
    181 </sect2>
    182 
    183 <sect2>
    184 <title>Contents</title>
    185 
    186 <segmentedlist>
    187   <segtitle>Installed Program</segtitle>
    188   <segtitle>Installed Library</segtitle>
    189   <segtitle>Installed Directories</segtitle>
    190  
    191   <seglistitem>
    192     <seg>famd</seg>
    193     <seg>libfam.[so,a]</seg>
    194     <seg>None</seg>
    195   </seglistitem>
    196 </segmentedlist>
    197  
    198 <variablelist>
    199   <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    200   <?dbfo list-presentation="list"?>
    201 
    202 <varlistentry id="famd">
    203   <term><command>famd</command></term>
    204   <listitem>
    205     <para>is the file alteration monitor daemon.</para>
    206     <indexterm zone="fam famd">
    207       <primary sortas="b-famd">famd</primary>
    208     </indexterm>
    209   </listitem>
    210 </varlistentry>
    211 
    212 <varlistentry id="libfam">
    213   <term><filename class='libraryfile'>libfam.[so,a]</filename></term>
    214   <listitem>
    215     <para>contains functions that support the file allocation monitor.</para>
    216     <indexterm zone="fam libfam">
    217       <primary sortas="c-libfam">libfam.[so,a]</primary>
    218     </indexterm>
    219   </listitem>
    220 </varlistentry>
    221 
    222 </variablelist>
    223 </sect2>
     178# End /etc/xinetd.d/sgi_fam</literal>
     179EOF</userinput></screen>
     180
     181      <para id='fam-init'>If you do not have an <command>inetd</command> daemon
     182      installed and have no wish to install one, you can also start
     183      <command>famd</command> during system startup by installing the
     184      <filename>/etc/rc.d/init.d/fam</filename> init script included in the
     185      <xref linkend="intro-important-bootscripts"/> package.</para>
     186
     187<screen role="root"><userinput>make install-fam</userinput></screen>
     188
     189      <indexterm zone="fam fam-init">
     190        <primary sortas="f-fam">fam</primary>
     191      </indexterm>
     192     
     193    </sect3>
     194   
     195  </sect2>
     196 
     197  <sect2 role="content">
     198    <title>Contents</title>
     199
     200    <segmentedlist>
     201      <segtitle>Installed Program</segtitle>
     202      <segtitle>Installed Library</segtitle>
     203      <segtitle>Installed Directories</segtitle>
     204   
     205      <seglistitem>
     206        <seg>famd</seg>
     207        <seg>libfam.[so,a]</seg>
     208        <seg>None</seg>
     209      </seglistitem>
     210    </segmentedlist>
     211   
     212    <variablelist>
     213      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     214      <?dbfo list-presentation="list"?>
     215      <?dbhtml list-presentation="table"?>
     216   
     217    <varlistentry id="famd">
     218      <term><command>famd</command></term>
     219      <listitem>
     220        <para>is the file alteration monitor daemon.</para>
     221        <indexterm zone="fam famd">
     222          <primary sortas="b-famd">famd</primary>
     223        </indexterm>
     224      </listitem>
     225    </varlistentry>
     226   
     227    <varlistentry id="libfam">
     228      <term><filename class='libraryfile'>libfam.[so,a]</filename></term>
     229      <listitem>
     230        <para>contains functions that support the file allocation monitor.</para>
     231        <indexterm zone="fam libfam">
     232          <primary sortas="c-libfam">libfam.[so,a]</primary>
     233        </indexterm>
     234      </listitem>
     235    </varlistentry>
     236   
     237    </variablelist>
     238   
     239  </sect2>
    224240
    225241</sect1>
Note: See TracChangeset for help on using the changeset viewer.