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

97 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
Convert to mdoc format.
1996-12-21 22:56:48 +00:00
.Dd "December 14, 1987"
.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