rpc_prot.c revision 1.18 1 1.18 christos /* $NetBSD: rpc_prot.c,v 1.18 2003/05/29 18:15:25 christos Exp $ */
2 1.2 cgd
3 1.1 cgd /*
4 1.1 cgd * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
5 1.1 cgd * unrestricted use provided that this legend is included on all tape
6 1.1 cgd * media and as a part of the software program in whole or part. Users
7 1.1 cgd * may copy or modify Sun RPC without charge, but are not authorized
8 1.1 cgd * to license or distribute it to anyone else except as part of a product or
9 1.1 cgd * program developed by the user.
10 1.1 cgd *
11 1.1 cgd * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
12 1.1 cgd * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
13 1.1 cgd * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
14 1.1 cgd *
15 1.1 cgd * Sun RPC is provided with no support and without any obligation on the
16 1.1 cgd * part of Sun Microsystems, Inc. to assist in its use, correction,
17 1.1 cgd * modification or enhancement.
18 1.1 cgd *
19 1.1 cgd * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
20 1.1 cgd * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
21 1.1 cgd * OR ANY PART THEREOF.
22 1.1 cgd *
23 1.1 cgd * In no event will Sun Microsystems, Inc. be liable for any lost revenue
24 1.1 cgd * or profits or other special, indirect and consequential damages, even if
25 1.1 cgd * Sun has been advised of the possibility of such damages.
26 1.1 cgd *
27 1.1 cgd * Sun Microsystems, Inc.
28 1.1 cgd * 2550 Garcia Avenue
29 1.1 cgd * Mountain View, California 94043
30 1.1 cgd */
31 1.1 cgd
32 1.4 christos #include <sys/cdefs.h>
33 1.1 cgd #if defined(LIBC_SCCS) && !defined(lint)
34 1.4 christos #if 0
35 1.4 christos static char *sccsid = "@(#)rpc_prot.c 1.36 87/08/11 Copyr 1984 Sun Micro";
36 1.4 christos static char *sccsid = "@(#)rpc_prot.c 2.3 88/08/07 4.0 RPCSRC";
37 1.4 christos #else
38 1.18 christos __RCSID("$NetBSD: rpc_prot.c,v 1.18 2003/05/29 18:15:25 christos Exp $");
39 1.4 christos #endif
40 1.1 cgd #endif
41 1.1 cgd
42 1.1 cgd /*
43 1.1 cgd * rpc_prot.c
44 1.1 cgd *
45 1.1 cgd * Copyright (C) 1984, Sun Microsystems, Inc.
46 1.1 cgd *
47 1.1 cgd * This set of routines implements the rpc message definition,
48 1.1 cgd * its serializer and some common rpc utility routines.
49 1.1 cgd * The routines are meant for various implementations of rpc -
50 1.1 cgd * they are NOT for the rpc client or rpc service implementations!
51 1.1 cgd * Because authentication stuff is easy and is part of rpc, the opaque
52 1.1 cgd * routines are also in this program.
53 1.1 cgd */
54 1.1 cgd
55 1.5 jtc #include "namespace.h"
56 1.8 lukem
57 1.1 cgd #include <sys/param.h>
58 1.8 lukem
59 1.13 lukem #include <assert.h>
60 1.13 lukem
61 1.5 jtc #include <rpc/rpc.h>
62 1.1 cgd
63 1.5 jtc #ifdef __weak_alias
64 1.15 mycroft __weak_alias(xdr_accepted_reply,_xdr_accepted_reply)
65 1.15 mycroft __weak_alias(xdr_callhdr,_xdr_callhdr)
66 1.15 mycroft __weak_alias(xdr_des_block,_xdr_des_block)
67 1.15 mycroft __weak_alias(xdr_opaque_auth,_xdr_opaque_auth)
68 1.15 mycroft __weak_alias(xdr_rejected_reply,_xdr_rejected_reply)
69 1.15 mycroft __weak_alias(xdr_replymsg,_xdr_replymsg)
70 1.5 jtc #endif
71 1.1 cgd
72 1.4 christos static void accepted __P((enum accept_stat, struct rpc_err *));
73 1.4 christos static void rejected __P((enum reject_stat, struct rpc_err *));
74 1.4 christos
75 1.1 cgd /* * * * * * * * * * * * * * XDR Authentication * * * * * * * * * * * */
76 1.1 cgd
77 1.1 cgd /*
78 1.1 cgd * XDR an opaque authentication struct
79 1.1 cgd * (see auth.h)
80 1.1 cgd */
81 1.1 cgd bool_t
82 1.1 cgd xdr_opaque_auth(xdrs, ap)
83 1.8 lukem XDR *xdrs;
84 1.8 lukem struct opaque_auth *ap;
85 1.1 cgd {
86 1.1 cgd
87 1.13 lukem _DIAGASSERT(xdrs != NULL);
88 1.13 lukem _DIAGASSERT(ap != NULL);
89 1.13 lukem
90 1.1 cgd if (xdr_enum(xdrs, &(ap->oa_flavor)))
91 1.1 cgd return (xdr_bytes(xdrs, &ap->oa_base,
92 1.1 cgd &ap->oa_length, MAX_AUTH_BYTES));
93 1.1 cgd return (FALSE);
94 1.1 cgd }
95 1.1 cgd
96 1.1 cgd /*
97 1.1 cgd * XDR a DES block
98 1.1 cgd */
99 1.1 cgd bool_t
100 1.1 cgd xdr_des_block(xdrs, blkp)
101 1.8 lukem XDR *xdrs;
102 1.8 lukem des_block *blkp;
103 1.1 cgd {
104 1.13 lukem
105 1.13 lukem _DIAGASSERT(xdrs != NULL);
106 1.13 lukem _DIAGASSERT(blkp != NULL);
107 1.13 lukem
108 1.10 christos return (xdr_opaque(xdrs, (caddr_t)(void *)blkp, sizeof(des_block)));
109 1.1 cgd }
110 1.1 cgd
111 1.1 cgd /* * * * * * * * * * * * * * XDR RPC MESSAGE * * * * * * * * * * * * * * * */
112 1.1 cgd
113 1.1 cgd /*
114 1.1 cgd * XDR the MSG_ACCEPTED part of a reply message union
115 1.1 cgd */
116 1.1 cgd bool_t
117 1.1 cgd xdr_accepted_reply(xdrs, ar)
118 1.8 lukem XDR *xdrs;
119 1.8 lukem struct accepted_reply *ar;
120 1.1 cgd {
121 1.1 cgd
122 1.13 lukem _DIAGASSERT(xdrs != NULL);
123 1.13 lukem _DIAGASSERT(ar != NULL);
124 1.13 lukem
125 1.1 cgd /* personalized union, rather than calling xdr_union */
126 1.1 cgd if (! xdr_opaque_auth(xdrs, &(ar->ar_verf)))
127 1.1 cgd return (FALSE);
128 1.18 christos if (! xdr_enum(xdrs, (enum_t *)(void *)&(ar->ar_stat)))
129 1.1 cgd return (FALSE);
130 1.1 cgd switch (ar->ar_stat) {
131 1.1 cgd
132 1.1 cgd case SUCCESS:
133 1.1 cgd return ((*(ar->ar_results.proc))(xdrs, ar->ar_results.where));
134 1.1 cgd
135 1.1 cgd case PROG_MISMATCH:
136 1.3 cgd if (! xdr_u_int32_t(xdrs, &(ar->ar_vers.low)))
137 1.1 cgd return (FALSE);
138 1.3 cgd return (xdr_u_int32_t(xdrs, &(ar->ar_vers.high)));
139 1.4 christos
140 1.4 christos case GARBAGE_ARGS:
141 1.4 christos case SYSTEM_ERR:
142 1.4 christos case PROC_UNAVAIL:
143 1.4 christos case PROG_UNAVAIL:
144 1.4 christos break;
145 1.1 cgd }
146 1.1 cgd return (TRUE); /* TRUE => open ended set of problems */
147 1.1 cgd }
148 1.1 cgd
149 1.1 cgd /*
150 1.1 cgd * XDR the MSG_DENIED part of a reply message union
151 1.1 cgd */
152 1.1 cgd bool_t
153 1.1 cgd xdr_rejected_reply(xdrs, rr)
154 1.8 lukem XDR *xdrs;
155 1.8 lukem struct rejected_reply *rr;
156 1.1 cgd {
157 1.1 cgd
158 1.13 lukem _DIAGASSERT(xdrs != NULL);
159 1.13 lukem _DIAGASSERT(rr != NULL);
160 1.13 lukem
161 1.1 cgd /* personalized union, rather than calling xdr_union */
162 1.18 christos if (! xdr_enum(xdrs, (enum_t *)(void *)&(rr->rj_stat)))
163 1.1 cgd return (FALSE);
164 1.1 cgd switch (rr->rj_stat) {
165 1.1 cgd
166 1.1 cgd case RPC_MISMATCH:
167 1.3 cgd if (! xdr_u_int32_t(xdrs, &(rr->rj_vers.low)))
168 1.1 cgd return (FALSE);
169 1.3 cgd return (xdr_u_int32_t(xdrs, &(rr->rj_vers.high)));
170 1.1 cgd
171 1.1 cgd case AUTH_ERROR:
172 1.18 christos return (xdr_enum(xdrs, (enum_t *)(void *)&(rr->rj_why)));
173 1.1 cgd }
174 1.10 christos /* NOTREACHED */
175 1.1 cgd return (FALSE);
176 1.1 cgd }
177 1.1 cgd
178 1.9 mycroft static const struct xdr_discrim reply_dscrm[3] = {
179 1.12 christos { (int)MSG_ACCEPTED, (xdrproc_t)xdr_accepted_reply },
180 1.12 christos { (int)MSG_DENIED, (xdrproc_t)xdr_rejected_reply },
181 1.1 cgd { __dontcare__, NULL_xdrproc_t } };
182 1.1 cgd
183 1.1 cgd /*
184 1.1 cgd * XDR a reply message
185 1.1 cgd */
186 1.1 cgd bool_t
187 1.1 cgd xdr_replymsg(xdrs, rmsg)
188 1.8 lukem XDR *xdrs;
189 1.8 lukem struct rpc_msg *rmsg;
190 1.1 cgd {
191 1.13 lukem _DIAGASSERT(xdrs != NULL);
192 1.13 lukem _DIAGASSERT(rmsg != NULL);
193 1.13 lukem
194 1.1 cgd if (
195 1.3 cgd xdr_u_int32_t(xdrs, &(rmsg->rm_xid)) &&
196 1.18 christos xdr_enum(xdrs, (enum_t *)(void *)&(rmsg->rm_direction)) &&
197 1.1 cgd (rmsg->rm_direction == REPLY) )
198 1.18 christos return (xdr_union(xdrs, (enum_t *)(void *)&(rmsg->rm_reply.rp_stat),
199 1.10 christos (caddr_t)(void *)&(rmsg->rm_reply.ru), reply_dscrm,
200 1.10 christos NULL_xdrproc_t));
201 1.1 cgd return (FALSE);
202 1.1 cgd }
203 1.1 cgd
204 1.1 cgd
205 1.1 cgd /*
206 1.1 cgd * Serializes the "static part" of a call message header.
207 1.1 cgd * The fields include: rm_xid, rm_direction, rpcvers, prog, and vers.
208 1.1 cgd * The rm_xid is not really static, but the user can easily munge on the fly.
209 1.1 cgd */
210 1.1 cgd bool_t
211 1.1 cgd xdr_callhdr(xdrs, cmsg)
212 1.8 lukem XDR *xdrs;
213 1.8 lukem struct rpc_msg *cmsg;
214 1.1 cgd {
215 1.1 cgd
216 1.13 lukem _DIAGASSERT(xdrs != NULL);
217 1.13 lukem _DIAGASSERT(cmsg != NULL);
218 1.13 lukem
219 1.1 cgd cmsg->rm_direction = CALL;
220 1.1 cgd cmsg->rm_call.cb_rpcvers = RPC_MSG_VERSION;
221 1.1 cgd if (
222 1.1 cgd (xdrs->x_op == XDR_ENCODE) &&
223 1.3 cgd xdr_u_int32_t(xdrs, &(cmsg->rm_xid)) &&
224 1.18 christos xdr_enum(xdrs, (enum_t *)(void *)&(cmsg->rm_direction)) &&
225 1.3 cgd xdr_u_int32_t(xdrs, &(cmsg->rm_call.cb_rpcvers)) &&
226 1.3 cgd xdr_u_int32_t(xdrs, &(cmsg->rm_call.cb_prog)) )
227 1.11 lukem return (xdr_u_int32_t(xdrs, &(cmsg->rm_call.cb_vers)));
228 1.1 cgd return (FALSE);
229 1.1 cgd }
230 1.1 cgd
231 1.1 cgd /* ************************** Client utility routine ************* */
232 1.1 cgd
233 1.1 cgd static void
234 1.1 cgd accepted(acpt_stat, error)
235 1.8 lukem enum accept_stat acpt_stat;
236 1.8 lukem struct rpc_err *error;
237 1.1 cgd {
238 1.1 cgd
239 1.13 lukem _DIAGASSERT(error != NULL);
240 1.13 lukem
241 1.1 cgd switch (acpt_stat) {
242 1.1 cgd
243 1.1 cgd case PROG_UNAVAIL:
244 1.1 cgd error->re_status = RPC_PROGUNAVAIL;
245 1.1 cgd return;
246 1.1 cgd
247 1.1 cgd case PROG_MISMATCH:
248 1.1 cgd error->re_status = RPC_PROGVERSMISMATCH;
249 1.1 cgd return;
250 1.1 cgd
251 1.1 cgd case PROC_UNAVAIL:
252 1.1 cgd error->re_status = RPC_PROCUNAVAIL;
253 1.1 cgd return;
254 1.1 cgd
255 1.1 cgd case GARBAGE_ARGS:
256 1.1 cgd error->re_status = RPC_CANTDECODEARGS;
257 1.1 cgd return;
258 1.1 cgd
259 1.1 cgd case SYSTEM_ERR:
260 1.1 cgd error->re_status = RPC_SYSTEMERROR;
261 1.1 cgd return;
262 1.1 cgd
263 1.1 cgd case SUCCESS:
264 1.1 cgd error->re_status = RPC_SUCCESS;
265 1.1 cgd return;
266 1.1 cgd }
267 1.10 christos /* NOTREACHED */
268 1.1 cgd /* something's wrong, but we don't know what ... */
269 1.1 cgd error->re_status = RPC_FAILED;
270 1.10 christos error->re_lb.s1 = (int32_t)MSG_ACCEPTED;
271 1.10 christos error->re_lb.s2 = (int32_t)acpt_stat;
272 1.1 cgd }
273 1.1 cgd
274 1.1 cgd static void
275 1.1 cgd rejected(rjct_stat, error)
276 1.8 lukem enum reject_stat rjct_stat;
277 1.8 lukem struct rpc_err *error;
278 1.1 cgd {
279 1.1 cgd
280 1.13 lukem _DIAGASSERT(error != NULL);
281 1.13 lukem
282 1.1 cgd switch (rjct_stat) {
283 1.4 christos case RPC_MISMATCH:
284 1.1 cgd error->re_status = RPC_VERSMISMATCH;
285 1.1 cgd return;
286 1.1 cgd
287 1.1 cgd case AUTH_ERROR:
288 1.1 cgd error->re_status = RPC_AUTHERROR;
289 1.1 cgd return;
290 1.1 cgd }
291 1.1 cgd /* something's wrong, but we don't know what ... */
292 1.10 christos /* NOTREACHED */
293 1.1 cgd error->re_status = RPC_FAILED;
294 1.10 christos error->re_lb.s1 = (int32_t)MSG_DENIED;
295 1.10 christos error->re_lb.s2 = (int32_t)rjct_stat;
296 1.1 cgd }
297 1.1 cgd
298 1.1 cgd /*
299 1.1 cgd * given a reply message, fills in the error
300 1.1 cgd */
301 1.1 cgd void
302 1.1 cgd _seterr_reply(msg, error)
303 1.8 lukem struct rpc_msg *msg;
304 1.8 lukem struct rpc_err *error;
305 1.1 cgd {
306 1.13 lukem
307 1.13 lukem _DIAGASSERT(msg != NULL);
308 1.13 lukem _DIAGASSERT(error != NULL);
309 1.1 cgd
310 1.1 cgd /* optimized for normal, SUCCESSful case */
311 1.1 cgd switch (msg->rm_reply.rp_stat) {
312 1.1 cgd
313 1.1 cgd case MSG_ACCEPTED:
314 1.1 cgd if (msg->acpted_rply.ar_stat == SUCCESS) {
315 1.1 cgd error->re_status = RPC_SUCCESS;
316 1.1 cgd return;
317 1.11 lukem }
318 1.1 cgd accepted(msg->acpted_rply.ar_stat, error);
319 1.1 cgd break;
320 1.1 cgd
321 1.1 cgd case MSG_DENIED:
322 1.1 cgd rejected(msg->rjcted_rply.rj_stat, error);
323 1.1 cgd break;
324 1.1 cgd
325 1.1 cgd default:
326 1.1 cgd error->re_status = RPC_FAILED;
327 1.10 christos error->re_lb.s1 = (int32_t)(msg->rm_reply.rp_stat);
328 1.1 cgd break;
329 1.1 cgd }
330 1.1 cgd switch (error->re_status) {
331 1.1 cgd
332 1.1 cgd case RPC_VERSMISMATCH:
333 1.1 cgd error->re_vers.low = msg->rjcted_rply.rj_vers.low;
334 1.1 cgd error->re_vers.high = msg->rjcted_rply.rj_vers.high;
335 1.1 cgd break;
336 1.1 cgd
337 1.1 cgd case RPC_AUTHERROR:
338 1.1 cgd error->re_why = msg->rjcted_rply.rj_why;
339 1.1 cgd break;
340 1.1 cgd
341 1.1 cgd case RPC_PROGVERSMISMATCH:
342 1.1 cgd error->re_vers.low = msg->acpted_rply.ar_vers.low;
343 1.1 cgd error->re_vers.high = msg->acpted_rply.ar_vers.high;
344 1.4 christos break;
345 1.4 christos
346 1.4 christos case RPC_FAILED:
347 1.4 christos case RPC_SUCCESS:
348 1.4 christos case RPC_PROGNOTREGISTERED:
349 1.4 christos case RPC_PMAPFAILURE:
350 1.4 christos case RPC_UNKNOWNPROTO:
351 1.4 christos case RPC_UNKNOWNHOST:
352 1.4 christos case RPC_SYSTEMERROR:
353 1.4 christos case RPC_CANTDECODEARGS:
354 1.4 christos case RPC_PROCUNAVAIL:
355 1.4 christos case RPC_PROGUNAVAIL:
356 1.4 christos case RPC_TIMEDOUT:
357 1.4 christos case RPC_CANTRECV:
358 1.4 christos case RPC_CANTSEND:
359 1.4 christos case RPC_CANTDECODERES:
360 1.4 christos case RPC_CANTENCODEARGS:
361 1.16 fvdl default:
362 1.1 cgd break;
363 1.1 cgd }
364 1.1 cgd }
365