3 * Copyright (c) 2009, Microsoft Corporation.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 * You should have received a copy of the GNU General Public License along with
15 * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
16 * Place - Suite 330, Boston, MA 02111-1307 USA.
19 * Haiyang Zhang <haiyangz@microsoft.com>
20 * Hank Janssen <hjanssen@microsoft.com>
25 #ifndef _RING_BUFFER_H_
26 #define _RING_BUFFER_H_
28 #include <linux/scatterlist.h>
30 struct hv_ring_buffer {
31 /* Offset in bytes from the start of ring data below */
32 volatile u32 WriteIndex;
34 /* Offset in bytes from the start of ring data below */
35 volatile u32 ReadIndex;
37 volatile u32 InterruptMask;
39 /* Pad it to PAGE_SIZE so that data starts on page boundary */
43 * The InterruptMask field is used only for channels but since our
44 * vmbus connection also uses this data structure and its data starts
45 * here, we commented out this field.
47 /* volatile u32 InterruptMask; */
50 * Ring data starts here + RingDataStartOffset
51 * !!! DO NOT place any fields below this !!!
54 } __attribute__((packed));
56 struct hv_ring_buffer_info {
57 struct hv_ring_buffer *RingBuffer;
58 u32 RingSize; /* Include the shared header */
61 u32 RingDataSize; /* < ringSize */
62 u32 RingDataStartOffset;
65 struct hv_ring_buffer_debug_info {
66 u32 CurrentInterruptMask;
68 u32 CurrentWriteIndex;
70 u32 BytesAvailToWrite;
78 int RingBufferInit(struct hv_ring_buffer_info *RingInfo, void *Buffer,
81 void RingBufferCleanup(struct hv_ring_buffer_info *RingInfo);
83 int RingBufferWrite(struct hv_ring_buffer_info *RingInfo,
84 struct scatterlist *sglist,
87 int RingBufferPeek(struct hv_ring_buffer_info *RingInfo, void *Buffer,
90 int RingBufferRead(struct hv_ring_buffer_info *RingInfo,
95 u32 GetRingBufferInterruptMask(struct hv_ring_buffer_info *RingInfo);
97 void DumpRingInfo(struct hv_ring_buffer_info *RingInfo, char *Prefix);
99 void RingBufferGetDebugInfo(struct hv_ring_buffer_info *RingInfo,
100 struct hv_ring_buffer_debug_info *debug_info);
102 #endif /* _RING_BUFFER_H_ */