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