1.\" @(#)rpcbind.1m 1.19 92/09/14 SMI; from SVr4 2.\" Copyright 1989 AT&T 3.\" Copyright 1991 Sun Microsystems, Inc. 4.\" $FreeBSD$ 5.Dd September 14, 1992 6.Dt RPCBIND 8 7.Os 8.Sh NAME 9.Nm rpcbind 10.Nd universal addresses to RPC program number mapper 11.Sh SYNOPSIS 12.Nm 13.Op Fl adhiLls 14.Sh DESCRIPTION 15The 16.Nm 17utility is a server that converts 18.Tn RPC 19program numbers into 20universal addresses. 21It must be running on the host to be able to make 22.Tn RPC 23calls 24on a server on that machine. 25.Pp 26When an 27.Tn RPC 28service is started, 29it tells 30.Nm 31the address at which it is listening, 32and the 33.Tn RPC 34program numbers it is prepared to serve. 35When a client wishes to make an 36.Tn RPC 37call to a given program number, 38it first contacts 39.Nm 40on the server machine to determine 41the address where 42.Tn RPC 43requests should be sent. 44.Pp 45The 46.Nm 47utility should be started before any other RPC service. 48Normally, standard 49.Tn RPC 50servers are started by port monitors, so 51.Nm 52must be started before port monitors are invoked. 53.Pp 54When 55.Nm 56is started, it checks that certain name-to-address 57translation-calls function correctly. 58If they fail, the network configuration databases may be corrupt. 59Since 60.Tn RPC 61services cannot function correctly in this situation, 62.Nm 63reports the condition and terminates. 64.Pp 65The 66.Nm 67utility can only be started by the super-user. 68.Sh OPTIONS 69.Bl -tag -width indent 70.It Fl a 71When debugging 72.Pq Fl d , 73do an abort on errors. 74.It Fl d 75Run in debug mode. 76In this mode, 77.Nm 78will not fork when it starts, will print additional information 79during operation, and will abort on certain errors if 80.Fl a 81is also specified. 82With this option, the name-to-address translation consistency 83checks are shown in detail. 84.It Fl h 85Specify specific IP addresses to bind to for UDP requests. 86This option 87may be specified multiple times and is typically necessary when running 88on a multi-homed host. 89If no 90.Fl h 91option is specified, 92.Nm 93will bind to 94.Dv INADDR_ANY , 95which could lead to problems on a multi-homed host due to 96.Nm 97returning a UDP packet from a different IP address than it was 98sent to. 99Note that when specifying IP addresses with 100.Fl h , 101.Nm 102will automatically add 103.Li 127.0.0.1 104and if IPv6 is enabled, 105.Li ::1 106to the list. 107.It Fl i 108.Dq Insecure 109mode. 110Allow calls to SET and UNSET from any host. 111Normally 112.Nm 113accepts these requests only from the loopback interface for security reasons. 114This change is necessary for programs that were compiled with earlier 115versions of the rpc library and do not make those requests using the 116loopback interface. 117.It Fl L 118Allow old-style local connections over the loopback interface. 119Without this flag, local connections are only allowed over a local socket, 120.Pa /var/run/rpcbind.sock . 121.It Fl l 122Turn on libwrap connection logging. 123.It Fl s 124Cause 125.Nm 126to change to the user daemon as soon as possible. 127This causes 128.Nm 129to use non-privileged ports for outgoing connections, preventing non-privileged 130clients from using 131.Nm 132to connect to services from a privileged port. 133.El 134.Sh NOTES 135All RPC servers must be restarted if 136.Nm 137is restarted. 138.Sh SEE ALSO 139.Xr rpcbind 3 , 140.Xr rpcinfo 8 141.Sh FILES 142.Bl -tag -width /var/run/rpcbind.sock -compact 143.It Pa /var/run/rpcbind.sock 144.El 145