source: basicnet/netprogs/portmap.xml@ d47e7ea9

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY portmap-download-http " ">
  <!ENTITY portmap-download-ftp  "ftp://ftp.porcupine.org/pub/security/portmap_5beta.tar.gz">
  <!ENTITY portmap-size          "20 KB">
  <!ENTITY portmap-buildsize     "250 KB">
  <!ENTITY portmap-time          "0.03 SBU">
]>

<sect1 id="portmap" xreflabel="portmap-&portmap-version;">
<?dbhtml filename="portmap.html"?>
<title>portmap-&portmap-version;</title>

<sect2>
<title>Introduction to <application>portmap</application></title>

<para>The <application>portmap</application> package is a more secure 
replacement for the original SUN <application>portmap</application> package.  
<application>Portmap</application> is used to forward <acronym>RPC</acronym>
requests to <acronym>RPC</acronym> daemons such as <acronym>NFS</acronym>
and <acronym>NIS</acronym>.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&portmap-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&portmap-download-ftp;"/></para></listitem>
<listitem><para>Download size: &portmap-size;</para></listitem>
<listitem><para>Estimated Disk space required:
&portmap-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&portmap-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required patch: <ulink
url="&patch-root;/portmap-5beta-compilation-fixes-2.patch"/></para></listitem>
<listitem><para>Required patch: <ulink
url="&patch-root;/portmap-5beta-glibc-errno-fix.patch"/></para></listitem>
</itemizedlist>
</sect3>

                                                                                
<sect3><title><application>portmap</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="tcpwrappers"/></para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>portmap</application></title>

<para>Install <application>portmap</application> with the following commands:</para>

<screen><userinput><command>patch -Np1 -i ../portmap-5beta-compilation-fixes-2.patch &amp;&amp;
patch -Np1 -i ../portmap-5beta-glibc-errno-fix.patch &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

<note><para>The above installation places executable <filename>portmap</filename>
in <filename class="directory">/sbin</filename>. You may choose to move the file
to <filename class="directory">/usr/sbin</filename>. If you do, remember to
modify the bootscript.</para></note>

</sect2>

<sect2>
<title>Configuring <application>portmap</application></title>

<sect3><title>Config files</title>
<para><filename>/etc/rc.d/init.d/portmap</filename></para>
</sect3>

<sect3><title>Boot script</title>

<para>Install the <filename>/etc/rc.d/init.d/portmap</filename>
init script included in the
<xref linkend="intro-important-bootscripts"/> package.</para>
                                                                                                                
<screen><userinput><command>make install-portmap</command></userinput></screen>

</sect3>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>portmap</application> package contains
<command>portmap</command>,
<command>pmap_dump</command> and
<command>pmap_set</command>.</para>
</sect2>

<sect2><title>Description</title>

<sect3><title>portmap</title>
<para><command>portmap</command> is the <acronym>RPC</acronym> port mapper.
</para></sect3>

<sect3><title>pmap_dump</title>
<para><command>pmap_dump</command> saves the port mapping table to an
<acronym>ASCII</acronym> file.</para></sect3>

<sect3><title>pmap_set</title>
<para><command>pmap_set</command> restores the port mapping table from an 
<acronym>ASCII</acronym> file.</para></sect3>
</sect2>

</sect1>