xref: /original-bsd/usr.sbin/portmap/portmap.8 (revision c3e32dec)
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.\" %sccs.include.redist.man%
6.\"
7.\"     @(#)portmap.8	8.1 (Berkeley) 06/06/93
8.\"
9.Dd
10.Dt PORTMAP 8
11.Os BSD 4.3
12.Sh NAME
13.Nm portmap
14.Nd
15.Tn DARPA
16port to
17.Tn RPC
18program number mapper
19.Sh SYNOPSIS
20.Nm portmap
21.Op Fl d
22.Sh DESCRIPTION
23.Nm Portmap
24is a server that converts
25.Tn RPC
26program numbers into
27.Tn DARPA
28protocol port numbers.
29It must be running in order to make
30.Tn RPC
31calls.
32.Pp
33When an
34.Tn RPC
35server is started, it will tell
36.Nm portmap
37what port number it is listening to, and what
38.Tn RPC
39program numbers it is prepared to serve.
40When a client wishes to make an
41.Tn RPC
42call to a given program number,
43it will first contact
44.Nm portmap
45on the server machine to determine
46the port number where
47.Tn RPC
48packets should be sent.
49.Pp
50.Nm Portmap
51must be started before any
52.Tn RPC
53servers are invoked.
54.Pp
55Normally
56.Nm portmap
57forks and dissociates itself from the terminal
58like any other daemon.
59.Nm Portmap
60then logs errors using
61.Xr syslog 3 .
62.Pp
63Option available:
64.Bl -tag -width Ds
65.It Fl d
66(debug) prevents
67.Nm portmap
68from running as a daemon,
69and causes errors and debugging information
70to be printed to the standard error output.
71.El
72.Sh SEE ALSO
73.Xr inetd.conf 5 ,
74.Xr rpcinfo 8 ,
75.Xr inetd 8
76.Sh BUGS
77If
78.Nm portmap
79crashes, all servers must be restarted.
80.Sh HISTORY
81The
82.Nm
83command appeared in
84.Bx 4.3
85