1.\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
| 1.\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
|
2.\" $FreeBSD: head/lib/libc/rpc/getrpcport.3 74462 2001-03-19 12:50:13Z alfred $
| 2.\" $FreeBSD: head/lib/libc/rpc/getrpcport.3 108037 2002-12-18 12:45:11Z ru $
|
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
| 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
|
16.Fn getrpcport
| 17.Fn getrpcport
|
| 18function
|
17returns the port number for version
18.Fa versnum
19of the RPC program
20.Fa prognum
21running on
22.Fa host
23and using protocol
24.Fa proto .
25It returns 0 if it cannot contact the portmapper, or if
26.Fa prognum
27is not registered. If
28.Fa prognum
29is registered but not with version
30.Fa versnum ,
31it will still return a port number (for some version of the program)
32indicating that the program is indeed registered.
33The version mismatch will be detected upon the first call to the service.
| 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. If
30.Fa prognum
31is registered but not with version
32.Fa versnum ,
33it will still return a port number (for some version of the program)
34indicating that the program is indeed registered.
35The version mismatch will be detected upon the first call to the service.
|