afsconfig-and-rcsid-all-around-20010705
[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 <afs/param.h>
30 #include <afsconfig.h>
31
32 RCSID("$Header$");
33
34 #ifndef NeXT
35
36 /*
37  * xdr_reference.c, Generic XDR routines impelmentation.
38  *
39  * Copyright (C) 1984, Sun Microsystems, Inc.
40  *
41  * These are the "non-trivial" xdr primitives used to serialize and de-serialize
42  * "pointers".  See xdr.h for more info on the interface to xdr.
43  */
44
45 #include "xdr.h"
46 #include <stdio.h>
47 #define LASTUNSIGNED    ((u_int)0-1)
48
49 #ifndef osi_alloc
50 char *osi_alloc();
51 #endif
52
53 /*
54  * XDR an indirect pointer
55  * xdr_reference is for recursively translating a structure that is
56  * referenced by a pointer inside the structure that is currently being
57  * translated.  pp references a pointer to storage. If *pp is null
58  * the  necessary storage is allocated.
59  * size is the sizeof the referneced structure.
60  * proc is the routine to handle the referenced structure.
61  */
62 bool_t
63 xdr_reference(xdrs, pp, size, proc)
64         register XDR *xdrs;
65         caddr_t *pp;            /* the pointer to work on */
66         u_int size;             /* size of the object pointed to */
67         xdrproc_t proc;         /* xdr routine to handle the object */
68 {
69         register caddr_t loc = *pp;
70         register bool_t stat;
71
72         if (loc == NULL)
73                 switch (xdrs->x_op) {
74                 case XDR_FREE:
75                         return (TRUE);
76
77                 case XDR_DECODE:
78                         *pp = loc = osi_alloc(size);
79                         if (loc == NULL) {
80                                 return (FALSE);
81                         }
82                         bzero(loc, (int)size);
83                         break;
84         }
85
86         stat = (*proc)(xdrs, loc, LASTUNSIGNED);
87
88         if (xdrs->x_op == XDR_FREE) {
89                 osi_free(loc, size);
90                 *pp = NULL;
91         }
92         return (stat);
93 }
94 #endif /* NeXT */