NAME

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

DESCRIPTION

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

Routines

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

#include <rpc/rpc.h>

int
rpc_reg(const u_long prognum, const u_long versnum,
const u_long procnum, const char ∗(∗procname),
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 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. 

SEE ALSO

rpcbind(1M), rpcbind(3N), rpc(3N), rpc_svc_err(3N), rpc_svc_create(3N), rpc_svc_reg(3N)