Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
RPCBIND(8)		  BSD System Manager's Manual		    RPCBIND(8)

     rpcbind --	universal addresses to RPC program number mapper

     rpcbind [-6adiLls]	[-h bindip]

     The rpcbind utility is a server that converts RPC program numbers into
     universal addresses.  It must be running on the host to be	able to	make
     RPC calls on a server on that machine.

     When an RPC service is started, it	tells rpcbind the address at which it
     is	listening, and the RPC program numbers it is prepared to serve.	 When
     a client wishes to	make an	RPC call to a given program number, it first
     contacts rpcbind on the server machine to determine the address where RPC
     requests should be	sent.

     The rpcbind utility should	be started before any other RPC	service.  Nor-
     mally, standard RPC servers are started by	port monitors, so rpcbind must
     be	started	before port monitors are invoked.

     When rpcbind is started, it checks	that certain name-to-address transla-
     tion-calls	function correctly.  If	they fail, the network configuration
     databases may be corrupt.	Since RPC services cannot function correctly
     in	this situation,	rpcbind	reports	the condition and terminates.

     The rpcbind utility can only be started by	the super-user.

     -6	     Bind to AF_INET6 (IPv6) addresses only.

     -a	     When debugging (-d), do an	abort on errors.

     -d	     Run in debug mode.	 In this mode, rpcbind will not	fork when it
	     starts, will print	additional information during operation, and
	     will abort	on certain errors if -a	is also	specified.  With this
	     option, the name-to-address translation consistency checks	are
	     shown in detail.

     -h	bindip
	     Specify specific IP addresses to bind to for TCP and UDP re-
	     quests.  This option may be specified multiple times and is typi-
	     cally necessary when running on a multi-homed host.  If no	-h op-
	     tion is specified,	rpcbind	will bind to INADDR_ANY, which could
	     lead to problems on a multi-homed host due	to rpcbind returning a
	     UDP packet	from a different IP address than it was	sent to.  Note
	     that when specifying IP addresses with -h,	rpcbind	will automati-
	     cally add and if	IPv6 is	enabled, ::1 to	the list.

     -i	     "Insecure"	mode.  Allow calls to SET and UNSET from any host.
	     Normally rpcbind accepts these requests only from the loopback
	     interface for security reasons.  This change is necessary for
	     programs that were	compiled with earlier versions of the rpc li-
	     brary and do not make those requests using	the loopback inter-

     -L	     Allow old-style local connections over the	loopback interface.
	     Without this flag,	local connections are only allowed over	a lo-
	     cal socket, /var/run/rpcbind.sock.

     -l	     Turn on libwrap connection	logging.

     -s	     Cause rpcbind to change to	the user daemon	as soon	as possible.
	     This causes rpcbind to use	non-privileged ports for outgoing con-
	     nections, preventing non-privileged clients from using rpcbind to
	     connect to	services from a	privileged port.

     All RPC servers must be restarted if rpcbind is restarted.


     rpcbind(3), netconfig(5), rpcinfo(8)

BSD				April 23, 2007				   BSD


Want to link to this manual page? Use this URL:

home | help