xref: /netbsd-src/lib/libc/rpc/getrpcport.3 (revision 3fdac2b8c50898b48f2ca25502d8dd95e58978e8)
19e15c989Scgd.\"	@(#)getrpcport.3r	2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
2*3fdac2b8Sthorpej.\"	$NetBSD: getrpcport.3,v 1.5 2003/01/18 11:29:04 thorpej Exp $
363d7b677Scgd.\"
463d7b677Scgd.Dd October 6, 1987
563d7b677Scgd.Dt GETRPCPORT 3
663d7b677Scgd.Os
763d7b677Scgd.Sh NAME
863d7b677Scgd.Nm getrpcport
963d7b677Scgd.Nd get RPC port number
10312aca53Sperry.Sh LIBRARY
11312aca53Sperry.Lb libc
1263d7b677Scgd.Sh SYNOPSIS
1363d7b677Scgd.Ft int
1463d7b677Scgd.Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
1563d7b677Scgd.Sh DESCRIPTION
1663d7b677Scgd.Fn getrpcport
1763d7b677Scgdreturns the port number for version
1863d7b677Scgd.Fa versnum
1963d7b677Scgdof the RPC program
2063d7b677Scgd.Fa prognum
2163d7b677Scgdrunning on
2263d7b677Scgd.Fa host
2363d7b677Scgdand using protocol
2463d7b677Scgd.Fa proto .
2563d7b677ScgdIt returns 0 if it cannot contact the portmapper, or if
2663d7b677Scgd.Fa prognum
276569c5c5Swizis not registered.
286569c5c5SwizIf
2963d7b677Scgd.Fa prognum
3063d7b677Scgdis registered but not with version
3163d7b677Scgd.Fa versnum ,
3263d7b677Scgdit will still return a port number (for some version of the program)
3363d7b677Scgdindicating that the program is indeed registered.
3463d7b677ScgdThe version mismatch will be detected upon the first call to the service.
35