man3/getrpcport.3

   1 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
   2 .\"
   3 .\" %%%LICENSE_START(BSD_ONELINE_CDROM)
   4 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
   5 .\" %%%LICENSE_END
   6 .\"
   7 .\" @(#)getrpcport.3r   2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
   8 .TH getrpcport 3 (date) "Linux man-pages (unreleased)"
   9 .SH NAME
  10 getrpcport \- get RPC port number
  11 .SH LIBRARY
  12 Standard C library
  13 .RI ( libc ", " \-lc )
  14 .SH SYNOPSIS
  15 .nf
  16 .B "#include <rpc/rpc.h>"
  17 .PP
  18 .BI "int getrpcport(const char *" host ", unsigned long " prognum ,
  19 .BI "               unsigned long " versnum ", unsigned int " proto );
  20 .fi
  21 .SH DESCRIPTION
  22 .BR getrpcport ()
  23 returns the port number for version
  24 .I versnum
  25 of the RPC program
  26 .I prognum
  27 running on
  28 .I host
  29 and using protocol
  30 .IR proto .
  31 It returns 0 if it cannot contact the portmapper, or if
  32 .I prognum
  33 is not registered.
  34 If
  35 .I prognum
  36 is registered but not with version
  37 .IR versnum ,
  38 it will still return a port number (for some version of the program)
  39 indicating that the program is indeed registered.
  40 The version mismatch will be detected upon the first call to the service.
  41 .SH ATTRIBUTES
  42 For an explanation of the terms used in this section, see
  43 .BR attributes (7).
  44 .ad l
  45 .nh
  46 .TS
  47 allbox;
  48 lbx lb lb
  49 l l l.
  50 Interface       Attribute       Value
  51 T{
  52 .BR getrpcport ()
  53 T}      Thread safety   MT-Safe env locale
  54 .TE
  55 .hy
  56 .ad
  57 .sp 1
  58 .SH STANDARDS
  59 Not in POSIX.1.
  60 Present on the BSDs, Solaris, and many other systems.