unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

RPC_SVC_ERR(3N)                                                RPC_SVC_ERR(3N)



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

DESCRIPTION
       RPC routines allow C programs to make procedure calls on other machines
       across the network.  First, the client calls  a  procedure  to  send  a
       request to the server.  Upon receipt of the request, the server calls a
       dispatch routine to perform the requested service, and then sends  back
       a reply.  Finally, the procedure call returns to the client.

       These  routines  can  be called by the server side dispatch function if
       there is any error in the transaction with the client.

   Routines
       The SVCXPRT data structure is defined in the  RPC/XDR  Library  Defini-
       tions of the

       #include <&lt;rpc/rpc.h>&gt;

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

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

       void svcerr_decode(xprt)
       SVCXPRT *xprt;

              Called by a service dispatch routine  that  cannot  successfully
              decode    the    remote   parameters.   See   svc_getargs()   in
              rpc_svc_reg(3N).

       void svcerr_noproc(xprt)
       SVCXPRT *xprt;

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

       void svcerr_noprog(xprt)
       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(xprt)
       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 svcerr_systemerr(xprt)
       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  rou-
              tine.

       void svcerr_weakauth(xprt)
       SVCXPRT *xprt;

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

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



                                20 January 1990                RPC_SVC_ERR(3N)