Networking Services Library Functions           rpcsvcerr(3NSL)



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(3NSL) for the definition of the SVCXPRT data  struc-
     ture.

       #include 



     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  suc-
         cessfully    decode    the    remote   parameters   (see
         svcgetargs() in rpcsvcreg(3NSL)).


     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.





SunOS 5.11          Last change: 20 Feb 1998                    1






Networking Services Library Functions           rpcsvcerr(3NSL)



     void svcerrprogvers(const SVCXPRT *xprt, const rpcverst
     lowvers, const rpcverst highvers);

         Called when the desired version  of  a  program  is  not
         registered  with the RPC package. lowvers is the lowest
         version number, and highvers  is  the  highest  version
         number.  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. 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, AUTHTOWEAK).


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     rpc(3NSL),    rpcsvccalls(3NSL),     rpcsvccreate(3NSL),
     rpcsvcreg(3NSL), attributes(5)













SunOS 5.11          Last change: 20 Feb 1998                    2