Home | History | Annotate | Line # | Download | only in rpc
rpc_prot.c revision 1.8
      1  1.8     lukem /*	$NetBSD: rpc_prot.c,v 1.8 1998/02/13 05:52:32 lukem 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.8     lukem __RCSID("$NetBSD: rpc_prot.c,v 1.8 1998/02/13 05:52:32 lukem 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.5       jtc #include <rpc/rpc.h>
     60  1.1       cgd 
     61  1.5       jtc #ifdef __weak_alias
     62  1.5       jtc __weak_alias(xdr_accepted_reply,_xdr_accepted_reply);
     63  1.5       jtc __weak_alias(xdr_callhdr,_xdr_callhdr);
     64  1.5       jtc __weak_alias(xdr_des_block,_xdr_des_block);
     65  1.5       jtc __weak_alias(xdr_opaque_auth,_xdr_opaque_auth);
     66  1.5       jtc __weak_alias(xdr_rejected_reply,_xdr_rejected_reply);
     67  1.5       jtc __weak_alias(xdr_replymsg,_xdr_replymsg);
     68  1.5       jtc #endif
     69  1.1       cgd 
     70  1.4  christos static void accepted __P((enum accept_stat, struct rpc_err *));
     71  1.4  christos static void rejected __P((enum reject_stat, struct rpc_err *));
     72  1.4  christos 
     73  1.1       cgd /* * * * * * * * * * * * * * XDR Authentication * * * * * * * * * * * */
     74  1.1       cgd 
     75  1.1       cgd struct opaque_auth _null_auth;
     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.1       cgd 	if (xdr_enum(xdrs, &(ap->oa_flavor)))
     88  1.1       cgd 		return (xdr_bytes(xdrs, &ap->oa_base,
     89  1.1       cgd 			&ap->oa_length, MAX_AUTH_BYTES));
     90  1.1       cgd 	return (FALSE);
     91  1.1       cgd }
     92  1.1       cgd 
     93  1.1       cgd /*
     94  1.1       cgd  * XDR a DES block
     95  1.1       cgd  */
     96  1.1       cgd bool_t
     97  1.1       cgd xdr_des_block(xdrs, blkp)
     98  1.8     lukem 	XDR *xdrs;
     99  1.8     lukem 	des_block *blkp;
    100  1.1       cgd {
    101  1.1       cgd 	return (xdr_opaque(xdrs, (caddr_t)blkp, sizeof(des_block)));
    102  1.1       cgd }
    103  1.1       cgd 
    104  1.1       cgd /* * * * * * * * * * * * * * XDR RPC MESSAGE * * * * * * * * * * * * * * * */
    105  1.1       cgd 
    106  1.1       cgd /*
    107  1.1       cgd  * XDR the MSG_ACCEPTED part of a reply message union
    108  1.1       cgd  */
    109  1.1       cgd bool_t
    110  1.1       cgd xdr_accepted_reply(xdrs, ar)
    111  1.8     lukem 	XDR *xdrs;
    112  1.8     lukem 	struct accepted_reply *ar;
    113  1.1       cgd {
    114  1.1       cgd 
    115  1.1       cgd 	/* personalized union, rather than calling xdr_union */
    116  1.1       cgd 	if (! xdr_opaque_auth(xdrs, &(ar->ar_verf)))
    117  1.1       cgd 		return (FALSE);
    118  1.1       cgd 	if (! xdr_enum(xdrs, (enum_t *)&(ar->ar_stat)))
    119  1.1       cgd 		return (FALSE);
    120  1.1       cgd 	switch (ar->ar_stat) {
    121  1.1       cgd 
    122  1.1       cgd 	case SUCCESS:
    123  1.1       cgd 		return ((*(ar->ar_results.proc))(xdrs, ar->ar_results.where));
    124  1.1       cgd 
    125  1.1       cgd 	case PROG_MISMATCH:
    126  1.3       cgd 		if (! xdr_u_int32_t(xdrs, &(ar->ar_vers.low)))
    127  1.1       cgd 			return (FALSE);
    128  1.3       cgd 		return (xdr_u_int32_t(xdrs, &(ar->ar_vers.high)));
    129  1.4  christos 
    130  1.4  christos 	case GARBAGE_ARGS:
    131  1.4  christos 	case SYSTEM_ERR:
    132  1.4  christos 	case PROC_UNAVAIL:
    133  1.4  christos 	case PROG_UNAVAIL:
    134  1.4  christos 		break;
    135  1.1       cgd 	}
    136  1.1       cgd 	return (TRUE);  /* TRUE => open ended set of problems */
    137  1.1       cgd }
    138  1.1       cgd 
    139  1.1       cgd /*
    140  1.1       cgd  * XDR the MSG_DENIED part of a reply message union
    141  1.1       cgd  */
    142  1.1       cgd bool_t
    143  1.1       cgd xdr_rejected_reply(xdrs, rr)
    144  1.8     lukem 	XDR *xdrs;
    145  1.8     lukem 	struct rejected_reply *rr;
    146  1.1       cgd {
    147  1.1       cgd 
    148  1.1       cgd 	/* personalized union, rather than calling xdr_union */
    149  1.1       cgd 	if (! xdr_enum(xdrs, (enum_t *)&(rr->rj_stat)))
    150  1.1       cgd 		return (FALSE);
    151  1.1       cgd 	switch (rr->rj_stat) {
    152  1.1       cgd 
    153  1.1       cgd 	case RPC_MISMATCH:
    154  1.3       cgd 		if (! xdr_u_int32_t(xdrs, &(rr->rj_vers.low)))
    155  1.1       cgd 			return (FALSE);
    156  1.3       cgd 		return (xdr_u_int32_t(xdrs, &(rr->rj_vers.high)));
    157  1.1       cgd 
    158  1.1       cgd 	case AUTH_ERROR:
    159  1.1       cgd 		return (xdr_enum(xdrs, (enum_t *)&(rr->rj_why)));
    160  1.1       cgd 	}
    161  1.1       cgd 	return (FALSE);
    162  1.1       cgd }
    163  1.1       cgd 
    164  1.1       cgd static struct xdr_discrim reply_dscrm[3] = {
    165  1.1       cgd 	{ (int)MSG_ACCEPTED, xdr_accepted_reply },
    166  1.1       cgd 	{ (int)MSG_DENIED, xdr_rejected_reply },
    167  1.1       cgd 	{ __dontcare__, NULL_xdrproc_t } };
    168  1.1       cgd 
    169  1.1       cgd /*
    170  1.1       cgd  * XDR a reply message
    171  1.1       cgd  */
    172  1.1       cgd bool_t
    173  1.1       cgd xdr_replymsg(xdrs, rmsg)
    174  1.8     lukem 	XDR *xdrs;
    175  1.8     lukem 	struct rpc_msg *rmsg;
    176  1.1       cgd {
    177  1.1       cgd 	if (
    178  1.3       cgd 	    xdr_u_int32_t(xdrs, &(rmsg->rm_xid)) &&
    179  1.1       cgd 	    xdr_enum(xdrs, (enum_t *)&(rmsg->rm_direction)) &&
    180  1.1       cgd 	    (rmsg->rm_direction == REPLY) )
    181  1.1       cgd 		return (xdr_union(xdrs, (enum_t *)&(rmsg->rm_reply.rp_stat),
    182  1.1       cgd 		   (caddr_t)&(rmsg->rm_reply.ru), reply_dscrm, NULL_xdrproc_t));
    183  1.1       cgd 	return (FALSE);
    184  1.1       cgd }
    185  1.1       cgd 
    186  1.1       cgd 
    187  1.1       cgd /*
    188  1.1       cgd  * Serializes the "static part" of a call message header.
    189  1.1       cgd  * The fields include: rm_xid, rm_direction, rpcvers, prog, and vers.
    190  1.1       cgd  * The rm_xid is not really static, but the user can easily munge on the fly.
    191  1.1       cgd  */
    192  1.1       cgd bool_t
    193  1.1       cgd xdr_callhdr(xdrs, cmsg)
    194  1.8     lukem 	XDR *xdrs;
    195  1.8     lukem 	struct rpc_msg *cmsg;
    196  1.1       cgd {
    197  1.1       cgd 
    198  1.1       cgd 	cmsg->rm_direction = CALL;
    199  1.1       cgd 	cmsg->rm_call.cb_rpcvers = RPC_MSG_VERSION;
    200  1.1       cgd 	if (
    201  1.1       cgd 	    (xdrs->x_op == XDR_ENCODE) &&
    202  1.3       cgd 	    xdr_u_int32_t(xdrs, &(cmsg->rm_xid)) &&
    203  1.1       cgd 	    xdr_enum(xdrs, (enum_t *)&(cmsg->rm_direction)) &&
    204  1.3       cgd 	    xdr_u_int32_t(xdrs, &(cmsg->rm_call.cb_rpcvers)) &&
    205  1.3       cgd 	    xdr_u_int32_t(xdrs, &(cmsg->rm_call.cb_prog)) )
    206  1.3       cgd 	    return (xdr_u_int32_t(xdrs, &(cmsg->rm_call.cb_vers)));
    207  1.1       cgd 	return (FALSE);
    208  1.1       cgd }
    209  1.1       cgd 
    210  1.1       cgd /* ************************** Client utility routine ************* */
    211  1.1       cgd 
    212  1.1       cgd static void
    213  1.1       cgd accepted(acpt_stat, error)
    214  1.8     lukem 	enum accept_stat acpt_stat;
    215  1.8     lukem 	struct rpc_err *error;
    216  1.1       cgd {
    217  1.1       cgd 
    218  1.1       cgd 	switch (acpt_stat) {
    219  1.1       cgd 
    220  1.1       cgd 	case PROG_UNAVAIL:
    221  1.1       cgd 		error->re_status = RPC_PROGUNAVAIL;
    222  1.1       cgd 		return;
    223  1.1       cgd 
    224  1.1       cgd 	case PROG_MISMATCH:
    225  1.1       cgd 		error->re_status = RPC_PROGVERSMISMATCH;
    226  1.1       cgd 		return;
    227  1.1       cgd 
    228  1.1       cgd 	case PROC_UNAVAIL:
    229  1.1       cgd 		error->re_status = RPC_PROCUNAVAIL;
    230  1.1       cgd 		return;
    231  1.1       cgd 
    232  1.1       cgd 	case GARBAGE_ARGS:
    233  1.1       cgd 		error->re_status = RPC_CANTDECODEARGS;
    234  1.1       cgd 		return;
    235  1.1       cgd 
    236  1.1       cgd 	case SYSTEM_ERR:
    237  1.1       cgd 		error->re_status = RPC_SYSTEMERROR;
    238  1.1       cgd 		return;
    239  1.1       cgd 
    240  1.1       cgd 	case SUCCESS:
    241  1.1       cgd 		error->re_status = RPC_SUCCESS;
    242  1.1       cgd 		return;
    243  1.1       cgd 	}
    244  1.1       cgd 	/* something's wrong, but we don't know what ... */
    245  1.1       cgd 	error->re_status = RPC_FAILED;
    246  1.7     lukem 	error->re_lb.s1 = (long)MSG_ACCEPTED;
    247  1.7     lukem 	error->re_lb.s2 = (long)acpt_stat;
    248  1.1       cgd }
    249  1.1       cgd 
    250  1.1       cgd static void
    251  1.1       cgd rejected(rjct_stat, error)
    252  1.8     lukem 	enum reject_stat rjct_stat;
    253  1.8     lukem 	struct rpc_err *error;
    254  1.1       cgd {
    255  1.1       cgd 
    256  1.1       cgd 	switch (rjct_stat) {
    257  1.4  christos 	case RPC_MISMATCH:
    258  1.1       cgd 		error->re_status = RPC_VERSMISMATCH;
    259  1.1       cgd 		return;
    260  1.1       cgd 
    261  1.1       cgd 	case AUTH_ERROR:
    262  1.1       cgd 		error->re_status = RPC_AUTHERROR;
    263  1.1       cgd 		return;
    264  1.1       cgd 	}
    265  1.1       cgd 	/* something's wrong, but we don't know what ... */
    266  1.1       cgd 	error->re_status = RPC_FAILED;
    267  1.7     lukem 	error->re_lb.s1 = (long)MSG_DENIED;
    268  1.7     lukem 	error->re_lb.s2 = (long)rjct_stat;
    269  1.1       cgd }
    270  1.1       cgd 
    271  1.1       cgd /*
    272  1.1       cgd  * given a reply message, fills in the error
    273  1.1       cgd  */
    274  1.1       cgd void
    275  1.1       cgd _seterr_reply(msg, error)
    276  1.8     lukem 	struct rpc_msg *msg;
    277  1.8     lukem 	struct rpc_err *error;
    278  1.1       cgd {
    279  1.1       cgd 
    280  1.1       cgd 	/* optimized for normal, SUCCESSful case */
    281  1.1       cgd 	switch (msg->rm_reply.rp_stat) {
    282  1.1       cgd 
    283  1.1       cgd 	case MSG_ACCEPTED:
    284  1.1       cgd 		if (msg->acpted_rply.ar_stat == SUCCESS) {
    285  1.1       cgd 			error->re_status = RPC_SUCCESS;
    286  1.1       cgd 			return;
    287  1.1       cgd 		};
    288  1.1       cgd 		accepted(msg->acpted_rply.ar_stat, error);
    289  1.1       cgd 		break;
    290  1.1       cgd 
    291  1.1       cgd 	case MSG_DENIED:
    292  1.1       cgd 		rejected(msg->rjcted_rply.rj_stat, error);
    293  1.1       cgd 		break;
    294  1.1       cgd 
    295  1.1       cgd 	default:
    296  1.1       cgd 		error->re_status = RPC_FAILED;
    297  1.7     lukem 		error->re_lb.s1 = (long)(msg->rm_reply.rp_stat);
    298  1.1       cgd 		break;
    299  1.1       cgd 	}
    300  1.1       cgd 	switch (error->re_status) {
    301  1.1       cgd 
    302  1.1       cgd 	case RPC_VERSMISMATCH:
    303  1.1       cgd 		error->re_vers.low = msg->rjcted_rply.rj_vers.low;
    304  1.1       cgd 		error->re_vers.high = msg->rjcted_rply.rj_vers.high;
    305  1.1       cgd 		break;
    306  1.1       cgd 
    307  1.1       cgd 	case RPC_AUTHERROR:
    308  1.1       cgd 		error->re_why = msg->rjcted_rply.rj_why;
    309  1.1       cgd 		break;
    310  1.1       cgd 
    311  1.1       cgd 	case RPC_PROGVERSMISMATCH:
    312  1.1       cgd 		error->re_vers.low = msg->acpted_rply.ar_vers.low;
    313  1.1       cgd 		error->re_vers.high = msg->acpted_rply.ar_vers.high;
    314  1.4  christos 		break;
    315  1.4  christos 
    316  1.4  christos 	case RPC_FAILED:
    317  1.4  christos 	case RPC_SUCCESS:
    318  1.4  christos 	case RPC_PROGNOTREGISTERED:
    319  1.4  christos 	case RPC_PMAPFAILURE:
    320  1.4  christos 	case RPC_UNKNOWNPROTO:
    321  1.4  christos 	case RPC_UNKNOWNHOST:
    322  1.4  christos 	case RPC_SYSTEMERROR:
    323  1.4  christos 	case RPC_CANTDECODEARGS:
    324  1.4  christos 	case RPC_PROCUNAVAIL:
    325  1.4  christos 	case RPC_PROGUNAVAIL:
    326  1.4  christos 	case RPC_TIMEDOUT:
    327  1.4  christos 	case RPC_CANTRECV:
    328  1.4  christos 	case RPC_CANTSEND:
    329  1.4  christos 	case RPC_CANTDECODERES:
    330  1.4  christos 	case RPC_CANTENCODEARGS:
    331  1.1       cgd 		break;
    332  1.1       cgd 	}
    333  1.1       cgd }
    334