1 .\" @(#)rpc_svc_err.3n 1.23 93/08/31 SMI; from SVr4
2 .\" Copyright 1989 AT&T
3 .\" @(#)rpc_svc_err 1.4 89/06/28 SMI;
4 .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
5 .\" $NetBSD: rpc_svc_err.3,v 1.1 2000/06/02 23:11:14 fvdl Exp $
17 .Nm svcerr_systemerr ,
19 .Nd library routines for server side remote procedure call errors
25 .Fn svcerr_auth "SVCXPRT *xprt" "enum auth_stat why"
27 .Fn svcerr_decode "SVCXPRT *xprt"
29 .Fn svcerr_noproc "SVCXPRT *xprt"
31 .Fn svcerr_noprog "SVCXPRT *xprt"
33 .Fn svcerr_progvers "SVCXPRT *xprt" "rpcvers_t low_vers" "rpcvers_t high_vers"
35 .Fn svcerr_systemerr "SVCXPRT *xprt"
37 .Fn svcerr_weakauth "SVCXPRT *xprt"
39 These routines are part of the RPC
40 library which allows C language programs to make procedure
41 calls on other machines across the network.
43 These routines can be called by the server side
44 dispatch function if there is any error in the
45 transaction with the client.
49 for the definition of the
54 Called by a service dispatch routine that refuses to perform
55 a remote procedure call due to an authentication error.
57 Called by a service dispatch routine that cannot successfully
58 decode the remote arguments
64 Called by a service dispatch routine that does not implement
65 the procedure number that the caller requests.
67 Called when the desired program is not registered with the
69 Service implementors usually do not need this routine.
70 .It Fn svcerr_progvers
71 Called when the desired version of a program is not registered with the
76 is the lowest version number,
79 is the highest version number.
80 Service implementors usually do not need this routine.
81 .It Fn svcerr_systemerr
82 Called by a service dispatch routine when it detects a system
83 error not covered by any particular protocol.
84 For example, if a service can no longer allocate storage,
85 it may call this routine.
86 .It Fn svcerr_weakauth
87 Called by a service dispatch routine that refuses to perform
88 a remote procedure call due to insufficient (but correct)
89 authentication arguments.
91 .Fn svcerr_auth "xprt" "AUTH_TOOWEAK" .
96 .Xr rpc_svc_create 3 ,