Ignore:
Timestamp:
04/23/2005 06:32:51 AM (19 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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:
eaf6a1cd
Parents:
c2f55d1
Message:

Update nfs-utils to 1.0.7

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/major/nfs-utils.xml

    rc2f55d1 ra16cb066  
    77  <!ENTITY nfs-utils-download-http "http://ftp.kernel.org/pub/linux/utils/nfs/nfs-utils-&nfs-utils-version;.tar.gz">
    88  <!ENTITY nfs-utils-download-ftp  "ftp://ftp.kernel.org/pub/linux/utils/nfs/nfs-utils-&nfs-utils-version;.tar.gz">
    9   <!ENTITY nfs-utils-md5sum        "f17e9983457e1cf61c37f0be4493fce6">
    10   <!ENTITY nfs-utils-size          "260 KB">
    11   <!ENTITY nfs-utils-buildsize     "4.1 MB">
    12   <!ENTITY nfs-utils-time          "0.9 SBU">
     9  <!ENTITY nfs-utils-md5sum        "8f863120261cd572ad320a9152581e11">
     10  <!ENTITY nfs-utils-size          "396 KB">
     11  <!ENTITY nfs-utils-buildsize     "5.8 MB">
     12  <!ENTITY nfs-utils-time          "0.2 SBU">
    1313]>
    1414
    1515<sect1 id="nfs-utils" xreflabel="NFS Utilities-&nfs-utils-version;">
    1616<sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
     17  <othername>$LastChangedBy$</othername>
     18  <date>$Date$</date>
    1919</sect1info>
     20
    2021<?dbhtml filename="nfs-utils.html"?>
    2122<title>NFS Utilities-&nfs-utils-version;</title>
     23
     24<indexterm zone="nfs-utils">
     25  <primary sortas="a-nfs-utils">NFS Utilities</primary>
     26</indexterm>
    2227
    2328<sect2>
    … …  
    2934network.</para>
    3035
    31 <sect3><title>Package information</title>
     36<bridgehead renderas="sect3">Package information</bridgehead>
    3237<itemizedlist spacing='compact'>
    33 <listitem><para>Download (HTTP): <ulink
    34 url="&nfs-utils-download-http;"/></para></listitem>
    35 <listitem><para>Download (FTP): <ulink
    36 url="&nfs-utils-download-ftp;"/></para></listitem>
    37 <listitem><para>Download MD5 sum: &nfs-utils-md5sum;</para></listitem>
    38 <listitem><para>Download size: &nfs-utils-size;</para></listitem>
    39 <listitem><para>Estimated disk space required:
    40 &nfs-utils-buildsize;</para></listitem>
    41 <listitem><para>Estimated build time:
    42 &nfs-utils-time;</para></listitem></itemizedlist>
    43 </sect3>
    44 
    45 <sect3><title><application>nfs-utils</application> dependencies</title>
    46 <sect4><title>Required</title>
     38  <listitem><para>Download (HTTP): <ulink url="&nfs-utils-download-http;"/></para></listitem>
     39  <listitem><para>Download (FTP): <ulink url="&nfs-utils-download-ftp;"/></para></listitem>
     40  <listitem><para>Download MD5 sum: &nfs-utils-md5sum;</para></listitem>
     41  <listitem><para>Download size: &nfs-utils-size;</para></listitem>
     42  <listitem><para>Estimated disk space required: &nfs-utils-buildsize;</para></listitem>
     43  <listitem><para>Estimated build time: &nfs-utils-time;</para></listitem>
     44</itemizedlist>
     45
     46<bridgehead renderas="sect3">nfs-utils Dependencies</bridgehead>
     47<bridgehead renderas="sect4">Required</bridgehead>
     48
    4749<para><xref linkend="portmap"/></para>
    48 </sect4>
    49 </sect3>
    50 
    51 </sect2>
    52 
    53 <sect2>
     50
     51<bridgehead renderas="sect4">Optional</bridgehead>
     52<para><ulink url="http://www.monkey.org/~provos/libevent/">libevent</ulink>
     53and <ulink url="http://www.citi.umich.edu/projects/nfsv4/linux/libnfsidmap/">libnsfidmap</ulink>
     54for nfsv4 support, and kerberos-5 development libraries for gss (RPC Security) support.
     55</para>
     56
     57</sect2>
     58
     59<sect2 id='nfs-utils-kernel'>
    5460<title>Kernel Configuration</title>
    5561
    … …  
    6571are selected.</para>
    6672
     73<indexterm zone="nfs-utils nfs-utils-kernel">
     74  <primary sortas="d-nfs-utils">NFS Utilities</primary>
     75</indexterm>
    6776</sect2>
    6877
    … …  
    7180
    7281<para>Before you compile the program, you need to be sure the "nobody"
    73 user and "nogroup" group are available. You can add these with the
    74 following commands:</para>
    75 
    76 <screen><userinput><command>groupadd -g 65534 nogroup &amp;&amp;
    77 useradd -c nobody -d /home -g nogroup -s /bin/bash -u 65534 nobody</command></userinput></screen>
     82user and "nogroup" group are available. You can add these by
     83running the following commands as the root user:</para>
     84
     85<screen><userinput><command>groupadd -g 99 nogroup &amp;&amp;
     86useradd -c nobody -d /home -g nogroup -s /bin/bash -u 99 nobody</command></userinput></screen>
     87
     88<note><para>The classic uid and gid values are 65534 which is also -2 when
     89interpreted as a signed 16-bit number.  These values impact other files on
     90some filesystems that do not have support for sparse files.  The nobody
     91and nogroup values have small impact.  The impact on a server is nil if the
     92exports file is configured correctly.  If it is misconfigured, the impact is
     93that a ls -l or ps listing will show a uid or gid number of 65534 instead
     94of a name. The client uses nobody only as the user running rpc.statd.</para></note>
    7895
    7996<para>Install nfs-utils by running the following commands:</para>
    8097
    81 <para><screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
    82 make &amp;&amp;
    83 make install</command></userinput></screen></para>
     98<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
     99    --disable-nfsv4 --disable-gss &amp;&amp;
     100make</userinput></screen>
     101
     102<para>Now, as the root user:</para>
     103
     104<screen role='root'><userinput>make install</userinput></screen>
    84105
    85106<note><para>If your <filename>/usr</filename> directory is NFS mounted,
    … …  
    90111</sect2>
    91112
     113<sect2 role="commands">
     114<title>Command Explanations</title>
     115
     116<para><parameter>--disable-nfsv4</parameter>: Disbles support 
     117for NFS Version 4.</para>
     118
     119<para><parameter>--disable-gss</parameter>: Disbles support for
     120RPCSEC GSS (RPC Security).</para>
     121
     122</sect2>
     123
    92124<sect2>
    93125<title>Configuring nfs-utils</title>
    94126
    95 <sect3><title>Server Configutation</title>
    96 
    97 <para><filename>/etc/exports</filename> contains the exported directories on
    98 <acronym>NFS</acronym> servers. Refer to the exports manual page for the
    99 syntax of this file. Also refer to the <acronym>NFS</acronym> HowTo available
    100 at <ulink url="http://nfs.sourceforge.net/nfs-howto/"/> on how to configure
    101 the servers and clients in a secure manner. For example, for sharing the
    102 <filename>/home</filename> directory over the local network, the following
    103 line may be added:</para>
    104 
    105 <screen><userinput>/home 192.168.0.0/255.255.0.0(rw)</userinput></screen>
    106 
    107 <para>Install the <filename>/etc/rc.d/init.d/nfs-server</filename>
    108 init script included in the
    109 <xref linkend="intro-important-bootscripts"/> package to start
     127<bridgehead renderas="sect3">Server Configutation</bridgehead>
     128
     129<para id='nfs-utils-server-config'><filename>/etc/exports</filename> contains
     130the exported directories on NFS servers. Refer to the exports manual page for
     131the syntax of this file. Also refer to the NFS HowTo available at <ulink
     132url="http://nfs.sourceforge.net/nfs-howto/"/> on how to configure the servers
     133and clients in a secure manner. For example, for sharing the
     134<filename>/home</filename> directory over the local network, the following line
     135may be added:</para>
     136
     137<screen><userinput>/home 192.168.0.0/255.255.255.0(rw,anonuid=99,anongid=99)</userinput></screen>
     138
     139<indexterm zone="nfs-utils nfs-utils-server-config">
     140  <primary sortas="e-etc-exportfs">/etc/exportfs</primary>
     141</indexterm>
     142
     143<para>Install the <filename>/etc/rc.d/init.d/nfs-server</filename> init script
     144included in the <xref linkend="intro-important-bootscripts"/> package to start
    110145the server at boot.</para>
    111146
    112147<screen><userinput><command>make install-nfs-server</command></userinput></screen>
    113148
     149<indexterm zone="nfs-utils nfs-utils-server-config">
     150  <primary sortas="f-nfs-server">nfs-server</primary>
     151</indexterm>
     152 
    114153<para>Now create the <filename>/etc/sysconfig/nfs-server</filename>
    115154configuration file:</para>
    … …  
    122161<command>EOF</command></userinput></screen>
    123162
    124 </sect3>
    125 
    126 <sect3><title>Client Configutation</title>
    127 
    128 <para><filename>/etc/fstab</filename> contains the directories that are to be
    129 mounted on the client. Alternately the partitions can be mounted by using the
    130 <command>mount</command> command with the proper options. To mount the
    131 <filename>/home</filename> partition, add the following to the
    132 <filename>/etc/fstab</filename>:</para>
    133 
    134 <screen><userinput>&lt;server-name&gt;:/home /home nfs rw 0 0</userinput></screen>
     163<indexterm zone="nfs-utils nfs-utils-server-config">
     164  <primary sortas="e-etc-sysconfig-nfs-server">/etc/sysconfig/nfs-server</primary>
     165</indexterm>
     166
     167<bridgehead renderas="sect3">Client Configutation</bridgehead>
     168
     169<para id='nfs-utils-client-config'><filename>/etc/fstab</filename> contains the
     170directories that are to be mounted on the client. Alternately the partitions
     171can be mounted by using the <command>mount</command> command with the proper
     172options. To mount the <filename>/home</filename> and <filename>/usr</filename>
     173partitions, add the following to the <filename>/etc/fstab</filename>:</para>
     174
     175<screen><userinput>&lt;server-name&gt;:/home  /home nfs   rw,_netdev,rsize=8192,wsize=8192 0 0
     176&lt;server-name&gt;:/usr   /usr  nfs   ro,_netdev,rsize=8192            0 0</userinput></screen>
     177
     178<indexterm zone="nfs-utils nfs-utils-client-config">
     179  <primary sortas="e-etc-fstab">/etc/fstab</primary>
     180</indexterm>
     181
    135182
    136183<para>Install the <filename>/etc/rc.d/init.d/nfs-client</filename>
    … …  
    141188<screen><userinput><command>make install-nfs-client</command></userinput></screen>
    142189
    143 </sect3>
     190<indexterm zone="nfs-utils nfs-utils-client-config">
     191  <primary sortas="f-nfs-client">nfs-client</primary>
     192</indexterm>
     193
     194<para>To automatically mount nfs filesystems, clients will also need to install
     195the netfs bootscript as described in <xref linkend='postlfs-config-netfs'/>.</para>
     196
     197<indexterm zone="nfs-utils nfs-utils-client-config">
     198  <primary sortas="f-netfs">netfs</primary>
     199</indexterm>
    144200
    145201</sect2>
    … …  
    147203<sect2>
    148204<title>Contents</title>
    149 
    150 <para>The nfs-utils package contains
    151 <command>getiversion</command>,
    152 <command>getkversion</command>,
    153 <command>locktest</command>,
    154 <command>nlmtest</command>,
    155 <command>rpcdebug</command>,
    156 <command>rpcgen</command>,
    157 <command>exportfs</command>,
    158 <command>lockd</command>,
    159 <command>mountd</command>,
    160 <command>nfsd</command>,
    161 <command>nfsstat</command>,
    162 <command>nhfsstone</command>,
    163 <command>rquotad</command>,
    164 <command>showmount</command>,
    165 <command>statd</command> </para>
    166 
    167 </sect2>
    168 
    169 <sect2><title>Description</title>
    170 
    171 <sect3><title>getiversion</title><para>No description available.</para></sect3>
    172 <sect3><title>getkversion</title><para>No description available.</para></sect3>
    173 <sect3><title>locktest</title><para>No description available.</para></sect3>
    174 <sect3><title>nlmtest</title><para>No description available.</para></sect3>
    175 <sect3><title>rpcdebug</title><para>No description available.</para></sect3>
    176 <sect3><title>rpcgen</title><para>No description available.</para></sect3>
    177 <sect3><title>exportfs</title><para><command>exportfs</command>
    178 maintains a list of <acronym>NFS</acronym> exported directories.</para></sect3>
    179 <sect3><title>lockd</title><para><command>lockd</command>
    180 is the <acronym>NFS</acronym> lock manager.</para></sect3>
    181 <sect3><title>mountd</title><para><command>mountd</command>
    182 is the <acronym>NFS</acronym> mount daemon which checks
    183 client-permissions.</para></sect3>
    184 <sect3><title>nfsd</title><para><command>nfsd</command>
    185 is the user-space daemon of the <acronym>NFS</acronym> service.</para></sect3>
    186 <sect3><title>nfsstat</title><para><command>nfsstat</command>
    187 prints <acronym>NFS</acronym> statistics.</para></sect3>
    188 <sect3><title>nhfsstone</title><para><command>nhfsstone</command>
    189 is the <acronym>NFS</acronym> benchmark program.</para></sect3>
    190 <sect3><title>rquotad</title><para><command>rquotad</command>
    191 is the remote quota server communicating with the
    192 <command>quota</command> client.</para></sect3>
    193 <sect3><title>showmount</title><para><command>showmount</command>
    194 shows mount information for an <acronym>NFS</acronym> server.</para></sect3>
    195 <sect3><title>statd</title><para><command>statd</command>
    196 is the <acronym>NFS</acronym> status monitor which implements the
    197 <acronym>NSM</acronym> (Network Status Monitor) <acronym>RPC</acronym> protocol.
    198 </para></sect3>
    199 
    200 </sect2>
    201 
     205<segmentedlist>
     206  <segtitle>Installed Programis</segtitle>
     207  <segtitle>Installed Libraries</segtitle>
     208  <segtitle>Installed Directories</segtitle>
     209 
     210  <seglistitem>
     211    <seg>exportfs, nfsstat, nhfsgraph, nhfsnums, nhfsrun, nhfsstone,
     212         rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd, showmount</seg>
     213    <seg>None</seg>
     214    <seg>/var/lib/nfs</seg>
     215  </seglistitem>
     216</segmentedlist>
     217
     218<variablelist>
     219  <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     220  <?dbfo list-presentation="list"?>
     221  <?dbhtml list-presentation="table"?>
     222
     223<varlistentry id="exportfs">
     224  <term><command>exportfs</command></term>
     225  <listitem>
     226    <para>maintains a list of NFS exported file systems.</para>
     227    <indexterm zone="nfs-utils exportfs">
     228      <primary sortas="b-exportfs">exportfs</primary>
     229    </indexterm>
     230  </listitem>
     231</varlistentry>
     232
     233<varlistentry id="nfsstat">
     234  <term><command>nfsstat</command></term>
     235  <listitem>
     236    <para>prints NFS statistics.</para>
     237    <indexterm zone="nfs-utils nfsstat">
     238      <primary sortas="b-nfsstat">nfsstat</primary>
     239    </indexterm>
     240  </listitem>
     241</varlistentry>
     242
     243<varlistentry id="nhfsgraph">
     244  <term><command>nhfsgraph</command></term>
     245  <listitem>
     246    <para>runs nhfsstone over multiple loads.</para>
     247    <indexterm zone="nfs-utils nhfsgraph">
     248      <primary sortas="b-nhfsgraph">nhfsgraph</primary>
     249    </indexterm>
     250  </listitem>
     251</varlistentry>
     252
     253<varlistentry id="nhfsnums">
     254  <term><command>nhfsnums</command></term>
     255  <listitem>
     256    <para>converts raw numbers from nhfsstone output into plot format.</para>
     257    <indexterm zone="nfs-utils nhfsnums">
     258      <primary sortas="b-nhfsnums">nhfsnums</primary>
     259    </indexterm>
     260  </listitem>
     261</varlistentry>
     262
     263<varlistentry id="nhfsrun">
     264  <term><command>nhfsrun</command></term>
     265  <listitem>
     266    <para>executes nhfsstone with a range of different loads.</para>
     267    <indexterm zone="nfs-utils nhfsrun">
     268      <primary sortas="b-nhfsrun">nhfsrun</primary>
     269    </indexterm>
     270  </listitem>
     271</varlistentry>
     272
     273<varlistentry id="nhfsstone">
     274  <term><command>nhfsstone</command></term>
     275  <listitem>
     276    <para>is used on a NFS client to generate an artificial load with a
     277          particular mix of NFS operations.</para>
     278    <indexterm zone="nfs-utils nhfsstone">
     279      <primary sortas="b-nhfsstone">nhfsstone</primary>
     280    </indexterm>
     281  </listitem>
     282</varlistentry>
     283
     284<varlistentry id="rpclockd">
     285  <term><command>rpc.lockd</command></term>
     286  <listitem>
     287    <para>starts the NFS lock manager (NLM) on kernels that don't
     288       start it automatically.  However, since most kernels do start it
     289       automatically it is usually not required.</para>
     290    <indexterm zone="nfs-utils rpclockd">
     291      <primary sortas="b-rpclockd">rpc.lockd</primary>
     292    </indexterm>
     293  </listitem>
     294</varlistentry>
     295
     296<varlistentry id="rpcmountd">
     297  <term><command>rpc.mountd</command></term>
     298  <listitem>
     299    <para>implements the NFS mount protocol on an NFS server.</para>
     300    <indexterm zone="nfs-utils rpcmountd">
     301      <primary sortas="b-rpcmountd">rpc.mountd</primary>
     302    </indexterm>
     303  </listitem>
     304</varlistentry>
     305
     306<varlistentry id="rpcnfsd">
     307  <term><command>rpc.nfsd</command></term>
     308  <listitem>
     309    <para>implements the user level part of the NFS service on the server.</para>
     310    <indexterm zone="nfs-utils rpcnfsd">
     311      <primary sortas="b-rpcnfsd">rpc.nfsd</primary>
     312    </indexterm>
     313  </listitem>
     314</varlistentry>
     315
     316<varlistentry id="rpcrquotad">
     317  <term><command>rpc.rquotad</command></term>
     318  <listitem>
     319    <para>is an rpc server which returns quotas for a user of a local file
     320       system which is mounted by a remote machine over the NFS.</para>
     321    <indexterm zone="nfs-utils rpcrquotad">
     322      <primary sortas="b-rpcrquotad">rpc.rquotad</primary>
     323    </indexterm>
     324  </listitem>
     325</varlistentry>
     326
     327<varlistentry id="rpcstatd">
     328  <term><command>rpc.statd</command></term>
     329  <listitem>
     330    <para>is used by the NFS file locking service, rpc.lockd, to implement
     331       lock recovery when the NFS server machine crashes and reboots. Runs
     332       on the NFS server only.</para>
     333    <indexterm zone="nfs-utils rpcstatd">
     334      <primary sortas="b-rpcstatd">rpc.statd</primary>
     335    </indexterm>
     336  </listitem>
     337</varlistentry>
     338
     339<varlistentry id="showmount">
     340  <term><command>showmount</command></term>
     341  <listitem>
     342    <para>displays mount information for an NFS server.</para>
     343    <indexterm zone="nfs-utils showmount">
     344      <primary sortas="b-showmount">showmount</primary>
     345    </indexterm>
     346  </listitem>
     347</varlistentry>
     348
     349
     350</variablelist>
     351
     352</sect2>
    202353</sect1>
    203354
Note: See TracChangeset for help on using the changeset viewer.