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 .\" $DragonFly: src/lib/libcr/rpc/Attic/getrpcport.3,v 1.2 2003/06/17 04:26:45 dillon Exp $
   4 .\"
   5 .Dd October 6, 1987
   6 .Dt GETRPCPORT 3
   7 .Os
   8 .Sh NAME
   9 .Nm getrpcport
  10 .Nd get RPC port number
  11 .Sh SYNOPSIS
  12 .Ft int
  13 .Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
  14 .Sh DESCRIPTION
  15 .Fn getrpcport
  16 returns the port number for version
  17 .Fa versnum
  18 of the RPC program
  19 .Fa prognum
  20 running on
  21 .Fa host
  22 and using protocol
  23 .Fa proto .
  24 It returns 0 if it cannot contact the portmapper, or if
  25 .Fa prognum
  26 is not registered.  If
  27 .Fa prognum
  28 is registered but not with version
  29 .Fa versnum ,
  30 it will still return a port number (for some version of the program)
  31 indicating that the program is indeed registered.
  32 The version mismatch will be detected upon the first call to the service.