d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
fd223545d4
freebsd-skq/lib/libc/rpc/getrpcent.3

99 lines
2.0 KiB
Groff
Raw Normal View History

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
.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 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 December 14, 1987
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Dt GETRPCENT 3
.Os
- tags in correct order - list missing functions - list missing args Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:28:10 +00:00
.Sh NAME
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Nm getrpcent ,
.Nm getrpcbyname ,
- tags in correct order - list missing functions - list missing args Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:28:10 +00:00
.Nm getrpcbynumber ,
.Nm endrpcent ,
.Nm setrpcent
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Nd get RPC entry
.Sh SYNOPSIS
Fix other small things that got lost in the merge: - bde's change to includes section in getrpcent.3 - Lost comment in svc_run.c (the code here was actually the same since I had fixed the 'fds + 1' bug in my stuff at home before mailing Peter about it, but I didn't notce that he'd made a change to the comment right above the changed line). Also pointed out by the ever vigilant: bde
1997-05-28 16:38:35 +00:00
.Fd #include <rpc/rpc.h>
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Ft struct rpcent *
- tags in correct order - list missing functions - list missing args Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:28:10 +00:00
.Fn getrpcent void
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Ft struct rpcent *
.Fn getrpcbyname "char *name"
.Ft struct rpcent *
.Fn getrpcbynumber "int number"
.Ft void
.Fn setrpcent "int stayopen"
.Ft void
- tags in correct order - list missing functions - list missing args Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:28:10 +00:00
.Fn endrpcent void
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Sh DESCRIPTION
The
.Fn getrpcent ,
.Fn getrpcbyname ,
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
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Fn getrpcbynumber
functions each return a pointer to an object with the
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
following structure
containing the broken-out
fields of a line in the rpc program number data base,
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Pa /etc/rpc .
.Bd -literal
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
struct rpcent {
char *r_name; /* name of server for this rpc program */
char **r_aliases; /* alias list */
long r_number; /* rpc program number */
};
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Ed
.Pp
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
The members of this structure are:
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Bl -tag -width r_aliasesxxx
.It Fa r_name
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
The name of the server for this rpc program.
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.It Fa r_aliases
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
A zero terminated list of alternate names for the rpc program.
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.It Fa r_number
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
The rpc program number for this service.
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.El
.Pp
The
.Fn getrpcent
function reads the next line of the file, opening the file if necessary.
The
mdoc(7) police: Nm -> Fn where appropriate.
2000-11-20 14:11:46 +00:00
.Fn setrpcent
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
function opens and rewinds the file. If the
.Fa stayopen
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
flag is non-zero,
the net data base will not be closed after each call to
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Fn getrpcent
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
(either directly, or indirectly through one of
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
the other
.Fn getrpcent
function family.
.Pp
.Fn endrpcent
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
closes the file.
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Pp
.Fn getrpcbyname
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
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Fn getrpcbynumber
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
sequentially search from the beginning
of the file until a matching rpc program name or
program number is found, or until end-of-file is encountered.
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Sh FILES
.Bl -tag -width /etc/rpc -compact
.It Pa /etc/rpc
.El
.Sh "SEE ALSO"
.Xr rpc 5 ,
.Xr rpcinfo 8 ,
.Xr ypserv 8
.Sh DIAGNOSTICS
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
A
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Dv NULL
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
pointer is returned on
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Dv EOF
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
or error.
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Sh BUGS
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
All information
is contained in a static area
so it must be copied if it is
to be saved.
Reference in New Issue Copy Permalink