solaris10-20040624
[openafs.git] / src / rx / xdr_refernce.c
1 /*
2  * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
3  * unrestricted use provided that this legend is included on all tape
4  * media and as a part of the software program in whole or part.  Users
5  * may copy or modify Sun RPC without charge, but are not authorized
6  * to license or distribute it to anyone else except as part of a product or
7  * program developed by the user.
8  * 
9  * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
10  * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
11  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
12  * 
13  * Sun RPC is provided with no support and without any obligation on the
14  * part of Sun Microsystems, Inc. to assist in its use, correction,
15  * modification or enhancement.
16  * 
17  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
18  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
19  * OR ANY PART THEREOF.
20  * 
21  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
22  * or profits or other special, indirect and consequential damages, even if
23  * Sun has been advised of the possibility of such damages.
24  * 
25  * Sun Microsystems, Inc.
26  * 2550 Garcia Avenue
27  * Mountain View, California  94043
28  */
29 #include <afsconfig.h>
30 #include <afs/param.h>
31
32 RCSID
33     ("$Header$");
34
35 #ifndef NeXT
36
37 /*
38  * xdr_reference.c, Generic XDR routines impelmentation.
39  *
40  * Copyright (C) 1984, Sun Microsystems, Inc.
41  *
42  * These are the "non-trivial" xdr primitives used to serialize and de-serialize
43  * "pointers".  See xdr.h for more info on the interface to xdr.
44  */
45
46 #include "xdr.h"
47 #include <stdio.h>
48 #define LASTUNSIGNED    ((u_int)0-1)
49
50 /*
51  * XDR an indirect pointer
52  * xdr_reference is for recursively translating a structure that is
53  * referenced by a pointer inside the structure that is currently being
54  * translated.  pp references a pointer to storage. If *pp is null
55  * the  necessary storage is allocated.
56  * size is the sizeof the referneced structure.
57  * proc is the routine to handle the referenced structure.
58  */
59 bool_t
60 xdr_reference(xdrs, pp, size, proc)
61      register XDR *xdrs;
62      caddr_t *pp;               /* the pointer to work on */
63      u_int size;                /* size of the object pointed to */
64      xdrproc_t proc;            /* xdr routine to handle the object */
65 {
66     register caddr_t loc = *pp;
67     register bool_t stat;
68
69     if (loc == NULL)
70         switch (xdrs->x_op) {
71         case XDR_FREE:
72             return (TRUE);
73
74         case XDR_DECODE:
75             *pp = loc = osi_alloc(size);
76             if (loc == NULL) {
77                 return (FALSE);
78             }
79             memset(loc, 0, (int)size);
80             break;
81         }
82
83     stat = (*proc) (xdrs, loc, LASTUNSIGNED);
84
85     if (xdrs->x_op == XDR_FREE) {
86         osi_free(loc, size);
87         *pp = NULL;
88     }
89     return (stat);
90 }
91 #endif /* NeXT */