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



NAME
     rpc_svc_err:   svcerr_auth, svcerr_decode, svcerr_noproc,
          svcerr_noprog, svcerr_progvers, svcerr_systemerr,
          svcerr_weakauth - library routines for server side
          remote procedure call errors

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 can be called by the server side dispatch
     function if there is any error in the transaction with the
     client.

   Routines
     See rpc(3N) for the definition of the SVCXPRT data struc-
     ture.

     #include <rpc/rpc.h>

     void
     svcerr_auth(const SVCXPRT *xprt, const enum auth_stat why);

          Called by a service dispatch routine that refuses to
          perform a remote procedure call due to an authentica-
          tion error.

     void
     svcerr_decode(const SVCXPRT *xprt);

          Called by a service dispatch routine that cannot suc-
          cessfully decode the remote parameters [see svc_getargs
          in rpc_svc_reg(3N)].

     void
     svcerr_noproc(const SVCXPRT *xprt);

          Called by a service dispatch routine that does not
          implement the procedure number that the caller
          requests.

     void
     svcerr_noprog(const SVCXPRT *xprt);

          Called when the desired program is not registered with
          the RPC package.  Service implementors usually do not
          need this routine.

     void
     svcerr_progvers(const SVCXPRT *xprt);




                        Printed 11/19/92                   Page 1

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



          Called when the desired version of a program is not
          registered with the RPC package.  Service implementors
          usually do not need this routine.

     void
     svcerr_systemerr(const SVCXPRT *xprt);

          Called by a service dispatch routine when it detects a
          system error not covered by any particular protocol.
          For example, if a service can no longer allocate
          storage, it may call this routine.

     void
     svcerr_weakauth(const SVCXPRT *xprt);

          Called by a service dispatch routine that refuses to
          perform a remote procedure call due to insufficient
          (but correct) authentication parameters.  The routine
          calls svcerr_auth(xprt, AUTH_TOOWEAK).

SEE ALSO
     rpc(3N), rpc_svc_calls(3N), rpc_svc_create(3N),
     rpc_svc_reg(3N).
































 Page 2                 Printed 11/19/92