d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
7f3dea244c
freebsd-dev/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
.Nm getrpcent
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