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