1rpc_svc_err(3NSL)    Networking Services Library Functions   rpc_svc_err(3NSL)
2
3
4

NAME

6       rpc_svc_err,  svcerr_auth, svcerr_decode, svcerr_noproc, svcerr_noprog,
7       svcerr_progvers, svcerr_systemerr, svcerr_weakauth -  library  routines
8       for server side remote procedure call errors
9

DESCRIPTION

11       These routines are part of the RPC library which allows C language pro‐
12       grams to make procedure calls on other machines across the network.
13
14
15       These routines can be called by the server side  dispatch  function  if
16       there is any error in the transaction with the client.
17
18   Routines
19       See rpc(3NSL) for the definition of the SVCXPRT data structure.
20
21         #include <rpc/rpc.h>
22
23
24
25       void svcerr_auth(const SVCXPRT *xprt, const enum auth_stat why);
26
27           Called  by  a  service  dispatch  routine that refuses to perform a
28           remote procedure call due to an authentication error.
29
30
31       void svcerr_decode(const SVCXPRT *xprt);
32
33           Called by a  service  dispatch  routine  that  cannot  successfully
34           decode    the    remote    parameters    (see    svc_getargs()   in
35           rpc_svc_reg(3NSL)).
36
37
38       void svcerr_noproc(const SVCXPRT *xprt);
39
40           Called by a service dispatch routine that does  not  implement  the
41           procedure number that the caller requests.
42
43
44       void svcerr_noprog(const SVCXPRT *xprt);
45
46           Called  when  the  desired  program  is not registered with the RPC
47           package. Service implementors usually do not need this routine.
48
49
50       void svcerr_progvers(const SVCXPRT *xprt, const rpcvers_t low_vers,
51       const rpcvers_t high_vers);
52
53           Called when the desired version of a program is not registered with
54           the RPC  package.  low_vers  is  the  lowest  version  number,  and
55           high_vers  is the highest version number. Service implementors usu‐
56           ally do not need this routine.
57
58
59       void svcerr_systemerr(const SVCXPRT *xprt);
60
61           Called by a service dispatch routine when it detects a system error
62           not  covered  by any particular protocol. For example, if a service
63           can no longer allocate storage, it may call this routine.
64
65
66       void svcerr_weakauth(const SVCXPRT *xprt);
67
68           Called by a service dispatch routine  that  refuses  to  perform  a
69           remote procedure call due to insufficient (but correct) authentica‐
70           tion parameters. The routine calls svcerr_auth(xprt, AUTH_TOOWEAK).
71
72

ATTRIBUTES

74       See attributes(5) for descriptions of the following attributes:
75
76
77
78
79       ┌─────────────────────────────┬─────────────────────────────┐
80       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
81       ├─────────────────────────────┼─────────────────────────────┤
82       │MT-Level                     │MT-Safe                      │
83       └─────────────────────────────┴─────────────────────────────┘
84

SEE ALSO

86       rpc(3NSL),          rpc_svc_calls(3NSL),          rpc_svc_create(3NSL),
87       rpc_svc_reg(3NSL), attributes(5)
88
89
90
91SunOS 5.11                        20 Feb 1998                rpc_svc_err(3NSL)
Impressum