xref: /freebsd/lib/libc/rpc/getrpcport.3 (revision 7d99ab9fd0cc2c1ce2ecef0ed6d0672c2a50b0cb)
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
16The
17.Fn getrpcport
18function
19returns the port number for version
20.Fa versnum
21of the RPC program
22.Fa prognum
23running on
24.Fa host
25and using protocol
26.Fa proto .
27It returns 0 if it cannot contact the portmapper, or if
28.Fa prognum
29is not registered.
30If
31.Fa prognum
32is registered but not with version
33.Fa versnum ,
34it will still return a port number (for some version of the program)
35indicating that the program is indeed registered.
36The version mismatch will be detected upon the first call to the service.
37