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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
RPCBIND(8)		FreeBSD	System Manager's Manual		    RPCBIND(8)

NAME
     rpcbind --	universal addresses to RPC program number mapper

SYNOPSIS
     rpcbind [-6adiLls]	[-h bindip]

DESCRIPTION
     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.

OPTIONS
     -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
	     requests.	This option may	be specified multiple times and	is
	     typically necessary when running on a multi-homed host.  If no -h
	     option 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 127.0.0.1 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
	     library and do not	make those requests using the loopback inter-
	     face.

     -L	     Allow old-style local connections over the	loopback interface.
	     Without this flag,	local connections are only allowed over	a
	     local 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.

NOTES
     All RPC servers must be restarted if rpcbind is restarted.

FILES
     /var/run/rpcbind.sock

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

FreeBSD	9.3			April 23, 2007			   FreeBSD 9.3

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=rpcbind&sektion=8&manpath=FreeBSD+6.3-RELEASE>

home | help