xref: /freebsd/usr.sbin/rpcbind/rpcbind.8 (revision 8360efbd6c932013ffdb2f83d2f2de4278febb5e)
18360efbdSAlfred Perlstein.\" @(#)rpcbind.1m 1.19 92/09/14 SMI; from SVr4
28360efbdSAlfred Perlstein.\" Copyright 1989 AT&T
38360efbdSAlfred Perlstein.\" Copyright 1991 Sun Microsystems, Inc.
48360efbdSAlfred Perlstein.\" $FreeBSD$
58360efbdSAlfred Perlstein.Dd September 14, 1992
68360efbdSAlfred Perlstein.Dt RPCBIND 8
78360efbdSAlfred Perlstein.Os
88360efbdSAlfred Perlstein.Sh NAME
98360efbdSAlfred Perlstein.Nm rpcbind
108360efbdSAlfred Perlstein.Nd universal addresses to RPC program number mapper
118360efbdSAlfred Perlstein.Sh SYNOPSIS
128360efbdSAlfred Perlstein.Nm
138360efbdSAlfred Perlstein.Op Fl dilLs
148360efbdSAlfred Perlstein.Sh DESCRIPTION
158360efbdSAlfred Perlstein.Nm
168360efbdSAlfred Perlsteinis a server that converts
178360efbdSAlfred Perlstein.Tn RPC
188360efbdSAlfred Perlsteinprogram numbers into
198360efbdSAlfred Perlsteinuniversal addresses.
208360efbdSAlfred PerlsteinIt must be running on the host to be able to make
218360efbdSAlfred Perlstein.Tn RPC
228360efbdSAlfred Perlsteincalls
238360efbdSAlfred Perlsteinon a server on that machine.
248360efbdSAlfred Perlstein.Pp
258360efbdSAlfred PerlsteinWhen an
268360efbdSAlfred Perlstein.Tn RPC
278360efbdSAlfred Perlsteinservice is started,
288360efbdSAlfred Perlsteinit tells
298360efbdSAlfred Perlstein.Nm
308360efbdSAlfred Perlsteinthe address at which it is listening,
318360efbdSAlfred Perlsteinand the
328360efbdSAlfred Perlstein.Tn RPC
338360efbdSAlfred Perlsteinprogram numbers it is prepared to serve.
348360efbdSAlfred PerlsteinWhen a client wishes to make an
358360efbdSAlfred Perlstein.Tn RPC
368360efbdSAlfred Perlsteincall to a given program number,
378360efbdSAlfred Perlsteinit first contacts
388360efbdSAlfred Perlstein.Nm
398360efbdSAlfred Perlsteinon the server machine to determine
408360efbdSAlfred Perlsteinthe address where
418360efbdSAlfred Perlstein.Tn RPC
428360efbdSAlfred Perlsteinrequests should be sent.
438360efbdSAlfred Perlstein.Pp
448360efbdSAlfred Perlstein.Nm
458360efbdSAlfred Perlsteinshould be started before any other RPC service.
468360efbdSAlfred PerlsteinNormally, standard
478360efbdSAlfred Perlstein.Tn RPC
488360efbdSAlfred Perlsteinservers are started by port monitors, so
498360efbdSAlfred Perlstein.Nm
508360efbdSAlfred Perlsteinmust be started before port monitors are invoked.
518360efbdSAlfred Perlstein.Pp
528360efbdSAlfred PerlsteinWhen
538360efbdSAlfred Perlstein.Nm
548360efbdSAlfred Perlsteinis started, it checks that certain name-to-address
558360efbdSAlfred Perlsteintranslation-calls function correctly.
568360efbdSAlfred PerlsteinIf they fail, the network configuration databases may be corrupt.
578360efbdSAlfred PerlsteinSince
588360efbdSAlfred Perlstein.Tn RPC
598360efbdSAlfred Perlsteinservices cannot function correctly in this situation,
608360efbdSAlfred Perlstein.Nm
618360efbdSAlfred Perlsteinreports the condition and terminates.
628360efbdSAlfred Perlstein.Pp
638360efbdSAlfred Perlstein.Nm
648360efbdSAlfred Perlsteincan only be started by the super-user.
658360efbdSAlfred Perlstein.Sh OPTIONS
668360efbdSAlfred Perlstein.Bl -tag -width indent
678360efbdSAlfred Perlstein.It Fl d
688360efbdSAlfred PerlsteinRun in debug mode.
698360efbdSAlfred PerlsteinIn this mode,
708360efbdSAlfred Perlstein.Nm
718360efbdSAlfred Perlsteinwill not fork when it starts, will print additional information
728360efbdSAlfred Perlsteinduring operation, and will abort on certain errors.
738360efbdSAlfred PerlsteinWith this option, the name-to-address translation consistency
748360efbdSAlfred Perlsteinchecks are shown in detail.
758360efbdSAlfred Perlstein.It Fl i
768360efbdSAlfred Perlstein.Dq insecure
778360efbdSAlfred Perlsteinmode.
788360efbdSAlfred PerlsteinAllows calls to SET and UNSET from any host.
798360efbdSAlfred PerlsteinNormally
808360efbdSAlfred Perlstein.Nm
818360efbdSAlfred Perlsteinaccepts these requests only from the loopback interface for security reasons.
828360efbdSAlfred PerlsteinThis change is necessary for programs that were compiled with earlier
838360efbdSAlfred Perlsteinversions of the rpc library and do not make those requests using the
848360efbdSAlfred Perlsteinloopback interface.
858360efbdSAlfred Perlstein.It Fl l
868360efbdSAlfred PerlsteinTurns on libwrap connection logging.
878360efbdSAlfred Perlstein.It Fl s
888360efbdSAlfred Perlsteincauses
898360efbdSAlfred Perlstein.Nm
908360efbdSAlfred Perlsteinto change to the user daemon as soon as possible.
918360efbdSAlfred PerlsteinThis causes
928360efbdSAlfred Perlstein.Nm
938360efbdSAlfred Perlsteinto use non-privileged ports for outgoing connections, preventing non-privileged
948360efbdSAlfred Perlsteinclients from using
958360efbdSAlfred Perlstein.Nm
968360efbdSAlfred Perlsteinto connect to services from a privileged port.
978360efbdSAlfred Perlstein.It Fl L
988360efbdSAlfred PerlsteinAllow old-style local connections over the loopback interface.
998360efbdSAlfred PerlsteinWithout this flag, local connections are only allowed over a local socket,
1008360efbdSAlfred Perlstein.Pa /var/run/rpcbind.sock
1018360efbdSAlfred Perlstein.El
1028360efbdSAlfred Perlstein.Sh NOTES
1038360efbdSAlfred PerlsteinAll RPC servers must be restarted if
1048360efbdSAlfred Perlstein.Nm
1058360efbdSAlfred Perlsteinis restarted.
1068360efbdSAlfred Perlstein.Sh SEE ALSO
1078360efbdSAlfred Perlstein.Xr rpcbind 3 ,
1088360efbdSAlfred Perlstein.Xr rpcinfo 8
1098360efbdSAlfred Perlstein.Sh FILES
1108360efbdSAlfred Perlstein.Bl -tag -width /var/run/rpcbind.sock -compact
1118360efbdSAlfred Perlstein.It Pa /var/run/rpcbind.sock
1128360efbdSAlfred Perlstein.El
113