source: networking/netprogs/rpcbind.xml@ a98af0b4

nosym
Last change on this file since a98af0b4 was a98af0b4, checked in by DJ Lucas <dj@…>, 8 years ago

Sync to r18048.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/nosym@18049 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY rpcbind-download-http "&sourceforge-repo;/rpcbind/rpcbind-&rpcbind-version;.tar.bz2">
8 <!ENTITY rpcbind-download-ftp " ">
9 <!ENTITY rpcbind-md5sum "cf10cd41ed8228fc54c316191c1f07fe">
10 <!ENTITY rpcbind-size "120 KB">
11 <!ENTITY rpcbind-buildsize "1.6 MB">
12 <!ENTITY rpcbind-time "less than 0.1 SBU">
13]>
14
15<sect1 id="rpcbind" xreflabel="rpcbind-&rpcbind-version;">
16 <?dbhtml filename="rpcbind.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>rpcbind-&rpcbind-version;</title>
24
25 <indexterm zone="rpcbind">
26 <primary sortas="a-rpcbind">rpcbind</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to rpcbind</title>
31
32 <para>The <application>rpcbind</application> program is a replacement for
33 <application>portmap</application>. It is required for import or export
34 of Network File System (NFS) shared directories. </para>
35
36 &lfs7a_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&rpcbind-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&rpcbind-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &rpcbind-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &rpcbind-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &rpcbind-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &rpcbind-time;</para>
57 </listitem>
58 </itemizedlist>
59<!--
60 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
61 <itemizedlist spacing="compact">
62 <listitem>
63 <para>
64 Required patch:
65 <ulink url="&patch-root;/rpcbind-&rpcbind-version;-tirpc_fix-1.patch"/>
66 </para>
67 </listitem>
68 </itemizedlist>
69-->
70 <bridgehead renderas="sect3">rpcbind Dependencies</bridgehead>
71
72 <bridgehead renderas="sect4">Required</bridgehead>
73 <para role="required">
74 <xref linkend="libtirpc"/>
75 </para>
76
77 <para condition="html" role="usernotes">User Notes:
78 <ulink url="&blfs-wiki;/rpcbind"/></para>
79
80 </sect2>
81
82 <sect2 role="installation">
83 <title>Installation of rpcbind</title>
84
85 <para revision="systemd">
86 There should be a dedicated user and group to take control
87 of the <command>rpcbind</command> daemon after it is started.
88 Issue the following commands as the
89 <systemitem class="username">root</systemitem> user:
90 </para>
91
92<screen role="root" revision="systemd"><userinput>groupadd -g 28 rpc &amp;&amp;
93useradd -c "RPC Bind Daemon Owner" -d /dev/null -g rpc \
94 -s /bin/false -u 28 rpc</userinput></screen>
95
96 <!-- Packages should adapt to standards, not the other way around -->
97 <para>In order to get <application>rpcbind</application> to work
98 properly, first fix the package to use correct service name:</para>
99
100<screen><userinput>sed -i "/servname/s:rpcbind:sunrpc:" src/rpcbind.c</userinput></screen>
101
102 <para>Install <application>rpcbind</application> by running the following
103 commands:</para>
104
105<screen revision="sysv"><userinput>./configure --prefix=/usr \
106 --bindir=/sbin \
107 --with-rpcuser=root \
108 --without-systemdsystemunitdir &amp;&amp;
109make</userinput></screen>
110
111<screen revision="systemd"><userinput>./configure --prefix=/usr \
112 --bindir=/sbin \
113 --with-rpcuser=rpc &amp;&amp;
114make</userinput></screen>
115
116 <para>This package does not come with a test suite.</para>
117
118 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
119
120<screen role="root"><userinput>make install</userinput></screen>
121
122 </sect2>
123
124 <sect2 role="commands">
125 <title>Command Explanations</title>
126
127 <para revision="sysv"><command>--with-rpcuser=root</command>: This works
128 around an error in the configure script.</para>
129
130 <para revision="sysv"><command>--without-systemdsystemunitdir</command>:
131 This version of BLFS does not support systemd.</para>
132
133 <para revision="systemd"><parameter>--with-rpcuser=rpc</parameter>:
134 This switch is used so the <command>rpcbind</command> daemon will
135 run as an unprivileged user instead of the
136 <systemitem class="username">root</systemitem> user.</para>
137
138 </sect2>
139
140 <sect2 role="configuration">
141 <title>Configuring rpcbind</title>
142
143 <sect3 id="rpcbind-init">
144 <title><phrase revision="sysv">Boot Script</phrase>
145 <phrase revision="systemd">Systemd Unit</phrase></title>
146
147 <para>Install the
148 <phrase revision="sysv"><filename>/etc/rc.d/init.d/rpcbind</filename>
149 init script</phrase>
150 <phrase revision="systemd"><filename>rpcbind.service</filename>
151 unit</phrase> included in the
152 <xref linkend="bootscripts" revision="sysv"/>
153 <xref linkend="systemd-units" revision="systemd"/> package.</para>
154
155 <indexterm zone="rpcbind rpcbind-init" revision="sysv">
156 <primary sortas="f-rpcbind">rpcbind</primary>
157 </indexterm>
158
159 <indexterm zone="rpcbind rpcbind-init" revision="systemd">
160 <primary sortas="f-rpcbind">rpcbind.service</primary>
161 </indexterm>
162
163<screen role="root"><userinput>make install-rpcbind</userinput></screen>
164
165 </sect3>
166
167 </sect2>
168
169 <sect2 role="content">
170 <title>Contents</title>
171
172 <segmentedlist>
173 <segtitle>Installed Program</segtitle>
174 <segtitle>Installed Libraries</segtitle>
175 <segtitle>Installed Directories</segtitle>
176
177 <seglistitem>
178 <seg>rpcbind and rpcinfo</seg>
179 <seg>None</seg>
180 <seg>None</seg>
181 </seglistitem>
182 </segmentedlist>
183
184 <variablelist>
185 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
186 <?dbfo list-presentation="list"?>
187 <?dbhtml list-presentation="table"?>
188
189 <varlistentry id="rpcbind-prog">
190 <term><command>rpcbind</command></term>
191 <listitem>
192 <para>is a server that converts RPC program numbers into universal
193 addresses. It must be running on the host to be able to make RPC
194 calls on a server on that machine. </para>
195 <indexterm zone="rpcbind rpcbind-prog">
196 <primary sortas="b-rpcbind">rpcbind</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="rpcinfo">
202 <term><command>rpcinfo</command></term>
203 <listitem>
204 <para>makes an RPC call to an RPC server and reports data according
205 to the requested options. </para>
206 <indexterm zone="rpcbind rpcinfo">
207 <primary sortas="b-rpcinfo">rpcinfo</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 </variablelist>
213
214 </sect2>
215
216</sect1>
Note: See TracBrowser for help on using the repository browser.