talexander
/
freebsd_amp_hwpstate
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
freebsd_amp_hwpstate/lib/libc/rpc/rpc.3

1520 lines
28 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
.\" @(#)rpc.3n 2.4 88/08/08 4.0 RPCSRC; from 1.19 88/06/24 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
.\"
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dd February 16, 1988
.Dt RPC 3
.Os
.Sh NAME
.Nm rpc
.Nd "library routines for remote procedure calls"
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.Fd "#include <rpc/rpc.h>"
.Pp
See
.Sx DESCRIPTION
for function declarations.
.Sh DESCRIPTION
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
These routines allow C programs to make procedure
calls on other machines across the network.
First, the client calls a procedure to send a
data packet to the server.
Upon receipt of the packet, the server calls a dispatch routine
to perform the requested service, and then sends back a
reply.
Finally, the procedure call returns to the client.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
Routines that are used for Secure
.Tn RPC ( DES
authentication) are described in
.Xr rpc_secure 3 .
Secure
.Tn RPC
can be used only if
.Tn DES
encryption is available.
.Bl -tag -width indent -compact
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn auth_destroy "AUTH *auth"
.Xc
.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
A macro that destroys the authentication information associated with
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa auth .
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
Destruction usually involves deallocation of private data
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
structures.
The use of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa auth
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 undefined after calling
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn auth_destroy .
.Pp
.It Xo
.Ft "AUTH *"
.Xc
.It Xo
.Fn authnone_create
.Xc
.Pp
Create and return an
.Tn RPC
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
authentication handle that passes nonusable authentication
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
information with each remote procedure call.
This is 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
default authentication used by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC .
.Pp
.It Xo
.Ft "AUTH *"
.Xc
.It Xo
.Fn authunix_create "char *host" "int uid" "int gid" "int len" "int *aup_gids"
.Xc
.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
Create and return an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
authentication handle that contains
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Ux
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
authentication information.
The parameter
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
is the name of the machine on which the information was
created;
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa uid
is the user's user ID;
.Fa gid
is the user's current group ID;
.Fa len
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa aup_gids
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
refer to a counted array of groups to which the user belongs.
It is easy to impersonate a user.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "AUTH *"
.Xc
.It Xo
.Fn authunix_create_default
.Xc
.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
Calls
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn authunix_create
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
with the appropriate parameters.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Fo callrpc
.Fa "char *host"
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "u_long procnum"
.Fa "xdrproc_t inproc"
.Fa "char *in"
.Fa "xdrproc_t outproc"
.Fa "char *out"
.Fc
.Xc
.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
Call the remote procedure associated with
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa prognum ,
.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
and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa procnum
on the machine
.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
The parameter
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa in
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 the address of the procedure's argument(s), and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa out
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 the address of where to place the result(s);
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa inproc
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 used to encode the procedure's parameters, and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa outproc
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 used to decode the procedure's results.
This routine returns zero if it succeeds, or the value of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Vt "enum clnt_stat"
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
cast to an integer if it fails.
The routine
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_perrno
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 handy for translating failure statuses into messages.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.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
Warning: calling remote procedures with this routine
uses
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP/IP
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
as a transport; see
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clntudp_create
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
for restrictions.
You do not have control of timeouts or authentication using
this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "enum clnt_stat"
.Xc
.It Xo
.Fo clnt_broadcast
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "u_long procnum"
.Fa "xdrproc_t inproc"
.Fa "char *in"
.Fa "xdrproc_t outproc"
.Fa "char *out"
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Fa "bool_t (*eachresult)(caddr_t, struct sockaddr_in *)
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fc
.Xc
.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
Like
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn callrpc ,
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
except the call message is broadcast to all locally
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
connected broadcast nets.
Each time it receives a
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
response, this routine calls
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn eachresult ,
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
whose form is:
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Bd -ragged -offset indent
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
.Fn eachresult "caddr_t out" "struct sockaddr_in *addr"
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
where
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa out
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 the same as
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa out
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
passed to
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_broadcast ,
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
except that the remote procedure's output is decoded there;
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr
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
points to the address of the machine that sent the results.
If
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn eachresult
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 zero,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_broadcast
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
waits for more replies; otherwise it returns with appropriate
status.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.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
Warning: broadcast sockets are limited in size to the
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
maximum transfer unit of the data link.
For ethernet,
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
this value is 1500 bytes.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "enum clnt_stat"
.Xc
.It Xo
.Fo clnt_call
.Fa "CLIENT *clnt"
.Fa "u_long procnum"
.Fa "xdrproc_t inproc"
.Fa "char *in"
.Fa "xdrproc_t outproc"
.Fa "char *out"
.Fa "struct timeval tout"
.Fc
.Xc
.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
A macro that calls the remote procedure
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa procnum
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
associated with the client handle,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa clnt ,
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
which is obtained with an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
client creation routine such as
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_create .
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 parameter
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa in
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 the address of the procedure's argument(s), and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa out
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 the address of where to place the result(s);
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa inproc
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 used to encode the procedure's parameters, and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa outproc
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 used to decode the procedure's results;
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa tout
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 the time allowed for results to come back.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft void
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_destroy "CLIENT *clnt"
.Xc
.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
A macro that destroys the client's
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
handle.
Destruction usually involves deallocation
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 private data structures, including
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa clnt
itself.
Use of
.Fa clnt
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 undefined after calling
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_destroy .
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
If the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
library opened the associated socket, it will close it also.
Otherwise, the socket remains open.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft CLIENT *
.Xc
.It Xo
.Fn clnt_create "char *host" "u_long prog" "u_long vers" "char *proto"
.Xc
.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
Generic client creation routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
identifies the name of the remote host where the server
is located.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa proto
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
indicates which kind of transport protocol to use.
The
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
currently supported values for this field are
.Qq Li udp
and
.Qq Li tcp .
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
Default timeouts are set, but can be modified using
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_control .
.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
Warning: Using
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP
has its shortcomings.
Since
.Tn UDP Ns \-based
.Tn RPC
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
messages can only hold up to 8 Kbytes of encoded data,
this transport cannot be used for procedures that take
large arguments or return huge results.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft bool_t
.Xc
.It Xo
.Fn clnt_control "CLIENT *cl" "u_int req" "char *info"
.Xc
.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
A macro used to change or retrieve various information
about a client object.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa req
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
indicates the type of operation, and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa info
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
is a pointer to the information.
For both
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn TCP ,
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 supported values of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa req
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 their argument types and what they do are:
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Bl -column "CLSET_RETRY_TIMEOUT" "struct sockaddr_in"
.It Dv CLSET_TIMEOUT Ta Xo
.Vt "struct timeval" Ta "set total timeout"
.Xc
.It Dv CLGET_TIMEOUT Ta Xo
.Vt "struct timeval" Ta "get total timeout"
.Xc
.El
.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
Note: if you set the timeout using
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_control ,
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 timeout parameter passed to
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_call
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
will be ignored in all future calls.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Bl -column "CLSET_RETRY_TIMEOUT" "struct sockaddr_in"
.It Dv CLGET_SERVER_ADDR Ta Xo
.Vt "struct sockaddr_in" Ta "get server's address"
.Xc
.El
.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 following operations are valid for
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP
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
only:
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Bl -column "CLSET_RETRY_TIMEOUT" "struct sockaddr_in"
.It Dv CLSET_RETRY_TIMEOUT Ta Xo
.Vt "struct timeval" Ta "set the retry timeout"
.Xc
.It Dv CLGET_RETRY_TIMEOUT Ta Xo
.Vt "struct timeval" Ta "get the retry timeout"
.Xc
.El
.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 retry timeout is the time that
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn "UDP RPC"
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
waits for the server to reply before
retransmitting the request.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_freeres "CLIENT *clnt" "xdrproc_t outproc" "char *out"
.Xc
.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
A macro that frees any data allocated by the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC/XDR
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
system when it decoded the results of an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
call.
The parameter
.Fa out
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 the address of the results, and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa outproc
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 the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn XDR
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
routine describing the results.
This routine returns one if the results were successfully
freed,
and zero otherwise.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn clnt_geterr "CLIENT *clnt" "struct rpc_err *errp"
.Xc
.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
A macro that copies the error structure out of the client
handle
to the structure at address
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa errp .
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn clnt_pcreateerror "char *s"
.Xc
.Pp
prints a message to standard error indicating
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
why a client
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
handle could not be created.
The message is prepended with string
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa s
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 a colon.
Used when a
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_create ,
.Fn clntraw_create ,
.Fn clnttcp_create ,
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clntudp_create
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
call fails.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn clnt_perrno "enum clnt_stat stat"
.Xc
.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
Print a message to standard error corresponding
to the condition indicated by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa stat .
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
Used after
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn callrpc .
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft void
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_perror "CLIENT *clnt" "char *s"
.Xc
.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
Print a message to standard error indicating why an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
call failed;
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa clnt
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 the handle used to do the call.
The message is prepended with string
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa s
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 a colon.
Used after
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_call .
.Pp
.It Xo
.Ft "char *"
.Xc
.It Xo
.Fn clnt_spcreateerror "char *s"
.Xc
.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
Like
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_pcreateerror ,
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
except that it returns a string
instead of printing to the standard error.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.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
Bugs: returns pointer to static data that is overwritten
on each call.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "char *"
.Xc
.It Xo
.Fn clnt_sperrno "enum clnt_stat stat"
.Xc
.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
Take the same arguments as
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_perrno ,
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
but instead of sending a message to the standard error
indicating why an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
call failed, return a pointer to a string which contains
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
the message.
The string ends with a newline
.Pq Ql "\en" .
.Pp
.Fn clnt_sperrno
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 used instead of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_perrno
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
if the program does not have a standard error (as a program
running as a server quite likely does not), or if the
programmer
does not want the message to be output with
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn printf ,
Grammar fix: ``Different than'' should really be ``different from''.
2000-01-29 01:54:59 +00:00
or if a message format different from that supported by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_perrno
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 to be used.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.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
Note: unlike
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_sperror
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_spcreaterror ,
.Fn clnt_sperrno
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 pointer to static data, but the
result will not get overwritten on each call.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "char *"
.Xc
.It Xo
.Fn clnt_sperror "CLIENT *rpch" "char *s"
.Xc
.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
Like
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_perror ,
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
except that (like
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_sperrno )
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 a string instead of printing to standard error.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.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
Bugs: returns pointer to static data that is overwritten
on each call.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "CLIENT *"
.Xc
.It Xo
.Fn clntraw_create "u_long prognum" "u_long versnum"
.Xc
.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
This routine creates a toy
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
client for the remote program
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
version
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
The transport used to pass messages to the service is
actually a buffer within the process's address space, so the
corresponding
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
server should live in the same address space; see
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svcraw_create .
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
This allows simulation of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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 acquisition of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
overheads, such as round trip times, without any
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
kernel interference.
This routine returns
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
if it fails.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "CLIENT *"
.Xc
.It Xo
.Fo clnttcp_create
.Fa "struct sockaddr_in *addr"
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "int *sockp"
.Fa "u_int sendsz"
.Fa "u_int recvsz"
.Fc
.Xc
.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
This routine creates an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
client for the remote program
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
version
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
the client uses
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn TCP/IP
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
as a transport.
The remote program is located at Internet
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
address
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr .
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
If
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr\->sin_port
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 zero, then it is set to the actual port that the remote
program is listening on (the remote
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
service is consulted for this information).
The parameter
.Fa sockp
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 a socket; if it is
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv RPC_ANYSOCK ,
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
then this routine opens a new one and sets
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa sockp .
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
Since
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn TCP Ns \-based
.Tn RPC
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
uses buffered
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn I/O ,
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 user may specify the size of the send and receive buffers
with the parameters
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa sendsz
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa recvsz ;
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
values of zero choose suitable defaults.
This routine returns
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
if it fails.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "CLIENT *"
.Xc
.It Xo
.Fo clntudp_create
.Fa "struct sockaddr_in *addr"
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "struct timeval wait"
.Fa "int *sockp"
.Fc
.Xc
.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
This routine creates an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
client for the remote program
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
version
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa versnum ;
misc typos
1995-10-27 16:56:53 +00:00
the client uses
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP/IP
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
as a transport.
The remote program is located at Internet
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
address
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr .
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
If
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr\->sin_port
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 zero, then it is set to actual port that the remote
program is listening on (the remote
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
service is consulted for this information).
The parameter
.Fa sockp
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 a socket; if it is
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv RPC_ANYSOCK ,
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
then this routine opens a new one and sets
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa sockp .
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP
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
transport resends the call message in intervals of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa wait
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
time until a response is received or until the call times
out.
The total time for the call to time out is specified by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_call .
.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
Warning: since
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP Ns \-based
.Tn RPC
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
messages can only hold up to 8 Kbytes
of encoded data, this transport cannot be used for procedures
that take large arguments or return huge results.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "CLIENT *"
.Xc
.It Xo
.Fo clntudp_bufcreate
.Fa "struct sockaddr_in *addr"
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "struct timeval wait"
.Fa "int *sockp"
.Fa "unsigned int sendsize"
.Fa "unsigned int recosize"
.Fc
.Xc
.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
This routine creates an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
client for the remote program
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
on
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa versnum ;
misc typos
1995-10-27 16:56:53 +00:00
the client uses
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP/IP
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
as a transport.
The remote program is located at Internet
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
address
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr .
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
If
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr\->sin_port
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 zero, then it is set to actual port that the remote
program is listening on (the remote
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
service is consulted for this information).
The parameter
.Fa sockp
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 a socket; if it is
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv RPC_ANYSOCK ,
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
then this routine opens a new one and sets
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa sockp .
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP
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
transport resends the call message in intervals of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa wait
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
time until a response is received or until the call times
out.
The total time for the call to time out is specified by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_call .
.Pp
This allows the user to specify the maximum packet size
for sending and receiving
.Tn UDP Ns \-based
.Tn RPC
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
messages.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft int
.Xc
.It Xo
.Fn get_myaddress "struct sockaddr_in *addr"
.Xc
.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
Stuff the machine's
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn IP
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
address into
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr ,
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
without consulting the library routines that deal with
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pa /etc/hosts .
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 port number is always set to
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn htons PMAPPORT .
- update return type of an "internal but documented" function - warn about FD_SETSIZE in certain internal functions Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:30:27 +00:00
Returns zero on success, non-zero on failure.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "struct pmaplist *"
.Xc
.It Xo
.Fn pmap_getmaps "struct sockaddr_in *addr"
.Xc
.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
A user interface to the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
service, which returns a list of the current
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
program\-to\-port mappings
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
on the host located at
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn IP
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
address
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr .
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
This routine can return
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
The command
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dq Nm rpcinfo Fl p
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
uses this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft u_short
.Xc
.It Xo
.Fo pmap_getport
.Fa "struct sockaddr_in *addr"
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "u_long protocol"
.Fc
.Xc
.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
A user interface to the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
service, which returns the port number
on which waits a service that supports program number
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
version
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
and speaks the transport protocol associated with
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa protocol .
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 value of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa protocol
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 most likely
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv IPPROTO_UDP
or
.Dv IPPROTO_TCP .
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 return value of zero means that the mapping does not exist
or that
the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
Fix even more spelling errors in some more man pages.
1996-01-30 16:34:52 +00:00
system failed to contact the remote
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
service.
In the latter case, the global variable
.Va rpc_createerr
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
contains the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
status.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "enum clnt_stat"
.Xc
.It Xo
.Fo pmap_rmtcall
.Fa "struct sockaddr_in *addr"
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "u_long procnum"
.Fa "xdrproc_t inproc"
.Fa "char *in"
.Fa "xdrproc_t outproc"
.Fa "char *out"
.Fa "struct timeval tout"
.Fa "u_long *portp"
.Fc
.Xc
.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
A user interface to the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
service, which instructs
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
on the host at
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn IP
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
address
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa addr
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
to make an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
call on your behalf to a procedure on that host.
The parameter
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa portp
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
will be modified to the program's port number if the
procedure
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
succeeds.
The definitions of other parameters are discussed
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
in
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn callrpc
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_call .
This procedure should be used for a
.Dq ping
and nothing
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
else.
See also
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clnt_broadcast .
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn pmap_set "u_long prognum" "u_long versnum" "u_long protocol" "u_short port"
.Xc
.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
A user interface to the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
service, which establishes a mapping between the triple
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pq Fa prognum , versnum , protocol
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa port
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
on the machine's
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
service.
The value of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa protocol
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 most likely
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv IPPROTO_UDP
or
.Dv IPPROTO_TCP .
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
This routine returns one if it succeeds, zero otherwise.
Automatically done by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_register .
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn pmap_unset "u_long prognum" "u_long versnum"
.Xc
.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
A user interface to the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
service, which destroys all mapping between the triple
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pq Fa prognum , 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
and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa ports
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
on the machine's
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
service.
This routine returns one if it succeeds, zero
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
otherwise.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fo registerrpc
.Fa "u_long prognum"
.Fa "u_long versnum"
.Fa "u_long procnum"
.Fa "char *(*procname)(void)"
.Fa "xdrproc_t inproc"
.Fa "xdrproc_t outproc"
.Fc
.Xc
.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
Register procedure
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa procname
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
with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
service package.
If a request arrives for program
.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
version
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
and procedure
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa procnum ,
.Fa procname
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 called with a pointer to its parameter(s);
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa progname
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
should return a pointer to its static result(s);
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa inproc
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 used to decode the parameters while
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa outproc
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 used to encode the results.
This routine returns zero if the registration succeeded, \-1
otherwise.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.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
Warning: remote procedures registered in this form
are accessed using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP/IP
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
transport; see
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svcudp_create
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
for restrictions.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Vt "struct rpc_createerr" rpc_createerr ;
.Xc
.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
A global variable whose value is set by any
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
client creation routine
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
that does not succeed.
Use the routine
.Fn clnt_pcreateerror
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
to print the reason why.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_destroy "SVCXPRT * xprt"
.Xc
.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
A macro that destroys the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service transport handle,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt .
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
Destruction usually involves deallocation
of private data structures, including
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt
itself.
Use of
.Fa xprt
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 undefined after calling this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Vt fd_set svc_fdset ;
.Xc
.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
A global variable reflecting the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service side's
- update return type of an "internal but documented" function - warn about FD_SETSIZE in certain internal functions Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:30:27 +00:00
read file descriptor bit mask; it is suitable as a template parameter
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
to the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr select 2
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
system call.
This is only of interest
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
if a service implementor does not call
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_run ,
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
but rather does his own asynchronous event processing.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
This variable is read\-only (do not pass its address to
.Xr select 2 ! ) ,
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
yet it may change after calls to
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getreqset
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 any creation routines.
- update return type of an "internal but documented" function - warn about FD_SETSIZE in certain internal functions Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:30:27 +00:00
As well, note that if the process has descriptor limits
which are extended beyond
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv FD_SETSIZE ,
- update return type of an "internal but documented" function - warn about FD_SETSIZE in certain internal functions Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:30:27 +00:00
this variable will only be usable for the first
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv FD_SETSIZE
- update return type of an "internal but documented" function - warn about FD_SETSIZE in certain internal functions Obtained from: a diff of FreeBSD vs. OpenBSD/NetBSD rpc code.
1996-12-30 14:30:27 +00:00
descriptors.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Vt int svc_fds ;
.Xc
.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
Similar to
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Va svc_fdset ,
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
but limited to 32 descriptors.
This
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
interface is obsoleted by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Va svc_fdset .
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_freeargs "SVCXPRT *xprt" "xdrproc_t inproc" "char *in"
.Xc
.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
A macro that frees any data allocated by the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC/XDR
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
system when it decoded the arguments to a service procedure
using
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getargs .
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
This routine returns 1 if the results were successfully
freed,
and zero otherwise.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getargs "SVCXPRT *xprt" "xdrproc_t inproc" "char *in"
.Xc
.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
A macro that decodes the arguments of an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
request
associated with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service transport handle,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt .
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 parameter
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa in
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 the address where the arguments will be placed;
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa inproc
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 the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn XDR
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
routine used to decode the arguments.
This routine returns one if decoding succeeds, and zero
otherwise.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "struct sockaddr_in *"
.Xc
.It Xo
.Fn svc_getcaller "SVCXPRT *xprt"
.Xc
.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 approved way of getting the network address of the caller
of a procedure associated with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service transport handle,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt .
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft void
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getreqset "fd_set *rdfds"
.Xc
.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
This routine is only of interest if a service implementor
does not call
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_run ,
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
but instead implements custom asynchronous event processing.
It is called when the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr select 2
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
system call has determined that an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
request has arrived on some
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
socket(s);
.Fa rdfds
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 the resultant read file descriptor bit mask.
The routine returns when all sockets associated with the
value of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa rdfds
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
have been serviced.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft void
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getreq "int rdfds"
.Xc
.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
Similar to
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getreqset ,
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
but limited to 32 descriptors.
This interface is obsoleted by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getreqset .
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fo svc_register
.Fa "SVCXPRT *xprt"
.Fa "u_long prognum"
.Fa "u_long versnum"
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Fa "void (*dispatch)(struct svc_req *, SVCXPRT *)"
.Fa "int protocol"
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fc
.Xc
.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
Associates
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
with the service dispatch procedure,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn dispatch .
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
If
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa protocol
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 zero, the service is not registered with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
service.
If
.Fa protocol
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 non-zero, then a mapping of the triple
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pq Fa prognum , versnum , protocol
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
to
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt\->xp_port
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 established with the local
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
service (generally
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa protocol
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 zero,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv IPPROTO_UDP
or
.Dv IPPROTO_TCP ) .
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 procedure
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn dispatch
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
has the following form:
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Bd -ragged -offset indent
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn dispatch "struct svc_req *request" "SVCXPRT *xprt"
.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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_register
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
routine returns one if it succeeds, and zero otherwise.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Fn svc_run
.Xc
.Pp
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
This routine never returns.
It waits for
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
requests to arrive, and calls the appropriate service
procedure using
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getreq
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
when one arrives.
This procedure is usually waiting for a
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr select 2
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
system call to return.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_sendreply "SVCXPRT *xprt" "xdrproc_t outproc" "char *out"
.Xc
.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
Called by an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service's dispatch routine to send the results of a
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
remote procedure call.
The parameter
.Fa xprt
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 the request's associated transport handle;
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa outproc
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 the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn XDR
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
routine which is used to encode the results; and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa out
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 the address of the results.
This routine returns one if it succeeds, zero otherwise.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn svc_unregister "u_long prognum" "u_long versnum"
.Xc
.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
Remove all mapping of the double
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pq Fa prognum , 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
to dispatch routines, and of the triple
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pq Fa prognum , 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
to port number.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn svcerr_auth "SVCXPRT *xprt" "enum auth_stat why"
.Xc
.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
Called by a service dispatch routine that refuses to perform
a remote procedure call due to an authentication error.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn svcerr_decode "SVCXPRT *xprt"
.Xc
.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
Called by a service dispatch routine that cannot successfully
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
decode its parameters.
See also
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn svc_getargs .
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn svcerr_noproc "SVCXPRT *xprt"
.Xc
.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
Called by a service dispatch routine that does not implement
the procedure number that the caller requests.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn svcerr_noprog "SVCXPRT *xprt"
.Xc
.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
Called when the desired program is not registered with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
package.
Service implementors usually do not need this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Fn svcerr_progvers "SVCXPRT *xprt" "u_long low_vers" "u_long high_vers"
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xc
.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
Called when the desired version of a program is not registered
with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
package.
Service implementors usually do not need this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn svcerr_systemerr "SVCXPRT *xprt"
.Xc
.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
Called by a service dispatch routine when it detects a system
error
not covered by any particular protocol.
For example, if a service can no longer allocate storage,
it may call this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn svcerr_weakauth "SVCXPRT *xprt"
.Xc
.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
Called by a service dispatch routine that refuses to perform
a remote procedure call due to insufficient
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
authentication parameters.
The routine calls
.Fn svcerr_auth xprt AUTH_TOOWEAK .
.Pp
.It Xo
.Ft "SVCXPRT *"
.Xc
.It Xo
.Fn svcraw_create void
.Xc
.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
This routine creates a toy
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
service transport, to which it returns a pointer.
The transport
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 really a buffer within the process's address space,
so the corresponding
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
client should live in the same
address space;
see
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn clntraw_create .
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
This routine allows simulation of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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 acquisition of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
overheads (such as round trip times), without any kernel
interference.
This routine returns
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
if it fails.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "SVCXPRT *"
.Xc
.It Xo
.Fn svctcp_create "int sock" "u_int send_buf_size" "u_int recv_buf_size"
.Xc
.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
This routine creates a
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn TCP/IP Ns \-based
.Tn RPC
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
service transport, to which it returns a pointer.
The transport is associated with the socket
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa sock ,
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
which may be
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv RPC_ANYSOCK ,
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
in which case a new socket is created.
If the socket is not bound to a local
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn TCP
port, then this routine binds it to an arbitrary port.
Upon completion,
.Fa xprt\->xp_sock
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 the transport's socket descriptor, and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt\->xp_port
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 the transport's port number.
This routine returns
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv NULL
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
if it fails.
Since
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn TCP Ns \-based
.Tn RPC
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
uses buffered
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn I/O ,
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
users may specify the size of buffers; values of zero
choose suitable defaults.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "SVCXPRT *"
.Xc
.It Xo
.Fn svcfd_create "int fd" "u_int sendsize" "u_int recvsize"
.Xc
.Pp
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
Create a service on top of any open descriptor.
Typically,
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
this
descriptor is a connected socket for a stream protocol such
as
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn TCP .
.Fa sendsize
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
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa recvsize
indicate sizes for the send and receive buffers.
If they are
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
zero, a reasonable default is chosen.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft "SVCXPRT *"
.Xc
.It Xo
.Fn svcudp_bufcreate "int sock" "u_int sendsize" "u_int recvsize"
.Xc
.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
This routine creates a
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP/IP Ns \-based
.Tn RPC
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
service transport, to which it returns a pointer.
The transport is associated with the socket
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa sock ,
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
which may be
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv RPC_ANYSOCK ,
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
in which case a new socket is created.
If the socket is not bound to a local
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
port, then this routine binds it to an arbitrary port.
Upon
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
completion,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt\->xp_sock
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 the transport's socket descriptor, and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa xprt\->xp_port
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 the transport's port number.
This routine returns
man(7) -> mdoc(7).
2001-01-17 18:26:21 +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
if it fails.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
This allows the user to specify the maximum packet size for sending and
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
receiving
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn UDP Ns \-based
.Tn RPC
messages.
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_accepted_reply "XDR *xdrs" "struct accepted_reply *ar"
.Xc
.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
Used for encoding
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
reply messages.
This routine is useful for users who
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
wish to generate
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC Ns \-style
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
messages without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
package.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_authunix_parms "XDR *xdrs" "struct authunix_parms *aupp"
.Xc
.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
Used for describing
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Ux
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
credentials.
This routine is useful for users
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
who wish to generate these credentials without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
authentication package.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_callhdr "XDR *xdrs" "struct rpc_msg *chdr"
.Xc
.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
Used for describing
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
call header messages.
This routine is useful for users who wish to generate
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC Ns \-style
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
messages without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
package.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_callmsg "XDR *xdrs" "struct rpc_msg *cmsg"
.Xc
.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
Used for describing
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
call messages.
This routine is useful for users who wish to generate
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC Ns \-style
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
messages without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
package.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_opaque_auth "XDR *xdrs" "struct opaque_auth *ap"
.Xc
.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
Used for describing
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
authentication information messages.
This routine is useful for users who wish to generate
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC Ns \-style
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
messages without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
package.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
mdoc(7) police: C types should be declared with either .Ft or .Vt.
2001-02-08 10:22:35 +00:00
.Vt struct pmap ;
.Xc
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_pmap "XDR *xdrs" "struct pmap *regs"
.Xc
.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
Used for describing parameters to various
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr portmap 8
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
procedures, externally.
This routine is useful for users who wish to generate
these parameters without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn pmap_*
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
interface.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_pmaplist "XDR *xdrs" "struct pmaplist **rp"
.Xc
.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
Used for describing a list of port mappings, externally.
This routine is useful for users who wish to generate
these parameters without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn pmap_*
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
interface.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_rejected_reply "XDR *xdrs" "struct rejected_reply *rr"
.Xc
.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
Used for describing
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
reply messages.
This routine is useful for users who wish to generate
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC Ns \-style
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
messages without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
package.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
Fixed errors in prototypes. Many were hiding under mdoc errors.
2001-02-05 15:11:09 +00:00
.Ft bool_t
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn xdr_replymsg "XDR *xdrs" "struct rpc_msg *rmsg"
.Xc
.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
Used for describing
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
reply messages.
This routine is useful for users who wish to generate
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
style messages without using the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
package.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn xprt_register "SVCXPRT *xprt"
.Xc
.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
After
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service transport handles are created,
they should register themselves with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service package.
This routine modifies the global variable
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Va svc_fds .
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
Service implementors usually do not need this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
.It Xo
.Ft void
.Xc
.It Xo
.Fn xprt_unregister "SVCXPRT *xprt"
.Xc
.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
Before an
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service transport handle is destroyed,
it should unregister itself with the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn RPC
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
service package.
This routine modifies the global variable
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Va svc_fds .
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
Service implementors usually do not need this routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.El
.Sh SEE ALSO
.Xr rpc_secure 3 ,
.Xr xdr 3
.Rs
.%T "Remote Procedure Calls: Protocol Specification"
.Re
.Rs
.%T "Remote Procedure Call Programming Guide"
.Re
.Rs
.%T "rpcgen Programming Guide"
.Re
.Rs
.%T "RPC: Remote Procedure Call Protocol Specification"
.%O RFC1050
.%Q "Sun Microsystems, Inc., USC-ISI"
.Re