rpc_svc_err(3N)                                             rpc_svc_err(3N)

NAME
     rpcsvcerr: svcerrauth, svcerrdecode, svcerrnoproc, svcerrnoprog,
     svcerrprogvers, svcerrsystemerr, svcerrweakauth - 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.

     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>

     void
     svcerrauth(const SVCXPRT *xprt, const enum authstat why);

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

     void
     svcerrdecode(const SVCXPRT *xprt);

          Called by a service dispatch routine that cannot successfully
          decode the remote parameters [see svcgetargs in
          rpcsvcreg(3N)].

     void
     svcerrnoproc(const SVCXPRT *xprt);

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

     void
     svcerrnoprog(const SVCXPRT *xprt);

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

     void
     svcerrprogvers(const SVCXPRT *xprt);

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



Page 1                       Reliant UNIX 5.44                Printed 11/98

rpc_svc_err(3N)                                             rpc_svc_err(3N)

     void
     svcerrsystemerr(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
     svcerrweakauth(const SVCXPRT *xprt);

          Called by a service dispatch routine that refuses to perform a
          remote procedure call due to insufficient (but correct) authenti-
          cation parameters. The routine calls svcerrauth(xprt,
          AUTHTOOWEAK).

SEE ALSO
     rpc(3N), rpcsvccalls(3N), rpcsvccreate(3N), rpcsvcreg(3N).





































Page 2                       Reliant UNIX 5.44                Printed 11/98