rpc_svc_err(3N)                                      rpc_svc_err(3N)


       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

       SYNOPSIS
             cc [options] file -lnsl
             #include <rpc/rpc.h>
             void svcerr_auth(const SVCXPRT *xprt, const enum auth_stat why);
             void svcerr_decode(const SVCXPRT *xprt);
             void svcerr_noproc(const SVCXPRT *xprt);
             void svcerr_noprog(const SVCXPRT *xprt);
             void svcerr_progvers(const SVCXPRT *xprt);
             void svcerr_systemerr(const SVCXPRT *xprt);
             void svcerr_weakauth(const SVCXPRT *xprt);

       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 structure.

             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 authentication
                   error.

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



                           Copyright 1994 Novell, Inc.               Page 1

      rpc_svc_err(3N)                                      rpc_svc_err(3N)


                  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);

                  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).

         Files
            /usr/lib/locale/locale/LC_MESSAGES/uxnsl

      REFERENCES
            rpc(3N), rpc_svc_calls(3N), rpc_svc_create(3N),
            rpc_svc_reg(3N)









                          Copyright 1994 Novell, Inc.               Page 2