1 /*- 2 * Copyright (c) 2009-2012,2016 Microsoft Corp. 3 * Copyright (c) 2012 NetApp Inc. 4 * Copyright (c) 2012 Citrix Inc. 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice unmodified, this list of conditions, and the following 12 * disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 * 28 * $FreeBSD$ 29 */ 30 31 #ifndef _VMBUS_BRVAR_H_ 32 #define _VMBUS_BRVAR_H_ 33 34 #include <sys/param.h> 35 #include <sys/lock.h> 36 #include <sys/mutex.h> 37 #include <sys/_iovec.h> 38 39 struct vmbus_br { 40 struct vmbus_bufring *vbr; 41 uint32_t vbr_dsize; /* total data size */ 42 }; 43 44 #define vbr_windex vbr->br_windex 45 #define vbr_rindex vbr->br_rindex 46 #define vbr_imask vbr->br_imask 47 #define vbr_psndsz vbr->br_pending_snd_sz 48 #define vbr_fpsndsz vbr->br_feature_bits.feat_pending_snd_sz 49 #define vbr_fvalue vbr->br_feature_bits.value 50 #define vbr_intrcnt vbr->br_g2h_intr_cnt 51 #define vbr_data vbr->br_data 52 53 struct vmbus_rxbr { 54 struct mtx rxbr_lock; 55 struct vmbus_br rxbr; 56 }; 57 58 #define rxbr_windex rxbr.vbr_windex 59 #define rxbr_rindex rxbr.vbr_rindex 60 #define rxbr_imask rxbr.vbr_imask 61 #define rxbr_psndsz rxbr.vbr_psndsz 62 #define rxbr_fpsndsz rxbr.vbr_fpsndsz 63 #define rxbr_fvalue rxbr.vbr_fvalue 64 #define rxbr_intrcnt rxbr.vbr_intrcnt 65 #define rxbr_data rxbr.vbr_data 66 #define rxbr_dsize rxbr.vbr_dsize 67 68 struct vmbus_txbr { 69 struct mtx txbr_lock; 70 struct vmbus_br txbr; 71 }; 72 73 #define txbr_windex txbr.vbr_windex 74 #define txbr_rindex txbr.vbr_rindex 75 #define txbr_imask txbr.vbr_imask 76 #define txbr_psndsz txbr.vbr_psndsz 77 #define txbr_fpsndsz txbr.vbr_fpsndsz 78 #define txbr_fvalue txbr.vbr_fvalue 79 #define txbr_intrcnt txbr.vbr_intrcnt 80 #define txbr_data txbr.vbr_data 81 #define txbr_dsize txbr.vbr_dsize 82 83 struct sysctl_ctx_list; 84 struct sysctl_oid; 85 86 static __inline int 87 vmbus_txbr_maxpktsz(const struct vmbus_txbr *tbr) 88 { 89 90 /* 91 * - 64 bits for the trailing start index (- sizeof(uint64_t)). 92 * - The rindex and windex can't be same (- 1). See 93 * the comment near vmbus_bufring.br_{r,w}index. 94 */ 95 return (tbr->txbr_dsize - sizeof(uint64_t) - 1); 96 } 97 98 static __inline bool 99 vmbus_txbr_empty(const struct vmbus_txbr *tbr) 100 { 101 102 return (atomic_load_acq_32(&tbr->txbr_windex) == 103 atomic_load_acq_32(&tbr->txbr_rindex) ? true : false); 104 } 105 106 static __inline bool 107 vmbus_rxbr_empty(const struct vmbus_rxbr *rbr) 108 { 109 110 return (atomic_load_acq_32(&rbr->rxbr_windex) == 111 atomic_load_acq_32(&rbr->rxbr_rindex) ? true : false); 112 } 113 114 static __inline int 115 vmbus_br_nelem(int br_size, int elem_size) 116 { 117 118 /* Strip bufring header */ 119 br_size -= sizeof(struct vmbus_bufring); 120 /* Add per-element trailing index */ 121 elem_size += sizeof(uint64_t); 122 return (br_size / elem_size); 123 } 124 125 void vmbus_br_sysctl_create(struct sysctl_ctx_list *ctx, 126 struct sysctl_oid *br_tree, struct vmbus_br *br, 127 const char *name); 128 129 void vmbus_rxbr_init(struct vmbus_rxbr *rbr); 130 void vmbus_rxbr_deinit(struct vmbus_rxbr *rbr); 131 void vmbus_rxbr_setup(struct vmbus_rxbr *rbr, void *buf, int blen); 132 int vmbus_rxbr_peek(struct vmbus_rxbr *rbr, void *data, int dlen); 133 int vmbus_rxbr_read(struct vmbus_rxbr *rbr, void *data, int dlen, 134 uint32_t skip); 135 int vmbus_rxbr_idxadv(struct vmbus_rxbr *rbr, uint32_t idx_adv, 136 boolean_t *need_sig); 137 int vmbus_rxbr_idxadv_peek(struct vmbus_rxbr *rbr, void *data, 138 int dlen, uint32_t idx_adv, boolean_t *need_sig); 139 int vmbus_rxbr_peek_call(struct vmbus_rxbr *rbr, int dlen, 140 uint32_t skip, vmbus_br_copy_callback_t cb, void *cbarg); 141 void vmbus_rxbr_intr_mask(struct vmbus_rxbr *rbr); 142 uint32_t vmbus_rxbr_intr_unmask(struct vmbus_rxbr *rbr); 143 uint32_t vmbus_rxbr_available(const struct vmbus_rxbr *rbr); 144 145 void vmbus_txbr_init(struct vmbus_txbr *tbr); 146 void vmbus_txbr_deinit(struct vmbus_txbr *tbr); 147 void vmbus_txbr_setup(struct vmbus_txbr *tbr, void *buf, int blen); 148 int vmbus_txbr_write(struct vmbus_txbr *tbr, 149 const struct iovec iov[], int iovlen, boolean_t *need_sig); 150 int vmbus_txbr_write_call(struct vmbus_txbr *tbr, 151 const struct iovec iov[], int iovlen, 152 vmbus_br_copy_callback_t cb, void *cbarg, 153 boolean_t *need_sig); 154 uint32_t vmbus_txbr_available(const struct vmbus_txbr *tbr); 155 uint32_t vmbus_txbr_get_imask(const struct vmbus_txbr *tbr); 156 void vmbus_txbr_set_pending_snd_sz(struct vmbus_txbr *tbr, 157 uint32_t size); 158 159 #endif /* _VMBUS_BRVAR_H_ */ 160