1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License, Version 1.0 only 6 * (the "License"). You may not use this file except in compliance 7 * with the License. 8 * 9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10 * or http://www.opensolaris.org/os/licensing. 11 * See the License for the specific language governing permissions 12 * and limitations under the License. 13 * 14 * When distributing Covered Code, include this CDDL HEADER in each 15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16 * If applicable, add the following below this CDDL HEADER, with the 17 * fields enclosed by brackets "[]" replaced with your own identifying 18 * information: Portions Copyright [yyyy] [name of copyright owner] 19 * 20 * CDDL HEADER END 21 */ 22 /* 23 * Copyright 2004 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27 /* Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T */ 28 /* All Rights Reserved */ 29 30 /* 31 * Portions of this source code were derived from Berkeley 4.3 BSD 32 * under license from the Regents of the University of California. 33 */ 34 35 /* 36 * #if !defined(lint) && defined(SCCSIDS) 37 * static char sccsid[] = "@(#)xdr_refer.c 1.21 89/02/28 SMI"; 38 * #endif 39 */ 40 41 /* 42 * xdr_refer.c, Generic XDR routines impelmentation. 43 * 44 * These are the "non-trivial" xdr primitives used to serialize and de-serialize 45 * "pointers". See xdr.h for more info on the interface to xdr. 46 */ 47 48 #include <sys/param.h> 49 #include <sys/systm.h> 50 51 #include <rpc/types.h> 52 #include <rpc/xdr.h> 53 54 #define LASTUNSIGNED ((uint_t)0-1) 55 56 /* 57 * XDR an indirect pointer 58 * xdr_reference is for recursively translating a structure that is 59 * referenced by a pointer inside the structure that is currently being 60 * translated. pp references a pointer to storage. If *pp is null 61 * the necessary storage is allocated. 62 * size is the sizeof the referneced structure. 63 * proc is the routine to handle the referenced structure. 64 */ 65 bool_t 66 xdr_reference(XDR *xdrs, caddr_t *pp, uint_t size, const xdrproc_t proc) 67 { 68 caddr_t loc = *pp; 69 bool_t stat; 70 71 if (loc == NULL) { 72 switch (xdrs->x_op) { 73 case XDR_FREE: 74 return (TRUE); 75 76 case XDR_DECODE: 77 *pp = loc = (caddr_t)mem_alloc(size); 78 bzero(loc, size); 79 break; 80 81 case XDR_ENCODE: 82 break; 83 } 84 } 85 86 stat = (*proc)(xdrs, loc, LASTUNSIGNED); 87 88 if (xdrs->x_op == XDR_FREE) { 89 mem_free(loc, size); 90 *pp = NULL; 91 } 92 return (stat); 93 } 94 95 /* 96 * xdr_pointer(): 97 * 98 * XDR a pointer to a possibly recursive data structure. This 99 * differs with xdr_reference in that it can serialize/deserialiaze 100 * trees correctly. 101 * 102 * What's sent is actually a union: 103 * 104 * union object_pointer switch (boolean b) { 105 * case TRUE: object_data data; 106 * case FALSE: void nothing; 107 * } 108 * 109 * > objpp: Pointer to the pointer to the object. 110 * > obj_size: size of the object. 111 * > xdr_obj: routine to XDR an object. 112 * 113 */ 114 bool_t 115 xdr_pointer(XDR *xdrs, char **objpp, uint_t obj_size, const xdrproc_t xdr_obj) 116 { 117 bool_t more_data; 118 119 more_data = (*objpp != NULL); 120 if (!xdr_bool(xdrs, &more_data)) 121 return (FALSE); 122 if (!more_data) { 123 *objpp = NULL; 124 return (TRUE); 125 } 126 return (xdr_reference(xdrs, objpp, obj_size, xdr_obj)); 127 } 128