lib/libcr/rpc/getrpcport.3

   1 .\" @(#)getrpcport.3r   2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
   2 .\" $FreeBSD: src/lib/libc/rpc/getrpcport.3,v 1.6 1999/08/28 00:00:40 peter Exp $
   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 SYNOPSIS
  11 .Ft int
  12 .Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
  13 .Sh DESCRIPTION
  14 .Fn getrpcport
  15 returns the port number for version
  16 .Fa versnum
  17 of the RPC program
  18 .Fa prognum
  19 running on
  20 .Fa host
  21 and using protocol
  22 .Fa proto .
  23 It returns 0 if it cannot contact the portmapper, or if
  24 .Fa prognum
  25 is not registered.  If
  26 .Fa prognum
  27 is registered but not with version
  28 .Fa versnum ,
  29 it will still return a port number (for some version of the program)
  30 indicating that the program is indeed registered.
  31 The version mismatch will be detected upon the first call to the service.