rpc_svc_err(3C)

NAME

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

SYNOPSIS

#include <rpc/rpc.h>

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

/* svcerr_decode */
void
svcerr_decode(xprt)
SVCXPRT *xprt;

/* svcerr_noproc */
void
svcerr_noproc(xprt)
SVCXPRT *xprt;

/* svcerr_noprog */
void
svcerr_noprog(xprt)
SVCXPRT *xprt;

/* svcerr_progvers */

void
svcerr_progvers(xprt)
SVCXPRT *xprt;

/* svcerr_systemerr */
void
svcerr_systemerr(xprt)
SVCXPRT *xprt;

/* svcerr_weakauth */

void
svcerr_weakauth(xprt)
SVCXPRT *xprt;

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 following routines require that the header file <rpc.h> be included.

The SVCXPRT data structure is defined in Power Programming with RPC.

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

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

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

svcerr_noprog Called when the desired program is not registered with the RPC package. Service implementors usually do not need this routine.

svcerr_progvers Called when the desired version of a program is not registered with the RPC package. Service implementors usually do not need this routine.

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

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

AUTHOR

rpc was developed by Sun Microsystems, Inc.

Museum