usr.bin/rpcinfo/rpcinfo.8

   1 .\"     from: @(#)rpcinfo.8c    2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI
   2 .\" $FreeBSD: src/usr.bin/rpcinfo/rpcinfo.8,v 1.5.2.2 2002/06/21 15:28:53 charnier Exp $
   3 .\"
   4 .Dd December 17, 1987
   5 .Dt RPCINFO 8
   6 .Os
   7 .Sh NAME
   8 .Nm rpcinfo
   9 .Nd report RPC information
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Fl p
  13 .Op Ar host
  14 .Nm
  15 .Op Fl n Ar portnum
  16 .Fl u Ar host
  17 .Ar program
  18 .Op Ar version
  19 .Nm
  20 .Op Fl n Ar portnum
  21 .Fl t Ar host
  22 .Ar program
  23 .Op Ar version
  24 .Nm
  25 .Fl b
  26 .Ar program version
  27 .Nm
  28 .Fl d
  29 .Ar program version
  30 .Sh DESCRIPTION
  31 The
  32 .Nm
  33 utility makes an
  34 .Tn RPC
  35 call to an
  36 .Tn RPC
  37 server and reports what it finds.
  38 .Sh OPTIONS
  39 .Bl -tag -width indent
  40 .It Fl p
  41 Probe the portmapper on
  42 .Ar host ,
  43 and print a list of all registered
  44 .Tn RPC
  45 programs.  If
  46 .Ar host
  47 is not specified, it defaults to the value returned by
  48 .Xr hostname 1 .
  49 .It Fl u
  50 Make an
  51 .Tn RPC
  52 call to procedure 0 of
  53 .Ar program
  54 on the specified
  55 .Ar host
  56 using
  57 .Tn UDP ,
  58 and report whether a response was received.
  59 .It Fl t
  60 Make an
  61 .Tn RPC
  62 call to procedure 0 of
  63 .Ar program
  64 on the specified
  65 .Ar host
  66 using
  67 .Tn TCP ,
  68 and report whether a response was received.
  69 .It Fl n
  70 Use
  71 .Ar portnum
  72 as the port number for the
  73 .Fl t
  74 and
  75 .Fl u
  76 options instead of the port number given by the portmapper.
  77 .It Fl b
  78 Make an
  79 .Tn RPC
  80 broadcast to procedure 0 of the specified
  81 .Ar program
  82 and
  83 .Ar version
  84 using
  85 .Tn UDP
  86 and report all hosts that respond.
  87 .It Fl d
  88 Delete registration for the
  89 .Tn RPC
  90 service of the specified
  91 .Ar program
  92 and
  93 .Ar version .
  94 This option can be exercised only by the super-user.
  95 .El
  96 .Pp
  97 The
  98 .Ar program
  99 argument can be either a name or a number.
 100 .Pp
 101 If a
 102 .Ar version
 103 is specified,
 104 .Nm
 105 attempts to call that version of the specified
 106 .Ar program .
 107 Otherwise,
 108 .Nm
 109 attempts to find all the registered version
 110 numbers for the specified
 111 .Ar program
 112 by calling version 0 (which is presumed not
 113 to exist; if it does exist,
 114 .Nm
 115 attempts to obtain this information by calling
 116 an extremely high version
 117 number instead) and attempts to call each registered version.
 118 Note: the version number is required for
 119 .Fl b
 120 and
 121 .Fl d
 122 options.
 123 .Sh EXAMPLES
 124 To show all of the
 125 .Tn RPC
 126 services registered on the local machine use:
 127 .Pp
 128 .Dl example% rpcinfo -p
 129 .Pp
 130 To show all of the
 131 .Tn RPC
 132 services registered on the machine named
 133 .Ar klaxon
 134 use:
 135 .Pp
 136 .Dl example% rpcinfo -p klaxon
 137 .Pp
 138 To show all machines on the local net that are running the Yellow Pages
 139 service use:
 140 .Pp
 141 .Dl example% rpcinfo -b ypserv 'version' | uniq
 142 .Pp
 143 where 'version' is the current Yellow Pages version obtained from the
 144 results of the
 145 .Fl p
 146 switch above.
 147 .Pp
 148 To delete the registration for version 1 of the
 149 .Nm walld
 150 service use:
 151 .Pp
 152 .Dl example% rpcinfo -d walld 1
 153 .Sh SEE ALSO
 154 .Xr rpc 5 ,
 155 .Xr portmap 8
 156 .Rs
 157 .%T "RPC Programming Guide"
 158 .Re
 159 .Sh BUGS
 160 In releases prior to SunOS 3.0, the Network File System (NFS) did not
 161 register itself with the portmapper;
 162 .Nm
 163 cannot be used to make
 164 .Tn RPC
 165 calls to the
 166 .Tn NFS
 167 server on hosts running such releases.