Ignore:
Timestamp:
06/12/2004 10:56:28 PM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
d3edf27
Parents:
bfe245f
Message:

XML Updates to Part III from DJ

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/genlib/fam.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY fam-download-http " ">
     8<!ENTITY fam-download-ftp "ftp://oss.sgi.com/projects/fam/download/stable/fam-&fam-version;.tar.gz">
     9<!ENTITY fam-size "320 KB">
     10<!ENTITY fam-buildsize "6.9 MB">
     11<!ENTITY fam-time "0.68 SBU">
     12
     13]>
     14
    115<sect1 id="fam" xreflabel="FAM-&fam-version;">
    216<?dbhtml filename="fam.html"?>
    317<title>FAM-&fam-version;</title>
    418
    5 &fam-intro;
    6 &fam-inst;
    7 &fam-exp;
    8 &fam-config;
    9 &fam-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>FAM</acronym></application></title>                                                                               
     21<para>The <application><acronym>FAM</acronym></application> package contains a
     22File Alteration Monitor which is useful for notifying applications of
     23changes to the file system.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&fam-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&fam-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &fam-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&fam-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&fam-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title>Additional downloads</title>
     39<itemizedlist spacing='compact'>
     40<listitem><para>Dnotify patch (Recommended): <ulink
     41url="&patch-root;/fam-&fam-version;-dnotify-1.patch"/></para></listitem></itemizedlist>
     42</sect3>
     43                                                                               
     44                                                                               
     45<sect3><title><application><acronym>FAM</acronym></application> dependencies
     46</title>
     47<sect4><title>Required</title>
     48<para><xref linkend="portmap"/></para></sect4>
     49</sect3>
     50                                                                               
     51</sect2>
     52                                                                               
     53<sect2>
     54<title>Installation of <application><acronym>FAM</acronym></application></title>                                                                               
     55<para>Install <application><acronym>FAM</acronym></application> by running the
     56following commands:</para>
     57                                                                               
     58<screen><userinput><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch &amp;&amp;
     59autoreconf -f -i &amp;&amp;
     60./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     61make &amp;&amp;
     62make install</command></userinput></screen>
     63                                                                               
     64</sect2>
     65
     66<sect2>
     67<title>Command explanations</title>
     68                                                                               
     69<para><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch</command>: This patch enables
     70<application><acronym>FAM</acronym></application> to use the Linux kernel
     71dnotify mechanism to inform the calling process of
     72file modifications, rather than polling the file system for
     73modifications.</para>
     74                                                                               
     75<para><command>autoreconf -f -i</command>
     76This command is necessary since the dnotify patch affects the
     77<filename>configure.ac</filename> and <filename>Makefile.am</filename>.</para>
     78                                                                               
     79</sect2>
     80
     81<sect2>
     82<title>Configuring <application><acronym>FAM</acronym></application></title>
     83                                                                               
     84<sect3><title>Config files</title>
     85                                                                               
     86<para><filename>/etc/rpc</filename>,
     87 <filename>/etc/fam.conf</filename>,
     88 <filename>/etc/inetd.conf</filename>,
     89 <filename>/etc/xinetd.d/fam</filename>
     90 or <filename>/etc/xinetd.conf</filename>
     91 </para>
     92</sect3>
     93                                                                               
     94<sect3><title>Configuration Information</title>
     95                                                                               
     96<para>Configuring the file alteration monitor.</para>
     97                                                                               
     98<para>If you use <application>inetd</application>, add the
     99<application><acronym>FAM</acronym></application> entry to
     100<filename>/etc/inetd.conf</filename> with the
     101following command: </para>
     102                                                                               
     103<screen><userinput><command>echo "sgi_fam/1-2 stream  rpc/tcp wait root /usr/sbin/famd fam" &gt;&gt; /etc/inetd.conf</command></userinput></screen>
     104                                                                               
     105<para>If you use <application>xinetd</application>, add an entry to
     106<filename>/etc/xinetd.conf</filename> with the following command (be
     107sure the "nogroup" group exists):</para>
     108                                                                               
     109<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
     110    # description: FAM - file alteration monitor
     111    service sgi_fam
     112    {
     113        type            = RPC UNLISTED
     114        socket_type     = stream
     115        user            = root
     116        group           = nogroup
     117        server          = /usr/sbin/famd
     118        wait            = yes
     119        protocol        = tcp
     120        rpc_version     = 2
     121        rpc_number      = 391002
     122    }
     123<command>EOF</command></userinput></screen>
     124                                                                               
     125<para>If you do not have any inetd daemon installed and have no
     126wish to install one, you can also start fam during system startup
     127by installing <filename>/etc/rc.d/init.d/fam</filename>
     128init script included in the
     129<xref linkend="intro-important-bootscripts"/> package.</para>
     130                                                                               
     131                                                                               
     132<screen><userinput><command>make install-fam</command></userinput></screen>
     133                                                                               
     134</sect3>
     135                                                                               
     136</sect2>
     137
     138<sect2>
     139<title>Contents</title>
     140                                                                               
     141<para>The <application><acronym>FAM</acronym></application> package contains
     142the <command>famd</command> executable and <filename>libfam</filename>
     143libraries.</para>
     144                                                                               
     145</sect2>
     146                                                                               
     147<sect2><title>Description</title>
     148                                                                               
     149<sect3><title>famd</title>
     150                                                                               
     151<para><command>famd</command> is the file alteration monitor.</para>
     152                                                                               
     153</sect3>
     154                                                                               
     155</sect2>
    10156
    11157</sect1>
     158
Note: See TracChangeset for help on using the changeset viewer.