lib/libc/rpc/getrpcport.3

   1 .\" @(#)getrpcport.3r   2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
   2 .\" $FreeBSD$
   3 .\"
   4 .Dd October 6, 1987
   5 .Dt GETRPCPORT 3
   6 .Os
   7 .Sh NAME
   8 .Nm getrpcport
   9 .Nd get RPC port number
  10 .Sh LIBRARY
  11 .Lb libc
  12 .Sh SYNOPSIS
  13 .Ft int
  14 .Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
  15 .Sh DESCRIPTION
  16 The
  17 .Fn getrpcport
  18 function
  19 returns the port number for version
  20 .Fa versnum
  21 of the RPC program
  22 .Fa prognum
  23 running on
  24 .Fa host
  25 and using protocol
  26 .Fa proto .
  27 It returns 0 if it cannot contact the portmapper, or if
  28 .Fa prognum
  29 is not registered.
  30 If
  31 .Fa prognum
  32 is registered but not with version
  33 .Fa versnum ,
  34 it will still return a port number (for some version of the program)
  35 indicating that the program is indeed registered.
  36 The version mismatch will be detected upon the first call to the service.