Commit | Line | Data |
---|---|---|
fceaf24a | 1 | /* |
fceaf24a HJ |
2 | * Copyright (c) 2009, Microsoft Corporation. |
3 | * | |
4 | * This program is free software; you can redistribute it and/or modify it | |
5 | * under the terms and conditions of the GNU General Public License, | |
6 | * version 2, as published by the Free Software Foundation. | |
7 | * | |
8 | * This program is distributed in the hope it will be useful, but WITHOUT | |
9 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
10 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
11 | * more details. | |
12 | * | |
13 | * You should have received a copy of the GNU General Public License along with | |
14 | * this program; if not, write to the Free Software Foundation, Inc., 59 Temple | |
15 | * Place - Suite 330, Boston, MA 02111-1307 USA. | |
16 | * | |
17 | * Authors: | |
d0e94d17 | 18 | * Haiyang Zhang <haiyangz@microsoft.com> |
fceaf24a | 19 | * Hank Janssen <hjanssen@microsoft.com> |
fceaf24a | 20 | */ |
eb335bc4 HJ |
21 | #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt |
22 | ||
5654e932 | 23 | #include <linux/kernel.h> |
0c3b7b2f S |
24 | #include <linux/sched.h> |
25 | #include <linux/wait.h> | |
0ffa63b0 | 26 | #include <linux/mm.h> |
b4362c9c | 27 | #include <linux/delay.h> |
21a80820 | 28 | #include <linux/io.h> |
5a0e3ad6 | 29 | #include <linux/slab.h> |
d9871158 | 30 | #include <linux/netdevice.h> |
f157e78d | 31 | #include <linux/if_ether.h> |
3f335ea2 | 32 | |
5ca7252a | 33 | #include "hyperv_net.h" |
fceaf24a HJ |
34 | |
35 | ||
5a71ae30 | 36 | static struct netvsc_device *alloc_net_device(struct hv_device *device) |
fceaf24a | 37 | { |
85799a37 | 38 | struct netvsc_device *net_device; |
2ddd5e5f | 39 | struct net_device *ndev = hv_get_drvdata(device); |
fceaf24a | 40 | |
85799a37 HZ |
41 | net_device = kzalloc(sizeof(struct netvsc_device), GFP_KERNEL); |
42 | if (!net_device) | |
fceaf24a HJ |
43 | return NULL; |
44 | ||
4d447c9a | 45 | net_device->start_remove = false; |
c38b9c71 | 46 | net_device->destroy = false; |
53d21fdb | 47 | net_device->dev = device; |
2ddd5e5f | 48 | net_device->ndev = ndev; |
fceaf24a | 49 | |
2ddd5e5f | 50 | hv_set_drvdata(device, net_device); |
85799a37 | 51 | return net_device; |
fceaf24a HJ |
52 | } |
53 | ||
5a71ae30 | 54 | static struct netvsc_device *get_outbound_net_device(struct hv_device *device) |
fceaf24a | 55 | { |
85799a37 | 56 | struct netvsc_device *net_device; |
fceaf24a | 57 | |
2ddd5e5f | 58 | net_device = hv_get_drvdata(device); |
9d88f33a | 59 | if (net_device && net_device->destroy) |
85799a37 | 60 | net_device = NULL; |
fceaf24a | 61 | |
85799a37 | 62 | return net_device; |
fceaf24a HJ |
63 | } |
64 | ||
5a71ae30 | 65 | static struct netvsc_device *get_inbound_net_device(struct hv_device *device) |
fceaf24a | 66 | { |
85799a37 | 67 | struct netvsc_device *net_device; |
fceaf24a | 68 | |
2ddd5e5f | 69 | net_device = hv_get_drvdata(device); |
9d88f33a S |
70 | |
71 | if (!net_device) | |
72 | goto get_in_err; | |
73 | ||
74 | if (net_device->destroy && | |
75 | atomic_read(&net_device->num_outstanding_sends) == 0) | |
85799a37 | 76 | net_device = NULL; |
fceaf24a | 77 | |
9d88f33a | 78 | get_in_err: |
85799a37 | 79 | return net_device; |
fceaf24a HJ |
80 | } |
81 | ||
fceaf24a | 82 | |
ec91cd09 HZ |
83 | static int netvsc_destroy_recv_buf(struct netvsc_device *net_device) |
84 | { | |
85 | struct nvsp_message *revoke_packet; | |
86 | int ret = 0; | |
2ddd5e5f | 87 | struct net_device *ndev = net_device->ndev; |
ec91cd09 HZ |
88 | |
89 | /* | |
90 | * If we got a section count, it means we received a | |
91 | * SendReceiveBufferComplete msg (ie sent | |
92 | * NvspMessage1TypeSendReceiveBuffer msg) therefore, we need | |
93 | * to send a revoke msg here | |
94 | */ | |
95 | if (net_device->recv_section_cnt) { | |
96 | /* Send the revoke receive buffer */ | |
97 | revoke_packet = &net_device->revoke_packet; | |
98 | memset(revoke_packet, 0, sizeof(struct nvsp_message)); | |
99 | ||
100 | revoke_packet->hdr.msg_type = | |
101 | NVSP_MSG1_TYPE_REVOKE_RECV_BUF; | |
102 | revoke_packet->msg.v1_msg. | |
103 | revoke_recv_buf.id = NETVSC_RECEIVE_BUFFER_ID; | |
104 | ||
105 | ret = vmbus_sendpacket(net_device->dev->channel, | |
106 | revoke_packet, | |
107 | sizeof(struct nvsp_message), | |
108 | (unsigned long)revoke_packet, | |
109 | VM_PKT_DATA_INBAND, 0); | |
110 | /* | |
111 | * If we failed here, we might as well return and | |
112 | * have a leak rather than continue and a bugchk | |
113 | */ | |
114 | if (ret != 0) { | |
d9871158 | 115 | netdev_err(ndev, "unable to send " |
c909ebbd | 116 | "revoke receive buffer to netvsp\n"); |
a3e00530 | 117 | return ret; |
ec91cd09 HZ |
118 | } |
119 | } | |
120 | ||
121 | /* Teardown the gpadl on the vsp end */ | |
122 | if (net_device->recv_buf_gpadl_handle) { | |
123 | ret = vmbus_teardown_gpadl(net_device->dev->channel, | |
124 | net_device->recv_buf_gpadl_handle); | |
125 | ||
126 | /* If we failed here, we might as well return and have a leak | |
127 | * rather than continue and a bugchk | |
128 | */ | |
129 | if (ret != 0) { | |
d9871158 | 130 | netdev_err(ndev, |
c909ebbd | 131 | "unable to teardown receive buffer's gpadl\n"); |
7f9615e6 | 132 | return ret; |
ec91cd09 HZ |
133 | } |
134 | net_device->recv_buf_gpadl_handle = 0; | |
135 | } | |
136 | ||
137 | if (net_device->recv_buf) { | |
138 | /* Free up the receive buffer */ | |
139 | free_pages((unsigned long)net_device->recv_buf, | |
140 | get_order(net_device->recv_buf_size)); | |
141 | net_device->recv_buf = NULL; | |
142 | } | |
143 | ||
144 | if (net_device->recv_section) { | |
145 | net_device->recv_section_cnt = 0; | |
146 | kfree(net_device->recv_section); | |
147 | net_device->recv_section = NULL; | |
148 | } | |
149 | ||
150 | return ret; | |
151 | } | |
152 | ||
5a71ae30 | 153 | static int netvsc_init_recv_buf(struct hv_device *device) |
fceaf24a | 154 | { |
21a80820 | 155 | int ret = 0; |
35abb21a | 156 | int t; |
85799a37 HZ |
157 | struct netvsc_device *net_device; |
158 | struct nvsp_message *init_packet; | |
2ddd5e5f | 159 | struct net_device *ndev; |
fceaf24a | 160 | |
5a71ae30 | 161 | net_device = get_outbound_net_device(device); |
2ddd5e5f | 162 | if (!net_device) |
927bc33c | 163 | return -ENODEV; |
2ddd5e5f | 164 | ndev = net_device->ndev; |
fceaf24a | 165 | |
53d21fdb | 166 | net_device->recv_buf = |
df3493e0 S |
167 | (void *)__get_free_pages(GFP_KERNEL|__GFP_ZERO, |
168 | get_order(net_device->recv_buf_size)); | |
53d21fdb | 169 | if (!net_device->recv_buf) { |
d9871158 | 170 | netdev_err(ndev, "unable to allocate receive " |
c909ebbd | 171 | "buffer of size %d\n", net_device->recv_buf_size); |
927bc33c | 172 | ret = -ENOMEM; |
0c3b7b2f | 173 | goto cleanup; |
fceaf24a | 174 | } |
fceaf24a | 175 | |
454f18a9 BP |
176 | /* |
177 | * Establish the gpadl handle for this buffer on this | |
178 | * channel. Note: This call uses the vmbus connection rather | |
179 | * than the channel to establish the gpadl handle. | |
180 | */ | |
53d21fdb HZ |
181 | ret = vmbus_establish_gpadl(device->channel, net_device->recv_buf, |
182 | net_device->recv_buf_size, | |
183 | &net_device->recv_buf_gpadl_handle); | |
21a80820 | 184 | if (ret != 0) { |
d9871158 | 185 | netdev_err(ndev, |
c909ebbd | 186 | "unable to establish receive buffer's gpadl\n"); |
0c3b7b2f | 187 | goto cleanup; |
fceaf24a HJ |
188 | } |
189 | ||
fceaf24a | 190 | |
454f18a9 | 191 | /* Notify the NetVsp of the gpadl handle */ |
53d21fdb | 192 | init_packet = &net_device->channel_init_pkt; |
fceaf24a | 193 | |
85799a37 | 194 | memset(init_packet, 0, sizeof(struct nvsp_message)); |
fceaf24a | 195 | |
53d21fdb HZ |
196 | init_packet->hdr.msg_type = NVSP_MSG1_TYPE_SEND_RECV_BUF; |
197 | init_packet->msg.v1_msg.send_recv_buf. | |
198 | gpadl_handle = net_device->recv_buf_gpadl_handle; | |
199 | init_packet->msg.v1_msg. | |
200 | send_recv_buf.id = NETVSC_RECEIVE_BUFFER_ID; | |
fceaf24a | 201 | |
454f18a9 | 202 | /* Send the gpadl notification request */ |
85799a37 | 203 | ret = vmbus_sendpacket(device->channel, init_packet, |
5a4df290 | 204 | sizeof(struct nvsp_message), |
85799a37 | 205 | (unsigned long)init_packet, |
415f2287 | 206 | VM_PKT_DATA_INBAND, |
5a4df290 | 207 | VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED); |
21a80820 | 208 | if (ret != 0) { |
d9871158 | 209 | netdev_err(ndev, |
c909ebbd | 210 | "unable to send receive buffer's gpadl to netvsp\n"); |
0c3b7b2f | 211 | goto cleanup; |
fceaf24a HJ |
212 | } |
213 | ||
5c5781b3 | 214 | t = wait_for_completion_timeout(&net_device->channel_init_wait, 5*HZ); |
35abb21a | 215 | BUG_ON(t == 0); |
0c3b7b2f | 216 | |
fceaf24a | 217 | |
454f18a9 | 218 | /* Check the response */ |
53d21fdb HZ |
219 | if (init_packet->msg.v1_msg. |
220 | send_recv_buf_complete.status != NVSP_STAT_SUCCESS) { | |
d9871158 | 221 | netdev_err(ndev, "Unable to complete receive buffer " |
8bff33ab | 222 | "initialization with NetVsp - status %d\n", |
53d21fdb HZ |
223 | init_packet->msg.v1_msg. |
224 | send_recv_buf_complete.status); | |
927bc33c | 225 | ret = -EINVAL; |
0c3b7b2f | 226 | goto cleanup; |
fceaf24a HJ |
227 | } |
228 | ||
454f18a9 | 229 | /* Parse the response */ |
fceaf24a | 230 | |
53d21fdb HZ |
231 | net_device->recv_section_cnt = init_packet->msg. |
232 | v1_msg.send_recv_buf_complete.num_sections; | |
fceaf24a | 233 | |
c1813200 HZ |
234 | net_device->recv_section = kmemdup( |
235 | init_packet->msg.v1_msg.send_recv_buf_complete.sections, | |
236 | net_device->recv_section_cnt * | |
237 | sizeof(struct nvsp_1_receive_buffer_section), | |
238 | GFP_KERNEL); | |
53d21fdb | 239 | if (net_device->recv_section == NULL) { |
927bc33c | 240 | ret = -EINVAL; |
0c3b7b2f | 241 | goto cleanup; |
fceaf24a HJ |
242 | } |
243 | ||
21a80820 GKH |
244 | /* |
245 | * For 1st release, there should only be 1 section that represents the | |
246 | * entire receive buffer | |
247 | */ | |
53d21fdb HZ |
248 | if (net_device->recv_section_cnt != 1 || |
249 | net_device->recv_section->offset != 0) { | |
927bc33c | 250 | ret = -EINVAL; |
0c3b7b2f | 251 | goto cleanup; |
fceaf24a HJ |
252 | } |
253 | ||
0c3b7b2f | 254 | goto exit; |
fceaf24a | 255 | |
0c3b7b2f | 256 | cleanup: |
5a71ae30 | 257 | netvsc_destroy_recv_buf(net_device); |
fceaf24a | 258 | |
0c3b7b2f | 259 | exit: |
fceaf24a HJ |
260 | return ret; |
261 | } | |
262 | ||
fceaf24a | 263 | |
f157e78d HZ |
264 | /* Negotiate NVSP protocol version */ |
265 | static int negotiate_nvsp_ver(struct hv_device *device, | |
266 | struct netvsc_device *net_device, | |
267 | struct nvsp_message *init_packet, | |
268 | u32 nvsp_ver) | |
fceaf24a | 269 | { |
35abb21a | 270 | int ret, t; |
fceaf24a | 271 | |
85799a37 | 272 | memset(init_packet, 0, sizeof(struct nvsp_message)); |
53d21fdb | 273 | init_packet->hdr.msg_type = NVSP_MSG_TYPE_INIT; |
f157e78d HZ |
274 | init_packet->msg.init_msg.init.min_protocol_ver = nvsp_ver; |
275 | init_packet->msg.init_msg.init.max_protocol_ver = nvsp_ver; | |
fceaf24a | 276 | |
454f18a9 | 277 | /* Send the init request */ |
85799a37 | 278 | ret = vmbus_sendpacket(device->channel, init_packet, |
5a4df290 | 279 | sizeof(struct nvsp_message), |
85799a37 | 280 | (unsigned long)init_packet, |
415f2287 | 281 | VM_PKT_DATA_INBAND, |
5a4df290 | 282 | VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED); |
21a80820 | 283 | |
b8a3d52b | 284 | if (ret != 0) |
f157e78d | 285 | return ret; |
fceaf24a | 286 | |
5c5781b3 | 287 | t = wait_for_completion_timeout(&net_device->channel_init_wait, 5*HZ); |
35abb21a | 288 | |
f157e78d HZ |
289 | if (t == 0) |
290 | return -ETIMEDOUT; | |
fceaf24a | 291 | |
53d21fdb | 292 | if (init_packet->msg.init_msg.init_complete.status != |
f157e78d HZ |
293 | NVSP_STAT_SUCCESS) |
294 | return -EINVAL; | |
fceaf24a | 295 | |
f157e78d HZ |
296 | if (nvsp_ver != NVSP_PROTOCOL_VERSION_2) |
297 | return 0; | |
298 | ||
299 | /* NVSPv2 only: Send NDIS config */ | |
300 | memset(init_packet, 0, sizeof(struct nvsp_message)); | |
301 | init_packet->hdr.msg_type = NVSP_MSG2_TYPE_SEND_NDIS_CONFIG; | |
4d447c9a | 302 | init_packet->msg.v2_msg.send_ndis_config.mtu = net_device->ndev->mtu; |
f157e78d HZ |
303 | |
304 | ret = vmbus_sendpacket(device->channel, init_packet, | |
305 | sizeof(struct nvsp_message), | |
306 | (unsigned long)init_packet, | |
307 | VM_PKT_DATA_INBAND, 0); | |
308 | ||
309 | return ret; | |
310 | } | |
311 | ||
312 | static int netvsc_connect_vsp(struct hv_device *device) | |
313 | { | |
314 | int ret; | |
315 | struct netvsc_device *net_device; | |
316 | struct nvsp_message *init_packet; | |
317 | int ndis_version; | |
318 | struct net_device *ndev; | |
319 | ||
320 | net_device = get_outbound_net_device(device); | |
321 | if (!net_device) | |
322 | return -ENODEV; | |
323 | ndev = net_device->ndev; | |
324 | ||
325 | init_packet = &net_device->channel_init_pkt; | |
326 | ||
327 | /* Negotiate the latest NVSP protocol supported */ | |
328 | if (negotiate_nvsp_ver(device, net_device, init_packet, | |
329 | NVSP_PROTOCOL_VERSION_2) == 0) { | |
330 | net_device->nvsp_version = NVSP_PROTOCOL_VERSION_2; | |
331 | } else if (negotiate_nvsp_ver(device, net_device, init_packet, | |
332 | NVSP_PROTOCOL_VERSION_1) == 0) { | |
333 | net_device->nvsp_version = NVSP_PROTOCOL_VERSION_1; | |
334 | } else { | |
0f48c72c | 335 | ret = -EPROTO; |
0c3b7b2f | 336 | goto cleanup; |
fceaf24a | 337 | } |
f157e78d HZ |
338 | |
339 | pr_debug("Negotiated NVSP version:%x\n", net_device->nvsp_version); | |
340 | ||
454f18a9 | 341 | /* Send the ndis version */ |
85799a37 | 342 | memset(init_packet, 0, sizeof(struct nvsp_message)); |
fceaf24a | 343 | |
85799a37 | 344 | ndis_version = 0x00050000; |
fceaf24a | 345 | |
53d21fdb HZ |
346 | init_packet->hdr.msg_type = NVSP_MSG1_TYPE_SEND_NDIS_VER; |
347 | init_packet->msg.v1_msg. | |
348 | send_ndis_ver.ndis_major_ver = | |
85799a37 | 349 | (ndis_version & 0xFFFF0000) >> 16; |
53d21fdb HZ |
350 | init_packet->msg.v1_msg. |
351 | send_ndis_ver.ndis_minor_ver = | |
85799a37 | 352 | ndis_version & 0xFFFF; |
fceaf24a | 353 | |
454f18a9 | 354 | /* Send the init request */ |
85799a37 | 355 | ret = vmbus_sendpacket(device->channel, init_packet, |
0c3b7b2f S |
356 | sizeof(struct nvsp_message), |
357 | (unsigned long)init_packet, | |
358 | VM_PKT_DATA_INBAND, 0); | |
0f48c72c | 359 | if (ret != 0) |
0c3b7b2f | 360 | goto cleanup; |
454f18a9 BP |
361 | |
362 | /* Post the big receive buffer to NetVSP */ | |
5a71ae30 | 363 | ret = netvsc_init_recv_buf(device); |
fceaf24a | 364 | |
0c3b7b2f | 365 | cleanup: |
fceaf24a HJ |
366 | return ret; |
367 | } | |
368 | ||
648dc598 | 369 | static void netvsc_disconnect_vsp(struct netvsc_device *net_device) |
fceaf24a | 370 | { |
5a71ae30 | 371 | netvsc_destroy_recv_buf(net_device); |
fceaf24a HJ |
372 | } |
373 | ||
3e189519 | 374 | /* |
5a71ae30 | 375 | * netvsc_device_remove - Callback when the root bus device is removed |
21a80820 | 376 | */ |
905620d1 | 377 | int netvsc_device_remove(struct hv_device *device) |
fceaf24a | 378 | { |
85799a37 HZ |
379 | struct netvsc_device *net_device; |
380 | struct hv_netvsc_packet *netvsc_packet, *pos; | |
c38b9c71 | 381 | unsigned long flags; |
fceaf24a | 382 | |
2ddd5e5f | 383 | net_device = hv_get_drvdata(device); |
c38b9c71 S |
384 | spin_lock_irqsave(&device->channel->inbound_lock, flags); |
385 | net_device->destroy = true; | |
386 | spin_unlock_irqrestore(&device->channel->inbound_lock, flags); | |
387 | ||
454f18a9 | 388 | /* Wait for all send completions */ |
53d21fdb | 389 | while (atomic_read(&net_device->num_outstanding_sends)) { |
d9871158 | 390 | dev_info(&device->device, |
c909ebbd | 391 | "waiting for %d requests to complete...\n", |
eb335bc4 | 392 | atomic_read(&net_device->num_outstanding_sends)); |
b4362c9c | 393 | udelay(100); |
fceaf24a HJ |
394 | } |
395 | ||
648dc598 | 396 | netvsc_disconnect_vsp(net_device); |
fceaf24a | 397 | |
3852409b | 398 | /* |
9d88f33a S |
399 | * Since we have already drained, we don't need to busy wait |
400 | * as was done in final_release_stor_device() | |
401 | * Note that we cannot set the ext pointer to NULL until | |
402 | * we have drained - to drain the outgoing packets, we need to | |
403 | * allow incoming packets. | |
3852409b | 404 | */ |
9d88f33a S |
405 | |
406 | spin_lock_irqsave(&device->channel->inbound_lock, flags); | |
2ddd5e5f | 407 | hv_set_drvdata(device, NULL); |
9d88f33a | 408 | spin_unlock_irqrestore(&device->channel->inbound_lock, flags); |
3852409b | 409 | |
86c921af S |
410 | /* |
411 | * At this point, no one should be accessing net_device | |
412 | * except in here | |
413 | */ | |
c909ebbd | 414 | dev_notice(&device->device, "net device safe to remove\n"); |
fceaf24a | 415 | |
454f18a9 | 416 | /* Now, we can close the channel safely */ |
85799a37 | 417 | vmbus_close(device->channel); |
fceaf24a | 418 | |
454f18a9 | 419 | /* Release all resources */ |
85799a37 | 420 | list_for_each_entry_safe(netvsc_packet, pos, |
53d21fdb | 421 | &net_device->recv_pkt_list, list_ent) { |
72a2f5bd | 422 | list_del(&netvsc_packet->list_ent); |
85799a37 | 423 | kfree(netvsc_packet); |
fceaf24a HJ |
424 | } |
425 | ||
356c4657 | 426 | kfree(net_device); |
21a80820 | 427 | return 0; |
fceaf24a HJ |
428 | } |
429 | ||
5a71ae30 | 430 | static void netvsc_send_completion(struct hv_device *device, |
85799a37 | 431 | struct vmpacket_descriptor *packet) |
fceaf24a | 432 | { |
85799a37 HZ |
433 | struct netvsc_device *net_device; |
434 | struct nvsp_message *nvsp_packet; | |
435 | struct hv_netvsc_packet *nvsc_packet; | |
2ddd5e5f | 436 | struct net_device *ndev; |
fceaf24a | 437 | |
5a71ae30 | 438 | net_device = get_inbound_net_device(device); |
2ddd5e5f | 439 | if (!net_device) |
fceaf24a | 440 | return; |
2ddd5e5f | 441 | ndev = net_device->ndev; |
fceaf24a | 442 | |
85799a37 | 443 | nvsp_packet = (struct nvsp_message *)((unsigned long)packet + |
415f2287 | 444 | (packet->offset8 << 3)); |
fceaf24a | 445 | |
53d21fdb HZ |
446 | if ((nvsp_packet->hdr.msg_type == NVSP_MSG_TYPE_INIT_COMPLETE) || |
447 | (nvsp_packet->hdr.msg_type == | |
448 | NVSP_MSG1_TYPE_SEND_RECV_BUF_COMPLETE) || | |
449 | (nvsp_packet->hdr.msg_type == | |
450 | NVSP_MSG1_TYPE_SEND_SEND_BUF_COMPLETE)) { | |
454f18a9 | 451 | /* Copy the response back */ |
53d21fdb | 452 | memcpy(&net_device->channel_init_pkt, nvsp_packet, |
21a80820 | 453 | sizeof(struct nvsp_message)); |
35abb21a | 454 | complete(&net_device->channel_init_wait); |
53d21fdb HZ |
455 | } else if (nvsp_packet->hdr.msg_type == |
456 | NVSP_MSG1_TYPE_SEND_RNDIS_PKT_COMPLETE) { | |
454f18a9 | 457 | /* Get the send context */ |
85799a37 | 458 | nvsc_packet = (struct hv_netvsc_packet *)(unsigned long) |
415f2287 | 459 | packet->trans_id; |
fceaf24a | 460 | |
454f18a9 | 461 | /* Notify the layer above us */ |
72a2f5bd HZ |
462 | nvsc_packet->completion.send.send_completion( |
463 | nvsc_packet->completion.send.send_completion_ctx); | |
fceaf24a | 464 | |
53d21fdb | 465 | atomic_dec(&net_device->num_outstanding_sends); |
1d06825b | 466 | |
4d447c9a | 467 | if (netif_queue_stopped(ndev) && !net_device->start_remove) |
1d06825b | 468 | netif_wake_queue(ndev); |
21a80820 | 469 | } else { |
d9871158 | 470 | netdev_err(ndev, "Unknown send completion packet type- " |
c909ebbd | 471 | "%d received!!\n", nvsp_packet->hdr.msg_type); |
fceaf24a HJ |
472 | } |
473 | ||
fceaf24a HJ |
474 | } |
475 | ||
f9819f05 | 476 | int netvsc_send(struct hv_device *device, |
85799a37 | 477 | struct hv_netvsc_packet *packet) |
fceaf24a | 478 | { |
85799a37 | 479 | struct netvsc_device *net_device; |
21a80820 | 480 | int ret = 0; |
223c1aa6 | 481 | struct nvsp_message sendMessage; |
2ddd5e5f | 482 | struct net_device *ndev; |
fceaf24a | 483 | |
5a71ae30 | 484 | net_device = get_outbound_net_device(device); |
2ddd5e5f | 485 | if (!net_device) |
ff2bd69a | 486 | return -ENODEV; |
2ddd5e5f | 487 | ndev = net_device->ndev; |
fceaf24a | 488 | |
53d21fdb | 489 | sendMessage.hdr.msg_type = NVSP_MSG1_TYPE_SEND_RNDIS_PKT; |
72a2f5bd | 490 | if (packet->is_data_pkt) { |
21a80820 | 491 | /* 0 is RMC_DATA; */ |
53d21fdb | 492 | sendMessage.msg.v1_msg.send_rndis_pkt.channel_type = 0; |
21a80820 GKH |
493 | } else { |
494 | /* 1 is RMC_CONTROL; */ | |
53d21fdb | 495 | sendMessage.msg.v1_msg.send_rndis_pkt.channel_type = 1; |
21a80820 | 496 | } |
fceaf24a | 497 | |
454f18a9 | 498 | /* Not using send buffer section */ |
53d21fdb HZ |
499 | sendMessage.msg.v1_msg.send_rndis_pkt.send_buf_section_index = |
500 | 0xFFFFFFFF; | |
501 | sendMessage.msg.v1_msg.send_rndis_pkt.send_buf_section_size = 0; | |
21a80820 | 502 | |
72a2f5bd | 503 | if (packet->page_buf_cnt) { |
85799a37 | 504 | ret = vmbus_sendpacket_pagebuffer(device->channel, |
72a2f5bd HZ |
505 | packet->page_buf, |
506 | packet->page_buf_cnt, | |
ff3f8eec GKH |
507 | &sendMessage, |
508 | sizeof(struct nvsp_message), | |
85799a37 | 509 | (unsigned long)packet); |
21a80820 | 510 | } else { |
85799a37 | 511 | ret = vmbus_sendpacket(device->channel, &sendMessage, |
e4d59ac5 HZ |
512 | sizeof(struct nvsp_message), |
513 | (unsigned long)packet, | |
514 | VM_PKT_DATA_INBAND, | |
515 | VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED); | |
fceaf24a HJ |
516 | |
517 | } | |
518 | ||
1d06825b HZ |
519 | if (ret == 0) { |
520 | atomic_inc(&net_device->num_outstanding_sends); | |
521 | } else if (ret == -EAGAIN) { | |
522 | netif_stop_queue(ndev); | |
523 | if (atomic_read(&net_device->num_outstanding_sends) < 1) | |
524 | netif_wake_queue(ndev); | |
525 | } else { | |
d9871158 | 526 | netdev_err(ndev, "Unable to send packet %p ret %d\n", |
85799a37 | 527 | packet, ret); |
1d06825b | 528 | } |
fceaf24a | 529 | |
fceaf24a HJ |
530 | return ret; |
531 | } | |
532 | ||
5fa9d3c5 HZ |
533 | static void netvsc_send_recv_completion(struct hv_device *device, |
534 | u64 transaction_id) | |
535 | { | |
536 | struct nvsp_message recvcompMessage; | |
537 | int retries = 0; | |
538 | int ret; | |
2ddd5e5f S |
539 | struct net_device *ndev; |
540 | struct netvsc_device *net_device = hv_get_drvdata(device); | |
541 | ||
542 | ndev = net_device->ndev; | |
5fa9d3c5 HZ |
543 | |
544 | recvcompMessage.hdr.msg_type = | |
545 | NVSP_MSG1_TYPE_SEND_RNDIS_PKT_COMPLETE; | |
546 | ||
547 | /* FIXME: Pass in the status */ | |
548 | recvcompMessage.msg.v1_msg.send_rndis_pkt_complete.status = | |
549 | NVSP_STAT_SUCCESS; | |
550 | ||
551 | retry_send_cmplt: | |
552 | /* Send the completion */ | |
553 | ret = vmbus_sendpacket(device->channel, &recvcompMessage, | |
554 | sizeof(struct nvsp_message), transaction_id, | |
555 | VM_PKT_COMP, 0); | |
556 | if (ret == 0) { | |
557 | /* success */ | |
558 | /* no-op */ | |
d2598f01 | 559 | } else if (ret == -EAGAIN) { |
5fa9d3c5 HZ |
560 | /* no more room...wait a bit and attempt to retry 3 times */ |
561 | retries++; | |
d9871158 | 562 | netdev_err(ndev, "unable to send receive completion pkt" |
c909ebbd | 563 | " (tid %llx)...retrying %d\n", transaction_id, retries); |
5fa9d3c5 HZ |
564 | |
565 | if (retries < 4) { | |
566 | udelay(100); | |
567 | goto retry_send_cmplt; | |
568 | } else { | |
d9871158 | 569 | netdev_err(ndev, "unable to send receive " |
c909ebbd | 570 | "completion pkt (tid %llx)...give up retrying\n", |
5fa9d3c5 HZ |
571 | transaction_id); |
572 | } | |
573 | } else { | |
d9871158 | 574 | netdev_err(ndev, "unable to send receive " |
c909ebbd | 575 | "completion pkt - %llx\n", transaction_id); |
5fa9d3c5 HZ |
576 | } |
577 | } | |
578 | ||
57991156 HZ |
579 | /* Send a receive completion packet to RNDIS device (ie NetVsp) */ |
580 | static void netvsc_receive_completion(void *context) | |
581 | { | |
582 | struct hv_netvsc_packet *packet = context; | |
583 | struct hv_device *device = (struct hv_device *)packet->device; | |
584 | struct netvsc_device *net_device; | |
585 | u64 transaction_id = 0; | |
586 | bool fsend_receive_comp = false; | |
587 | unsigned long flags; | |
2ddd5e5f | 588 | struct net_device *ndev; |
57991156 HZ |
589 | |
590 | /* | |
591 | * Even though it seems logical to do a GetOutboundNetDevice() here to | |
592 | * send out receive completion, we are using GetInboundNetDevice() | |
593 | * since we may have disable outbound traffic already. | |
594 | */ | |
595 | net_device = get_inbound_net_device(device); | |
2ddd5e5f | 596 | if (!net_device) |
57991156 | 597 | return; |
2ddd5e5f | 598 | ndev = net_device->ndev; |
57991156 HZ |
599 | |
600 | /* Overloading use of the lock. */ | |
601 | spin_lock_irqsave(&net_device->recv_pkt_list_lock, flags); | |
602 | ||
603 | packet->xfer_page_pkt->count--; | |
604 | ||
605 | /* | |
606 | * Last one in the line that represent 1 xfer page packet. | |
607 | * Return the xfer page packet itself to the freelist | |
608 | */ | |
609 | if (packet->xfer_page_pkt->count == 0) { | |
610 | fsend_receive_comp = true; | |
611 | transaction_id = packet->completion.recv.recv_completion_tid; | |
612 | list_add_tail(&packet->xfer_page_pkt->list_ent, | |
613 | &net_device->recv_pkt_list); | |
614 | ||
615 | } | |
616 | ||
617 | /* Put the packet back */ | |
618 | list_add_tail(&packet->list_ent, &net_device->recv_pkt_list); | |
619 | spin_unlock_irqrestore(&net_device->recv_pkt_list_lock, flags); | |
620 | ||
621 | /* Send a receive completion for the xfer page packet */ | |
622 | if (fsend_receive_comp) | |
623 | netvsc_send_recv_completion(device, transaction_id); | |
624 | ||
57991156 HZ |
625 | } |
626 | ||
5a71ae30 | 627 | static void netvsc_receive(struct hv_device *device, |
85799a37 | 628 | struct vmpacket_descriptor *packet) |
fceaf24a | 629 | { |
85799a37 HZ |
630 | struct netvsc_device *net_device; |
631 | struct vmtransfer_page_packet_header *vmxferpage_packet; | |
632 | struct nvsp_message *nvsp_packet; | |
633 | struct hv_netvsc_packet *netvsc_packet = NULL; | |
7e23a6e9 | 634 | /* struct netvsc_driver *netvscDriver; */ |
85799a37 | 635 | struct xferpage_packet *xferpage_packet = NULL; |
45326342 HZ |
636 | int i; |
637 | int count = 0; | |
6436873a | 638 | unsigned long flags; |
2ddd5e5f | 639 | struct net_device *ndev; |
779b4d17 | 640 | |
d29274ef | 641 | LIST_HEAD(listHead); |
fceaf24a | 642 | |
5a71ae30 | 643 | net_device = get_inbound_net_device(device); |
2ddd5e5f | 644 | if (!net_device) |
fceaf24a | 645 | return; |
2ddd5e5f | 646 | ndev = net_device->ndev; |
fceaf24a | 647 | |
21a80820 GKH |
648 | /* |
649 | * All inbound packets other than send completion should be xfer page | |
650 | * packet | |
651 | */ | |
415f2287 | 652 | if (packet->type != VM_PKT_DATA_USING_XFER_PAGES) { |
d9871158 | 653 | netdev_err(ndev, "Unknown packet type received - %d\n", |
415f2287 | 654 | packet->type); |
fceaf24a HJ |
655 | return; |
656 | } | |
657 | ||
85799a37 | 658 | nvsp_packet = (struct nvsp_message *)((unsigned long)packet + |
415f2287 | 659 | (packet->offset8 << 3)); |
fceaf24a | 660 | |
454f18a9 | 661 | /* Make sure this is a valid nvsp packet */ |
53d21fdb HZ |
662 | if (nvsp_packet->hdr.msg_type != |
663 | NVSP_MSG1_TYPE_SEND_RNDIS_PKT) { | |
d9871158 | 664 | netdev_err(ndev, "Unknown nvsp packet type received-" |
c909ebbd | 665 | " %d\n", nvsp_packet->hdr.msg_type); |
fceaf24a HJ |
666 | return; |
667 | } | |
668 | ||
85799a37 | 669 | vmxferpage_packet = (struct vmtransfer_page_packet_header *)packet; |
fceaf24a | 670 | |
415f2287 | 671 | if (vmxferpage_packet->xfer_pageset_id != NETVSC_RECEIVE_BUFFER_ID) { |
d9871158 | 672 | netdev_err(ndev, "Invalid xfer page set id - " |
c909ebbd | 673 | "expecting %x got %x\n", NETVSC_RECEIVE_BUFFER_ID, |
415f2287 | 674 | vmxferpage_packet->xfer_pageset_id); |
fceaf24a HJ |
675 | return; |
676 | } | |
677 | ||
454f18a9 BP |
678 | /* |
679 | * Grab free packets (range count + 1) to represent this xfer | |
680 | * page packet. +1 to represent the xfer page packet itself. | |
681 | * We grab it here so that we know exactly how many we can | |
682 | * fulfil | |
683 | */ | |
53d21fdb HZ |
684 | spin_lock_irqsave(&net_device->recv_pkt_list_lock, flags); |
685 | while (!list_empty(&net_device->recv_pkt_list)) { | |
686 | list_move_tail(net_device->recv_pkt_list.next, &listHead); | |
415f2287 | 687 | if (++count == vmxferpage_packet->range_cnt + 1) |
fceaf24a HJ |
688 | break; |
689 | } | |
53d21fdb | 690 | spin_unlock_irqrestore(&net_device->recv_pkt_list_lock, flags); |
fceaf24a | 691 | |
454f18a9 BP |
692 | /* |
693 | * We need at least 2 netvsc pkts (1 to represent the xfer | |
694 | * page and at least 1 for the range) i.e. we can handled | |
695 | * some of the xfer page packet ranges... | |
696 | */ | |
21a80820 | 697 | if (count < 2) { |
d9871158 | 698 | netdev_err(ndev, "Got only %d netvsc pkt...needed " |
c909ebbd | 699 | "%d pkts. Dropping this xfer page packet completely!\n", |
eb335bc4 | 700 | count, vmxferpage_packet->range_cnt + 1); |
fceaf24a | 701 | |
454f18a9 | 702 | /* Return it to the freelist */ |
53d21fdb | 703 | spin_lock_irqsave(&net_device->recv_pkt_list_lock, flags); |
21a80820 | 704 | for (i = count; i != 0; i--) { |
92ec0893 | 705 | list_move_tail(listHead.next, |
53d21fdb | 706 | &net_device->recv_pkt_list); |
fceaf24a | 707 | } |
53d21fdb | 708 | spin_unlock_irqrestore(&net_device->recv_pkt_list_lock, |
21a80820 | 709 | flags); |
fceaf24a | 710 | |
5a71ae30 | 711 | netvsc_send_recv_completion(device, |
415f2287 | 712 | vmxferpage_packet->d.trans_id); |
fceaf24a | 713 | |
fceaf24a HJ |
714 | return; |
715 | } | |
716 | ||
454f18a9 | 717 | /* Remove the 1st packet to represent the xfer page packet itself */ |
85799a37 | 718 | xferpage_packet = (struct xferpage_packet *)listHead.next; |
72a2f5bd | 719 | list_del(&xferpage_packet->list_ent); |
d29274ef | 720 | |
21a80820 | 721 | /* This is how much we can satisfy */ |
72a2f5bd | 722 | xferpage_packet->count = count - 1; |
21a80820 | 723 | |
415f2287 | 724 | if (xferpage_packet->count != vmxferpage_packet->range_cnt) { |
8bff33ab | 725 | netdev_err(ndev, "Needed %d netvsc pkts to satisfy " |
c909ebbd | 726 | "this xfer page...got %d\n", |
eb335bc4 | 727 | vmxferpage_packet->range_cnt, xferpage_packet->count); |
fceaf24a HJ |
728 | } |
729 | ||
454f18a9 | 730 | /* Each range represents 1 RNDIS pkt that contains 1 ethernet frame */ |
21a80820 | 731 | for (i = 0; i < (count - 1); i++) { |
85799a37 | 732 | netvsc_packet = (struct hv_netvsc_packet *)listHead.next; |
72a2f5bd | 733 | list_del(&netvsc_packet->list_ent); |
fceaf24a | 734 | |
454f18a9 | 735 | /* Initialize the netvsc packet */ |
72a2f5bd HZ |
736 | netvsc_packet->xfer_page_pkt = xferpage_packet; |
737 | netvsc_packet->completion.recv.recv_completion = | |
5a71ae30 | 738 | netvsc_receive_completion; |
72a2f5bd | 739 | netvsc_packet->completion.recv.recv_completion_ctx = |
85799a37 | 740 | netvsc_packet; |
72a2f5bd | 741 | netvsc_packet->device = device; |
21a80820 | 742 | /* Save this so that we can send it back */ |
72a2f5bd | 743 | netvsc_packet->completion.recv.recv_completion_tid = |
415f2287 | 744 | vmxferpage_packet->d.trans_id; |
fceaf24a | 745 | |
45326342 HZ |
746 | netvsc_packet->data = (void *)((unsigned long)net_device-> |
747 | recv_buf + vmxferpage_packet->ranges[i].byte_offset); | |
72a2f5bd | 748 | netvsc_packet->total_data_buflen = |
415f2287 | 749 | vmxferpage_packet->ranges[i].byte_count; |
fceaf24a | 750 | |
454f18a9 | 751 | /* Pass it to the upper layer */ |
ac6f7859 | 752 | rndis_filter_receive(device, netvsc_packet); |
fceaf24a | 753 | |
5a71ae30 | 754 | netvsc_receive_completion(netvsc_packet-> |
72a2f5bd | 755 | completion.recv.recv_completion_ctx); |
fceaf24a HJ |
756 | } |
757 | ||
fceaf24a HJ |
758 | } |
759 | ||
5a71ae30 | 760 | static void netvsc_channel_cb(void *context) |
fceaf24a | 761 | { |
21a80820 | 762 | int ret; |
85799a37 HZ |
763 | struct hv_device *device = context; |
764 | struct netvsc_device *net_device; | |
765 | u32 bytes_recvd; | |
766 | u64 request_id; | |
c6fcf0ba | 767 | unsigned char *packet; |
8dc0a06a | 768 | struct vmpacket_descriptor *desc; |
c6fcf0ba BP |
769 | unsigned char *buffer; |
770 | int bufferlen = NETVSC_PACKET_SIZE; | |
2ddd5e5f | 771 | struct net_device *ndev; |
fceaf24a | 772 | |
c6fcf0ba | 773 | packet = kzalloc(NETVSC_PACKET_SIZE * sizeof(unsigned char), |
d70c6731 | 774 | GFP_ATOMIC); |
c6fcf0ba BP |
775 | if (!packet) |
776 | return; | |
777 | buffer = packet; | |
778 | ||
5a71ae30 | 779 | net_device = get_inbound_net_device(device); |
2ddd5e5f | 780 | if (!net_device) |
c6fcf0ba | 781 | goto out; |
2ddd5e5f | 782 | ndev = net_device->ndev; |
fceaf24a | 783 | |
21a80820 | 784 | do { |
9f630068 | 785 | ret = vmbus_recvpacket_raw(device->channel, buffer, bufferlen, |
85799a37 | 786 | &bytes_recvd, &request_id); |
21a80820 | 787 | if (ret == 0) { |
85799a37 | 788 | if (bytes_recvd > 0) { |
21a80820 | 789 | desc = (struct vmpacket_descriptor *)buffer; |
415f2287 HZ |
790 | switch (desc->type) { |
791 | case VM_PKT_COMP: | |
5a71ae30 | 792 | netvsc_send_completion(device, desc); |
21a80820 GKH |
793 | break; |
794 | ||
415f2287 | 795 | case VM_PKT_DATA_USING_XFER_PAGES: |
5a71ae30 | 796 | netvsc_receive(device, desc); |
21a80820 GKH |
797 | break; |
798 | ||
799 | default: | |
d9871158 | 800 | netdev_err(ndev, |
21a80820 GKH |
801 | "unhandled packet type %d, " |
802 | "tid %llx len %d\n", | |
415f2287 | 803 | desc->type, request_id, |
85799a37 | 804 | bytes_recvd); |
21a80820 | 805 | break; |
fceaf24a HJ |
806 | } |
807 | ||
454f18a9 | 808 | /* reset */ |
c6fcf0ba | 809 | if (bufferlen > NETVSC_PACKET_SIZE) { |
8c69f52a | 810 | kfree(buffer); |
fceaf24a | 811 | buffer = packet; |
c6fcf0ba | 812 | bufferlen = NETVSC_PACKET_SIZE; |
fceaf24a | 813 | } |
21a80820 | 814 | } else { |
454f18a9 | 815 | /* reset */ |
c6fcf0ba | 816 | if (bufferlen > NETVSC_PACKET_SIZE) { |
8c69f52a | 817 | kfree(buffer); |
fceaf24a | 818 | buffer = packet; |
c6fcf0ba | 819 | bufferlen = NETVSC_PACKET_SIZE; |
fceaf24a HJ |
820 | } |
821 | ||
822 | break; | |
823 | } | |
3d5cad97 | 824 | } else if (ret == -ENOBUFS) { |
21a80820 | 825 | /* Handle large packet */ |
85799a37 | 826 | buffer = kmalloc(bytes_recvd, GFP_ATOMIC); |
21a80820 | 827 | if (buffer == NULL) { |
454f18a9 | 828 | /* Try again next time around */ |
d9871158 | 829 | netdev_err(ndev, |
21a80820 | 830 | "unable to allocate buffer of size " |
c909ebbd | 831 | "(%d)!!\n", bytes_recvd); |
fceaf24a HJ |
832 | break; |
833 | } | |
834 | ||
85799a37 | 835 | bufferlen = bytes_recvd; |
fceaf24a HJ |
836 | } |
837 | } while (1); | |
838 | ||
c6fcf0ba BP |
839 | out: |
840 | kfree(buffer); | |
fceaf24a HJ |
841 | return; |
842 | } | |
af24ce42 | 843 | |
b637e023 HZ |
844 | /* |
845 | * netvsc_device_add - Callback when the device belonging to this | |
846 | * driver is added | |
847 | */ | |
7bd23a4d | 848 | int netvsc_device_add(struct hv_device *device, void *additional_info) |
b637e023 HZ |
849 | { |
850 | int ret = 0; | |
851 | int i; | |
aae23986 S |
852 | int ring_size = |
853 | ((struct netvsc_device_info *)additional_info)->ring_size; | |
b637e023 HZ |
854 | struct netvsc_device *net_device; |
855 | struct hv_netvsc_packet *packet, *pos; | |
2ddd5e5f | 856 | struct net_device *ndev; |
b637e023 HZ |
857 | |
858 | net_device = alloc_net_device(device); | |
859 | if (!net_device) { | |
ace163a8 | 860 | ret = -ENOMEM; |
b637e023 HZ |
861 | goto cleanup; |
862 | } | |
863 | ||
2ddd5e5f S |
864 | /* |
865 | * Coming into this function, struct net_device * is | |
866 | * registered as the driver private data. | |
867 | * In alloc_net_device(), we register struct netvsc_device * | |
868 | * as the driver private data and stash away struct net_device * | |
869 | * in struct netvsc_device *. | |
870 | */ | |
871 | ndev = net_device->ndev; | |
872 | ||
b637e023 HZ |
873 | /* Initialize the NetVSC channel extension */ |
874 | net_device->recv_buf_size = NETVSC_RECEIVE_BUFFER_SIZE; | |
875 | spin_lock_init(&net_device->recv_pkt_list_lock); | |
876 | ||
b637e023 HZ |
877 | INIT_LIST_HEAD(&net_device->recv_pkt_list); |
878 | ||
879 | for (i = 0; i < NETVSC_RECEIVE_PACKETLIST_COUNT; i++) { | |
880 | packet = kzalloc(sizeof(struct hv_netvsc_packet) + | |
881 | (NETVSC_RECEIVE_SG_COUNT * | |
882 | sizeof(struct hv_page_buffer)), GFP_KERNEL); | |
883 | if (!packet) | |
884 | break; | |
885 | ||
886 | list_add_tail(&packet->list_ent, | |
887 | &net_device->recv_pkt_list); | |
888 | } | |
35abb21a | 889 | init_completion(&net_device->channel_init_wait); |
b637e023 HZ |
890 | |
891 | /* Open the channel */ | |
aae23986 S |
892 | ret = vmbus_open(device->channel, ring_size * PAGE_SIZE, |
893 | ring_size * PAGE_SIZE, NULL, 0, | |
b637e023 HZ |
894 | netvsc_channel_cb, device); |
895 | ||
896 | if (ret != 0) { | |
d9871158 | 897 | netdev_err(ndev, "unable to open channel: %d\n", ret); |
b637e023 HZ |
898 | goto cleanup; |
899 | } | |
900 | ||
901 | /* Channel is opened */ | |
c909ebbd | 902 | pr_info("hv_netvsc channel opened successfully\n"); |
b637e023 HZ |
903 | |
904 | /* Connect with the NetVsp */ | |
905 | ret = netvsc_connect_vsp(device); | |
906 | if (ret != 0) { | |
d9871158 | 907 | netdev_err(ndev, |
c909ebbd | 908 | "unable to connect to NetVSP - %d\n", ret); |
b637e023 HZ |
909 | goto close; |
910 | } | |
911 | ||
912 | return ret; | |
913 | ||
914 | close: | |
915 | /* Now, we can close the channel safely */ | |
916 | vmbus_close(device->channel); | |
917 | ||
918 | cleanup: | |
919 | ||
920 | if (net_device) { | |
921 | list_for_each_entry_safe(packet, pos, | |
922 | &net_device->recv_pkt_list, | |
923 | list_ent) { | |
924 | list_del(&packet->list_ent); | |
925 | kfree(packet); | |
926 | } | |
927 | ||
356c4657 | 928 | kfree(net_device); |
b637e023 HZ |
929 | } |
930 | ||
931 | return ret; | |
932 | } |