Copyright 1989 AT&T
@(#)rpc_svc_err 1.4 89/06/28 SMI;
Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
$NetBSD: rpc_svc_err.3,v 1.1 2000/06/02 23:11:14 fvdl Exp $
$FreeBSD$
.Dd May 3, 1993 .Dt RPC_SVC_ERR 3 .Os .Sh NAME .Nm rpc_svc_err , .Nm svcerr_auth , .Nm svcerr_decode , .Nm svcerr_noproc , .Nm svcerr_noprog , .Nm svcerr_progvers , .Nm svcerr_systemerr , .Nm svcerr_weakauth .Nd library routines for server side remote procedure call errors .Sh LIBRARY .Lb libc .Sh SYNOPSIS n rpc/rpc.h .Ft void .Fn svcerr_auth "SVCXPRT *xprt" "enum auth_stat why" .Ft void .Fn svcerr_decode "SVCXPRT *xprt" .Ft void .Fn svcerr_noproc "SVCXPRT *xprt" .Ft void .Fn svcerr_noprog "SVCXPRT *xprt" .Ft void .Fn svcerr_progvers "SVCXPRT *xprt" "rpcvers_t low_vers" "rpcvers_t high_vers" .Ft void .Fn svcerr_systemerr "SVCXPRT *xprt" .Ft void .Fn svcerr_weakauth "SVCXPRT *xprt" .Sh DESCRIPTION These routines are part of the RPC library which allows C language programs to make procedure calls on other machines across the network.
p These routines can be called by the server side dispatch function if there is any error in the transaction with the client. .Sh Routines See .Xr rpc 3 for the definition of the .Vt SVCXPRT data structure. l -tag -width XXXXX t Fn svcerr_auth Called by a service dispatch routine that refuses to perform a remote procedure call due to an authentication error. t Fn svcerr_decode Called by a service dispatch routine that cannot successfully decode the remote arguments (see .Fn svc_getargs in .Xr rpc_svc_reg 3 ) . t Fn svcerr_noproc Called by a service dispatch routine that does not implement the procedure number that the caller requests. t Fn svcerr_noprog Called when the desired program is not registered with the RPC package. Service implementors usually do not need this routine. t Fn svcerr_progvers Called when the desired version of a program is not registered with the RPC package. The .Fa low_vers argument is the lowest version number, and .Fa high_vers is the highest version number. Service implementors usually do not need this routine. t Fn 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. t Fn svcerr_weakauth Called by a service dispatch routine that refuses to perform a remote procedure call due to insufficient (but correct) authentication arguments. The routine calls .Fn svcerr_auth "xprt" "AUTH_TOOWEAK" . .El .Sh SEE ALSO .Xr rpc 3 , .Xr rpc_svc_calls 3 , .Xr rpc_svc_create 3 , .Xr rpc_svc_reg 3