1996-01-12 07:03:35 +00:00
|
|
|
.\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
|
1997-05-28 05:00:11 +00:00
|
|
|
.Dd "October 6, 1987"
|
|
|
|
.Dt GETRPCPORT 3
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm getrpcport
|
|
|
|
.Nd get RPC port number
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Ft int
|
|
|
|
.Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Fn getrpcport
|
1996-01-12 07:03:35 +00:00
|
|
|
returns the port number for version
|
1997-05-28 05:00:11 +00:00
|
|
|
.Fa versnum
|
1996-01-12 07:03:35 +00:00
|
|
|
of the RPC program
|
1997-05-28 05:00:11 +00:00
|
|
|
.Fa prognum
|
1996-01-12 07:03:35 +00:00
|
|
|
running on
|
1997-05-28 05:00:11 +00:00
|
|
|
.Fa host
|
1996-01-12 07:03:35 +00:00
|
|
|
and using protocol
|
1997-05-28 05:00:11 +00:00
|
|
|
.Fa proto .
|
1996-01-12 07:03:35 +00:00
|
|
|
It returns 0 if it cannot contact the portmapper, or if
|
1997-05-28 05:00:11 +00:00
|
|
|
.Fa prognum
|
1996-01-12 07:03:35 +00:00
|
|
|
is not registered. If
|
1997-05-28 05:00:11 +00:00
|
|
|
.Fa prognum
|
1996-01-12 07:03:35 +00:00
|
|
|
is registered but not with version
|
1997-05-28 05:00:11 +00:00
|
|
|
.Fa versnum ,
|
1996-01-12 07:03:35 +00:00
|
|
|
it will still return a port number (for some version of the program)
|
|
|
|
indicating that the program is indeed registered.
|
|
|
|
The version mismatch will be detected upon the first call to the service.
|