xref: /dragonfly/lib/libc/rpc/getrpcport.3 (revision 0ca59c34)
1.\" @(#)getrpcport.3r	2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
2.\" $FreeBSD: src/lib/libc/rpc/getrpcport.3,v 1.6 1999/08/28 00:00:40 peter Exp $
3.\" $DragonFly: src/lib/libc/rpc/getrpcport.3,v 1.3 2007/08/18 20:48:47 swildner Exp $
4.\"
5.Dd October 6, 1987
6.Dt GETRPCPORT 3
7.Os
8.Sh NAME
9.Nm getrpcport
10.Nd get RPC port number
11.Sh LIBRARY
12.Lb libc
13.Sh SYNOPSIS
14.In rpc/rpc.h
15.Ft int
16.Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
17.Sh DESCRIPTION
18.Fn getrpcport
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.
36