rpc_svc_calls(S)

rpc_svc_calls: rpc_reg, svc_reg, svc_unreg, xprt_register, xprt_unregister -- library routines for registering servers

Synopsis

cc [options] file -lnsl

#include <rpc/rpc.h>

int rpc_reg(const u_long prognum, const u_long versnum,
	const u_long procnum, const char *(*procname)(caddr_t),
	const xdrproc_t inproc, const xdrproc_t outproc,
	const char *nettype);

int svc_reg(const SVCXPRT *xprt, const u_long prognum,
	const u_long versnum,
	const void (*dispatch)(const struct svc_req *, const SVCXPRT *),
	const struct netconfig *netconf);

void svc_unreg(const u_long prognum, const u_long versnum);

void xprt_register(const SVCXPRT *xprt);

void xprt_unregister(const SVCXPRT *xprt);

Description

These routines are a part of the RPC library which allows the RPC servers to register themselves with rpcbind (see rpcbind(ADMN)), and it associates the given program and version number with the dispatch function.

Routines

See rpc(NS) for the definition of the SVCXPRT data structure.

int
rpc_reg(const u_long prognum, const u_long versnum,
	const u_long procnum, const char *(*procname)(caddr_t),
	const xdrproc_t inproc, const xdrproc_t outproc,
	const char *nettype);

Register program prognum, procedure procname, and version versnum with the RPC service package. If a request arrives for program prognum, version versnum, and procedure procnum, procname is called with a pointer to its parameter(s); procname should return a pointer to its static result(s); inproc is used to decode the parameters while outproc is used to encode the results. Procedures are registered on all available transports of the class nettype. nettype defines a class of transports which can be used for a particular application. If nettype is NULL, it defaults to netpath. This routine returns 0 if the registration succeeded, -1 otherwise.

int
svc_reg(const SVCXPRT *xprt, const u_long prognum,
	const u_long versnum,
	const void (*dispatch)(const struct svc_req *, const SVCXPRT *),
	const struct netconfig *netconf);

Associates prognum and versnum with the service dispatch procedure, dispatch. If netconf is NULL, the service is not registered with the rpcbind service. If netconf is non-zero, then a mapping of the triple [prognum, versnum, netconf->nc_netid] to xprt->xp_ltaddr is established with the local rpcbind service.

The svc_reg routine returns 1 if it succeeds, and 0 otherwise.

void
svc_unreg(const u_long prognum, const u_long versnum);

Remove, from the rpcbind service, all mappings of the double [prognum, versnum] to dispatch routines, and of the triple (prognum, versnum, *] to network address.

void
xprt_register(const SVCXPRT *xprt);

After RPC service transport handle xprt is created, it is registered with the RPC service package. This routine modifies the global variable svc_fds. Service implementors usually do not need this routine.

void
xprt_unregister(const SVCXPRT *xprt);

Before an RPC service transport handle xprt is destroyed, it unregisters itself with the RPC service package. This routine modifies the global variable svc_fds. Service implementors usually do not need this routine.

Files

/usr/lib/locale/locale/LC_MESSAGES/uxnsl

References

rpcbind(ADMN), rpcbind(NS), rpc(NS), rpc_svc_err(NS), rpc_svc_create(NS), rpc_svc_reg(NS)