1.\" @(#)rpcbind.1m 1.19 92/09/14 SMI; from SVr4 2.\" Copyright 1989 AT&T 3.\" Copyright 1991 Sun Microsystems, Inc. 4.Dd August 31, 2023 5.Dt RPCBIND 8 6.Os 7.Sh NAME 8.Nm rpcbind 9.Nd universal addresses to RPC program number mapper 10.Sh SYNOPSIS 11.Nm 12.Op Fl 6adiLlNswW 13.Op Fl h Ar bindip 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 6 71Bind to AF_INET6 (IPv6) addresses only. 72.It Fl a 73When debugging 74.Pq Fl d , 75do an abort on errors. 76.It Fl d 77Run in debug mode. 78In this mode, 79.Nm 80will not fork when it starts, will print additional information 81during operation, and will abort on certain errors if 82.Fl a 83is also specified. 84With this option, the name-to-address translation consistency 85checks are shown in detail. 86.It Fl h Ar bindip 87IP addresses to bind to when servicing TCP and UDP requests. 88This option 89may be specified multiple times and is typically necessary when running 90on a multi-homed host. 91If no 92.Fl h 93option is specified, 94.Nm 95will bind to 96.Dv INADDR_ANY , 97which could lead to problems on a multi-homed host due to 98.Nm 99returning a UDP packet from a different IP address than it was 100sent to. 101Note that when specifying IP addresses with 102.Fl h , 103.Nm 104will automatically add 105.Li 127.0.0.1 106and if IPv6 is enabled, 107.Li ::1 108to the list. 109.It Fl i 110.Dq Insecure 111mode. 112Allow calls to SET and UNSET from any host. 113Normally 114.Nm 115accepts these requests only from the loopback interface for security reasons. 116This change is necessary for programs that were compiled with earlier 117versions of the rpc library and do not make those requests using the 118loopback interface. 119.It Fl L 120Allow old-style local connections over the loopback interface. 121Without this flag, local connections are only allowed over a local socket, 122.Pa /var/run/rpcbind.sock . 123.It Fl l 124Turn on libwrap connection logging. 125.It Fl N 126Run in foreground mode. 127In this mode, 128.Nm 129will not fork when it starts. 130.It Fl s 131Cause 132.Nm 133to change to the user daemon as soon as possible. 134This causes 135.Nm 136to use non-privileged ports for outgoing connections, preventing non-privileged 137clients from using 138.Nm 139to connect to services from a privileged port. 140.It Fl W 141Enable libwrap (TCP wrappers) support. 142.It Fl w 143Enable the warmstart feature. 144.Pp 145The warmstart feature saves RPC registrations on termination. 146Any saved RPC registrations are restored on restart if 147.Fl w 148is specified. 149This feature helps avoid RPC service interruption when restarting 150.Nm . 151warmstart support must be compiled in to 152.Nm . 153Portmap registrations are stored in 154.Pa /tmp/portmap.file . 155.Nm 156registrations are stored in 157.Pa /tmp/rpcbind.file . 158.El 159.Sh NOTES 160All RPC servers must be restarted if 161.Nm 162is restarted. 163.Sh FILES 164.Bl -tag -width /var/run/rpcbind.sock -compact 165.It Pa /tmp/portmap.file 166saved portmap registrations file. 167.It Pa /tmp/rpcbind.file 168saved 169.Nm 170registrations file. 171.It Pa /var/run/rpcbind.sock 172socket used for local connections. 173.El 174.Sh SEE ALSO 175.Xr rpcbind 3 , 176.Xr netconfig 5 , 177.Xr rpcinfo 8 178