1/* 2 * Copyright (c) 2010 Apple Inc. All rights reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 3. Neither the name of Apple Inc. ("Apple") nor the names of its 16 * contributors may be used to endorse or promote products derived from 17 * this software without specific prior written permission. 18 * 19 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY 20 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 21 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 22 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY 23 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 24 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 25 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 26 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 28 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 * 30 * Portions of this software have been released under the following terms: 31 * 32 * (c) Copyright 1989-1993 OPEN SOFTWARE FOUNDATION, INC. 33 * (c) Copyright 1989-1993 HEWLETT-PACKARD COMPANY 34 * (c) Copyright 1989-1993 DIGITAL EQUIPMENT CORPORATION 35 * 36 * To anyone who acknowledges that this file is provided "AS IS" 37 * without any express or implied warranty: 38 * permission to use, copy, modify, and distribute this file for any 39 * purpose is hereby granted without fee, provided that the above 40 * copyright notices and this notice appears in all source code copies, 41 * and that none of the names of Open Software Foundation, Inc., Hewlett- 42 * Packard Company or Digital Equipment Corporation be used 43 * in advertising or publicity pertaining to distribution of the software 44 * without specific, written prior permission. Neither Open Software 45 * Foundation, Inc., Hewlett-Packard Company nor Digital 46 * Equipment Corporation makes any representations about the suitability 47 * of this software for any purpose. 48 * 49 * Copyright (c) 2007, Novell, Inc. All rights reserved. 50 * Redistribution and use in source and binary forms, with or without 51 * modification, are permitted provided that the following conditions 52 * are met: 53 * 54 * 1. Redistributions of source code must retain the above copyright 55 * notice, this list of conditions and the following disclaimer. 56 * 2. Redistributions in binary form must reproduce the above copyright 57 * notice, this list of conditions and the following disclaimer in the 58 * documentation and/or other materials provided with the distribution. 59 * 3. Neither the name of Novell Inc. nor the names of its contributors 60 * may be used to endorse or promote products derived from this 61 * this software without specific prior written permission. 62 * 63 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY 64 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 65 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 66 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY 67 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 68 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 69 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 70 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 71 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 72 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 73 * 74 * @APPLE_LICENSE_HEADER_END@ 75 */ 76 77/* 78** 79** NAME: 80** 81** dgrq.h 82** 83** FACILITY: 84** 85** Remote Procedure Call (RPC) 86** 87** ABSTRACT: 88** 89** DG protocol service routines 90** 91** 92*/ 93 94#ifndef _DGRQ_H 95#define _DGRQ_H 96 97/* 98 * R P C _ D G _ R E C V Q _ E L T _ F R O M _ I O V E C T O R _ E L T 99 * 100 * Given an IO vector element, return the associated receive queue element. 101 * This macro is used by internal callers of the "comm_receive/transceive" 102 * path so that can get back a receieve queue element and look at the 103 * header. This macro depends on how "comm_receive" works. 104 */ 105 106#define RPC_DG_RECVQ_ELT_FROM_IOVECTOR_ELT(iove) \ 107 ((rpc_dg_recvq_elt_p_t) (iove)->buff_addr) 108 109/* 110 * R P C _ D G _ R E C V Q _ R E I N I T 111 * 112 * Reinitialize a receive queue. 113 */ 114 115#define RPC_DG_RECVQ_REINIT(rq) { \ 116 if ((rq)->head != NULL) rpc__dg_recvq_free(rq); \ 117 rpc__dg_recvq_init(rq); /* !!! Maybe be smarter later -- this may be losing "history" */ \ 118} 119 120/* 121 * R P C _ D G _ R E C V Q _ I O V E C T O R _ S E T U P 122 * 123 * Setup the return iovector element. 124 * 125 * NOTE WELL that other logic depends on the fact that the "buff_addr" 126 * field of iovector elements points to an "rpc_dg_recvq_elt_t" (rqe). 127 * See comments by RPC_DG_RECVQ_ELT_FROM_IOVECTOR_ELT. 128 */ 129 130#define RPC_DG_RECVQ_IOVECTOR_SETUP(data, rqe) { \ 131 (data)->buff_dealloc = (rpc_buff_dealloc_fn_t) rpc__dg_pkt_free_rqe_for_stub; \ 132 (data)->buff_addr = (byte_p_t) (rqe); \ 133 (data)->buff_len = sizeof *(rqe); \ 134 (data)->data_addr = (byte_p_t) &(rqe)->pkt->body; \ 135 (data)->data_len = ((rqe)->hdrp != NULL) ? \ 136 MIN((rqe)->hdrp->len, \ 137 (rqe)->pkt_len - RPC_C_DG_RAW_PKT_HDR_SIZE) : \ 138 (rqe)->pkt_len; \ 139} 140 141PRIVATE void rpc__dg_recvq_init ( rpc_dg_recvq_p_t /*rq*/); 142 143PRIVATE void rpc__dg_recvq_free ( rpc_dg_recvq_p_t /*rq*/); 144 145#endif /* _DGRQ_H */ 146