bool_t
svc_control(
SVCXPRT *svc
, const u_int req
, void *info
)
int
svc_create(
const void (*dispatch)(struct svc_req *, SVCXPRT *)
, const rpcprog_t prognum
, const rpcvers_t versnum
, const char *nettype
)
SVCXPRT
*"
svc_dg_create(
const int fildes
, const u_int sendsz
, const u_int recvsz
)
void
svc_destroy(
SVCXPRT *xprt
)
SVCXPRT *
svc_fd_create(
const int fildes
, const u_int sendsz
, const u_int recvsz
)
SVCXPRT *
svc_raw_create(
void
)
SVCXPRT *
svc_tli_create(
const int fildes
, const struct netconfig *netconf
, const struct t_bind *bindaddr
, const u_int sendsz
, const u_int recvsz
)
SVCXPRT *
svc_tp_create(
const void (*dispatch)(const struct svc_reg *, const SVCXPRT *)const rpcprog_t prognum
, const rpcvers_t versnum
, const struct netconfig *netconf
)
SVCXPRT *
svc_vc_create(
const int fildes
, const u_int sendsz
, const u_int recvsz
)
).
SVCXPRT
data structure.
)
req
indicates the type of operation and
info
is a pointer to the information.
The supported values of
req
,
their argument types, and what they do are:
SVCGET_VERSQUIET
RPC_PROGVERSMISMATCH
error will normally
be returned.
info
should be a pointer to an integer.
Upon successful completion of the
SVCGET_VERSQUIET
request,
*info
contains an
integer which describes the server's current
behavior: 0 indicates normal server behavior
(that is, an
RPC_PROGVERSMISMATCH
error
will be returned); 1 indicates that the out of
range request will be silently ignored.
SVCSET_VERSQUIET
RPC_PROGVERSMISMATCH
error will normally be returned.
It is sometimes desirable to change this behavior.
info
should be a
pointer to an integer which is either 0
(indicating normal server behavior - an
RPC_PROGVERSMISMATCH
error will be returned),
or 1 (indicating that the out of range request
should be silently ignored).
)
)
creates server handles for all the transports
belonging to the class
nettype
.
nettype
defines a class of transports which can be used
for a particular application.
The transports are tried in left to right order in
NETPATH
variable or in top to bottom order in the netconfig database.
If
nettype
is
NULL
,
it defaults to
netpath
.
svc_create()
registers itself with the rpcbind
service (see
rpcbind(8)).
dispatch
is called when there is a remote procedure call for the given
prognum
and
versnum
;
this requires calling
svc_run()
(see
svc_run(
)
in
rpc_svc_reg(3)).
If
svc_create(
)
succeeds, it returns the number of server
handles it created,
otherwise it returns 0 and an error message is logged.
)
xprt
.
Destruction usually involves deallocation
of private data structures,
including
xprt
itself.
Use of
xprt
is undefined after calling this routine.
)
NULL
if it fails, and an error message is logged.
sendsz
and
recvsz
are parameters used to specify the size of the buffers.
If they are 0, suitable defaults are chosen.
The file descriptor
fildes
should be open and bound.
The server is not registered with
rpcbind(8).
)
sendsz
and
recvsz
indicate sizes for the send and receive buffers.
If they are 0, reasonable defaults are chosen.
This routine returns
NULL
if it fails, and an error message is logged.
)
)
in
rpc_clnt_create(3)).
This routine allows simulation of RPC and acquisition of
RPC overheads (such as round trip times),
without any kernel and networking interference.
This routine returns
NULL
if it fails, and an error message is logged.
)
should not be called when the raw interface is being used.
)
fildes
is the file descriptor on which the service is listening.
If
fildes
is
RPC_ANYFD
,
it opens a file descriptor on the transport specified by
netconf
.
If the file descriptor is unbound and
bindaddr
is non-null
fildes
is bound to the address specified by
bindaddr
,
otherwise
fildes
is bound to a default address chosen by the transport.
Note: the
structure comes from the TLI/XTI SysV interface, which
NetBSD
does not use.
The structure is defined in
<rpc/types.h
>
for compatibility as:
struct t_bind {
struct netbuf addr; /* network address, see rpc(3) */
unsigned int qlen; /* queue length (for listen(2)) */
};
In the case where the default address is chosen,
the number of outstanding connect requests is set to 8
for connection-oriented transports.
The user may specify the size of the send and receive buffers
with the parameters
sendsz
and
recvsz
;
values of 0 choose suitable defaults.
This routine returns
NULL
if it fails,
and an error message is logged.
The server is not registered with the
rpcbind(8)
service.
)
)
creates a server handle for the network
specified by
netconf
,
and registers itself with the rpcbind service.
dispatch
is called when there is a remote procedure call
for the given
prognum
and
versnum
;
this requires calling
svc_run(
).
svc_tp_create(
)
returns the service handle if it succeeds,
otherwise a
NULL
is returned and an error message is logged.
)
NULL
if it fails, and an error message is logged.
The users may specify the size of the send and receive buffers
with the parameters
sendsz
and
recvsz
;
values of 0 choose suitable defaults.
The file descriptor
fildes
should be open and bound.
The server is not registered with the
rpcbind(8)
service.