1.\" $NetBSD: rpcbind.8,v 1.6 2002/02/02 01:44:31 wiz Exp $ 2.\" @(#)rpcbind.1m 1.19 92/09/14 SMI; from SVr4 3.\" Copyright 1989 AT&T 4.\" Copyright 1991 Sun Microsystems, Inc. 5.Dd September 14, 1992 6.Dt RPCBIND 8 7.Sh NAME 8.Nm rpcbind 9.Nd 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. 77Allows calls to SET and UNSET from any host. 78Normally 79.Nm 80accepts these requests only from the loopback interface for security reasons. 81This change is necessary for programs that were compiled with earlier 82versions of the rpc library and do not make those requests using the 83loopback interface. 84.It Fl l 85Turns on libwrap connection logging. 86.It Fl s 87causes 88.Nm 89to change to the user daemon as soon as possible. 90This causes 91.Nm 92to use non-privileged ports for outgoing connections, preventing non-privileged 93clients from using 94.Nm 95to connect to services from a privileged port. 96.It Fl L 97Allow old-style local connections over the loopback interface. 98Without this flag, local connections are only allowed over a local socket, 99.Pa /var/run/rpcbind.sock 100.El 101.Sh NOTES 102All RPC servers must be restarted if 103.Nm 104is restarted. 105.Sh FILES 106.Pa /var/run/rpcbind.sock 107.Sh SEE ALSO 108.Xr rpcbind 3 , 109.Xr rpcinfo 8 110