rpc_svc_err(3N)         LIBRARY FUNCTIONS         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.

  Routines
     See rpc(3N) for the definition of the  SVCXPRT  data  struc-
     ture.
     #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 authentica-
          tion error.
          void
          svcerrdecode(const SVCXPRT *xprt);

          Called by a service dispatch routine that  cannot  suc-
          cessfully 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.
          void
          svcerrsystemerr(const SVCXPRT *xprt);

          Called by a service dispatch routine when it detects  a
          system  error  not  covered by any particular protocol.



                                                                1

rpc_svc_err(3N)         LIBRARY FUNCTIONS         rpc_svc_err(3N)



          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) authentication parameters.   The  routine
          calls svcerrauth(xprt, AUTHTOOWEAK).

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










































                                                                2