source: archive/portmap.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 6.8 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 <!-- Inserted as a reminder to do this. The mention of a test suite
8 is usually right before the root user installation commands. Please
9 delete these 12 (including one blank) lines after you are done.-->
10
11 <!-- Use one of the two mentions below about a test suite,
12 delete the line that is not applicable. Of course, if the
13 test suite uses syntax other than "make check", revise the
14 line to reflect the actual syntax to run the test suite -->
15
16 <!-- <para>This package does not come with a test suite.</para> -->
17 <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
18
19 <!ENTITY portmap-download-http "http://neil.brown.name/portmap/portmap-&portmap-version;.tgz">
20 <!ENTITY portmap-download-ftp " ">
21 <!ENTITY portmap-md5sum "ac108ab68bf0f34477f8317791aaf1ff">
22 <!ENTITY portmap-size "21 KB">
23 <!ENTITY portmap-buildsize "268 KB">
24 <!ENTITY portmap-time "0.01 SBU">
25]>
26
27<sect1 id="portmap" xreflabel="portmap-&portmap-version;">
28 <?dbhtml filename="portmap.html"?>
29
30 <sect1info>
31 <date>$Date$</date>
32 </sect1info>
33
34 <title>Portmap-&portmap-version;</title>
35
36 <indexterm zone="portmap">
37 <primary sortas="a-Portmap">Portmap</primary>
38 </indexterm>
39
40 <sect2 role="package">
41 <title>Introduction to Portmap</title>
42
43 <para>The <application>portmap</application> package is a more secure
44 replacement for the original SUN <application>portmap</application> package.
45 <application>Portmap</application> is used to forward RPC requests to RPC
46 daemons such as NFS and NIS.</para>
47
48 &lfs70_checked;
49
50 <bridgehead renderas="sect3">Package Information</bridgehead>
51 <itemizedlist spacing="compact">
52 <listitem>
53 <para>Download (HTTP): <ulink url="&portmap-download-http;"/></para>
54 </listitem>
55 <listitem>
56 <para>Download (FTP): <ulink url="&portmap-download-ftp;"/></para>
57 </listitem>
58 <listitem>
59 <para>Download MD5 sum: &portmap-md5sum;</para>
60 </listitem>
61 <listitem>
62 <para>Download size: &portmap-size;</para>
63 </listitem>
64 <listitem>
65 <para>Estimated disk space required: &portmap-buildsize;</para>
66 </listitem>
67 <listitem>
68 <para>Estimated build time: &portmap-time;</para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">Portmap Dependencies</bridgehead>
73
74 <bridgehead renderas="sect4">Required</bridgehead>
75 <para role="required">
76 <xref linkend="libtirpc"/>
77 </para>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <xref linkend="tcpwrappers"/>
82 </para>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/portmap"/></para>
86
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of Portmap</title>
91
92 <para>Portmap runs as a daemon with a uid of 1. This uid is only
93 configurable at compile time and is used as default. To set up a
94 user to match this uid, as the <systemitem class="username">root</systemitem>
95 user, issue:</para>
96
97<screen><userinput>useradd -u 1 -g 1 -d /dev/null -s /bin/false bin</userinput></screen>
98
99 <para>Install <application>portmap</application> with the following
100 commands:</para>
101
102<screen><userinput>LDLIBS=-ltirpc make</userinput></screen>
103
104 <para>Note that the LDLIBS environment variable must be before the
105 <command>make</command> command.</para>
106
107 <para>If you want the portmap daemon to use a uid/gid other than the
108 defaults, pass DAEMON_UID=x and DAEMON_GID=y as shown below:</para>
109
110 <para><command>LDLIBS=-ltirpc make DAEMON_UID=x DAEMON_GID=y</command></para>
111
112 <para>If you want to build the portmap daemon without
113 <application>tcpwrappers</application>, add
114 <userinput>NO_TCP_WRAPPER=true</userinput> to the make line as shown below:</para>
115
116 <para><command>LDLIBS=-ltirpc make NO_TCP_WRAPPER=true</command></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 <note>
123 <para>The above installation places executable <command>portmap</command>
124 in <filename class="directory">/sbin</filename>. You may choose to move the
125 file to <filename class="directory">/usr/sbin</filename>. If you do,
126 remember to modify the bootscript also.</para>
127 </note>
128
129 </sect2>
130
131 <sect2 role="configuration">
132 <title>Configuring Portmap</title>
133
134 <sect3 id="portmap-init">
135 <title>Boot Script</title>
136
137 <para>Install the <filename>/etc/rc.d/init.d/portmap</filename> init script
138 included in the <xref linkend="bootscripts"/> package.</para>
139
140 <indexterm zone="portmap portmap-init">
141 <primary sortas="f-portmap">portmap</primary>
142 </indexterm>
143
144<screen role="root"><userinput>make install-portmap</userinput></screen>
145
146 </sect3>
147
148 </sect2>
149
150 <sect2 role="content">
151 <title>Contents</title>
152
153 <segmentedlist>
154 <segtitle>Installed Programs</segtitle>
155 <segtitle>Installed Libraries</segtitle>
156 <segtitle>Installed Directories</segtitle>
157
158 <seglistitem>
159 <seg>pmap_dump, pmap_set, and portmap</seg>
160 <seg>None</seg>
161 <seg>None</seg>
162 </seglistitem>
163 </segmentedlist>
164
165 <variablelist>
166 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
167 <?dbfo list-presentation="list"?>
168 <?dbhtml list-presentation="table"?>
169
170 <varlistentry id="pmap_dump">
171 <!-- Don't remove the extra space, it prevent a FOP warning. -->
172 <term><command>pmap_dump</command> </term>
173 <listitem>
174 <para>saves the port mapping table to an ASCII file.</para>
175 <indexterm zone="portmap pmap_dump">
176 <primary sortas="b-pmap_dump">pmap_dump</primary>
177 </indexterm>
178 </listitem>
179 </varlistentry>
180
181 <varlistentry id="pmap_set">
182 <term><command>pmap_set</command></term>
183 <listitem>
184 <para>restores the port mapping table from an ASCII file.</para>
185 <indexterm zone="portmap pmap_set">
186 <primary sortas="b-pmap_set">pmap_set</primary>
187 </indexterm>
188 </listitem>
189 </varlistentry>
190
191 <varlistentry id="portmap-prog">
192 <term><command>portmap</command></term>
193 <listitem>
194 <para>is an RPC port mapper.</para>
195 <indexterm zone="portmap portmap-prog">
196 <primary sortas="b-portmap">portmap</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 </variablelist>
202
203 </sect2>
204
205</sect1>
206
Note: See TracBrowser for help on using the repository browser.