usr.sbin/rpcbind/rpcbind.8

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