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