]>
Commit | Line | Data |
---|---|---|
3e7ee490 HJ |
1 | /* |
2 | * | |
3 | * Copyright (c) 2009, Microsoft Corporation. | |
4 | * | |
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. | |
8 | * | |
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 | |
12 | * more details. | |
13 | * | |
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. | |
17 | * | |
18 | * Authors: | |
19 | * Haiyang Zhang <haiyangz@microsoft.com> | |
20 | * Hank Janssen <hjanssen@microsoft.com> | |
b2a5a585 | 21 | * K. Y. Srinivasan <kys@microsoft.com> |
3e7ee490 HJ |
22 | * |
23 | */ | |
0a46618d | 24 | #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt |
3e7ee490 | 25 | |
a0086dc5 GKH |
26 | #include <linux/kernel.h> |
27 | #include <linux/mm.h> | |
46a97191 | 28 | #include <linux/hyperv.h> |
011a7c3c | 29 | #include <linux/uio.h> |
3f335ea2 | 30 | |
0f2a6619 | 31 | #include "hyperv_vmbus.h" |
3e7ee490 | 32 | |
6fdf3b21 S |
33 | void hv_begin_read(struct hv_ring_buffer_info *rbi) |
34 | { | |
35 | rbi->ring_buffer->interrupt_mask = 1; | |
dcd0eeca | 36 | virt_mb(); |
6fdf3b21 S |
37 | } |
38 | ||
39 | u32 hv_end_read(struct hv_ring_buffer_info *rbi) | |
40 | { | |
6fdf3b21 S |
41 | |
42 | rbi->ring_buffer->interrupt_mask = 0; | |
dcd0eeca | 43 | virt_mb(); |
6fdf3b21 S |
44 | |
45 | /* | |
46 | * Now check to see if the ring buffer is still empty. | |
47 | * If it is not, we raced and we need to process new | |
48 | * incoming messages. | |
49 | */ | |
a6341f00 | 50 | return hv_get_bytes_to_read(rbi); |
6fdf3b21 S |
51 | } |
52 | ||
98fa8cf4 S |
53 | /* |
54 | * When we write to the ring buffer, check if the host needs to | |
55 | * be signaled. Here is the details of this protocol: | |
56 | * | |
57 | * 1. The host guarantees that while it is draining the | |
58 | * ring buffer, it will set the interrupt_mask to | |
59 | * indicate it does not need to be interrupted when | |
60 | * new data is placed. | |
61 | * | |
62 | * 2. The host guarantees that it will completely drain | |
63 | * the ring buffer before exiting the read loop. Further, | |
64 | * once the ring buffer is empty, it will clear the | |
65 | * interrupt_mask and re-check to see if new data has | |
66 | * arrived. | |
67 | */ | |
68 | ||
ccef9bcc S |
69 | static bool hv_need_to_signal(u32 old_write, struct hv_ring_buffer_info *rbi, |
70 | enum hv_signal_policy policy) | |
98fa8cf4 | 71 | { |
dcd0eeca | 72 | virt_mb(); |
d45faaee | 73 | if (READ_ONCE(rbi->ring_buffer->interrupt_mask)) |
98fa8cf4 S |
74 | return false; |
75 | ||
ccef9bcc S |
76 | /* |
77 | * When the client wants to control signaling, | |
78 | * we only honour the host interrupt mask. | |
79 | */ | |
80 | if (policy == HV_SIGNAL_POLICY_EXPLICIT) | |
81 | return true; | |
82 | ||
e91e84fa | 83 | /* check interrupt_mask before read_index */ |
dcd0eeca | 84 | virt_rmb(); |
98fa8cf4 S |
85 | /* |
86 | * This is the only case we need to signal when the | |
87 | * ring transitions from being empty to non-empty. | |
88 | */ | |
d45faaee | 89 | if (old_write == READ_ONCE(rbi->ring_buffer->read_index)) |
98fa8cf4 S |
90 | return true; |
91 | ||
92 | return false; | |
93 | } | |
94 | ||
822f18d4 | 95 | /* Get the next write location for the specified ring buffer. */ |
4d643114 | 96 | static inline u32 |
2b8a912e | 97 | hv_get_next_write_location(struct hv_ring_buffer_info *ring_info) |
3e7ee490 | 98 | { |
fc8c72eb | 99 | u32 next = ring_info->ring_buffer->write_index; |
3e7ee490 | 100 | |
3e7ee490 HJ |
101 | return next; |
102 | } | |
103 | ||
822f18d4 | 104 | /* Set the next write location for the specified ring buffer. */ |
3e7ee490 | 105 | static inline void |
2b8a912e | 106 | hv_set_next_write_location(struct hv_ring_buffer_info *ring_info, |
fc8c72eb | 107 | u32 next_write_location) |
3e7ee490 | 108 | { |
fc8c72eb | 109 | ring_info->ring_buffer->write_index = next_write_location; |
3e7ee490 HJ |
110 | } |
111 | ||
822f18d4 | 112 | /* Get the next read location for the specified ring buffer. */ |
4d643114 | 113 | static inline u32 |
2b8a912e | 114 | hv_get_next_read_location(struct hv_ring_buffer_info *ring_info) |
3e7ee490 | 115 | { |
fc8c72eb | 116 | u32 next = ring_info->ring_buffer->read_index; |
3e7ee490 | 117 | |
3e7ee490 HJ |
118 | return next; |
119 | } | |
120 | ||
b2a5a585 | 121 | /* |
b2a5a585 | 122 | * Get the next read location + offset for the specified ring buffer. |
822f18d4 | 123 | * This allows the caller to skip. |
b2a5a585 | 124 | */ |
4d643114 | 125 | static inline u32 |
2b8a912e | 126 | hv_get_next_readlocation_withoffset(struct hv_ring_buffer_info *ring_info, |
1ac58644 | 127 | u32 offset) |
3e7ee490 | 128 | { |
fc8c72eb | 129 | u32 next = ring_info->ring_buffer->read_index; |
3e7ee490 | 130 | |
fc8c72eb HZ |
131 | next += offset; |
132 | next %= ring_info->ring_datasize; | |
3e7ee490 HJ |
133 | |
134 | return next; | |
135 | } | |
136 | ||
822f18d4 | 137 | /* Set the next read location for the specified ring buffer. */ |
3e7ee490 | 138 | static inline void |
2b8a912e | 139 | hv_set_next_read_location(struct hv_ring_buffer_info *ring_info, |
fc8c72eb | 140 | u32 next_read_location) |
3e7ee490 | 141 | { |
fc8c72eb | 142 | ring_info->ring_buffer->read_index = next_read_location; |
ab028db4 | 143 | ring_info->priv_read_index = next_read_location; |
3e7ee490 HJ |
144 | } |
145 | ||
822f18d4 | 146 | /* Get the size of the ring buffer. */ |
4d643114 | 147 | static inline u32 |
2b8a912e | 148 | hv_get_ring_buffersize(struct hv_ring_buffer_info *ring_info) |
3e7ee490 | 149 | { |
fc8c72eb | 150 | return ring_info->ring_datasize; |
3e7ee490 HJ |
151 | } |
152 | ||
822f18d4 | 153 | /* Get the read and write indices as u64 of the specified ring buffer. */ |
59471438 | 154 | static inline u64 |
2b8a912e | 155 | hv_get_ring_bufferindices(struct hv_ring_buffer_info *ring_info) |
3e7ee490 | 156 | { |
fc8c72eb | 157 | return (u64)ring_info->ring_buffer->write_index << 32; |
3e7ee490 HJ |
158 | } |
159 | ||
8f1136ae | 160 | /* |
8f1136ae S |
161 | * Helper routine to copy to source from ring buffer. |
162 | * Assume there is enough room. Handles wrap-around in src case only!! | |
8f1136ae S |
163 | */ |
164 | static u32 hv_copyfrom_ringbuffer( | |
165 | struct hv_ring_buffer_info *ring_info, | |
166 | void *dest, | |
167 | u32 destlen, | |
168 | u32 start_read_offset) | |
169 | { | |
170 | void *ring_buffer = hv_get_ring_buffer(ring_info); | |
171 | u32 ring_buffer_size = hv_get_ring_buffersize(ring_info); | |
172 | ||
173 | u32 frag_len; | |
174 | ||
175 | /* wrap-around detected at the src */ | |
176 | if (destlen > ring_buffer_size - start_read_offset) { | |
177 | frag_len = ring_buffer_size - start_read_offset; | |
178 | ||
179 | memcpy(dest, ring_buffer + start_read_offset, frag_len); | |
180 | memcpy(dest + frag_len, ring_buffer, destlen - frag_len); | |
181 | } else | |
182 | ||
183 | memcpy(dest, ring_buffer + start_read_offset, destlen); | |
184 | ||
185 | ||
186 | start_read_offset += destlen; | |
187 | start_read_offset %= ring_buffer_size; | |
188 | ||
189 | return start_read_offset; | |
190 | } | |
191 | ||
192 | ||
7581578d | 193 | /* |
7581578d S |
194 | * Helper routine to copy from source to ring buffer. |
195 | * Assume there is enough room. Handles wrap-around in dest case only!! | |
7581578d S |
196 | */ |
197 | static u32 hv_copyto_ringbuffer( | |
fc8c72eb HZ |
198 | struct hv_ring_buffer_info *ring_info, |
199 | u32 start_write_offset, | |
200 | void *src, | |
7581578d S |
201 | u32 srclen) |
202 | { | |
203 | void *ring_buffer = hv_get_ring_buffer(ring_info); | |
204 | u32 ring_buffer_size = hv_get_ring_buffersize(ring_info); | |
205 | u32 frag_len; | |
206 | ||
207 | /* wrap-around detected! */ | |
208 | if (srclen > ring_buffer_size - start_write_offset) { | |
209 | frag_len = ring_buffer_size - start_write_offset; | |
210 | memcpy(ring_buffer + start_write_offset, src, frag_len); | |
211 | memcpy(ring_buffer, src + frag_len, srclen - frag_len); | |
212 | } else | |
213 | memcpy(ring_buffer + start_write_offset, src, srclen); | |
3e7ee490 | 214 | |
7581578d S |
215 | start_write_offset += srclen; |
216 | start_write_offset %= ring_buffer_size; | |
217 | ||
218 | return start_write_offset; | |
219 | } | |
3e7ee490 | 220 | |
822f18d4 | 221 | /* Get various debug metrics for the specified ring buffer. */ |
a75b61d5 | 222 | void hv_ringbuffer_get_debuginfo(struct hv_ring_buffer_info *ring_info, |
80682b7a | 223 | struct hv_ring_buffer_debug_info *debug_info) |
3e7ee490 | 224 | { |
fc8c72eb HZ |
225 | u32 bytes_avail_towrite; |
226 | u32 bytes_avail_toread; | |
3e7ee490 | 227 | |
fc8c72eb | 228 | if (ring_info->ring_buffer) { |
2b8a912e | 229 | hv_get_ringbuffer_availbytes(ring_info, |
fc8c72eb HZ |
230 | &bytes_avail_toread, |
231 | &bytes_avail_towrite); | |
3e7ee490 | 232 | |
fc8c72eb HZ |
233 | debug_info->bytes_avail_toread = bytes_avail_toread; |
234 | debug_info->bytes_avail_towrite = bytes_avail_towrite; | |
82f8bd40 | 235 | debug_info->current_read_index = |
fc8c72eb | 236 | ring_info->ring_buffer->read_index; |
82f8bd40 | 237 | debug_info->current_write_index = |
fc8c72eb | 238 | ring_info->ring_buffer->write_index; |
82f8bd40 | 239 | debug_info->current_interrupt_mask = |
fc8c72eb | 240 | ring_info->ring_buffer->interrupt_mask; |
3e7ee490 HJ |
241 | } |
242 | } | |
243 | ||
822f18d4 | 244 | /* Initialize the ring buffer. */ |
72a95cbc | 245 | int hv_ringbuffer_init(struct hv_ring_buffer_info *ring_info, |
fc8c72eb | 246 | void *buffer, u32 buflen) |
3e7ee490 | 247 | { |
4a1b3acc | 248 | if (sizeof(struct hv_ring_buffer) != PAGE_SIZE) |
3324fb40 | 249 | return -EINVAL; |
3e7ee490 | 250 | |
fc8c72eb | 251 | memset(ring_info, 0, sizeof(struct hv_ring_buffer_info)); |
3e7ee490 | 252 | |
fc8c72eb HZ |
253 | ring_info->ring_buffer = (struct hv_ring_buffer *)buffer; |
254 | ring_info->ring_buffer->read_index = | |
255 | ring_info->ring_buffer->write_index = 0; | |
3e7ee490 | 256 | |
822f18d4 | 257 | /* Set the feature bit for enabling flow control. */ |
046c7911 S |
258 | ring_info->ring_buffer->feature_bits.value = 1; |
259 | ||
fc8c72eb HZ |
260 | ring_info->ring_size = buflen; |
261 | ring_info->ring_datasize = buflen - sizeof(struct hv_ring_buffer); | |
3e7ee490 | 262 | |
fc8c72eb | 263 | spin_lock_init(&ring_info->ring_lock); |
3e7ee490 HJ |
264 | |
265 | return 0; | |
266 | } | |
267 | ||
822f18d4 | 268 | /* Cleanup the ring buffer. */ |
2dba688b | 269 | void hv_ringbuffer_cleanup(struct hv_ring_buffer_info *ring_info) |
3e7ee490 | 270 | { |
3e7ee490 HJ |
271 | } |
272 | ||
822f18d4 | 273 | /* Write to the ring buffer. */ |
633c4dce | 274 | int hv_ringbuffer_write(struct hv_ring_buffer_info *outring_info, |
ccef9bcc S |
275 | struct kvec *kv_list, u32 kv_count, bool *signal, bool lock, |
276 | enum hv_signal_policy policy) | |
3e7ee490 | 277 | { |
4408f531 | 278 | int i = 0; |
fc8c72eb | 279 | u32 bytes_avail_towrite; |
fc8c72eb | 280 | u32 totalbytes_towrite = 0; |
3e7ee490 | 281 | |
66a60543 | 282 | u32 next_write_location; |
98fa8cf4 | 283 | u32 old_write; |
fc8c72eb | 284 | u64 prev_indices = 0; |
fe760e4d | 285 | unsigned long flags = 0; |
3e7ee490 | 286 | |
011a7c3c S |
287 | for (i = 0; i < kv_count; i++) |
288 | totalbytes_towrite += kv_list[i].iov_len; | |
3e7ee490 | 289 | |
fc8c72eb | 290 | totalbytes_towrite += sizeof(u64); |
3e7ee490 | 291 | |
fe760e4d S |
292 | if (lock) |
293 | spin_lock_irqsave(&outring_info->ring_lock, flags); | |
3e7ee490 | 294 | |
a6341f00 | 295 | bytes_avail_towrite = hv_get_bytes_to_write(outring_info); |
3e7ee490 | 296 | |
822f18d4 VK |
297 | /* |
298 | * If there is only room for the packet, assume it is full. | |
299 | * Otherwise, the next time around, we think the ring buffer | |
300 | * is empty since the read index == write index. | |
301 | */ | |
fc8c72eb | 302 | if (bytes_avail_towrite <= totalbytes_towrite) { |
fe760e4d S |
303 | if (lock) |
304 | spin_unlock_irqrestore(&outring_info->ring_lock, flags); | |
d2598f01 | 305 | return -EAGAIN; |
3e7ee490 HJ |
306 | } |
307 | ||
454f18a9 | 308 | /* Write to the ring buffer */ |
2b8a912e | 309 | next_write_location = hv_get_next_write_location(outring_info); |
3e7ee490 | 310 | |
98fa8cf4 S |
311 | old_write = next_write_location; |
312 | ||
011a7c3c | 313 | for (i = 0; i < kv_count; i++) { |
2b8a912e | 314 | next_write_location = hv_copyto_ringbuffer(outring_info, |
fc8c72eb | 315 | next_write_location, |
011a7c3c S |
316 | kv_list[i].iov_base, |
317 | kv_list[i].iov_len); | |
3e7ee490 HJ |
318 | } |
319 | ||
454f18a9 | 320 | /* Set previous packet start */ |
2b8a912e | 321 | prev_indices = hv_get_ring_bufferindices(outring_info); |
3e7ee490 | 322 | |
2b8a912e | 323 | next_write_location = hv_copyto_ringbuffer(outring_info, |
fc8c72eb HZ |
324 | next_write_location, |
325 | &prev_indices, | |
b219b3f7 | 326 | sizeof(u64)); |
3e7ee490 | 327 | |
98fa8cf4 | 328 | /* Issue a full memory barrier before updating the write index */ |
dcd0eeca | 329 | virt_mb(); |
3e7ee490 | 330 | |
454f18a9 | 331 | /* Now, update the write location */ |
2b8a912e | 332 | hv_set_next_write_location(outring_info, next_write_location); |
3e7ee490 | 333 | |
3e7ee490 | 334 | |
fe760e4d S |
335 | if (lock) |
336 | spin_unlock_irqrestore(&outring_info->ring_lock, flags); | |
98fa8cf4 | 337 | |
ccef9bcc | 338 | *signal = hv_need_to_signal(old_write, outring_info, policy); |
3e7ee490 HJ |
339 | return 0; |
340 | } | |
341 | ||
940b68e2 VK |
342 | int hv_ringbuffer_read(struct hv_ring_buffer_info *inring_info, |
343 | void *buffer, u32 buflen, u32 *buffer_actual_len, | |
344 | u64 *requestid, bool *signal, bool raw) | |
3e7ee490 | 345 | { |
fc8c72eb HZ |
346 | u32 bytes_avail_toread; |
347 | u32 next_read_location = 0; | |
348 | u64 prev_indices = 0; | |
940b68e2 VK |
349 | struct vmpacket_descriptor desc; |
350 | u32 offset; | |
351 | u32 packetlen; | |
352 | int ret = 0; | |
3e7ee490 | 353 | |
fc8c72eb | 354 | if (buflen <= 0) |
a16e1485 | 355 | return -EINVAL; |
3e7ee490 | 356 | |
3e7ee490 | 357 | |
940b68e2 VK |
358 | *buffer_actual_len = 0; |
359 | *requestid = 0; | |
360 | ||
a6341f00 | 361 | bytes_avail_toread = hv_get_bytes_to_read(inring_info); |
454f18a9 | 362 | /* Make sure there is something to read */ |
940b68e2 VK |
363 | if (bytes_avail_toread < sizeof(desc)) { |
364 | /* | |
365 | * No error is set when there is even no header, drivers are | |
366 | * supposed to analyze buffer_actual_len. | |
367 | */ | |
3eba9a77 | 368 | return ret; |
940b68e2 | 369 | } |
3e7ee490 | 370 | |
940b68e2 VK |
371 | next_read_location = hv_get_next_read_location(inring_info); |
372 | next_read_location = hv_copyfrom_ringbuffer(inring_info, &desc, | |
373 | sizeof(desc), | |
374 | next_read_location); | |
375 | ||
376 | offset = raw ? 0 : (desc.offset8 << 3); | |
377 | packetlen = (desc.len8 << 3) - offset; | |
378 | *buffer_actual_len = packetlen; | |
379 | *requestid = desc.trans_id; | |
380 | ||
3eba9a77 S |
381 | if (bytes_avail_toread < packetlen + offset) |
382 | return -EAGAIN; | |
940b68e2 | 383 | |
3eba9a77 S |
384 | if (packetlen > buflen) |
385 | return -ENOBUFS; | |
3e7ee490 | 386 | |
1ac58644 | 387 | next_read_location = |
2b8a912e | 388 | hv_get_next_readlocation_withoffset(inring_info, offset); |
3e7ee490 | 389 | |
2b8a912e | 390 | next_read_location = hv_copyfrom_ringbuffer(inring_info, |
fc8c72eb | 391 | buffer, |
940b68e2 | 392 | packetlen, |
fc8c72eb | 393 | next_read_location); |
3e7ee490 | 394 | |
2b8a912e | 395 | next_read_location = hv_copyfrom_ringbuffer(inring_info, |
fc8c72eb | 396 | &prev_indices, |
4408f531 | 397 | sizeof(u64), |
fc8c72eb | 398 | next_read_location); |
3e7ee490 | 399 | |
822f18d4 VK |
400 | /* |
401 | * Make sure all reads are done before we update the read index since | |
402 | * the writer may start writing to the read area once the read index | |
403 | * is updated. | |
404 | */ | |
dcd0eeca | 405 | virt_mb(); |
3e7ee490 | 406 | |
454f18a9 | 407 | /* Update the read index */ |
2b8a912e | 408 | hv_set_next_read_location(inring_info, next_read_location); |
3e7ee490 | 409 | |
a389fcfd | 410 | *signal = hv_need_to_signal_on_read(inring_info); |
c2b8e520 | 411 | |
940b68e2 | 412 | return ret; |
b5f53dde | 413 | } |