usr.sbin/portmap/portmap.8

   1 .\" Copyright (c) 1987 Sun Microsystems
   2 .\" Copyright (c) 1990, 1991, 1993
   3 .\"     The Regents of the University of California.  All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. All advertising materials mentioning features or use of this software
  14 .\"    must display the following acknowledgement:
  15 .\"     This product includes software developed by the University of
  16 .\"     California, Berkeley and its contributors.
  17 .\" 4. Neither the name of the University nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .\"     @(#)portmap.8   8.1 (Berkeley) 6/6/93
  34 .\" $FreeBSD$
  35 .\"
  36 .Dd June 6, 1993
  37 .Dt PORTMAP 8
  38 .Os BSD 4.3
  39 .Sh NAME
  40 .Nm portmap
  41 .Nd
  42 .Tn RPC
  43 program,version
  44 to
  45 .Tn DARPA
  46 port mapper
  47 .Sh SYNOPSIS
  48 .Nm portmap
  49 .Op Fl d
  50 .Op Fl v
  51 .Sh DESCRIPTION
  52 .Nm Portmap
  53 is a server that converts
  54 .Tn RPC
  55 program numbers into
  56 .Tn DARPA
  57 protocol port numbers.
  58 It must be running in order to make
  59 .Tn RPC
  60 calls.
  61 .Pp
  62 When an
  63 .Tn RPC
  64 server is started, it will tell
  65 .Nm
  66 what port number it is listening to, and what
  67 .Tn RPC
  68 program numbers it is prepared to serve.
  69 When a client wishes to make an
  70 .Tn RPC
  71 call to a given program number,
  72 it will first contact
  73 .Nm
  74 on the server machine to determine
  75 the port number where
  76 .Tn RPC
  77 packets should be sent.
  78 .Pp
  79 .Nm Portmap
  80 must be started before any
  81 .Tn RPC
  82 servers are invoked.
  83 .Pp
  84 .Nm Portmap
  85 uses
  86 .Xr hosts_access 5
  87 access control by default.
  88 Access control patterns may only reference IP addresses.
  89 .Pp
  90 Normally
  91 .Nm
  92 forks and dissociates itself from the terminal
  93 like any other daemon.
  94 .Nm Portmap
  95 then logs errors using
  96 .Xr syslog 3 .
  97 .Pp
  98 The following options are available:
  99 .Bl -tag -width indent
 100 .It Fl d
 101 Prevent
 102 .Nm
 103 from running as a daemon,
 104 and causes errors and debugging information
 105 to be printed to the standard error output.
 106 .It Fl v
 107 Enable verbose logging of access control checks.
 108 .El
 109 .Sh SEE ALSO
 110 .Xr hosts_access 5 ,
 111 .Xr inetd.conf 5 ,
 112 .Xr inetd 8 ,
 113 .Xr rpcinfo 8
 114 .Sh BUGS
 115 If
 116 .Nm
 117 crashes, all servers must be restarted.
 118 .Sh HISTORY
 119 The
 120 .Nm
 121 command appeared in
 122 .Bx 4.3