RPCSVCREG(3N-SVR4)RISC/os Reference Manual RPCSVCREG(3N-SVR4)



NAME
     rpc_svc_reg: svc_freeargs, svc_getargs, svc_getreqset,
          svc_getrpccaller, svc_run, svc_sendreply - library rou-
          tines 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 mechanism.  Some of them are called by the server side
     dispatch function, while others [such as svcrun] are called
     when the server is initiated.

   Routines
     #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 ser-
          vice procedure using svcgetargs.  This routine returns
          1 if the results were successfully freed, and 0 other-
          wise.

     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 han-
          dle 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
     svcgetreqset(fdset *rdfds);

          This routine is only of interest if a service implemen-
          tor does not call svcrun, but instead implements cus-
          tom 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 *
     svcgetrpccaller(const SVCXPRT *xprt);




                        Printed 11/19/92                   Page 1

RPCSVCREG(3N-SVR4)RISC/os Reference Manual RPCSVCREG(3N-SVR4)



          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), rpc_svc_calls(3N), rpc_svc_create(3N),
     rpc_svc_err(3N).





























 Page 2                 Printed 11/19/92