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