freebsd-dev/lib/libc/rpc/getrpcport.3

.\" @(#)getrpcport.3r	2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
.\" $FreeBSD$
.\"
.Dd October 6, 1987
.Dt GETRPCPORT 3
.Os
.Sh NAME
.Nm getrpcport
.Nd get RPC port number
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.Ft int
.Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"
.Sh DESCRIPTION
The
.Fn getrpcport
function
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.
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`.\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI`
$Id$ -> $FreeBSD$ 1999-08-28 00:22:10 +00:00			`.\" $FreeBSD$`
Add $Id$, to make it simpler for members of the translation teams to track. The $Id$ line is normally at the bottom of the main comment block in the man page, separated from the rest of the manpage by an empty comment, like so; .\" $Id$ .\" If the immediately preceding comment is a @(#) format ID marker than the the $Id$ will line up underneath it with no intervening blank lines. Otherwise, an additional blank line is inserted. Approved by: bde 1999-07-12 20:50:10 +00:00			`.\"`
Show the real revision date and not the date that this manpage is being viewed. 1997-06-23 04:03:49 +00:00			`.Dd October 6, 1987`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Dt GETRPCPORT 3`
			`.Os`
			`.Sh NAME`
			`.Nm getrpcport`
			`.Nd get RPC port number`
Bring in a hybrid of SunSoft's transport-independent RPC (TI-RPC) and associated changes that had to happen to make this possible as well as bugs fixed along the way. Bring in required TLI library routines to support this. Since we don't support TLI we've essentially copied what NetBSD has done, adding a thin layer to emulate direct the TLI calls into BSD socket calls. This is mostly from Sun's tirpc release that was made in 1994, however some fixes were backported from the 1999 release (supposedly only made available after this porting effort was underway). The submitter has agreed to continue on and bring us up to the 1999 release. Several key features are introduced with this update: Client calls are thread safe. (1999 code has server side thread safe) Updated, a more modern interface. Many userland updates were done to bring the code up to par with the recent RPC API. There is an update to the pthreads library, a function pthread_main_np() was added to emulate a function of Sun's threads library. While we're at it, bring in NetBSD's lockd, it's been far too long of a wait. New rpcbind(8) replaces portmap(8) (supporting communication over an authenticated Unix-domain socket, and by default only allowing set and unset requests over that channel). It's much more secure than the old portmapper. Umount(8), mountd(8), mount_nfs(8), nfsd(8) have also been upgraded to support TI-RPC and to support IPV6. Umount(8) is also fixed to unmount pathnames longer than 80 chars, which are currently truncated by the Kernel statfs structure. Submitted by: Martin Blapp <mb@imp.ch> Manpage review: ru Secure RPC implemented by: wpaul 2001-03-19 12:50:13 +00:00			`.Sh LIBRARY`
			`.Lb libc`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Sh SYNOPSIS`
			`.Ft int`
			`.Fn getrpcport "char *host" "int prognum" "int versnum" "int proto"`
			`.Sh DESCRIPTION`
mdoc(7) police: "The .Fn function". 2002-12-18 12:45:11 +00:00			`The`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fn getrpcport`
mdoc(7) police: "The .Fn function". 2002-12-18 12:45:11 +00:00			`function`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`returns the port number for version`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fa versnum`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`of the RPC program`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fa prognum`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`running on`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fa host`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`and using protocol`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fa proto .`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`It returns 0 if it cannot contact the portmapper, or if`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fa prognum`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`is not registered. If`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fa prognum`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +00:00			`is registered but not with version`
Convert to mdoc format. 1996-12-21 22:56:48 +00:00			`.Fa versnum ,`
Moving Sun RPC code into libc, part 1. Based on work done by a number of people, including J.T. Conklin, Theo de Raadt, Paul Richards, and probably someone else who's going to flame me as soon as they see this message. 1994-08-07 18:36:12 +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.`