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
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.
#include <rpc/rpc.h>
void
svcerr_auth(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(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(SVCXPRT *xprt);
Called by a service dispatch routine that does not implement the
procedure number that the caller requests.
void
svcerr_noprog(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(SVCXPRT *xprt, rpcvers_t low_vers, rpcvers_t high_vers);
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(SVCXPRT *xprt);
Page 1
rpc_svc_err(3N)rpc_svc_err(3N)
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(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).
SEE ALSOrpc(3N), rpc_svc_calls(3N), rpc_svc_create(3N), rpc_svc_reg(3N)
Page 2
