1995-02-25 06:01:33 +03:00
|
|
|
.\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
|
1998-02-05 21:45:17 +03:00
|
|
|
.\" $NetBSD: getrpcport.3,v 1.3 1998/02/05 18:49:08 perry Exp $
|
1993-10-07 10:29:33 +03:00
|
|
|
.\"
|
|
|
|
.Dd October 6, 1987
|
|
|
|
.Dt GETRPCPORT 3
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm getrpcport
|
|
|
|
.Nd get RPC port number
|
1998-02-05 21:45:17 +03:00
|
|
|
.Sh LIBRARY
|
|
|
|
.Lb libc
|
1993-10-07 10:29:33 +03:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Ft int
|
|
|
|
.Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Fn getrpcport
|
|
|
|
returns the port number for version
|
|
|
|
.Fa versnum
|
|
|
|
of the RPC program
|
|
|
|
.Fa prognum
|
|
|
|
running on
|
|
|
|
.Fa host
|
|
|
|
and using protocol
|
|
|
|
.Fa proto .
|
|
|
|
It returns 0 if it cannot contact the portmapper, or if
|
|
|
|
.Fa prognum
|
|
|
|
is not registered. If
|
|
|
|
.Fa prognum
|
|
|
|
is registered but not with version
|
|
|
|
.Fa versnum ,
|
|
|
|
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.
|