rpc_svc_reg(3N)						       rpc_svc_reg(3N)

NAME    [Toc]    [Back]

     rpc_svc_reg:   svc_freeargs, svc_getargs, svc_getreqset,
     svc_getrpccaller, svc_run,	svc_sendreply -	library	routines for RPC
     servers

DESCRIPTION    [Toc]    [Back]

     These routines are	part of	the RPC	library	which allows C language
     programs to make procedure	calls on other machines	across the network.

     These routines are	associated with	the server side	of the RPC mechanism.
     Some of them are called by	the server side	dispatch function, while
     others [such as svc_run] are called when the server is initiated.

   Routines    [Toc]    [Back]
     #include <rpc/rpc.h>

     int
     svc_freeargs(const	SVCXPRT	*xprt, const xdrproc_t inproc, char *in);

	  A function macro that	frees any data allocated by the	RPC/XDR	system
	  when it decoded the arguments	to a service procedure using
	  svc_getargs.	This routine returns 1 if the results were
	  successfully freed, and 0 otherwise.

     int
     svc_getargs(const SVCXPRT *xprt, const xdrproc_t inproc, caddr_t *in);

	  A function macro that	decodes	the arguments of an RPC	request
	  associated with the RPC service transport handle xprt.  The
	  parameter in is the address where the	arguments will be placed;
	  inproc is the	XDR routine used to decode the arguments.  This
	  routine returns 1 if decoding	succeeds, and 0	otherwise.

     void
     svc_getreqset(fd_set *rdfds);

	  This routine is only of interest if a	service	implementor does not
	  call svc_run,	but instead implements custom asynchronous event
	  processing.  It is called when poll has determined that an RPC
	  request has arrived on some RPC file descriptors; rdfds is the
	  resultant read file descriptor bit mask.  The	routine	returns	when
	  all file descriptors associated with the value of rdfds have been
	  serviced

     struct netbuf *
     svc_getrpccaller(const SVCXPRT *xprt);

	  The approved way of getting the network address of the caller	of a
	  procedure associated with the	RPC service transport handle xprt.






									Page 1






rpc_svc_reg(3N)						       rpc_svc_reg(3N)



     void
     svc_run(void);

	  This routine never returns.  It waits	for RPC	requests to arrive,
	  and calls the	appropriate service procedure using svc_getreqset when
	  one arrives.	This procedure is usually waiting for a	poll library
	  call to return.

     int
     svc_sendreply(const SVCXPRT *xprt,	const xdrproc_t	outproc,
	  const	caddr_t	*out);

	  Called by an RPC service's dispatch routine to send the results of a
	  remote procedure call.  The parameter	xprt is	the request's
	  associated transport handle; outproc is the XDR routine which	is
	  used to encode the results; and out is the address of	the results.
	  This routine returns 1 if it succeeds, 0 otherwise.

SEE ALSO    [Toc]    [Back]

     poll(2), rpc(3N), rpc_svc_calls(3N), rpc_svc_create(3N), rpc_svc_err(3N)


									PPPPaaaaggggeeee 2222