1.\" @(#)rpcbind.1m 1.19 92/09/14 SMI; from SVr4 2.\" Copyright 1989 AT&T 3.\" Copyright 1991 Sun Microsystems, Inc. 4.Dd Sep 14, 1992 5.Dt RPCBIND 8 6.Sh NAME 7.Nm rpcbind 8.Nd 9\- universal addresses to RPC program number mapper 10.Sh SYNOPSIS 11.Nm 12.Op Fl dilLs 13.Sh DESCRIPTION 14.Nm 15is a server that converts 16.Tn RPC 17program numbers into 18universal addresses. 19It must be running on the host to be able to make 20.Tn RPC 21calls 22on a server on that machine. 23.Pp 24When an 25.Tn RPC 26service is started, 27it tells 28.Nm 29the address at which it is listening, 30and the 31.Tn RPC 32program numbers it is prepared to serve. 33When a client wishes to make an 34.Tn RPC 35call to a given program number, 36it first contacts 37.Nm 38on the server machine to determine 39the address where 40.Tn RPC 41requests should be sent. 42.Pp 43.Nm 44should be started before any other RPC service. 45Normally, standard 46.Tn RPC 47servers are started by port monitors, so 48.Nm 49must be started before port monitors are invoked. 50.Pp 51When 52.Nm 53is started, it checks that certain name-to-address 54translation-calls function correctly. 55If they fail, the network configuration databases may be corrupt. 56Since 57.Tn RPC 58services cannot function correctly in this situation, 59.Nm 60reports the condition and terminates. 61.Pp 62.Nm 63can only be started by the super-user. 64.Sh OPTIONS 65.Bl -tag -width Ds 66.It Fl d 67Run in debug mode. 68In this mode, 69.Nm 70will not fork when it starts, will print additional information 71during operation, and will abort on certain errors. 72With this option, the name-to-address translation consistency 73checks are shown in detail. 74.It Fl i 75.Dq insecure 76mode. Allows calls to SET and UNSET from any host. Normally 77.Nm 78accepts these requests only from the loopback interface for security reasons. 79This change is necessary for programs that were compiled with earlier 80versions of the rpc library and do not make those requests using the 81loopback interface. 82.It Fl l 83Turns on libwrap connection logging. 84.It Fl s 85causes 86.Nm 87to change to the user daemon as soon as possible. 88This causes 89.Nm 90to use non-privileged ports for outgoing connections, preventing non-privileged 91clients from using 92.Nm 93to connect to services from a privileged port. 94.It Fl L 95Allow old-style local connections over the loopback interface. Without 96this flag, local connections are only allowed over a local socket, 97.Pa /var/run/rpcbind.sock 98.El 99.Sh NOTES 100.Pp 101All RPC servers must be restarted if 102.Nm 103is restarted. 104.Sh SEE ALSO 105.Xr rpcinfo 1 , 106.Xr rpcbind 3 , 107.Sh FILES 108 109.Pa /var/run/rpcbind.sock 110