rpc_svc_reg(3N)                                             rpc_svc_reg(3N)

NAME
     rpcsvcreg: svcfreeargs, svcgetargs, svcgetreqset,
     svcgetrpccaller, svcrun, svcsendreply - library routines for RPC
     servers

DESCRIPTION
     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 mechan-
     ism. Some of them are called by the server side dispatch function,
     while others [such as svcrun] are called when the server is ini-
     tiated.

     If you use one of the RPC functions, you must link the libnsl library
     at compilation (cc -lnsl).

   Routines

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

     #include <rpc/rpc.h>

     int
     svcfreeargs(const SVCXPRT *xprt, const xdrproct 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
          svcgetargs. This routine returns 1 if the results were success-
          fully freed, and 0 otherwise.

     int
     svcgetargs(const SVCXPRT *xprt, const xdrproct inproc, caddrt *in);

          A function macro that decodes the arguments of an RPC request
          associated with the RPC service transport handle xprt. The param-
          eter 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
     svcgetreqset(fdset *rdfds);

          This routine is only of interest if a service implementor does
          not call svcrun, 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.





Page 1                       Reliant UNIX 5.44                Printed 11/98

rpc_svc_reg(3N)                                             rpc_svc_reg(3N)

     struct netbuf *
     svcgetrpccaller(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.

     void
     svcrun(void);

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

     int
     svcsendreply(const SVCXPRT *xprt, const xdrproct outproc,
          const caddrt *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
     poll(2), rpc(3N), rpcsvccalls(3N), rpcsvccreate(3N),
     rpcsvcerr(3N).


























Page 2                       Reliant UNIX 5.44                Printed 11/98