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 Definitions of the Network Programming. 

#include <rpc/rpc.h>

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

void svcerr_weakauth(xprt)
SVCXPRT ∗xprt;

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

SEE ALSO

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

Solbourne Computer, Inc.  —  20 January 1990