bde8106c5012dd95b9875955175ae38565dcdd48
[vpp.git] / vnet / vnet / devices / virtio / vhost-user.c
1 /*
2  *------------------------------------------------------------------
3  * vhost.c - vhost-user
4  *
5  * Copyright (c) 2014 Cisco and/or its affiliates.
6  * Licensed under the Apache License, Version 2.0 (the "License");
7  * you may not use this file except in compliance with the License.
8  * You may obtain a copy of the License at:
9  *
10  *     http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing, software
13  * distributed under the License is distributed on an "AS IS" BASIS,
14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15  * See the License for the specific language governing permissions and
16  * limitations under the License.
17  *------------------------------------------------------------------
18  */
19
20 #include <fcntl.h>              /* for open */
21 #include <sys/ioctl.h>
22 #include <sys/socket.h>
23 #include <sys/un.h>
24 #include <sys/stat.h>
25 #include <sys/types.h>
26 #include <sys/uio.h>            /* for iovec */
27 #include <netinet/in.h>
28 #include <sys/vfs.h>
29
30 #include <linux/if_arp.h>
31 #include <linux/if_tun.h>
32
33 #include <vlib/vlib.h>
34 #include <vlib/unix/unix.h>
35
36 #include <vnet/ip/ip.h>
37
38 #include <vnet/ethernet/ethernet.h>
39 #include <vnet/devices/devices.h>
40 #include <vnet/feature/feature.h>
41
42 #include <vnet/devices/virtio/vhost-user.h>
43
44 /**
45  * @file
46  * @brief vHost User Device Driver.
47  *
48  * This file contains the source code for vHost User interface.
49  */
50
51
52 #define VHOST_USER_DEBUG_SOCKET 0
53 #define VHOST_DEBUG_VQ 0
54
55 #if VHOST_USER_DEBUG_SOCKET == 1
56 #define DBG_SOCK(args...) clib_warning(args);
57 #else
58 #define DBG_SOCK(args...)
59 #endif
60
61 #if VHOST_DEBUG_VQ == 1
62 #define DBG_VQ(args...) clib_warning(args);
63 #else
64 #define DBG_VQ(args...)
65 #endif
66
67 /*
68  * When an RX queue is down but active, received packets
69  * must be discarded. This value controls up to how many
70  * packets will be discarded during each round.
71  */
72 #define VHOST_USER_DOWN_DISCARD_COUNT 256
73
74 /*
75  * When the number of available buffers gets under this threshold,
76  * RX node will start discarding packets.
77  */
78 #define VHOST_USER_RX_BUFFER_STARVATION 32
79
80 /*
81  * On the receive side, the host should free descriptors as soon
82  * as possible in order to avoid TX drop in the VM.
83  * This value controls the number of copy operations that are stacked
84  * before copy is done for all and descriptors are given back to
85  * the guest.
86  * The value 64 was obtained by testing (48 and 128 were not as good).
87  */
88 #define VHOST_USER_RX_COPY_THRESHOLD 64
89
90 #define UNIX_GET_FD(unixfd_idx) \
91     (unixfd_idx != ~0) ? \
92         pool_elt_at_index (unix_main.file_pool, \
93                            unixfd_idx)->file_descriptor : -1;
94
95 #define foreach_virtio_trace_flags \
96   _ (SIMPLE_CHAINED, 0, "Simple descriptor chaining") \
97   _ (SINGLE_DESC,  1, "Single descriptor packet") \
98   _ (INDIRECT, 2, "Indirect descriptor") \
99   _ (MAP_ERROR, 4, "Memory mapping error")
100
101 typedef enum
102 {
103 #define _(n,i,s) VIRTIO_TRACE_F_##n,
104   foreach_virtio_trace_flags
105 #undef _
106 } virtio_trace_flag_t;
107
108 vlib_node_registration_t vhost_user_input_node;
109
110 #define foreach_vhost_user_tx_func_error      \
111   _(NONE, "no error")  \
112   _(NOT_READY, "vhost vring not ready")  \
113   _(DOWN, "vhost interface is down")  \
114   _(PKT_DROP_NOBUF, "tx packet drops (no available descriptors)")  \
115   _(PKT_DROP_NOMRG, "tx packet drops (cannot merge descriptors)")  \
116   _(MMAP_FAIL, "mmap failure") \
117   _(INDIRECT_OVERFLOW, "indirect descriptor table overflow")
118
119 typedef enum
120 {
121 #define _(f,s) VHOST_USER_TX_FUNC_ERROR_##f,
122   foreach_vhost_user_tx_func_error
123 #undef _
124     VHOST_USER_TX_FUNC_N_ERROR,
125 } vhost_user_tx_func_error_t;
126
127 static char *vhost_user_tx_func_error_strings[] = {
128 #define _(n,s) s,
129   foreach_vhost_user_tx_func_error
130 #undef _
131 };
132
133 #define foreach_vhost_user_input_func_error      \
134   _(NO_ERROR, "no error")  \
135   _(NO_BUFFER, "no available buffer")  \
136   _(MMAP_FAIL, "mmap failure")  \
137   _(INDIRECT_OVERFLOW, "indirect descriptor overflows table")  \
138   _(UNDERSIZED_FRAME, "undersized ethernet frame received (< 14 bytes)") \
139   _(FULL_RX_QUEUE, "full rx queue (possible driver tx drop)")
140
141 typedef enum
142 {
143 #define _(f,s) VHOST_USER_INPUT_FUNC_ERROR_##f,
144   foreach_vhost_user_input_func_error
145 #undef _
146     VHOST_USER_INPUT_FUNC_N_ERROR,
147 } vhost_user_input_func_error_t;
148
149 static char *vhost_user_input_func_error_strings[] = {
150 #define _(n,s) s,
151   foreach_vhost_user_input_func_error
152 #undef _
153 };
154
155 /* *INDENT-OFF* */
156 static vhost_user_main_t vhost_user_main = {
157   .mtu_bytes = 1518,
158 };
159
160 VNET_HW_INTERFACE_CLASS (vhost_interface_class, static) = {
161   .name = "vhost-user",
162 };
163 /* *INDENT-ON* */
164
165 static u8 *
166 format_vhost_user_interface_name (u8 * s, va_list * args)
167 {
168   u32 i = va_arg (*args, u32);
169   u32 show_dev_instance = ~0;
170   vhost_user_main_t *vum = &vhost_user_main;
171
172   if (i < vec_len (vum->show_dev_instance_by_real_dev_instance))
173     show_dev_instance = vum->show_dev_instance_by_real_dev_instance[i];
174
175   if (show_dev_instance != ~0)
176     i = show_dev_instance;
177
178   s = format (s, "VirtualEthernet0/0/%d", i);
179   return s;
180 }
181
182 static int
183 vhost_user_name_renumber (vnet_hw_interface_t * hi, u32 new_dev_instance)
184 {
185   // FIXME: check if the new dev instance is already used
186   vhost_user_main_t *vum = &vhost_user_main;
187   vec_validate_init_empty (vum->show_dev_instance_by_real_dev_instance,
188                            hi->dev_instance, ~0);
189
190   vum->show_dev_instance_by_real_dev_instance[hi->dev_instance] =
191     new_dev_instance;
192
193   DBG_SOCK ("renumbered vhost-user interface dev_instance %d to %d",
194             hi->dev_instance, new_dev_instance);
195
196   return 0;
197 }
198
199 static_always_inline void *
200 map_guest_mem (vhost_user_intf_t * vui, uword addr, u32 * hint)
201 {
202   int i = *hint;
203   if (PREDICT_TRUE ((vui->regions[i].guest_phys_addr <= addr) &&
204                     ((vui->regions[i].guest_phys_addr +
205                       vui->regions[i].memory_size) > addr)))
206     {
207       return (void *) (vui->region_mmap_addr[i] + addr -
208                        vui->regions[i].guest_phys_addr);
209     }
210 #if __SSE4_2__
211   __m128i rl, rh, al, ah, r;
212   al = _mm_set1_epi64x (addr + 1);
213   ah = _mm_set1_epi64x (addr);
214
215   rl = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_lo[0]);
216   rl = _mm_cmpgt_epi64 (al, rl);
217   rh = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_hi[0]);
218   rh = _mm_cmpgt_epi64 (rh, ah);
219   r = _mm_and_si128 (rl, rh);
220
221   rl = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_lo[2]);
222   rl = _mm_cmpgt_epi64 (al, rl);
223   rh = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_hi[2]);
224   rh = _mm_cmpgt_epi64 (rh, ah);
225   r = _mm_blend_epi16 (r, _mm_and_si128 (rl, rh), 0x22);
226
227   rl = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_lo[4]);
228   rl = _mm_cmpgt_epi64 (al, rl);
229   rh = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_hi[4]);
230   rh = _mm_cmpgt_epi64 (rh, ah);
231   r = _mm_blend_epi16 (r, _mm_and_si128 (rl, rh), 0x44);
232
233   rl = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_lo[6]);
234   rl = _mm_cmpgt_epi64 (al, rl);
235   rh = _mm_loadu_si128 ((__m128i *) & vui->region_guest_addr_hi[6]);
236   rh = _mm_cmpgt_epi64 (rh, ah);
237   r = _mm_blend_epi16 (r, _mm_and_si128 (rl, rh), 0x88);
238
239   r = _mm_shuffle_epi8 (r, _mm_set_epi64x (0, 0x0e060c040a020800));
240   i = __builtin_ctzll (_mm_movemask_epi8 (r));
241
242   if (i < vui->nregions)
243     {
244       *hint = i;
245       return (void *) (vui->region_mmap_addr[i] + addr -
246                        vui->regions[i].guest_phys_addr);
247     }
248
249 #else
250   for (i = 0; i < vui->nregions; i++)
251     {
252       if ((vui->regions[i].guest_phys_addr <= addr) &&
253           ((vui->regions[i].guest_phys_addr + vui->regions[i].memory_size) >
254            addr))
255         {
256           *hint = i;
257           return (void *) (vui->region_mmap_addr[i] + addr -
258                            vui->regions[i].guest_phys_addr);
259         }
260     }
261 #endif
262   DBG_VQ ("failed to map guest mem addr %llx", addr);
263   *hint = 0;
264   return 0;
265 }
266
267 static inline void *
268 map_user_mem (vhost_user_intf_t * vui, uword addr)
269 {
270   int i;
271   for (i = 0; i < vui->nregions; i++)
272     {
273       if ((vui->regions[i].userspace_addr <= addr) &&
274           ((vui->regions[i].userspace_addr + vui->regions[i].memory_size) >
275            addr))
276         {
277           return (void *) (vui->region_mmap_addr[i] + addr -
278                            vui->regions[i].userspace_addr);
279         }
280     }
281   return 0;
282 }
283
284 static long
285 get_huge_page_size (int fd)
286 {
287   struct statfs s;
288   fstatfs (fd, &s);
289   return s.f_bsize;
290 }
291
292 static void
293 unmap_all_mem_regions (vhost_user_intf_t * vui)
294 {
295   int i, r;
296   for (i = 0; i < vui->nregions; i++)
297     {
298       if (vui->region_mmap_addr[i] != (void *) -1)
299         {
300
301           long page_sz = get_huge_page_size (vui->region_mmap_fd[i]);
302
303           ssize_t map_sz = (vui->regions[i].memory_size +
304                             vui->regions[i].mmap_offset +
305                             page_sz) & ~(page_sz - 1);
306
307           r =
308             munmap (vui->region_mmap_addr[i] - vui->regions[i].mmap_offset,
309                     map_sz);
310
311           DBG_SOCK
312             ("unmap memory region %d addr 0x%lx len 0x%lx page_sz 0x%x", i,
313              vui->region_mmap_addr[i], map_sz, page_sz);
314
315           vui->region_mmap_addr[i] = (void *) -1;
316
317           if (r == -1)
318             {
319               clib_warning ("failed to unmap memory region (errno %d)",
320                             errno);
321             }
322           close (vui->region_mmap_fd[i]);
323         }
324     }
325   vui->nregions = 0;
326 }
327
328 static void
329 vhost_user_tx_thread_placement (vhost_user_intf_t * vui)
330 {
331   //Let's try to assign one queue to each thread
332   u32 qid = 0;
333   u32 cpu_index = 0;
334   vui->use_tx_spinlock = 0;
335   while (1)
336     {
337       for (qid = 0; qid < VHOST_VRING_MAX_N / 2; qid++)
338         {
339           vhost_user_vring_t *rxvq = &vui->vrings[VHOST_VRING_IDX_RX (qid)];
340           if (!rxvq->started || !rxvq->enabled)
341             continue;
342
343           vui->per_cpu_tx_qid[cpu_index] = qid;
344           cpu_index++;
345           if (cpu_index == vlib_get_thread_main ()->n_vlib_mains)
346             return;
347         }
348       //We need to loop, meaning the spinlock has to be used
349       vui->use_tx_spinlock = 1;
350       if (cpu_index == 0)
351         {
352           //Could not find a single valid one
353           for (cpu_index = 0;
354                cpu_index < vlib_get_thread_main ()->n_vlib_mains; cpu_index++)
355             {
356               vui->per_cpu_tx_qid[cpu_index] = 0;
357             }
358           return;
359         }
360     }
361 }
362
363 static void
364 vhost_user_rx_thread_placement ()
365 {
366   vhost_user_main_t *vum = &vhost_user_main;
367   vhost_user_intf_t *vui;
368   vhost_cpu_t *vhc;
369   u32 *workers = 0;
370
371   //Let's list all workers cpu indexes
372   u32 i;
373   for (i = vum->input_cpu_first_index;
374        i < vum->input_cpu_first_index + vum->input_cpu_count; i++)
375     {
376       vlib_node_set_state (vlib_mains ? vlib_mains[i] : &vlib_global_main,
377                            vhost_user_input_node.index,
378                            VLIB_NODE_STATE_DISABLED);
379       vec_add1 (workers, i);
380     }
381
382   vec_foreach (vhc, vum->cpus)
383   {
384     vec_reset_length (vhc->rx_queues);
385   }
386
387   i = 0;
388   vhost_iface_and_queue_t iaq;
389   /* *INDENT-OFF* */
390   pool_foreach (vui, vum->vhost_user_interfaces, {
391       u32 *vui_workers = vec_len (vui->workers) ? vui->workers : workers;
392       u32 qid;
393       for (qid = 0; qid < VHOST_VRING_MAX_N / 2; qid++)
394         {
395           vhost_user_vring_t *txvq =
396               &vui->vrings[VHOST_VRING_IDX_TX (qid)];
397           if (!txvq->started)
398             continue;
399
400           i %= vec_len (vui_workers);
401           u32 cpu_index = vui_workers[i];
402           i++;
403           vhc = &vum->cpus[cpu_index];
404
405           iaq.qid = qid;
406           iaq.vhost_iface_index = vui - vum->vhost_user_interfaces;
407           vec_add1 (vhc->rx_queues, iaq);
408           vlib_node_set_state (vlib_mains ? vlib_mains[cpu_index] :
409               &vlib_global_main, vhost_user_input_node.index,
410               VLIB_NODE_STATE_POLLING);
411         }
412   });
413   /* *INDENT-ON* */
414 }
415
416 static int
417 vhost_user_thread_placement (u32 sw_if_index, u32 worker_thread_index, u8 del)
418 {
419   vhost_user_main_t *vum = &vhost_user_main;
420   vhost_user_intf_t *vui;
421   vnet_hw_interface_t *hw;
422
423   if (worker_thread_index < vum->input_cpu_first_index ||
424       worker_thread_index >=
425       vum->input_cpu_first_index + vum->input_cpu_count)
426     return -1;
427
428   if (!(hw = vnet_get_sup_hw_interface (vnet_get_main (), sw_if_index)))
429     return -2;
430
431   vui = pool_elt_at_index (vum->vhost_user_interfaces, hw->dev_instance);
432   u32 found = ~0, *w;
433   vec_foreach (w, vui->workers)
434   {
435     if (*w == worker_thread_index)
436       {
437         found = w - vui->workers;
438         break;
439       }
440   }
441
442   if (del)
443     {
444       if (found == ~0)
445         return -3;
446       vec_del1 (vui->workers, found);
447     }
448   else if (found == ~0)
449     {
450       vec_add1 (vui->workers, worker_thread_index);
451     }
452
453   vhost_user_rx_thread_placement ();
454   return 0;
455 }
456
457 /** @brief Returns whether at least one TX and one RX vring are enabled */
458 int
459 vhost_user_intf_ready (vhost_user_intf_t * vui)
460 {
461   int i, found[2] = { };        //RX + TX
462
463   for (i = 0; i < VHOST_VRING_MAX_N; i++)
464     if (vui->vrings[i].started && vui->vrings[i].enabled)
465       found[i & 1] = 1;
466
467   return found[0] && found[1];
468 }
469
470 static void
471 vhost_user_update_iface_state (vhost_user_intf_t * vui)
472 {
473   /* if we have pointers to descriptor table, go up */
474   int is_up = vhost_user_intf_ready (vui);
475   if (is_up != vui->is_up)
476     {
477       DBG_SOCK ("interface %d %s", vui->sw_if_index,
478                 is_up ? "ready" : "down");
479       vnet_hw_interface_set_flags (vnet_get_main (), vui->hw_if_index,
480                                    is_up ? VNET_HW_INTERFACE_FLAG_LINK_UP :
481                                    0);
482       vui->is_up = is_up;
483     }
484   vhost_user_rx_thread_placement ();
485   vhost_user_tx_thread_placement (vui);
486 }
487
488 static clib_error_t *
489 vhost_user_callfd_read_ready (unix_file_t * uf)
490 {
491   __attribute__ ((unused)) int n;
492   u8 buff[8];
493   n = read (uf->file_descriptor, ((char *) &buff), 8);
494   return 0;
495 }
496
497 static clib_error_t *
498 vhost_user_kickfd_read_ready (unix_file_t * uf)
499 {
500   __attribute__ ((unused)) int n;
501   u8 buff[8];
502   vhost_user_intf_t *vui =
503     pool_elt_at_index (vhost_user_main.vhost_user_interfaces,
504                        uf->private_data >> 8);
505   u32 qid = uf->private_data & 0xff;
506   n = read (uf->file_descriptor, ((char *) &buff), 8);
507   DBG_SOCK ("if %d KICK queue %d", uf->private_data >> 8, qid);
508
509   vlib_worker_thread_barrier_sync (vlib_get_main ());
510   vui->vrings[qid].started = 1;
511   vhost_user_update_iface_state (vui);
512   vlib_worker_thread_barrier_release (vlib_get_main ());
513   return 0;
514 }
515
516 /**
517  * @brief Try once to lock the vring
518  * @return 0 on success, non-zero on failure.
519  */
520 static inline int
521 vhost_user_vring_try_lock (vhost_user_intf_t * vui, u32 qid)
522 {
523   return __sync_lock_test_and_set (vui->vring_locks[qid], 1);
524 }
525
526 /**
527  * @brief Spin until the vring is successfully locked
528  */
529 static inline void
530 vhost_user_vring_lock (vhost_user_intf_t * vui, u32 qid)
531 {
532   while (vhost_user_vring_try_lock (vui, qid))
533     ;
534 }
535
536 /**
537  * @brief Unlock the vring lock
538  */
539 static inline void
540 vhost_user_vring_unlock (vhost_user_intf_t * vui, u32 qid)
541 {
542   *vui->vring_locks[qid] = 0;
543 }
544
545 static inline void
546 vhost_user_vring_init (vhost_user_intf_t * vui, u32 qid)
547 {
548   vhost_user_vring_t *vring = &vui->vrings[qid];
549   memset (vring, 0, sizeof (*vring));
550   vring->kickfd_idx = ~0;
551   vring->callfd_idx = ~0;
552   vring->errfd = -1;
553
554   /*
555    * We have a bug with some qemu 2.5, and this may be a fix.
556    * Feel like interpretation holy text, but this is from vhost-user.txt.
557    * "
558    * One queue pair is enabled initially. More queues are enabled
559    * dynamically, by sending message VHOST_USER_SET_VRING_ENABLE.
560    * "
561    * Don't know who's right, but this is what DPDK does.
562    */
563   if (qid == 0 || qid == 1)
564     vring->enabled = 1;
565 }
566
567 static inline void
568 vhost_user_vring_close (vhost_user_intf_t * vui, u32 qid)
569 {
570   vhost_user_vring_t *vring = &vui->vrings[qid];
571   if (vring->kickfd_idx != ~0)
572     {
573       unix_file_t *uf = pool_elt_at_index (unix_main.file_pool,
574                                            vring->kickfd_idx);
575       unix_file_del (&unix_main, uf);
576       vring->kickfd_idx = ~0;
577     }
578   if (vring->callfd_idx != ~0)
579     {
580       unix_file_t *uf = pool_elt_at_index (unix_main.file_pool,
581                                            vring->callfd_idx);
582       unix_file_del (&unix_main, uf);
583       vring->callfd_idx = ~0;
584     }
585   if (vring->errfd != -1)
586     close (vring->errfd);
587   vhost_user_vring_init (vui, qid);
588 }
589
590 static inline void
591 vhost_user_if_disconnect (vhost_user_intf_t * vui)
592 {
593   vnet_main_t *vnm = vnet_get_main ();
594   int q;
595
596   vnet_hw_interface_set_flags (vnm, vui->hw_if_index, 0);
597
598   if (vui->unix_file_index != ~0)
599     {
600       unix_file_del (&unix_main, unix_main.file_pool + vui->unix_file_index);
601       vui->unix_file_index = ~0;
602     }
603
604   vui->is_up = 0;
605
606   for (q = 0; q < VHOST_VRING_MAX_N; q++)
607     vhost_user_vring_close (vui, q);
608
609   unmap_all_mem_regions (vui);
610   DBG_SOCK ("interface ifindex %d disconnected", vui->sw_if_index);
611 }
612
613 #define VHOST_LOG_PAGE 0x1000
614 static_always_inline void
615 vhost_user_log_dirty_pages_2 (vhost_user_intf_t * vui,
616                               u64 addr, u64 len, u8 is_host_address)
617 {
618   if (PREDICT_TRUE (vui->log_base_addr == 0
619                     || !(vui->features & (1 << FEAT_VHOST_F_LOG_ALL))))
620     {
621       return;
622     }
623   if (is_host_address)
624     {
625       addr = (u64) map_user_mem (vui, (uword) addr);
626     }
627   if (PREDICT_FALSE ((addr + len - 1) / VHOST_LOG_PAGE / 8 >= vui->log_size))
628     {
629       DBG_SOCK ("vhost_user_log_dirty_pages(): out of range\n");
630       return;
631     }
632
633   CLIB_MEMORY_BARRIER ();
634   u64 page = addr / VHOST_LOG_PAGE;
635   while (page * VHOST_LOG_PAGE < addr + len)
636     {
637       ((u8 *) vui->log_base_addr)[page / 8] |= 1 << page % 8;
638       page++;
639     }
640 }
641
642 static_always_inline void
643 vhost_user_log_dirty_pages (vhost_user_intf_t * vui, u64 addr, u64 len)
644 {
645   vhost_user_log_dirty_pages_2 (vui, addr, len, 0);
646 }
647
648 #define vhost_user_log_dirty_ring(vui, vq, member) \
649   if (PREDICT_FALSE(vq->log_used)) { \
650     vhost_user_log_dirty_pages(vui, vq->log_guest_addr + STRUCT_OFFSET_OF(vring_used_t, member), \
651                              sizeof(vq->used->member)); \
652   }
653
654 static clib_error_t *
655 vhost_user_socket_read (unix_file_t * uf)
656 {
657   int n, i;
658   int fd, number_of_fds = 0;
659   int fds[VHOST_MEMORY_MAX_NREGIONS];
660   vhost_user_msg_t msg;
661   struct msghdr mh;
662   struct iovec iov[1];
663   vhost_user_main_t *vum = &vhost_user_main;
664   vhost_user_intf_t *vui;
665   struct cmsghdr *cmsg;
666   u8 q;
667   unix_file_t template = { 0 };
668   vnet_main_t *vnm = vnet_get_main ();
669
670   vui = pool_elt_at_index (vum->vhost_user_interfaces, uf->private_data);
671
672   char control[CMSG_SPACE (VHOST_MEMORY_MAX_NREGIONS * sizeof (int))];
673
674   memset (&mh, 0, sizeof (mh));
675   memset (control, 0, sizeof (control));
676
677   for (i = 0; i < VHOST_MEMORY_MAX_NREGIONS; i++)
678     fds[i] = -1;
679
680   /* set the payload */
681   iov[0].iov_base = (void *) &msg;
682   iov[0].iov_len = VHOST_USER_MSG_HDR_SZ;
683
684   mh.msg_iov = iov;
685   mh.msg_iovlen = 1;
686   mh.msg_control = control;
687   mh.msg_controllen = sizeof (control);
688
689   n = recvmsg (uf->file_descriptor, &mh, 0);
690
691   /* Stop workers to avoid end of the world */
692   vlib_worker_thread_barrier_sync (vlib_get_main ());
693
694   if (n != VHOST_USER_MSG_HDR_SZ)
695     {
696       if (n == -1)
697         {
698           DBG_SOCK ("recvmsg returned error %d %s", errno, strerror (errno));
699         }
700       else
701         {
702           DBG_SOCK ("n (%d) != VHOST_USER_MSG_HDR_SZ (%d)",
703                     n, VHOST_USER_MSG_HDR_SZ);
704         }
705       goto close_socket;
706     }
707
708   if (mh.msg_flags & MSG_CTRUNC)
709     {
710       DBG_SOCK ("MSG_CTRUNC is set");
711       goto close_socket;
712     }
713
714   cmsg = CMSG_FIRSTHDR (&mh);
715
716   if (cmsg && (cmsg->cmsg_len > 0) && (cmsg->cmsg_level == SOL_SOCKET) &&
717       (cmsg->cmsg_type == SCM_RIGHTS) &&
718       (cmsg->cmsg_len - CMSG_LEN (0) <=
719        VHOST_MEMORY_MAX_NREGIONS * sizeof (int)))
720     {
721       number_of_fds = (cmsg->cmsg_len - CMSG_LEN (0)) / sizeof (int);
722       clib_memcpy (fds, CMSG_DATA (cmsg), number_of_fds * sizeof (int));
723     }
724
725   /* version 1, no reply bit set */
726   if ((msg.flags & 7) != 1)
727     {
728       DBG_SOCK ("malformed message received. closing socket");
729       goto close_socket;
730     }
731
732   {
733     int rv;
734     rv =
735       read (uf->file_descriptor, ((char *) &msg) + VHOST_USER_MSG_HDR_SZ,
736             msg.size);
737     if (rv < 0)
738       {
739         DBG_SOCK ("read failed %s", strerror (errno));
740         goto close_socket;
741       }
742     else if (rv != msg.size)
743       {
744         DBG_SOCK ("message too short (read %dB should be %dB)", rv, msg.size);
745         goto close_socket;
746       }
747   }
748
749   switch (msg.request)
750     {
751     case VHOST_USER_GET_FEATURES:
752       msg.flags |= 4;
753       msg.u64 = (1ULL << FEAT_VIRTIO_NET_F_MRG_RXBUF) |
754         (1ULL << FEAT_VIRTIO_NET_F_CTRL_VQ) |
755         (1ULL << FEAT_VIRTIO_F_ANY_LAYOUT) |
756         (1ULL << FEAT_VIRTIO_F_INDIRECT_DESC) |
757         (1ULL << FEAT_VHOST_F_LOG_ALL) |
758         (1ULL << FEAT_VIRTIO_NET_F_GUEST_ANNOUNCE) |
759         (1ULL << FEAT_VIRTIO_NET_F_MQ) |
760         (1ULL << FEAT_VHOST_USER_F_PROTOCOL_FEATURES) |
761         (1ULL << FEAT_VIRTIO_F_VERSION_1);
762       msg.u64 &= vui->feature_mask;
763       msg.size = sizeof (msg.u64);
764       DBG_SOCK ("if %d msg VHOST_USER_GET_FEATURES - reply 0x%016llx",
765                 vui->hw_if_index, msg.u64);
766       break;
767
768     case VHOST_USER_SET_FEATURES:
769       DBG_SOCK ("if %d msg VHOST_USER_SET_FEATURES features 0x%016llx",
770                 vui->hw_if_index, msg.u64);
771
772       vui->features = msg.u64;
773
774       if (vui->features &
775           ((1 << FEAT_VIRTIO_NET_F_MRG_RXBUF) |
776            (1ULL << FEAT_VIRTIO_F_VERSION_1)))
777         vui->virtio_net_hdr_sz = 12;
778       else
779         vui->virtio_net_hdr_sz = 10;
780
781       vui->is_any_layout =
782         (vui->features & (1 << FEAT_VIRTIO_F_ANY_LAYOUT)) ? 1 : 0;
783
784       ASSERT (vui->virtio_net_hdr_sz < VLIB_BUFFER_PRE_DATA_SIZE);
785       vnet_hw_interface_set_flags (vnm, vui->hw_if_index, 0);
786       vui->is_up = 0;
787
788       /*for (q = 0; q < VHOST_VRING_MAX_N; q++)
789          vhost_user_vring_close(&vui->vrings[q]); */
790
791       break;
792
793     case VHOST_USER_SET_MEM_TABLE:
794       DBG_SOCK ("if %d msg VHOST_USER_SET_MEM_TABLE nregions %d",
795                 vui->hw_if_index, msg.memory.nregions);
796
797       if ((msg.memory.nregions < 1) ||
798           (msg.memory.nregions > VHOST_MEMORY_MAX_NREGIONS))
799         {
800
801           DBG_SOCK ("number of mem regions must be between 1 and %i",
802                     VHOST_MEMORY_MAX_NREGIONS);
803
804           goto close_socket;
805         }
806
807       if (msg.memory.nregions != number_of_fds)
808         {
809           DBG_SOCK ("each memory region must have FD");
810           goto close_socket;
811         }
812       unmap_all_mem_regions (vui);
813       for (i = 0; i < msg.memory.nregions; i++)
814         {
815           clib_memcpy (&(vui->regions[i]), &msg.memory.regions[i],
816                        sizeof (vhost_user_memory_region_t));
817
818           long page_sz = get_huge_page_size (fds[i]);
819
820           /* align size to 2M page */
821           ssize_t map_sz = (vui->regions[i].memory_size +
822                             vui->regions[i].mmap_offset +
823                             page_sz) & ~(page_sz - 1);
824
825           vui->region_mmap_addr[i] = mmap (0, map_sz, PROT_READ | PROT_WRITE,
826                                            MAP_SHARED, fds[i], 0);
827           vui->region_guest_addr_lo[i] = vui->regions[i].guest_phys_addr;
828           vui->region_guest_addr_hi[i] = vui->regions[i].guest_phys_addr +
829             vui->regions[i].memory_size;
830
831           DBG_SOCK
832             ("map memory region %d addr 0 len 0x%lx fd %d mapped 0x%lx "
833              "page_sz 0x%x", i, map_sz, fds[i], vui->region_mmap_addr[i],
834              page_sz);
835
836           if (vui->region_mmap_addr[i] == MAP_FAILED)
837             {
838               clib_warning ("failed to map memory. errno is %d", errno);
839               goto close_socket;
840             }
841           vui->region_mmap_addr[i] += vui->regions[i].mmap_offset;
842           vui->region_mmap_fd[i] = fds[i];
843         }
844       vui->nregions = msg.memory.nregions;
845       break;
846
847     case VHOST_USER_SET_VRING_NUM:
848       DBG_SOCK ("if %d msg VHOST_USER_SET_VRING_NUM idx %d num %d",
849                 vui->hw_if_index, msg.state.index, msg.state.num);
850
851       if ((msg.state.num > 32768) ||    /* maximum ring size is 32768 */
852           (msg.state.num == 0) ||       /* it cannot be zero */
853           ((msg.state.num - 1) & msg.state.num))        /* must be power of 2 */
854         goto close_socket;
855       vui->vrings[msg.state.index].qsz = msg.state.num;
856       break;
857
858     case VHOST_USER_SET_VRING_ADDR:
859       DBG_SOCK ("if %d msg VHOST_USER_SET_VRING_ADDR idx %d",
860                 vui->hw_if_index, msg.state.index);
861
862       if (msg.state.index >= VHOST_VRING_MAX_N)
863         {
864           DBG_SOCK ("invalid vring index VHOST_USER_SET_VRING_ADDR:"
865                     " %d >= %d", msg.state.index, VHOST_VRING_MAX_N);
866           goto close_socket;
867         }
868
869       if (msg.size < sizeof (msg.addr))
870         {
871           DBG_SOCK ("vhost message is too short (%d < %d)",
872                     msg.size, sizeof (msg.addr));
873           goto close_socket;
874         }
875
876       vui->vrings[msg.state.index].desc = (vring_desc_t *)
877         map_user_mem (vui, msg.addr.desc_user_addr);
878       vui->vrings[msg.state.index].used = (vring_used_t *)
879         map_user_mem (vui, msg.addr.used_user_addr);
880       vui->vrings[msg.state.index].avail = (vring_avail_t *)
881         map_user_mem (vui, msg.addr.avail_user_addr);
882
883       if ((vui->vrings[msg.state.index].desc == NULL) ||
884           (vui->vrings[msg.state.index].used == NULL) ||
885           (vui->vrings[msg.state.index].avail == NULL))
886         {
887           DBG_SOCK ("failed to map user memory for hw_if_index %d",
888                     vui->hw_if_index);
889           goto close_socket;
890         }
891
892       vui->vrings[msg.state.index].log_guest_addr = msg.addr.log_guest_addr;
893       vui->vrings[msg.state.index].log_used =
894         (msg.addr.flags & (1 << VHOST_VRING_F_LOG)) ? 1 : 0;
895
896       /* Spec says: If VHOST_USER_F_PROTOCOL_FEATURES has not been negotiated,
897          the ring is initialized in an enabled state. */
898       if (!(vui->features & (1 << FEAT_VHOST_USER_F_PROTOCOL_FEATURES)))
899         {
900           vui->vrings[msg.state.index].enabled = 1;
901         }
902
903       vui->vrings[msg.state.index].last_used_idx =
904         vui->vrings[msg.state.index].last_avail_idx =
905         vui->vrings[msg.state.index].used->idx;
906
907       /* tell driver that we don't want interrupts */
908       vui->vrings[msg.state.index].used->flags = VRING_USED_F_NO_NOTIFY;
909       break;
910
911     case VHOST_USER_SET_OWNER:
912       DBG_SOCK ("if %d msg VHOST_USER_SET_OWNER", vui->hw_if_index);
913       break;
914
915     case VHOST_USER_RESET_OWNER:
916       DBG_SOCK ("if %d msg VHOST_USER_RESET_OWNER", vui->hw_if_index);
917       break;
918
919     case VHOST_USER_SET_VRING_CALL:
920       DBG_SOCK ("if %d msg VHOST_USER_SET_VRING_CALL u64 %d",
921                 vui->hw_if_index, msg.u64);
922
923       q = (u8) (msg.u64 & 0xFF);
924
925       /* if there is old fd, delete and close it */
926       if (vui->vrings[q].callfd_idx != ~0)
927         {
928           unix_file_t *uf = pool_elt_at_index (unix_main.file_pool,
929                                                vui->vrings[q].callfd_idx);
930           unix_file_del (&unix_main, uf);
931           vui->vrings[q].callfd_idx = ~0;
932         }
933
934       if (!(msg.u64 & 0x100))
935         {
936           if (number_of_fds != 1)
937             {
938               DBG_SOCK ("More than one fd received !");
939               goto close_socket;
940             }
941
942           template.read_function = vhost_user_callfd_read_ready;
943           template.file_descriptor = fds[0];
944           template.private_data =
945             ((vui - vhost_user_main.vhost_user_interfaces) << 8) + q;
946           vui->vrings[q].callfd_idx = unix_file_add (&unix_main, &template);
947         }
948       else
949         vui->vrings[q].callfd_idx = ~0;
950       break;
951
952     case VHOST_USER_SET_VRING_KICK:
953       DBG_SOCK ("if %d msg VHOST_USER_SET_VRING_KICK u64 %d",
954                 vui->hw_if_index, msg.u64);
955
956       q = (u8) (msg.u64 & 0xFF);
957
958       if (vui->vrings[q].kickfd_idx != ~0)
959         {
960           unix_file_t *uf = pool_elt_at_index (unix_main.file_pool,
961                                                vui->vrings[q].kickfd_idx);
962           unix_file_del (&unix_main, uf);
963           vui->vrings[q].kickfd_idx = ~0;
964         }
965
966       if (!(msg.u64 & 0x100))
967         {
968           if (number_of_fds != 1)
969             {
970               DBG_SOCK ("More than one fd received !");
971               goto close_socket;
972             }
973
974           template.read_function = vhost_user_kickfd_read_ready;
975           template.file_descriptor = fds[0];
976           template.private_data =
977             (((uword) (vui - vhost_user_main.vhost_user_interfaces)) << 8) +
978             q;
979           vui->vrings[q].kickfd_idx = unix_file_add (&unix_main, &template);
980         }
981       else
982         {
983           //When no kickfd is set, the queue is initialized as started
984           vui->vrings[q].kickfd_idx = ~0;
985           vui->vrings[q].started = 1;
986         }
987
988       break;
989
990     case VHOST_USER_SET_VRING_ERR:
991       DBG_SOCK ("if %d msg VHOST_USER_SET_VRING_ERR u64 %d",
992                 vui->hw_if_index, msg.u64);
993
994       q = (u8) (msg.u64 & 0xFF);
995
996       if (vui->vrings[q].errfd != -1)
997         close (vui->vrings[q].errfd);
998
999       if (!(msg.u64 & 0x100))
1000         {
1001           if (number_of_fds != 1)
1002             goto close_socket;
1003
1004           vui->vrings[q].errfd = fds[0];
1005         }
1006       else
1007         vui->vrings[q].errfd = -1;
1008
1009       break;
1010
1011     case VHOST_USER_SET_VRING_BASE:
1012       DBG_SOCK ("if %d msg VHOST_USER_SET_VRING_BASE idx %d num %d",
1013                 vui->hw_if_index, msg.state.index, msg.state.num);
1014
1015       vui->vrings[msg.state.index].last_avail_idx = msg.state.num;
1016       break;
1017
1018     case VHOST_USER_GET_VRING_BASE:
1019       DBG_SOCK ("if %d msg VHOST_USER_GET_VRING_BASE idx %d num %d",
1020                 vui->hw_if_index, msg.state.index, msg.state.num);
1021
1022       if (msg.state.index >= VHOST_VRING_MAX_N)
1023         {
1024           DBG_SOCK ("invalid vring index VHOST_USER_GET_VRING_BASE:"
1025                     " %d >= %d", msg.state.index, VHOST_VRING_MAX_N);
1026           goto close_socket;
1027         }
1028
1029       /* Spec says: Client must [...] stop ring upon receiving VHOST_USER_GET_VRING_BASE. */
1030       vhost_user_vring_close (vui, msg.state.index);
1031
1032       msg.state.num = vui->vrings[msg.state.index].last_avail_idx;
1033       msg.flags |= 4;
1034       msg.size = sizeof (msg.state);
1035       break;
1036
1037     case VHOST_USER_NONE:
1038       DBG_SOCK ("if %d msg VHOST_USER_NONE", vui->hw_if_index);
1039
1040       break;
1041
1042     case VHOST_USER_SET_LOG_BASE:
1043       {
1044         DBG_SOCK ("if %d msg VHOST_USER_SET_LOG_BASE", vui->hw_if_index);
1045
1046         if (msg.size != sizeof (msg.log))
1047           {
1048             DBG_SOCK
1049               ("invalid msg size for VHOST_USER_SET_LOG_BASE: %d instead of %d",
1050                msg.size, sizeof (msg.log));
1051             goto close_socket;
1052           }
1053
1054         if (!
1055             (vui->protocol_features & (1 << VHOST_USER_PROTOCOL_F_LOG_SHMFD)))
1056           {
1057             DBG_SOCK
1058               ("VHOST_USER_PROTOCOL_F_LOG_SHMFD not set but VHOST_USER_SET_LOG_BASE received");
1059             goto close_socket;
1060           }
1061
1062         fd = fds[0];
1063         /* align size to 2M page */
1064         long page_sz = get_huge_page_size (fd);
1065         ssize_t map_sz =
1066           (msg.log.size + msg.log.offset + page_sz) & ~(page_sz - 1);
1067
1068         vui->log_base_addr = mmap (0, map_sz, PROT_READ | PROT_WRITE,
1069                                    MAP_SHARED, fd, 0);
1070
1071         DBG_SOCK
1072           ("map log region addr 0 len 0x%lx off 0x%lx fd %d mapped 0x%lx",
1073            map_sz, msg.log.offset, fd, vui->log_base_addr);
1074
1075         if (vui->log_base_addr == MAP_FAILED)
1076           {
1077             clib_warning ("failed to map memory. errno is %d", errno);
1078             goto close_socket;
1079           }
1080
1081         vui->log_base_addr += msg.log.offset;
1082         vui->log_size = msg.log.size;
1083
1084         msg.flags |= 4;
1085         msg.size = sizeof (msg.u64);
1086
1087         break;
1088       }
1089
1090     case VHOST_USER_SET_LOG_FD:
1091       DBG_SOCK ("if %d msg VHOST_USER_SET_LOG_FD", vui->hw_if_index);
1092
1093       break;
1094
1095     case VHOST_USER_GET_PROTOCOL_FEATURES:
1096       DBG_SOCK ("if %d msg VHOST_USER_GET_PROTOCOL_FEATURES",
1097                 vui->hw_if_index);
1098
1099       msg.flags |= 4;
1100       msg.u64 = (1 << VHOST_USER_PROTOCOL_F_LOG_SHMFD) |
1101         (1 << VHOST_USER_PROTOCOL_F_MQ);
1102       msg.size = sizeof (msg.u64);
1103       break;
1104
1105     case VHOST_USER_SET_PROTOCOL_FEATURES:
1106       DBG_SOCK ("if %d msg VHOST_USER_SET_PROTOCOL_FEATURES features 0x%lx",
1107                 vui->hw_if_index, msg.u64);
1108
1109       vui->protocol_features = msg.u64;
1110
1111       break;
1112
1113     case VHOST_USER_GET_QUEUE_NUM:
1114       DBG_SOCK ("if %d msg VHOST_USER_GET_QUEUE_NUM", vui->hw_if_index);
1115       msg.flags |= 4;
1116       msg.u64 = VHOST_VRING_MAX_N;
1117       msg.size = sizeof (msg.u64);
1118       break;
1119
1120     case VHOST_USER_SET_VRING_ENABLE:
1121       DBG_SOCK ("if %d VHOST_USER_SET_VRING_ENABLE: %s queue %d",
1122                 vui->hw_if_index, msg.state.num ? "enable" : "disable",
1123                 msg.state.index);
1124       if (msg.state.index >= VHOST_VRING_MAX_N)
1125         {
1126           DBG_SOCK ("invalid vring index VHOST_USER_SET_VRING_ENABLE:"
1127                     " %d >= %d", msg.state.index, VHOST_VRING_MAX_N);
1128           goto close_socket;
1129         }
1130
1131       vui->vrings[msg.state.index].enabled = msg.state.num;
1132       break;
1133
1134     default:
1135       DBG_SOCK ("unknown vhost-user message %d received. closing socket",
1136                 msg.request);
1137       goto close_socket;
1138     }
1139
1140   /* if we need to reply */
1141   if (msg.flags & 4)
1142     {
1143       n =
1144         send (uf->file_descriptor, &msg, VHOST_USER_MSG_HDR_SZ + msg.size, 0);
1145       if (n != (msg.size + VHOST_USER_MSG_HDR_SZ))
1146         {
1147           DBG_SOCK ("could not send message response");
1148           goto close_socket;
1149         }
1150     }
1151
1152   vhost_user_update_iface_state (vui);
1153   vlib_worker_thread_barrier_release (vlib_get_main ());
1154   return 0;
1155
1156 close_socket:
1157   vhost_user_if_disconnect (vui);
1158   vhost_user_update_iface_state (vui);
1159   vlib_worker_thread_barrier_release (vlib_get_main ());
1160   return 0;
1161 }
1162
1163 static clib_error_t *
1164 vhost_user_socket_error (unix_file_t * uf)
1165 {
1166   vlib_main_t *vm = vlib_get_main ();
1167   vhost_user_main_t *vum = &vhost_user_main;
1168   vhost_user_intf_t *vui =
1169     pool_elt_at_index (vum->vhost_user_interfaces, uf->private_data);
1170
1171   DBG_SOCK ("socket error on if %d", vui->sw_if_index);
1172   vlib_worker_thread_barrier_sync (vm);
1173   vhost_user_if_disconnect (vui);
1174   vhost_user_rx_thread_placement ();
1175   vlib_worker_thread_barrier_release (vm);
1176   return 0;
1177 }
1178
1179 static clib_error_t *
1180 vhost_user_socksvr_accept_ready (unix_file_t * uf)
1181 {
1182   int client_fd, client_len;
1183   struct sockaddr_un client;
1184   unix_file_t template = { 0 };
1185   vhost_user_main_t *vum = &vhost_user_main;
1186   vhost_user_intf_t *vui;
1187
1188   vui = pool_elt_at_index (vum->vhost_user_interfaces, uf->private_data);
1189
1190   client_len = sizeof (client);
1191   client_fd = accept (uf->file_descriptor,
1192                       (struct sockaddr *) &client,
1193                       (socklen_t *) & client_len);
1194
1195   if (client_fd < 0)
1196     return clib_error_return_unix (0, "accept");
1197
1198   DBG_SOCK ("New client socket for vhost interface %d", vui->sw_if_index);
1199   template.read_function = vhost_user_socket_read;
1200   template.error_function = vhost_user_socket_error;
1201   template.file_descriptor = client_fd;
1202   template.private_data = vui - vhost_user_main.vhost_user_interfaces;
1203   vui->unix_file_index = unix_file_add (&unix_main, &template);
1204   return 0;
1205 }
1206
1207 static clib_error_t *
1208 vhost_user_init (vlib_main_t * vm)
1209 {
1210   clib_error_t *error;
1211   vhost_user_main_t *vum = &vhost_user_main;
1212   vlib_thread_main_t *tm = vlib_get_thread_main ();
1213   vlib_thread_registration_t *tr;
1214   uword *p;
1215
1216   error = vlib_call_init_function (vm, ip4_init);
1217   if (error)
1218     return error;
1219
1220   vum->coalesce_frames = 32;
1221   vum->coalesce_time = 1e-3;
1222
1223   vec_validate (vum->cpus, tm->n_vlib_mains - 1);
1224
1225   vhost_cpu_t *cpu;
1226   vec_foreach (cpu, vum->cpus)
1227   {
1228     /* This is actually not necessary as validate already zeroes it
1229      * Just keeping the loop here for later because I am lazy. */
1230     cpu->rx_buffers_len = 0;
1231   }
1232
1233   /* find out which cpus will be used for input */
1234   vum->input_cpu_first_index = 0;
1235   vum->input_cpu_count = 1;
1236   p = hash_get_mem (tm->thread_registrations_by_name, "workers");
1237   tr = p ? (vlib_thread_registration_t *) p[0] : 0;
1238
1239   if (tr && tr->count > 0)
1240     {
1241       vum->input_cpu_first_index = tr->first_index;
1242       vum->input_cpu_count = tr->count;
1243     }
1244
1245   vum->random = random_default_seed ();
1246
1247   return 0;
1248 }
1249
1250 VLIB_INIT_FUNCTION (vhost_user_init);
1251
1252 static clib_error_t *
1253 vhost_user_exit (vlib_main_t * vm)
1254 {
1255   /* TODO cleanup */
1256   return 0;
1257 }
1258
1259 VLIB_MAIN_LOOP_EXIT_FUNCTION (vhost_user_exit);
1260
1261 static u8 *
1262 format_vhost_trace (u8 * s, va_list * va)
1263 {
1264   CLIB_UNUSED (vlib_main_t * vm) = va_arg (*va, vlib_main_t *);
1265   CLIB_UNUSED (vlib_node_t * node) = va_arg (*va, vlib_node_t *);
1266   CLIB_UNUSED (vnet_main_t * vnm) = vnet_get_main ();
1267   vhost_user_main_t *vum = &vhost_user_main;
1268   vhost_trace_t *t = va_arg (*va, vhost_trace_t *);
1269   vhost_user_intf_t *vui = pool_elt_at_index (vum->vhost_user_interfaces,
1270                                               t->device_index);
1271
1272   vnet_sw_interface_t *sw = vnet_get_sw_interface (vnm, vui->sw_if_index);
1273
1274   uword indent = format_get_indent (s);
1275
1276   s = format (s, "%U %U queue %d\n", format_white_space, indent,
1277               format_vnet_sw_interface_name, vnm, sw, t->qid);
1278
1279   s = format (s, "%U virtio flags:\n", format_white_space, indent);
1280 #define _(n,i,st) \
1281           if (t->virtio_ring_flags & (1 << VIRTIO_TRACE_F_##n)) \
1282             s = format (s, "%U  %s %s\n", format_white_space, indent, #n, st);
1283   foreach_virtio_trace_flags
1284 #undef _
1285     s = format (s, "%U virtio_net_hdr first_desc_len %u\n",
1286                 format_white_space, indent, t->first_desc_len);
1287
1288   s = format (s, "%U   flags 0x%02x gso_type %u\n",
1289               format_white_space, indent,
1290               t->hdr.hdr.flags, t->hdr.hdr.gso_type);
1291
1292   if (vui->virtio_net_hdr_sz == 12)
1293     s = format (s, "%U   num_buff %u",
1294                 format_white_space, indent, t->hdr.num_buffers);
1295
1296   return s;
1297 }
1298
1299 void
1300 vhost_user_rx_trace (vhost_trace_t * t,
1301                      vhost_user_intf_t * vui, u16 qid,
1302                      vlib_buffer_t * b, vhost_user_vring_t * txvq)
1303 {
1304   vhost_user_main_t *vum = &vhost_user_main;
1305   u32 qsz_mask = txvq->qsz - 1;
1306   u32 last_avail_idx = txvq->last_avail_idx;
1307   u32 desc_current = txvq->avail->ring[last_avail_idx & qsz_mask];
1308   vring_desc_t *hdr_desc = 0;
1309   virtio_net_hdr_mrg_rxbuf_t *hdr;
1310   u32 hint = 0;
1311
1312   memset (t, 0, sizeof (*t));
1313   t->device_index = vui - vum->vhost_user_interfaces;
1314   t->qid = qid;
1315
1316   hdr_desc = &txvq->desc[desc_current];
1317   if (txvq->desc[desc_current].flags & VIRTQ_DESC_F_INDIRECT)
1318     {
1319       t->virtio_ring_flags |= 1 << VIRTIO_TRACE_F_INDIRECT;
1320       /* Header is the first here */
1321       hdr_desc = map_guest_mem (vui, txvq->desc[desc_current].addr, &hint);
1322     }
1323   if (txvq->desc[desc_current].flags & VIRTQ_DESC_F_NEXT)
1324     {
1325       t->virtio_ring_flags |= 1 << VIRTIO_TRACE_F_SIMPLE_CHAINED;
1326     }
1327   if (!(txvq->desc[desc_current].flags & VIRTQ_DESC_F_NEXT) &&
1328       !(txvq->desc[desc_current].flags & VIRTQ_DESC_F_INDIRECT))
1329     {
1330       t->virtio_ring_flags |= 1 << VIRTIO_TRACE_F_SINGLE_DESC;
1331     }
1332
1333   t->first_desc_len = hdr_desc ? hdr_desc->len : 0;
1334
1335   if (!hdr_desc || !(hdr = map_guest_mem (vui, hdr_desc->addr, &hint)))
1336     {
1337       t->virtio_ring_flags |= 1 << VIRTIO_TRACE_F_MAP_ERROR;
1338     }
1339   else
1340     {
1341       u32 len = vui->virtio_net_hdr_sz;
1342       memcpy (&t->hdr, hdr, len > hdr_desc->len ? hdr_desc->len : len);
1343     }
1344 }
1345
1346 static inline void
1347 vhost_user_send_call (vlib_main_t * vm, vhost_user_vring_t * vq)
1348 {
1349   vhost_user_main_t *vum = &vhost_user_main;
1350   u64 x = 1;
1351   int fd = UNIX_GET_FD (vq->callfd_idx);
1352   int rv __attribute__ ((unused));
1353   /* TODO: pay attention to rv */
1354   rv = write (fd, &x, sizeof (x));
1355   vq->n_since_last_int = 0;
1356   vq->int_deadline = vlib_time_now (vm) + vum->coalesce_time;
1357 }
1358
1359 static_always_inline u32
1360 vhost_user_input_copy (vhost_user_intf_t * vui, vhost_copy_t * cpy,
1361                        u16 copy_len, u32 * map_hint)
1362 {
1363   void *src0, *src1, *src2, *src3;
1364   if (PREDICT_TRUE (copy_len >= 4))
1365     {
1366       if (PREDICT_FALSE (!(src2 = map_guest_mem (vui, cpy[0].src, map_hint))))
1367         return 1;
1368       if (PREDICT_FALSE (!(src3 = map_guest_mem (vui, cpy[1].src, map_hint))))
1369         return 1;
1370
1371       while (PREDICT_TRUE (copy_len >= 4))
1372         {
1373           src0 = src2;
1374           src1 = src3;
1375
1376           if (PREDICT_FALSE
1377               (!(src2 = map_guest_mem (vui, cpy[2].src, map_hint))))
1378             return 1;
1379           if (PREDICT_FALSE
1380               (!(src3 = map_guest_mem (vui, cpy[3].src, map_hint))))
1381             return 1;
1382
1383           CLIB_PREFETCH (src2, 64, LOAD);
1384           CLIB_PREFETCH (src3, 64, LOAD);
1385
1386           clib_memcpy ((void *) cpy[0].dst, src0, cpy[0].len);
1387           clib_memcpy ((void *) cpy[1].dst, src1, cpy[1].len);
1388           copy_len -= 2;
1389           cpy += 2;
1390         }
1391     }
1392   while (copy_len)
1393     {
1394       if (PREDICT_FALSE (!(src0 = map_guest_mem (vui, cpy->src, map_hint))))
1395         return 1;
1396       clib_memcpy ((void *) cpy->dst, src0, cpy->len);
1397       copy_len -= 1;
1398       cpy += 1;
1399     }
1400   return 0;
1401 }
1402
1403 /**
1404  * Try to discard packets from the tx ring (VPP RX path).
1405  * Returns the number of discarded packets.
1406  */
1407 u32
1408 vhost_user_rx_discard_packet (vlib_main_t * vm,
1409                               vhost_user_intf_t * vui,
1410                               vhost_user_vring_t * txvq, u32 discard_max)
1411 {
1412   /*
1413    * On the RX side, each packet corresponds to one descriptor
1414    * (it is the same whether it is a shallow descriptor, chained, or indirect).
1415    * Therefore, discarding a packet is like discarding a descriptor.
1416    */
1417   u32 discarded_packets = 0;
1418   u32 avail_idx = txvq->avail->idx;
1419   u16 qsz_mask = txvq->qsz - 1;
1420   while (discarded_packets != discard_max)
1421     {
1422       if (avail_idx == txvq->last_avail_idx)
1423         goto out;
1424
1425       u16 desc_chain_head =
1426         txvq->avail->ring[txvq->last_avail_idx & qsz_mask];
1427       txvq->last_avail_idx++;
1428       txvq->used->ring[txvq->last_used_idx & qsz_mask].id = desc_chain_head;
1429       txvq->used->ring[txvq->last_used_idx & qsz_mask].len = 0;
1430       vhost_user_log_dirty_ring (vui, txvq,
1431                                  ring[txvq->last_used_idx & qsz_mask]);
1432       txvq->last_used_idx++;
1433       discarded_packets++;
1434     }
1435
1436 out:
1437   CLIB_MEMORY_BARRIER ();
1438   txvq->used->idx = txvq->last_used_idx;
1439   vhost_user_log_dirty_ring (vui, txvq, idx);
1440   return discarded_packets;
1441 }
1442
1443 /*
1444  * In case of overflow, we need to rewind the array of allocated buffers.
1445  */
1446 static void
1447 vhost_user_input_rewind_buffers (vlib_main_t * vm,
1448                                  vhost_cpu_t * cpu, vlib_buffer_t * b_head)
1449 {
1450   u32 bi_current = cpu->rx_buffers[cpu->rx_buffers_len];
1451   vlib_buffer_t *b_current = vlib_get_buffer (vm, bi_current);
1452   b_current->current_length = 0;
1453   b_current->flags = 0;
1454   while (b_current != b_head)
1455     {
1456       cpu->rx_buffers_len++;
1457       bi_current = cpu->rx_buffers[cpu->rx_buffers_len];
1458       b_current = vlib_get_buffer (vm, bi_current);
1459       b_current->current_length = 0;
1460       b_current->flags = 0;
1461     }
1462 }
1463
1464 static u32
1465 vhost_user_if_input (vlib_main_t * vm,
1466                      vhost_user_main_t * vum,
1467                      vhost_user_intf_t * vui,
1468                      u16 qid, vlib_node_runtime_t * node)
1469 {
1470   vhost_user_vring_t *txvq = &vui->vrings[VHOST_VRING_IDX_TX (qid)];
1471   u16 n_rx_packets = 0;
1472   u32 n_rx_bytes = 0;
1473   u16 n_left;
1474   u32 n_left_to_next, *to_next;
1475   u32 next_index = VNET_DEVICE_INPUT_NEXT_ETHERNET_INPUT;
1476   u32 n_trace = vlib_get_trace_count (vm, node);
1477   u16 qsz_mask;
1478   u32 map_hint = 0;
1479   u16 cpu_index = os_get_cpu_number ();
1480   u16 copy_len = 0;
1481
1482   {
1483     /* do we have pending interrupts ? */
1484     vhost_user_vring_t *rxvq = &vui->vrings[VHOST_VRING_IDX_RX (qid)];
1485     f64 now = vlib_time_now (vm);
1486
1487     if ((txvq->n_since_last_int) && (txvq->int_deadline < now))
1488       vhost_user_send_call (vm, txvq);
1489
1490     if ((rxvq->n_since_last_int) && (rxvq->int_deadline < now))
1491       vhost_user_send_call (vm, rxvq);
1492   }
1493
1494   if (PREDICT_FALSE (txvq->avail->flags & 0xFFFE))
1495     return 0;
1496
1497   n_left = (u16) (txvq->avail->idx - txvq->last_avail_idx);
1498
1499   /* nothing to do */
1500   if (PREDICT_FALSE (n_left == 0))
1501     return 0;
1502
1503   if (PREDICT_FALSE (!vui->admin_up || !(txvq->enabled)))
1504     {
1505       /*
1506        * Discard input packet if interface is admin down or vring is not
1507        * enabled.
1508        * "For example, for a networking device, in the disabled state
1509        * client must not supply any new RX packets, but must process
1510        * and discard any TX packets."
1511        */
1512       vhost_user_rx_discard_packet (vm, vui, txvq,
1513                                     VHOST_USER_DOWN_DISCARD_COUNT);
1514       return 0;
1515     }
1516
1517   if (PREDICT_FALSE (n_left == txvq->qsz))
1518     {
1519       /*
1520        * Informational error logging when VPP is not
1521        * receiving packets fast enough.
1522        */
1523       vlib_error_count (vm, node->node_index,
1524                         VHOST_USER_INPUT_FUNC_ERROR_FULL_RX_QUEUE, 1);
1525     }
1526
1527   qsz_mask = txvq->qsz - 1;
1528
1529   if (n_left > VLIB_FRAME_SIZE)
1530     n_left = VLIB_FRAME_SIZE;
1531
1532   /*
1533    * For small packets (<2kB), we will not need more than one vlib buffer
1534    * per packet. In case packets are bigger, we will just yeld at some point
1535    * in the loop and come back later. This is not an issue as for big packet,
1536    * processing cost really comes from the memory copy.
1537    */
1538   if (PREDICT_FALSE (vum->cpus[cpu_index].rx_buffers_len < n_left + 1))
1539     {
1540       u32 curr_len = vum->cpus[cpu_index].rx_buffers_len;
1541       vum->cpus[cpu_index].rx_buffers_len +=
1542         vlib_buffer_alloc_from_free_list (vm,
1543                                           vum->cpus[cpu_index].rx_buffers +
1544                                           curr_len,
1545                                           VHOST_USER_RX_BUFFERS_N - curr_len,
1546                                           VLIB_BUFFER_DEFAULT_FREE_LIST_INDEX);
1547
1548       if (PREDICT_FALSE
1549           (vum->cpus[cpu_index].rx_buffers_len <
1550            VHOST_USER_RX_BUFFER_STARVATION))
1551         {
1552           /* In case of buffer starvation, discard some packets from the queue
1553            * and log the event.
1554            * We keep doing best effort for the remaining packets. */
1555           u32 flush = (n_left + 1 > vum->cpus[cpu_index].rx_buffers_len) ?
1556             n_left + 1 - vum->cpus[cpu_index].rx_buffers_len : 1;
1557           flush = vhost_user_rx_discard_packet (vm, vui, txvq, flush);
1558
1559           n_left -= flush;
1560           vlib_increment_simple_counter (vnet_main.
1561                                          interface_main.sw_if_counters +
1562                                          VNET_INTERFACE_COUNTER_DROP,
1563                                          os_get_cpu_number (),
1564                                          vui->sw_if_index, flush);
1565
1566           vlib_error_count (vm, vhost_user_input_node.index,
1567                             VHOST_USER_INPUT_FUNC_ERROR_NO_BUFFER, flush);
1568         }
1569     }
1570
1571   while (n_left > 0)
1572     {
1573       vlib_get_next_frame (vm, node, next_index, to_next, n_left_to_next);
1574
1575       while (n_left > 0 && n_left_to_next > 0)
1576         {
1577           vlib_buffer_t *b_head, *b_current;
1578           u32 bi_current;
1579           u16 desc_current;
1580           u32 desc_data_offset;
1581           vring_desc_t *desc_table = txvq->desc;
1582
1583           if (PREDICT_FALSE (vum->cpus[cpu_index].rx_buffers_len <= 1))
1584             {
1585               /* Not enough rx_buffers
1586                * Note: We yeld on 1 so we don't need to do an additional
1587                * check for the next buffer prefetch.
1588                */
1589               n_left = 0;
1590               break;
1591             }
1592
1593           desc_current = txvq->avail->ring[txvq->last_avail_idx & qsz_mask];
1594           vum->cpus[cpu_index].rx_buffers_len--;
1595           bi_current = (vum->cpus[cpu_index].rx_buffers)
1596             [vum->cpus[cpu_index].rx_buffers_len];
1597           b_head = b_current = vlib_get_buffer (vm, bi_current);
1598           to_next[0] = bi_current;      //We do that now so we can forget about bi_current
1599           to_next++;
1600           n_left_to_next--;
1601
1602           vlib_prefetch_buffer_with_index (vm,
1603                                            (vum->cpus[cpu_index].rx_buffers)
1604                                            [vum->cpus[cpu_index].
1605                                             rx_buffers_len - 1], LOAD);
1606
1607           /* Just preset the used descriptor id and length for later */
1608           txvq->used->ring[txvq->last_used_idx & qsz_mask].id = desc_current;
1609           txvq->used->ring[txvq->last_used_idx & qsz_mask].len = 0;
1610           vhost_user_log_dirty_ring (vui, txvq,
1611                                      ring[txvq->last_used_idx & qsz_mask]);
1612
1613           /* The buffer should already be initialized */
1614           b_head->total_length_not_including_first_buffer = 0;
1615           b_head->flags |= VLIB_BUFFER_TOTAL_LENGTH_VALID;
1616
1617           if (PREDICT_FALSE (n_trace))
1618             {
1619               //TODO: next_index is not exactly known at that point
1620               vlib_trace_buffer (vm, node, next_index, b_head,
1621                                  /* follow_chain */ 0);
1622               vhost_trace_t *t0 =
1623                 vlib_add_trace (vm, node, b_head, sizeof (t0[0]));
1624               vhost_user_rx_trace (t0, vui, qid, b_head, txvq);
1625               n_trace--;
1626               vlib_set_trace_count (vm, node, n_trace);
1627             }
1628
1629           /* This depends on the setup but is very consistent
1630            * So I think the CPU branch predictor will make a pretty good job
1631            * at optimizing the decision. */
1632           if (txvq->desc[desc_current].flags & VIRTQ_DESC_F_INDIRECT)
1633             {
1634               desc_table = map_guest_mem (vui, txvq->desc[desc_current].addr,
1635                                           &map_hint);
1636               desc_current = 0;
1637               if (PREDICT_FALSE (desc_table == 0))
1638                 {
1639                   //FIXME: Handle error by shutdown the queue
1640                   goto out;
1641                 }
1642             }
1643
1644           if (PREDICT_TRUE (vui->is_any_layout) ||
1645               (!(desc_table[desc_current].flags & VIRTQ_DESC_F_NEXT)))
1646             {
1647               /* ANYLAYOUT or single buffer */
1648               desc_data_offset = vui->virtio_net_hdr_sz;
1649             }
1650           else
1651             {
1652               /* CSR case without ANYLAYOUT, skip 1st buffer */
1653               desc_data_offset = desc_table[desc_current].len;
1654             }
1655
1656           while (1)
1657             {
1658               /* Get more input if necessary. Or end of packet. */
1659               if (desc_data_offset == desc_table[desc_current].len)
1660                 {
1661                   if (PREDICT_FALSE (desc_table[desc_current].flags &
1662                                      VIRTQ_DESC_F_NEXT))
1663                     {
1664                       desc_current = desc_table[desc_current].next;
1665                       desc_data_offset = 0;
1666                     }
1667                   else
1668                     {
1669                       goto out;
1670                     }
1671                 }
1672
1673               /* Get more output if necessary. Or end of packet. */
1674               if (PREDICT_FALSE
1675                   (b_current->current_length == VLIB_BUFFER_DATA_SIZE))
1676                 {
1677                   if (PREDICT_FALSE
1678                       (vum->cpus[cpu_index].rx_buffers_len == 0))
1679                     {
1680                       /*
1681                        * Checking if there are some left buffers.
1682                        * If not, just rewind the used buffers and stop.
1683                        * Note: Scheduled copies are not cancelled. This is
1684                        * not an issue as they would still be valid. Useless,
1685                        * but valid.
1686                        */
1687                       vhost_user_input_rewind_buffers (vm,
1688                                                        &vum->cpus[cpu_index],
1689                                                        b_head);
1690                       n_left = 0;
1691                       goto stop;
1692                     }
1693
1694                   /* Get next output */
1695                   vum->cpus[cpu_index].rx_buffers_len--;
1696                   u32 bi_next =
1697                     (vum->cpus[cpu_index].rx_buffers)[vum->cpus
1698                                                       [cpu_index].rx_buffers_len];
1699                   b_current->next_buffer = bi_next;
1700                   b_current->flags |= VLIB_BUFFER_NEXT_PRESENT;
1701                   bi_current = bi_next;
1702                   b_current = vlib_get_buffer (vm, bi_current);
1703                 }
1704
1705               /* Prepare a copy order executed later for the data */
1706               vhost_copy_t *cpy = &vum->cpus[cpu_index].copy[copy_len];
1707               copy_len++;
1708               u32 desc_data_l =
1709                 desc_table[desc_current].len - desc_data_offset;
1710               cpy->len = VLIB_BUFFER_DATA_SIZE - b_current->current_length;
1711               cpy->len = (cpy->len > desc_data_l) ? desc_data_l : cpy->len;
1712               cpy->dst = (uword) vlib_buffer_get_current (b_current);
1713               cpy->src = desc_table[desc_current].addr + desc_data_offset;
1714
1715               desc_data_offset += cpy->len;
1716
1717               b_current->current_length += cpy->len;
1718               b_head->total_length_not_including_first_buffer += cpy->len;
1719             }
1720
1721         out:
1722           CLIB_PREFETCH (&n_left, sizeof (n_left), LOAD);
1723
1724           n_rx_bytes += b_head->total_length_not_including_first_buffer;
1725           n_rx_packets++;
1726
1727           b_head->total_length_not_including_first_buffer -=
1728             b_head->current_length;
1729
1730           /* consume the descriptor and return it as used */
1731           txvq->last_avail_idx++;
1732           txvq->last_used_idx++;
1733
1734           VLIB_BUFFER_TRACE_TRAJECTORY_INIT (b_head);
1735
1736           vnet_buffer (b_head)->sw_if_index[VLIB_RX] = vui->sw_if_index;
1737           vnet_buffer (b_head)->sw_if_index[VLIB_TX] = (u32) ~ 0;
1738           b_head->error = 0;
1739
1740           {
1741             u32 next0 = VNET_DEVICE_INPUT_NEXT_ETHERNET_INPUT;
1742
1743             /* redirect if feature path enabled */
1744             vnet_feature_start_device_input_x1 (vui->sw_if_index, &next0,
1745                                                 b_head, 0);
1746
1747             u32 bi = to_next[-1];       //Cannot use to_next[-1] in the macro
1748             vlib_validate_buffer_enqueue_x1 (vm, node, next_index,
1749                                              to_next, n_left_to_next,
1750                                              bi, next0);
1751           }
1752
1753           n_left--;
1754
1755           /*
1756            * Although separating memory copies from virtio ring parsing
1757            * is beneficial, we can offer to perform the copies from time
1758            * to time in order to free some space in the ring.
1759            */
1760           if (PREDICT_FALSE (copy_len >= VHOST_USER_RX_COPY_THRESHOLD))
1761             {
1762               if (PREDICT_FALSE
1763                   (vhost_user_input_copy (vui, vum->cpus[cpu_index].copy,
1764                                           copy_len, &map_hint)))
1765                 {
1766                   clib_warning
1767                     ("Memory mapping error on interface hw_if_index=%d "
1768                      "(Shutting down - Switch interface down and up to restart)",
1769                      vui->hw_if_index);
1770                   vui->admin_up = 0;
1771                   copy_len = 0;
1772                   break;
1773                 }
1774               copy_len = 0;
1775
1776               /* give buffers back to driver */
1777               CLIB_MEMORY_BARRIER ();
1778               txvq->used->idx = txvq->last_used_idx;
1779               vhost_user_log_dirty_ring (vui, txvq, idx);
1780             }
1781         }
1782     stop:
1783       vlib_put_next_frame (vm, node, next_index, n_left_to_next);
1784     }
1785
1786   /* Do the memory copies */
1787   if (PREDICT_FALSE
1788       (vhost_user_input_copy (vui, vum->cpus[cpu_index].copy,
1789                               copy_len, &map_hint)))
1790     {
1791       clib_warning ("Memory mapping error on interface hw_if_index=%d "
1792                     "(Shutting down - Switch interface down and up to restart)",
1793                     vui->hw_if_index);
1794       vui->admin_up = 0;
1795     }
1796
1797   /* give buffers back to driver */
1798   CLIB_MEMORY_BARRIER ();
1799   txvq->used->idx = txvq->last_used_idx;
1800   vhost_user_log_dirty_ring (vui, txvq, idx);
1801
1802   /* interrupt (call) handling */
1803   if ((txvq->callfd_idx != ~0) && !(txvq->avail->flags & 1))
1804     {
1805       txvq->n_since_last_int += n_rx_packets;
1806
1807       if (txvq->n_since_last_int > vum->coalesce_frames)
1808         vhost_user_send_call (vm, txvq);
1809     }
1810
1811   /* increase rx counters */
1812   vlib_increment_combined_counter
1813     (vnet_main.interface_main.combined_sw_if_counters
1814      + VNET_INTERFACE_COUNTER_RX,
1815      os_get_cpu_number (), vui->sw_if_index, n_rx_packets, n_rx_bytes);
1816
1817   return n_rx_packets;
1818 }
1819
1820 static uword
1821 vhost_user_input (vlib_main_t * vm,
1822                   vlib_node_runtime_t * node, vlib_frame_t * f)
1823 {
1824   vhost_user_main_t *vum = &vhost_user_main;
1825   uword n_rx_packets = 0;
1826   u32 cpu_index = os_get_cpu_number ();
1827
1828
1829   vhost_iface_and_queue_t *vhiq;
1830   vec_foreach (vhiq, vum->cpus[cpu_index].rx_queues)
1831   {
1832     vhost_user_intf_t *vui =
1833       &vum->vhost_user_interfaces[vhiq->vhost_iface_index];
1834     n_rx_packets += vhost_user_if_input (vm, vum, vui, vhiq->qid, node);
1835   }
1836
1837   return n_rx_packets;
1838 }
1839
1840 /* *INDENT-OFF* */
1841 VLIB_REGISTER_NODE (vhost_user_input_node) = {
1842   .function = vhost_user_input,
1843   .type = VLIB_NODE_TYPE_INPUT,
1844   .name = "vhost-user-input",
1845   .sibling_of = "device-input",
1846
1847   /* Will be enabled if/when hardware is detected. */
1848   .state = VLIB_NODE_STATE_DISABLED,
1849
1850   .format_buffer = format_ethernet_header_with_length,
1851   .format_trace = format_vhost_trace,
1852
1853   .n_errors = VHOST_USER_INPUT_FUNC_N_ERROR,
1854   .error_strings = vhost_user_input_func_error_strings,
1855 };
1856
1857 VLIB_NODE_FUNCTION_MULTIARCH (vhost_user_input_node, vhost_user_input)
1858 /* *INDENT-ON* */
1859
1860
1861 void
1862 vhost_user_tx_trace (vhost_trace_t * t,
1863                      vhost_user_intf_t * vui, u16 qid,
1864                      vlib_buffer_t * b, vhost_user_vring_t * rxvq)
1865 {
1866   vhost_user_main_t *vum = &vhost_user_main;
1867   u32 qsz_mask = rxvq->qsz - 1;
1868   u32 last_avail_idx = rxvq->last_avail_idx;
1869   u32 desc_current = rxvq->avail->ring[last_avail_idx & qsz_mask];
1870   vring_desc_t *hdr_desc = 0;
1871   u32 hint = 0;
1872
1873   memset (t, 0, sizeof (*t));
1874   t->device_index = vui - vum->vhost_user_interfaces;
1875   t->qid = qid;
1876
1877   hdr_desc = &rxvq->desc[desc_current];
1878   if (rxvq->desc[desc_current].flags & VIRTQ_DESC_F_INDIRECT)
1879     {
1880       t->virtio_ring_flags |= 1 << VIRTIO_TRACE_F_INDIRECT;
1881       /* Header is the first here */
1882       hdr_desc = map_guest_mem (vui, rxvq->desc[desc_current].addr, &hint);
1883     }
1884   if (rxvq->desc[desc_current].flags & VIRTQ_DESC_F_NEXT)
1885     {
1886       t->virtio_ring_flags |= 1 << VIRTIO_TRACE_F_SIMPLE_CHAINED;
1887     }
1888   if (!(rxvq->desc[desc_current].flags & VIRTQ_DESC_F_NEXT) &&
1889       !(rxvq->desc[desc_current].flags & VIRTQ_DESC_F_INDIRECT))
1890     {
1891       t->virtio_ring_flags |= 1 << VIRTIO_TRACE_F_SINGLE_DESC;
1892     }
1893
1894   t->first_desc_len = hdr_desc ? hdr_desc->len : 0;
1895 }
1896
1897 static_always_inline u32
1898 vhost_user_tx_copy (vhost_user_intf_t * vui, vhost_copy_t * cpy,
1899                     u16 copy_len, u32 * map_hint)
1900 {
1901   void *dst0, *dst1, *dst2, *dst3;
1902   if (PREDICT_TRUE (copy_len >= 4))
1903     {
1904       if (PREDICT_FALSE (!(dst2 = map_guest_mem (vui, cpy[0].dst, map_hint))))
1905         return 1;
1906       if (PREDICT_FALSE (!(dst3 = map_guest_mem (vui, cpy[1].dst, map_hint))))
1907         return 1;
1908       while (PREDICT_TRUE (copy_len >= 4))
1909         {
1910           dst0 = dst2;
1911           dst1 = dst3;
1912
1913           if (PREDICT_FALSE
1914               (!(dst2 = map_guest_mem (vui, cpy[2].dst, map_hint))))
1915             return 1;
1916           if (PREDICT_FALSE
1917               (!(dst3 = map_guest_mem (vui, cpy[3].dst, map_hint))))
1918             return 1;
1919
1920           CLIB_PREFETCH ((void *) cpy[2].src, 64, LOAD);
1921           CLIB_PREFETCH ((void *) cpy[3].src, 64, LOAD);
1922
1923           clib_memcpy (dst0, (void *) cpy[0].src, cpy[0].len);
1924           clib_memcpy (dst1, (void *) cpy[1].src, cpy[1].len);
1925
1926           vhost_user_log_dirty_pages_2 (vui, cpy[0].dst, cpy[0].len, 1);
1927           vhost_user_log_dirty_pages_2 (vui, cpy[1].dst, cpy[1].len, 1);
1928           copy_len -= 2;
1929           cpy += 2;
1930         }
1931     }
1932   while (copy_len)
1933     {
1934       if (PREDICT_FALSE (!(dst0 = map_guest_mem (vui, cpy->dst, map_hint))))
1935         return 1;
1936       clib_memcpy (dst0, (void *) cpy->src, cpy->len);
1937       vhost_user_log_dirty_pages_2 (vui, cpy->dst, cpy->len, 1);
1938       copy_len -= 1;
1939       cpy += 1;
1940     }
1941   return 0;
1942 }
1943
1944
1945 static uword
1946 vhost_user_tx (vlib_main_t * vm,
1947                vlib_node_runtime_t * node, vlib_frame_t * frame)
1948 {
1949   u32 *buffers = vlib_frame_args (frame);
1950   u32 n_left = frame->n_vectors;
1951   vhost_user_main_t *vum = &vhost_user_main;
1952   vnet_interface_output_runtime_t *rd = (void *) node->runtime_data;
1953   vhost_user_intf_t *vui =
1954     pool_elt_at_index (vum->vhost_user_interfaces, rd->dev_instance);
1955   u32 qid = ~0;
1956   vhost_user_vring_t *rxvq;
1957   u16 qsz_mask;
1958   u8 error;
1959   u32 cpu_index = os_get_cpu_number ();
1960   u32 map_hint = 0;
1961   u8 retry = 8;
1962   u16 copy_len;
1963   u16 tx_headers_len;
1964
1965   if (PREDICT_FALSE (!vui->admin_up))
1966     {
1967       error = VHOST_USER_TX_FUNC_ERROR_DOWN;
1968       goto done3;
1969     }
1970
1971   if (PREDICT_FALSE (!vui->is_up))
1972     {
1973       error = VHOST_USER_TX_FUNC_ERROR_NOT_READY;
1974       goto done3;
1975     }
1976
1977   qid =
1978     VHOST_VRING_IDX_RX (*vec_elt_at_index
1979                         (vui->per_cpu_tx_qid, os_get_cpu_number ()));
1980   rxvq = &vui->vrings[qid];
1981   if (PREDICT_FALSE (vui->use_tx_spinlock))
1982     vhost_user_vring_lock (vui, qid);
1983
1984   qsz_mask = rxvq->qsz - 1;     /* qsz is always power of 2 */
1985
1986 retry:
1987   error = VHOST_USER_TX_FUNC_ERROR_NONE;
1988   tx_headers_len = 0;
1989   copy_len = 0;
1990   while (n_left > 0)
1991     {
1992       vlib_buffer_t *b0, *current_b0;
1993       u16 desc_head, desc_index, desc_len;
1994       vring_desc_t *desc_table;
1995       uword buffer_map_addr;
1996       u32 buffer_len;
1997       u16 bytes_left;
1998
1999       if (PREDICT_TRUE (n_left > 1))
2000         vlib_prefetch_buffer_with_index (vm, buffers[1], LOAD);
2001
2002       b0 = vlib_get_buffer (vm, buffers[0]);
2003
2004       if (PREDICT_FALSE (b0->flags & VLIB_BUFFER_IS_TRACED))
2005         {
2006           vum->cpus[cpu_index].current_trace =
2007             vlib_add_trace (vm, node, b0,
2008                             sizeof (*vum->cpus[cpu_index].current_trace));
2009           vhost_user_tx_trace (vum->cpus[cpu_index].current_trace,
2010                                vui, qid / 2, b0, rxvq);
2011         }
2012
2013       if (PREDICT_FALSE (rxvq->last_avail_idx == rxvq->avail->idx))
2014         {
2015           error = VHOST_USER_TX_FUNC_ERROR_PKT_DROP_NOBUF;
2016           goto done;
2017         }
2018
2019       desc_table = rxvq->desc;
2020       desc_head = desc_index =
2021         rxvq->avail->ring[rxvq->last_avail_idx & qsz_mask];
2022
2023       /* Go deeper in case of indirect descriptor
2024        * I don't know of any driver providing indirect for RX. */
2025       if (PREDICT_FALSE (rxvq->desc[desc_head].flags & VIRTQ_DESC_F_INDIRECT))
2026         {
2027           if (PREDICT_FALSE
2028               (rxvq->desc[desc_head].len < sizeof (vring_desc_t)))
2029             {
2030               error = VHOST_USER_TX_FUNC_ERROR_INDIRECT_OVERFLOW;
2031               goto done;
2032             }
2033           if (PREDICT_FALSE
2034               (!(desc_table =
2035                  map_guest_mem (vui, rxvq->desc[desc_index].addr,
2036                                 &map_hint))))
2037             {
2038               error = VHOST_USER_TX_FUNC_ERROR_MMAP_FAIL;
2039               goto done;
2040             }
2041           desc_index = 0;
2042         }
2043
2044       desc_len = vui->virtio_net_hdr_sz;
2045       buffer_map_addr = desc_table[desc_index].addr;
2046       buffer_len = desc_table[desc_index].len;
2047
2048       {
2049         // Get a header from the header array
2050         virtio_net_hdr_mrg_rxbuf_t *hdr =
2051           &vum->cpus[cpu_index].tx_headers[tx_headers_len];
2052         tx_headers_len++;
2053         hdr->hdr.flags = 0;
2054         hdr->hdr.gso_type = 0;
2055         hdr->num_buffers = 1;   //This is local, no need to check
2056
2057         // Prepare a copy order executed later for the header
2058         vhost_copy_t *cpy = &vum->cpus[cpu_index].copy[copy_len];
2059         copy_len++;
2060         cpy->len = vui->virtio_net_hdr_sz;
2061         cpy->dst = buffer_map_addr;
2062         cpy->src = (uword) hdr;
2063       }
2064
2065       buffer_map_addr += vui->virtio_net_hdr_sz;
2066       buffer_len -= vui->virtio_net_hdr_sz;
2067       bytes_left = b0->current_length;
2068       current_b0 = b0;
2069       while (1)
2070         {
2071           if (buffer_len == 0)
2072             {                   //Get new output
2073               if (desc_table[desc_index].flags & VIRTQ_DESC_F_NEXT)
2074                 {
2075                   //Next one is chained
2076                   desc_index = desc_table[desc_index].next;
2077                   buffer_map_addr = desc_table[desc_index].addr;
2078                   buffer_len = desc_table[desc_index].len;
2079                 }
2080               else if (vui->virtio_net_hdr_sz == 12)    //MRG is available
2081                 {
2082                   virtio_net_hdr_mrg_rxbuf_t *hdr =
2083                     &vum->cpus[cpu_index].tx_headers[tx_headers_len - 1];
2084
2085                   //Move from available to used buffer
2086                   rxvq->used->ring[rxvq->last_used_idx & qsz_mask].id =
2087                     desc_head;
2088                   rxvq->used->ring[rxvq->last_used_idx & qsz_mask].len =
2089                     desc_len;
2090                   vhost_user_log_dirty_ring (vui, rxvq,
2091                                              ring[rxvq->last_used_idx &
2092                                                   qsz_mask]);
2093
2094                   rxvq->last_avail_idx++;
2095                   rxvq->last_used_idx++;
2096                   hdr->num_buffers++;
2097                   desc_len = 0;
2098
2099                   if (PREDICT_FALSE
2100                       (rxvq->last_avail_idx == rxvq->avail->idx))
2101                     {
2102                       //Dequeue queued descriptors for this packet
2103                       rxvq->last_used_idx -= hdr->num_buffers - 1;
2104                       rxvq->last_avail_idx -= hdr->num_buffers - 1;
2105                       error = VHOST_USER_TX_FUNC_ERROR_PKT_DROP_NOBUF;
2106                       goto done;
2107                     }
2108
2109                   desc_table = rxvq->desc;
2110                   desc_head = desc_index =
2111                     rxvq->avail->ring[rxvq->last_avail_idx & qsz_mask];
2112                   if (PREDICT_FALSE
2113                       (rxvq->desc[desc_head].flags & VIRTQ_DESC_F_INDIRECT))
2114                     {
2115                       //It is seriously unlikely that a driver will put indirect descriptor
2116                       //after non-indirect descriptor.
2117                       if (PREDICT_FALSE
2118                           (rxvq->desc[desc_head].len < sizeof (vring_desc_t)))
2119                         {
2120                           error = VHOST_USER_TX_FUNC_ERROR_INDIRECT_OVERFLOW;
2121                           goto done;
2122                         }
2123                       if (PREDICT_FALSE
2124                           (!(desc_table =
2125                              map_guest_mem (vui,
2126                                             rxvq->desc[desc_index].addr,
2127                                             &map_hint))))
2128                         {
2129                           error = VHOST_USER_TX_FUNC_ERROR_MMAP_FAIL;
2130                           goto done;
2131                         }
2132                       desc_index = 0;
2133                     }
2134                   buffer_map_addr = desc_table[desc_index].addr;
2135                   buffer_len = desc_table[desc_index].len;
2136                 }
2137               else
2138                 {
2139                   error = VHOST_USER_TX_FUNC_ERROR_PKT_DROP_NOMRG;
2140                   goto done;
2141                 }
2142             }
2143
2144           {
2145             vhost_copy_t *cpy = &vum->cpus[cpu_index].copy[copy_len];
2146             copy_len++;
2147             cpy->len = bytes_left;
2148             cpy->len = (cpy->len > buffer_len) ? buffer_len : cpy->len;
2149             cpy->dst = buffer_map_addr;
2150             cpy->src = (uword) vlib_buffer_get_current (current_b0) +
2151               current_b0->current_length - bytes_left;
2152
2153             bytes_left -= cpy->len;
2154             buffer_len -= cpy->len;
2155             buffer_map_addr += cpy->len;
2156             desc_len += cpy->len;
2157
2158             CLIB_PREFETCH (&rxvq->desc, CLIB_CACHE_LINE_BYTES, LOAD);
2159           }
2160
2161           // Check if vlib buffer has more data. If not, get more or break.
2162           if (PREDICT_TRUE (!bytes_left))
2163             {
2164               if (PREDICT_FALSE
2165                   (current_b0->flags & VLIB_BUFFER_NEXT_PRESENT))
2166                 {
2167                   current_b0 = vlib_get_buffer (vm, current_b0->next_buffer);
2168                   bytes_left = current_b0->current_length;
2169                 }
2170               else
2171                 {
2172                   //End of packet
2173                   break;
2174                 }
2175             }
2176         }
2177
2178       //Move from available to used ring
2179       rxvq->used->ring[rxvq->last_used_idx & qsz_mask].id = desc_head;
2180       rxvq->used->ring[rxvq->last_used_idx & qsz_mask].len = desc_len;
2181       vhost_user_log_dirty_ring (vui, rxvq,
2182                                  ring[rxvq->last_used_idx & qsz_mask]);
2183       rxvq->last_avail_idx++;
2184       rxvq->last_used_idx++;
2185
2186       if (PREDICT_FALSE (b0->flags & VLIB_BUFFER_IS_TRACED))
2187         {
2188           vum->cpus[cpu_index].current_trace->hdr =
2189             vum->cpus[cpu_index].tx_headers[tx_headers_len - 1];
2190         }
2191
2192       n_left--;                 //At the end for error counting when 'goto done' is invoked
2193       buffers++;
2194     }
2195
2196 done:
2197   //Do the memory copies
2198   if (PREDICT_FALSE
2199       (vhost_user_tx_copy (vui, vum->cpus[cpu_index].copy,
2200                            copy_len, &map_hint)))
2201     {
2202       clib_warning ("Memory mapping error on interface hw_if_index=%d "
2203                     "(Shutting down - Switch interface down and up to restart)",
2204                     vui->hw_if_index);
2205       vui->admin_up = 0;
2206     }
2207
2208   CLIB_MEMORY_BARRIER ();
2209   rxvq->used->idx = rxvq->last_used_idx;
2210   vhost_user_log_dirty_ring (vui, rxvq, idx);
2211
2212   /*
2213    * When n_left is set, error is always set to something too.
2214    * In case error is due to lack of remaining buffers, we go back up and
2215    * retry.
2216    * The idea is that it is better to waste some time on packets
2217    * that have been processed already than dropping them and get
2218    * more fresh packets with a good likelyhood that they will be dropped too.
2219    * This technique also gives more time to VM driver to pick-up packets.
2220    * In case the traffic flows from physical to virtual interfaces, this
2221    * technique will end-up leveraging the physical NIC buffer in order to
2222    * absorb the VM's CPU jitter.
2223    */
2224   if (n_left && (error == VHOST_USER_TX_FUNC_ERROR_PKT_DROP_NOBUF) && retry)
2225     {
2226       retry--;
2227       goto retry;
2228     }
2229
2230   /* interrupt (call) handling */
2231   if ((rxvq->callfd_idx != ~0) && !(rxvq->avail->flags & 1))
2232     {
2233       rxvq->n_since_last_int += frame->n_vectors - n_left;
2234
2235       if (rxvq->n_since_last_int > vum->coalesce_frames)
2236         vhost_user_send_call (vm, rxvq);
2237     }
2238
2239   vhost_user_vring_unlock (vui, qid);
2240
2241 done3:
2242   if (PREDICT_FALSE (n_left && error != VHOST_USER_TX_FUNC_ERROR_NONE))
2243     {
2244       vlib_error_count (vm, node->node_index, error, n_left);
2245       vlib_increment_simple_counter
2246         (vnet_main.interface_main.sw_if_counters
2247          + VNET_INTERFACE_COUNTER_DROP,
2248          os_get_cpu_number (), vui->sw_if_index, n_left);
2249     }
2250
2251   vlib_buffer_free (vm, vlib_frame_args (frame), frame->n_vectors);
2252   return frame->n_vectors;
2253 }
2254
2255 static clib_error_t *
2256 vhost_user_interface_admin_up_down (vnet_main_t * vnm, u32 hw_if_index,
2257                                     u32 flags)
2258 {
2259   vnet_hw_interface_t *hif = vnet_get_hw_interface (vnm, hw_if_index);
2260   uword is_up = (flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP) != 0;
2261   vhost_user_main_t *vum = &vhost_user_main;
2262   vhost_user_intf_t *vui =
2263     pool_elt_at_index (vum->vhost_user_interfaces, hif->dev_instance);
2264
2265   vui->admin_up = is_up;
2266
2267   if (is_up)
2268     vnet_hw_interface_set_flags (vnm, vui->hw_if_index,
2269                                  VNET_HW_INTERFACE_FLAG_LINK_UP);
2270
2271   return /* no error */ 0;
2272 }
2273
2274 /* *INDENT-OFF* */
2275 VNET_DEVICE_CLASS (vhost_user_dev_class,static) = {
2276   .name = "vhost-user",
2277   .tx_function = vhost_user_tx,
2278   .tx_function_n_errors = VHOST_USER_TX_FUNC_N_ERROR,
2279   .tx_function_error_strings = vhost_user_tx_func_error_strings,
2280   .format_device_name = format_vhost_user_interface_name,
2281   .name_renumber = vhost_user_name_renumber,
2282   .admin_up_down_function = vhost_user_interface_admin_up_down,
2283   .format_tx_trace = format_vhost_trace,
2284 };
2285
2286 VLIB_DEVICE_TX_FUNCTION_MULTIARCH (vhost_user_dev_class,
2287                                    vhost_user_tx)
2288 /* *INDENT-ON* */
2289
2290 static uword
2291 vhost_user_process (vlib_main_t * vm,
2292                     vlib_node_runtime_t * rt, vlib_frame_t * f)
2293 {
2294   vhost_user_main_t *vum = &vhost_user_main;
2295   vhost_user_intf_t *vui;
2296   struct sockaddr_un sun;
2297   int sockfd;
2298   unix_file_t template = { 0 };
2299   f64 timeout = 3153600000.0 /* 100 years */ ;
2300   uword *event_data = 0;
2301
2302   sockfd = socket (AF_UNIX, SOCK_STREAM, 0);
2303   sun.sun_family = AF_UNIX;
2304   template.read_function = vhost_user_socket_read;
2305   template.error_function = vhost_user_socket_error;
2306
2307   if (sockfd < 0)
2308     return 0;
2309
2310   while (1)
2311     {
2312       vlib_process_wait_for_event_or_clock (vm, timeout);
2313       vlib_process_get_events (vm, &event_data);
2314       vec_reset_length (event_data);
2315
2316       timeout = 3.0;
2317
2318       /* *INDENT-OFF* */
2319       pool_foreach (vui, vum->vhost_user_interfaces, {
2320
2321           if (vui->unix_server_index == ~0) { //Nothing to do for server sockets
2322               if (vui->unix_file_index == ~0)
2323                 {
2324                   /* try to connect */
2325                   strncpy (sun.sun_path, (char *) vui->sock_filename,
2326                            sizeof (sun.sun_path) - 1);
2327
2328                   if (connect (sockfd, (struct sockaddr *) &sun,
2329                                sizeof (struct sockaddr_un)) == 0)
2330                     {
2331                       vui->sock_errno = 0;
2332                       template.file_descriptor = sockfd;
2333                       template.private_data =
2334                           vui - vhost_user_main.vhost_user_interfaces;
2335                       vui->unix_file_index = unix_file_add (&unix_main, &template);
2336
2337                       //Re-open for next connect
2338                       if ((sockfd = socket (AF_UNIX, SOCK_STREAM, 0)) < 0) {
2339                           clib_warning("Critical: Could not open unix socket");
2340                           return 0;
2341                       }
2342                     }
2343                   else
2344                     {
2345                       vui->sock_errno = errno;
2346                     }
2347                 }
2348               else
2349                 {
2350                   /* check if socket is alive */
2351                   int error = 0;
2352                   socklen_t len = sizeof (error);
2353                   int fd = UNIX_GET_FD(vui->unix_file_index);
2354                   int retval =
2355                       getsockopt (fd, SOL_SOCKET, SO_ERROR, &error, &len);
2356
2357                   if (retval)
2358                     {
2359                       DBG_SOCK ("getsockopt returned %d", retval);
2360                       vhost_user_if_disconnect (vui);
2361                     }
2362                 }
2363           }
2364       });
2365       /* *INDENT-ON* */
2366     }
2367   return 0;
2368 }
2369
2370 /* *INDENT-OFF* */
2371 VLIB_REGISTER_NODE (vhost_user_process_node,static) = {
2372     .function = vhost_user_process,
2373     .type = VLIB_NODE_TYPE_PROCESS,
2374     .name = "vhost-user-process",
2375 };
2376 /* *INDENT-ON* */
2377
2378 /**
2379  * Disables and reset interface structure.
2380  * It can then be either init again, or removed from used interfaces.
2381  */
2382 static void
2383 vhost_user_term_if (vhost_user_intf_t * vui)
2384 {
2385   // Delete configured thread pinning
2386   vec_reset_length (vui->workers);
2387   // disconnect interface sockets
2388   vhost_user_if_disconnect (vui);
2389   vhost_user_update_iface_state (vui);
2390
2391   if (vui->unix_server_index != ~0)
2392     {
2393       //Close server socket
2394       unix_file_t *uf = pool_elt_at_index (unix_main.file_pool,
2395                                            vui->unix_server_index);
2396       unix_file_del (&unix_main, uf);
2397       vui->unix_server_index = ~0;
2398     }
2399 }
2400
2401 int
2402 vhost_user_delete_if (vnet_main_t * vnm, vlib_main_t * vm, u32 sw_if_index)
2403 {
2404   vhost_user_main_t *vum = &vhost_user_main;
2405   vhost_user_intf_t *vui;
2406   int rv = 0;
2407   vnet_hw_interface_t *hwif;
2408
2409   if (!(hwif = vnet_get_sup_hw_interface (vnm, sw_if_index)) ||
2410       hwif->dev_class_index != vhost_user_dev_class.index)
2411     return VNET_API_ERROR_INVALID_SW_IF_INDEX;
2412
2413   DBG_SOCK ("Deleting vhost-user interface %s (instance %d)",
2414             hwif->name, hwif->dev_instance);
2415
2416   vui = pool_elt_at_index (vum->vhost_user_interfaces, hwif->dev_instance);
2417
2418   // Disable and reset interface
2419   vhost_user_term_if (vui);
2420
2421   // Back to pool
2422   pool_put (vum->vhost_user_interfaces, vui);
2423
2424   // Reset renumbered iface
2425   if (hwif->dev_instance <
2426       vec_len (vum->show_dev_instance_by_real_dev_instance))
2427     vum->show_dev_instance_by_real_dev_instance[hwif->dev_instance] = ~0;
2428
2429   // Delete ethernet interface
2430   ethernet_delete_interface (vnm, vui->hw_if_index);
2431   return rv;
2432 }
2433
2434 /**
2435  * Open server unix socket on specified sock_filename.
2436  */
2437 static int
2438 vhost_user_init_server_sock (const char *sock_filename, int *sock_fd)
2439 {
2440   int rv = 0;
2441   struct sockaddr_un un = { };
2442   int fd;
2443   /* create listening socket */
2444   if ((fd = socket (AF_UNIX, SOCK_STREAM, 0)) < 0)
2445     return VNET_API_ERROR_SYSCALL_ERROR_1;
2446
2447   un.sun_family = AF_UNIX;
2448   strncpy ((char *) un.sun_path, (char *) sock_filename,
2449            sizeof (un.sun_path) - 1);
2450
2451   /* remove if exists */
2452   unlink ((char *) sock_filename);
2453
2454   if (bind (fd, (struct sockaddr *) &un, sizeof (un)) == -1)
2455     {
2456       rv = VNET_API_ERROR_SYSCALL_ERROR_2;
2457       goto error;
2458     }
2459
2460   if (listen (fd, 1) == -1)
2461     {
2462       rv = VNET_API_ERROR_SYSCALL_ERROR_3;
2463       goto error;
2464     }
2465
2466   *sock_fd = fd;
2467   return 0;
2468
2469 error:
2470   close (fd);
2471   return rv;
2472 }
2473
2474 /**
2475  * Create ethernet interface for vhost user interface.
2476  */
2477 static void
2478 vhost_user_create_ethernet (vnet_main_t * vnm, vlib_main_t * vm,
2479                             vhost_user_intf_t * vui, u8 * hwaddress)
2480 {
2481   vhost_user_main_t *vum = &vhost_user_main;
2482   u8 hwaddr[6];
2483   clib_error_t *error;
2484
2485   /* create hw and sw interface */
2486   if (hwaddress)
2487     {
2488       clib_memcpy (hwaddr, hwaddress, 6);
2489     }
2490   else
2491     {
2492       random_u32 (&vum->random);
2493       clib_memcpy (hwaddr + 2, &vum->random, sizeof (vum->random));
2494       hwaddr[0] = 2;
2495       hwaddr[1] = 0xfe;
2496     }
2497
2498   error = ethernet_register_interface
2499     (vnm,
2500      vhost_user_dev_class.index,
2501      vui - vum->vhost_user_interfaces /* device instance */ ,
2502      hwaddr /* ethernet address */ ,
2503      &vui->hw_if_index, 0 /* flag change */ );
2504
2505   if (error)
2506     clib_error_report (error);
2507
2508   vnet_hw_interface_t *hi = vnet_get_hw_interface (vnm, vui->hw_if_index);
2509   hi->max_l3_packet_bytes[VLIB_RX] = hi->max_l3_packet_bytes[VLIB_TX] = 9000;
2510 }
2511
2512 /*
2513  *  Initialize vui with specified attributes
2514  */
2515 static void
2516 vhost_user_vui_init (vnet_main_t * vnm,
2517                      vhost_user_intf_t * vui,
2518                      int server_sock_fd,
2519                      const char *sock_filename,
2520                      u64 feature_mask, u32 * sw_if_index)
2521 {
2522   vnet_sw_interface_t *sw;
2523   sw = vnet_get_hw_sw_interface (vnm, vui->hw_if_index);
2524   int q;
2525
2526   if (server_sock_fd != -1)
2527     {
2528       unix_file_t template = { 0 };
2529       template.read_function = vhost_user_socksvr_accept_ready;
2530       template.file_descriptor = server_sock_fd;
2531       template.private_data = vui - vhost_user_main.vhost_user_interfaces;      //hw index
2532       vui->unix_server_index = unix_file_add (&unix_main, &template);
2533     }
2534   else
2535     {
2536       vui->unix_server_index = ~0;
2537     }
2538
2539   vui->sw_if_index = sw->sw_if_index;
2540   strncpy (vui->sock_filename, sock_filename,
2541            ARRAY_LEN (vui->sock_filename) - 1);
2542   vui->sock_errno = 0;
2543   vui->is_up = 0;
2544   vui->feature_mask = feature_mask;
2545   vui->unix_file_index = ~0;
2546   vui->log_base_addr = 0;
2547
2548   for (q = 0; q < VHOST_VRING_MAX_N; q++)
2549     vhost_user_vring_init (vui, q);
2550
2551   vnet_hw_interface_set_flags (vnm, vui->hw_if_index, 0);
2552
2553   if (sw_if_index)
2554     *sw_if_index = vui->sw_if_index;
2555
2556   for (q = 0; q < VHOST_VRING_MAX_N; q++)
2557     {
2558       vui->vring_locks[q] = clib_mem_alloc_aligned (CLIB_CACHE_LINE_BYTES,
2559                                                     CLIB_CACHE_LINE_BYTES);
2560       memset ((void *) vui->vring_locks[q], 0, CLIB_CACHE_LINE_BYTES);
2561     }
2562
2563   vec_validate (vui->per_cpu_tx_qid,
2564                 vlib_get_thread_main ()->n_vlib_mains - 1);
2565   vhost_user_tx_thread_placement (vui);
2566 }
2567
2568 int
2569 vhost_user_create_if (vnet_main_t * vnm, vlib_main_t * vm,
2570                       const char *sock_filename,
2571                       u8 is_server,
2572                       u32 * sw_if_index,
2573                       u64 feature_mask,
2574                       u8 renumber, u32 custom_dev_instance, u8 * hwaddr)
2575 {
2576   vhost_user_intf_t *vui = NULL;
2577   u32 sw_if_idx = ~0;
2578   int rv = 0;
2579   int server_sock_fd = -1;
2580
2581   if (is_server)
2582     {
2583       if ((rv =
2584            vhost_user_init_server_sock (sock_filename, &server_sock_fd)) != 0)
2585         {
2586           return rv;
2587         }
2588     }
2589
2590   pool_get (vhost_user_main.vhost_user_interfaces, vui);
2591
2592   vhost_user_create_ethernet (vnm, vm, vui, hwaddr);
2593   vhost_user_vui_init (vnm, vui, server_sock_fd, sock_filename,
2594                        feature_mask, &sw_if_idx);
2595
2596   if (renumber)
2597     vnet_interface_name_renumber (sw_if_idx, custom_dev_instance);
2598
2599   if (sw_if_index)
2600     *sw_if_index = sw_if_idx;
2601
2602   // Process node must connect
2603   vlib_process_signal_event (vm, vhost_user_process_node.index, 0, 0);
2604   return rv;
2605 }
2606
2607 int
2608 vhost_user_modify_if (vnet_main_t * vnm, vlib_main_t * vm,
2609                       const char *sock_filename,
2610                       u8 is_server,
2611                       u32 sw_if_index,
2612                       u64 feature_mask, u8 renumber, u32 custom_dev_instance)
2613 {
2614   vhost_user_main_t *vum = &vhost_user_main;
2615   vhost_user_intf_t *vui = NULL;
2616   u32 sw_if_idx = ~0;
2617   int server_sock_fd = -1;
2618   int rv = 0;
2619   vnet_hw_interface_t *hwif;
2620
2621   if (!(hwif = vnet_get_sup_hw_interface (vnm, sw_if_index)) ||
2622       hwif->dev_class_index != vhost_user_dev_class.index)
2623     return VNET_API_ERROR_INVALID_SW_IF_INDEX;
2624
2625   vui = vec_elt_at_index (vum->vhost_user_interfaces, hwif->dev_instance);
2626
2627   // First try to open server socket
2628   if (is_server)
2629     if ((rv = vhost_user_init_server_sock (sock_filename,
2630                                            &server_sock_fd)) != 0)
2631       return rv;
2632
2633   vhost_user_term_if (vui);
2634   vhost_user_vui_init (vnm, vui, server_sock_fd,
2635                        sock_filename, feature_mask, &sw_if_idx);
2636
2637   if (renumber)
2638     vnet_interface_name_renumber (sw_if_idx, custom_dev_instance);
2639
2640   // Process node must connect
2641   vlib_process_signal_event (vm, vhost_user_process_node.index, 0, 0);
2642   return rv;
2643 }
2644
2645 clib_error_t *
2646 vhost_user_connect_command_fn (vlib_main_t * vm,
2647                                unformat_input_t * input,
2648                                vlib_cli_command_t * cmd)
2649 {
2650   unformat_input_t _line_input, *line_input = &_line_input;
2651   u8 *sock_filename = NULL;
2652   u32 sw_if_index;
2653   u8 is_server = 0;
2654   u64 feature_mask = (u64) ~ (0ULL);
2655   u8 renumber = 0;
2656   u32 custom_dev_instance = ~0;
2657   u8 hwaddr[6];
2658   u8 *hw = NULL;
2659
2660   /* Get a line of input. */
2661   if (!unformat_user (input, unformat_line_input, line_input))
2662     return 0;
2663
2664   while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2665     {
2666       if (unformat (line_input, "socket %s", &sock_filename))
2667         ;
2668       else if (unformat (line_input, "server"))
2669         is_server = 1;
2670       else if (unformat (line_input, "feature-mask 0x%llx", &feature_mask))
2671         ;
2672       else
2673         if (unformat
2674             (line_input, "hwaddr %U", unformat_ethernet_address, hwaddr))
2675         hw = hwaddr;
2676       else if (unformat (line_input, "renumber %d", &custom_dev_instance))
2677         {
2678           renumber = 1;
2679         }
2680       else
2681         return clib_error_return (0, "unknown input `%U'",
2682                                   format_unformat_error, input);
2683     }
2684   unformat_free (line_input);
2685
2686   vnet_main_t *vnm = vnet_get_main ();
2687
2688   int rv;
2689   if ((rv = vhost_user_create_if (vnm, vm, (char *) sock_filename,
2690                                   is_server, &sw_if_index, feature_mask,
2691                                   renumber, custom_dev_instance, hw)))
2692     {
2693       vec_free (sock_filename);
2694       return clib_error_return (0, "vhost_user_create_if returned %d", rv);
2695     }
2696
2697   vec_free (sock_filename);
2698   vlib_cli_output (vm, "%U\n", format_vnet_sw_if_index_name, vnet_get_main (),
2699                    sw_if_index);
2700   return 0;
2701 }
2702
2703 clib_error_t *
2704 vhost_user_delete_command_fn (vlib_main_t * vm,
2705                               unformat_input_t * input,
2706                               vlib_cli_command_t * cmd)
2707 {
2708   unformat_input_t _line_input, *line_input = &_line_input;
2709   u32 sw_if_index = ~0;
2710   vnet_main_t *vnm = vnet_get_main ();
2711
2712   /* Get a line of input. */
2713   if (!unformat_user (input, unformat_line_input, line_input))
2714     return 0;
2715
2716   while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2717     {
2718       if (unformat (line_input, "sw_if_index %d", &sw_if_index))
2719         ;
2720       else if (unformat
2721                (line_input, "%U", unformat_vnet_sw_interface, vnm,
2722                 &sw_if_index))
2723         {
2724           vnet_hw_interface_t *hwif =
2725             vnet_get_sup_hw_interface (vnm, sw_if_index);
2726           if (hwif == NULL ||
2727               vhost_user_dev_class.index != hwif->dev_class_index)
2728             return clib_error_return (0, "Not a vhost interface");
2729         }
2730       else
2731         return clib_error_return (0, "unknown input `%U'",
2732                                   format_unformat_error, input);
2733     }
2734   unformat_free (line_input);
2735   vhost_user_delete_if (vnm, vm, sw_if_index);
2736   return 0;
2737 }
2738
2739 int
2740 vhost_user_dump_ifs (vnet_main_t * vnm, vlib_main_t * vm,
2741                      vhost_user_intf_details_t ** out_vuids)
2742 {
2743   int rv = 0;
2744   vhost_user_main_t *vum = &vhost_user_main;
2745   vhost_user_intf_t *vui;
2746   vhost_user_intf_details_t *r_vuids = NULL;
2747   vhost_user_intf_details_t *vuid = NULL;
2748   u32 *hw_if_indices = 0;
2749   vnet_hw_interface_t *hi;
2750   u8 *s = NULL;
2751   int i;
2752
2753   if (!out_vuids)
2754     return -1;
2755
2756   pool_foreach (vui, vum->vhost_user_interfaces,
2757                 vec_add1 (hw_if_indices, vui->hw_if_index);
2758     );
2759
2760   for (i = 0; i < vec_len (hw_if_indices); i++)
2761     {
2762       hi = vnet_get_hw_interface (vnm, hw_if_indices[i]);
2763       vui = pool_elt_at_index (vum->vhost_user_interfaces, hi->dev_instance);
2764
2765       vec_add2 (r_vuids, vuid, 1);
2766       vuid->sw_if_index = vui->sw_if_index;
2767       vuid->virtio_net_hdr_sz = vui->virtio_net_hdr_sz;
2768       vuid->features = vui->features;
2769       vuid->num_regions = vui->nregions;
2770       vuid->sock_errno = vui->sock_errno;
2771       strncpy ((char *) vuid->sock_filename, (char *) vui->sock_filename,
2772                ARRAY_LEN (vuid->sock_filename) - 1);
2773
2774       s = format (s, "%v%c", hi->name, 0);
2775
2776       strncpy ((char *) vuid->if_name, (char *) s,
2777                ARRAY_LEN (vuid->if_name) - 1);
2778       _vec_len (s) = 0;
2779     }
2780
2781   vec_free (s);
2782   vec_free (hw_if_indices);
2783
2784   *out_vuids = r_vuids;
2785
2786   return rv;
2787 }
2788
2789 clib_error_t *
2790 show_vhost_user_command_fn (vlib_main_t * vm,
2791                             unformat_input_t * input,
2792                             vlib_cli_command_t * cmd)
2793 {
2794   clib_error_t *error = 0;
2795   vnet_main_t *vnm = vnet_get_main ();
2796   vhost_user_main_t *vum = &vhost_user_main;
2797   vhost_user_intf_t *vui;
2798   u32 hw_if_index, *hw_if_indices = 0;
2799   vnet_hw_interface_t *hi;
2800   vhost_cpu_t *vhc;
2801   vhost_iface_and_queue_t *vhiq;
2802   u32 ci;
2803
2804   int i, j, q;
2805   int show_descr = 0;
2806   struct feat_struct
2807   {
2808     u8 bit;
2809     char *str;
2810   };
2811   struct feat_struct *feat_entry;
2812
2813   static struct feat_struct feat_array[] = {
2814 #define _(s,b) { .str = #s, .bit = b, },
2815     foreach_virtio_net_feature
2816 #undef _
2817     {.str = NULL}
2818   };
2819
2820 #define foreach_protocol_feature \
2821   _(VHOST_USER_PROTOCOL_F_MQ) \
2822   _(VHOST_USER_PROTOCOL_F_LOG_SHMFD)
2823
2824   static struct feat_struct proto_feat_array[] = {
2825 #define _(s) { .str = #s, .bit = s},
2826     foreach_protocol_feature
2827 #undef _
2828     {.str = NULL}
2829   };
2830
2831   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
2832     {
2833       if (unformat
2834           (input, "%U", unformat_vnet_hw_interface, vnm, &hw_if_index))
2835         {
2836           vec_add1 (hw_if_indices, hw_if_index);
2837         }
2838       else if (unformat (input, "descriptors") || unformat (input, "desc"))
2839         show_descr = 1;
2840       else
2841         {
2842           error = clib_error_return (0, "unknown input `%U'",
2843                                      format_unformat_error, input);
2844           goto done;
2845         }
2846     }
2847   if (vec_len (hw_if_indices) == 0)
2848     {
2849       pool_foreach (vui, vum->vhost_user_interfaces,
2850                     vec_add1 (hw_if_indices, vui->hw_if_index);
2851         );
2852     }
2853   vlib_cli_output (vm, "Virtio vhost-user interfaces");
2854   vlib_cli_output (vm, "Global:\n  coalesce frames %d time %e",
2855                    vum->coalesce_frames, vum->coalesce_time);
2856
2857   for (i = 0; i < vec_len (hw_if_indices); i++)
2858     {
2859       hi = vnet_get_hw_interface (vnm, hw_if_indices[i]);
2860       vui = pool_elt_at_index (vum->vhost_user_interfaces, hi->dev_instance);
2861       vlib_cli_output (vm, "Interface: %s (ifindex %d)",
2862                        hi->name, hw_if_indices[i]);
2863
2864       vlib_cli_output (vm, "virtio_net_hdr_sz %d\n"
2865                        " features mask (0x%llx): \n"
2866                        " features (0x%llx): \n",
2867                        vui->virtio_net_hdr_sz, vui->feature_mask,
2868                        vui->features);
2869
2870       feat_entry = (struct feat_struct *) &feat_array;
2871       while (feat_entry->str)
2872         {
2873           if (vui->features & (1ULL << feat_entry->bit))
2874             vlib_cli_output (vm, "   %s (%d)", feat_entry->str,
2875                              feat_entry->bit);
2876           feat_entry++;
2877         }
2878
2879       vlib_cli_output (vm, "  protocol features (0x%llx)",
2880                        vui->protocol_features);
2881       feat_entry = (struct feat_struct *) &proto_feat_array;
2882       while (feat_entry->str)
2883         {
2884           if (vui->protocol_features & (1ULL << feat_entry->bit))
2885             vlib_cli_output (vm, "   %s (%d)", feat_entry->str,
2886                              feat_entry->bit);
2887           feat_entry++;
2888         }
2889
2890       vlib_cli_output (vm, "\n");
2891
2892       vlib_cli_output (vm, " socket filename %s type %s errno \"%s\"\n\n",
2893                        vui->sock_filename,
2894                        (vui->unix_server_index != ~0) ? "server" : "client",
2895                        strerror (vui->sock_errno));
2896
2897       vlib_cli_output (vm, " rx placement: ");
2898       vec_foreach (vhc, vum->cpus)
2899       {
2900         vec_foreach (vhiq, vhc->rx_queues)
2901         {
2902           if (vhiq->vhost_iface_index == vui - vum->vhost_user_interfaces)
2903             vlib_cli_output (vm, "   thread %d on vring %d\n",
2904                              vhc - vum->cpus, VHOST_VRING_IDX_TX (vhiq->qid));
2905         }
2906       }
2907
2908       vlib_cli_output (vm, " tx placement: %s\n",
2909                        vui->use_tx_spinlock ? "spin-lock" : "lock-free");
2910
2911       vec_foreach_index (ci, vui->per_cpu_tx_qid)
2912       {
2913         vlib_cli_output (vm, "   thread %d on vring %d\n", ci,
2914                          VHOST_VRING_IDX_RX (vui->per_cpu_tx_qid[ci]));
2915       }
2916
2917       vlib_cli_output (vm, "\n");
2918
2919       vlib_cli_output (vm, " Memory regions (total %d)\n", vui->nregions);
2920
2921       if (vui->nregions)
2922         {
2923           vlib_cli_output (vm,
2924                            " region fd    guest_phys_addr    memory_size        userspace_addr     mmap_offset        mmap_addr\n");
2925           vlib_cli_output (vm,
2926                            " ====== ===== ================== ================== ================== ================== ==================\n");
2927         }
2928       for (j = 0; j < vui->nregions; j++)
2929         {
2930           vlib_cli_output (vm,
2931                            "  %d     %-5d 0x%016lx 0x%016lx 0x%016lx 0x%016lx 0x%016lx\n",
2932                            j, vui->region_mmap_fd[j],
2933                            vui->regions[j].guest_phys_addr,
2934                            vui->regions[j].memory_size,
2935                            vui->regions[j].userspace_addr,
2936                            vui->regions[j].mmap_offset,
2937                            pointer_to_uword (vui->region_mmap_addr[j]));
2938         }
2939       for (q = 0; q < VHOST_VRING_MAX_N; q++)
2940         {
2941           if (!vui->vrings[q].started)
2942             continue;
2943
2944           vlib_cli_output (vm, "\n Virtqueue %d (%s%s)\n", q,
2945                            (q & 1) ? "RX" : "TX",
2946                            vui->vrings[q].enabled ? "" : " disabled");
2947
2948           vlib_cli_output (vm,
2949                            "  qsz %d last_avail_idx %d last_used_idx %d\n",
2950                            vui->vrings[q].qsz, vui->vrings[q].last_avail_idx,
2951                            vui->vrings[q].last_used_idx);
2952
2953           if (vui->vrings[q].avail && vui->vrings[q].used)
2954             vlib_cli_output (vm,
2955                              "  avail.flags %x avail.idx %d used.flags %x used.idx %d\n",
2956                              vui->vrings[q].avail->flags,
2957                              vui->vrings[q].avail->idx,
2958                              vui->vrings[q].used->flags,
2959                              vui->vrings[q].used->idx);
2960
2961           int kickfd = UNIX_GET_FD (vui->vrings[q].kickfd_idx);
2962           int callfd = UNIX_GET_FD (vui->vrings[q].callfd_idx);
2963           vlib_cli_output (vm, "  kickfd %d callfd %d errfd %d\n",
2964                            kickfd, callfd, vui->vrings[q].errfd);
2965
2966           if (show_descr)
2967             {
2968               vlib_cli_output (vm, "\n  descriptor table:\n");
2969               vlib_cli_output (vm,
2970                                "   id          addr         len  flags  next      user_addr\n");
2971               vlib_cli_output (vm,
2972                                "  ===== ================== ===== ====== ===== ==================\n");
2973               for (j = 0; j < vui->vrings[q].qsz; j++)
2974                 {
2975                   u32 mem_hint = 0;
2976                   vlib_cli_output (vm,
2977                                    "  %-5d 0x%016lx %-5d 0x%04x %-5d 0x%016lx\n",
2978                                    j, vui->vrings[q].desc[j].addr,
2979                                    vui->vrings[q].desc[j].len,
2980                                    vui->vrings[q].desc[j].flags,
2981                                    vui->vrings[q].desc[j].next,
2982                                    pointer_to_uword (map_guest_mem
2983                                                      (vui,
2984                                                       vui->vrings[q].desc[j].
2985                                                       addr, &mem_hint)));
2986                 }
2987             }
2988         }
2989       vlib_cli_output (vm, "\n");
2990     }
2991 done:
2992   vec_free (hw_if_indices);
2993   return error;
2994 }
2995
2996 /*
2997  * CLI functions
2998  */
2999
3000 /*?
3001  * Create a vHost User interface. Once created, a new virtual interface
3002  * will exist with the name '<em>VirtualEthernet0/0/x</em>', where '<em>x</em>'
3003  * is the next free index.
3004  *
3005  * There are several parameters associated with a vHost interface:
3006  *
3007  * - <b>socket <socket-filename></b> - Name of the linux socket used by QEMU/VM and
3008  * VPP to manage the vHost interface. If socket does not already exist, VPP will
3009  * create the socket.
3010  *
3011  * - <b>server</b> - Optional flag to indicate that VPP should be the server for the
3012  * linux socket. If not provided, VPP will be the client.
3013  *
3014  * - <b>feature-mask <hex></b> - Optional virtio/vhost feature set negotiated at
3015  * startup. By default, all supported features will be advertised. Otherwise,
3016  * provide the set of features desired.
3017  *   - 0x000008000 (15) - VIRTIO_NET_F_MRG_RXBUF
3018  *   - 0x000020000 (17) - VIRTIO_NET_F_CTRL_VQ
3019  *   - 0x000200000 (21) - VIRTIO_NET_F_GUEST_ANNOUNCE
3020  *   - 0x000400000 (22) - VIRTIO_NET_F_MQ
3021  *   - 0x004000000 (26) - VHOST_F_LOG_ALL
3022  *   - 0x008000000 (27) - VIRTIO_F_ANY_LAYOUT
3023  *   - 0x010000000 (28) - VIRTIO_F_INDIRECT_DESC
3024  *   - 0x040000000 (30) - VHOST_USER_F_PROTOCOL_FEATURES
3025  *   - 0x100000000 (32) - VIRTIO_F_VERSION_1
3026  *
3027  * - <b>hwaddr <mac-addr></b> - Optional ethernet address, can be in either
3028  * X:X:X:X:X:X unix or X.X.X cisco format.
3029  *
3030  * - <b>renumber <dev_instance></b> - Optional parameter which allows the instance
3031  * in the name to be specified. If instance already exists, name will be used
3032  * anyway and multiple instances will have the same name. Use with caution.
3033  *
3034  * @cliexpar
3035  * Example of how to create a vhost interface with VPP as the client and all features enabled:
3036  * @cliexstart{create vhost-user socket /tmp/vhost1.sock}
3037  * VirtualEthernet0/0/0
3038  * @cliexend
3039  * Example of how to create a vhost interface with VPP as the server and with just
3040  * multiple queues enabled:
3041  * @cliexstart{create vhost-user socket /tmp/vhost2.sock server feature-mask 0x40400000}
3042  * VirtualEthernet0/0/1
3043  * @cliexend
3044  * Once the vHost interface is created, enable the interface using:
3045  * @cliexcmd{set interface state VirtualEthernet0/0/0 up}
3046 ?*/
3047 /* *INDENT-OFF* */
3048 VLIB_CLI_COMMAND (vhost_user_connect_command, static) = {
3049     .path = "create vhost-user",
3050     .short_help = "create vhost-user socket <socket-filename> [server] [feature-mask <hex>] [hwaddr <mac-addr>] [renumber <dev_instance>]",
3051     .function = vhost_user_connect_command_fn,
3052 };
3053 /* *INDENT-ON* */
3054
3055 /*?
3056  * Delete a vHost User interface using the interface name or the
3057  * software interface index. Use the '<em>show interfaces</em>'
3058  * command to determine the software interface index. On deletion,
3059  * the linux socket will not be deleted.
3060  *
3061  * @cliexpar
3062  * Example of how to delete a vhost interface by name:
3063  * @cliexcmd{delete vhost-user VirtualEthernet0/0/1}
3064  * Example of how to delete a vhost interface by software interface index:
3065  * @cliexcmd{delete vhost-user sw_if_index 1}
3066 ?*/
3067 /* *INDENT-OFF* */
3068 VLIB_CLI_COMMAND (vhost_user_delete_command, static) = {
3069     .path = "delete vhost-user",
3070     .short_help = "delete vhost-user {<interface> | sw_if_index <sw_idx>}",
3071     .function = vhost_user_delete_command_fn,
3072 };
3073
3074 /*?
3075  * Display the attributes of a single vHost User interface (provide interface
3076  * name), multiple vHost User interfaces (provide a list of interface names seperated
3077  * by spaces) or all Vhost User interfaces (omit an interface name to display all
3078  * vHost interfaces).
3079  *
3080  * @cliexpar
3081  * @parblock
3082  * Example of how to display a vhost interface:
3083  * @cliexstart{show vhost-user VirtualEthernet0/0/0}
3084  * Virtio vhost-user interfaces
3085  * Global:
3086  *   coalesce frames 32 time 1e-3
3087  * Interface: VirtualEthernet0/0/0 (ifindex 1)
3088  * virtio_net_hdr_sz 12
3089  *  features mask (0xffffffffffffffff):
3090  *  features (0x50408000):
3091  *    VIRTIO_NET_F_MRG_RXBUF (15)
3092  *    VIRTIO_NET_F_MQ (22)
3093  *    VIRTIO_F_INDIRECT_DESC (28)
3094  *    VHOST_USER_F_PROTOCOL_FEATURES (30)
3095  *   protocol features (0x3)
3096  *    VHOST_USER_PROTOCOL_F_MQ (0)
3097  *    VHOST_USER_PROTOCOL_F_LOG_SHMFD (1)
3098  *
3099  *  socket filename /tmp/vhost1.sock type client errno "Success"
3100  *
3101  * rx placement:
3102  *    thread 1 on vring 1
3103  *    thread 1 on vring 5
3104  *    thread 2 on vring 3
3105  *    thread 2 on vring 7
3106  *  tx placement: spin-lock
3107  *    thread 0 on vring 0
3108  *    thread 1 on vring 2
3109  *    thread 2 on vring 0
3110  *
3111  * Memory regions (total 2)
3112  * region fd    guest_phys_addr    memory_size        userspace_addr     mmap_offset        mmap_addr
3113  * ====== ===== ================== ================== ================== ================== ==================
3114  *   0     60    0x0000000000000000 0x00000000000a0000 0x00002aaaaac00000 0x0000000000000000 0x00002aab2b400000
3115  *   1     61    0x00000000000c0000 0x000000003ff40000 0x00002aaaaacc0000 0x00000000000c0000 0x00002aababcc0000
3116  *
3117  *  Virtqueue 0 (TX)
3118  *   qsz 256 last_avail_idx 0 last_used_idx 0
3119  *   avail.flags 1 avail.idx 128 used.flags 1 used.idx 0
3120  *   kickfd 62 callfd 64 errfd -1
3121  *
3122  *  Virtqueue 1 (RX)
3123  *   qsz 256 last_avail_idx 0 last_used_idx 0
3124  *   avail.flags 1 avail.idx 0 used.flags 1 used.idx 0
3125  *   kickfd 65 callfd 66 errfd -1
3126  *
3127  *  Virtqueue 2 (TX)
3128  *   qsz 256 last_avail_idx 0 last_used_idx 0
3129  *   avail.flags 1 avail.idx 128 used.flags 1 used.idx 0
3130  *   kickfd 63 callfd 70 errfd -1
3131  *
3132  *  Virtqueue 3 (RX)
3133  *   qsz 256 last_avail_idx 0 last_used_idx 0
3134  *   avail.flags 1 avail.idx 0 used.flags 1 used.idx 0
3135  *   kickfd 72 callfd 74 errfd -1
3136  *
3137  *  Virtqueue 4 (TX disabled)
3138  *   qsz 256 last_avail_idx 0 last_used_idx 0
3139  *   avail.flags 1 avail.idx 0 used.flags 1 used.idx 0
3140  *   kickfd 76 callfd 78 errfd -1
3141  *
3142  *  Virtqueue 5 (RX disabled)
3143  *   qsz 256 last_avail_idx 0 last_used_idx 0
3144  *   avail.flags 1 avail.idx 0 used.flags 1 used.idx 0
3145  *   kickfd 80 callfd 82 errfd -1
3146  *
3147  *  Virtqueue 6 (TX disabled)
3148  *   qsz 256 last_avail_idx 0 last_used_idx 0
3149  *  avail.flags 1 avail.idx 0 used.flags 1 used.idx 0
3150  *   kickfd 84 callfd 86 errfd -1
3151  *
3152  *  Virtqueue 7 (RX disabled)
3153  *   qsz 256 last_avail_idx 0 last_used_idx 0
3154  *   avail.flags 1 avail.idx 0 used.flags 1 used.idx 0
3155  *   kickfd 88 callfd 90 errfd -1
3156  *
3157  * @cliexend
3158  *
3159  * The optional '<em>descriptors</em>' parameter will display the same output as
3160  * the previous example but will include the descriptor table for each queue.
3161  * The output is truncated below:
3162  * @cliexstart{show vhost-user VirtualEthernet0/0/0 descriptors}
3163  * Virtio vhost-user interfaces
3164  * Global:
3165  *   coalesce frames 32 time 1e-3
3166  * Interface: VirtualEthernet0/0/0 (ifindex 1)
3167  * virtio_net_hdr_sz 12
3168  *  features mask (0xffffffffffffffff):
3169  *  features (0x50408000):
3170  *    VIRTIO_NET_F_MRG_RXBUF (15)
3171  *    VIRTIO_NET_F_MQ (22)
3172  * :
3173  *  Virtqueue 0 (TX)
3174  *   qsz 256 last_avail_idx 0 last_used_idx 0
3175  *   avail.flags 1 avail.idx 128 used.flags 1 used.idx 0
3176  *   kickfd 62 callfd 64 errfd -1
3177  *
3178  *   descriptor table:
3179  *    id          addr         len  flags  next      user_addr
3180  *   ===== ================== ===== ====== ===== ==================
3181  *   0     0x0000000010b6e974 2060  0x0002 1     0x00002aabbc76e974
3182  *   1     0x0000000010b6e034 2060  0x0002 2     0x00002aabbc76e034
3183  *   2     0x0000000010b6d6f4 2060  0x0002 3     0x00002aabbc76d6f4
3184  *   3     0x0000000010b6cdb4 2060  0x0002 4     0x00002aabbc76cdb4
3185  *   4     0x0000000010b6c474 2060  0x0002 5     0x00002aabbc76c474
3186  *   5     0x0000000010b6bb34 2060  0x0002 6     0x00002aabbc76bb34
3187  *   6     0x0000000010b6b1f4 2060  0x0002 7     0x00002aabbc76b1f4
3188  *   7     0x0000000010b6a8b4 2060  0x0002 8     0x00002aabbc76a8b4
3189  *   8     0x0000000010b69f74 2060  0x0002 9     0x00002aabbc769f74
3190  *   9     0x0000000010b69634 2060  0x0002 10    0x00002aabbc769634
3191  *   10    0x0000000010b68cf4 2060  0x0002 11    0x00002aabbc768cf4
3192  * :
3193  *   249   0x0000000000000000 0     0x0000 250   0x00002aab2b400000
3194  *   250   0x0000000000000000 0     0x0000 251   0x00002aab2b400000
3195  *   251   0x0000000000000000 0     0x0000 252   0x00002aab2b400000
3196  *   252   0x0000000000000000 0     0x0000 253   0x00002aab2b400000
3197  *   253   0x0000000000000000 0     0x0000 254   0x00002aab2b400000
3198  *   254   0x0000000000000000 0     0x0000 255   0x00002aab2b400000
3199  *   255   0x0000000000000000 0     0x0000 32768 0x00002aab2b400000
3200  *
3201  *  Virtqueue 1 (RX)
3202  *   qsz 256 last_avail_idx 0 last_used_idx 0
3203  * :
3204  * @cliexend
3205  * @endparblock
3206 ?*/
3207 /* *INDENT-OFF* */
3208 VLIB_CLI_COMMAND (show_vhost_user_command, static) = {
3209     .path = "show vhost-user",
3210     .short_help = "show vhost-user [<interface> [<interface> [..]]] [descriptors]",
3211     .function = show_vhost_user_command_fn,
3212 };
3213 /* *INDENT-ON* */
3214
3215 static clib_error_t *
3216 vhost_user_config (vlib_main_t * vm, unformat_input_t * input)
3217 {
3218   vhost_user_main_t *vum = &vhost_user_main;
3219
3220   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
3221     {
3222       if (unformat (input, "coalesce-frames %d", &vum->coalesce_frames))
3223         ;
3224       else if (unformat (input, "coalesce-time %f", &vum->coalesce_time))
3225         ;
3226       else if (unformat (input, "dont-dump-memory"))
3227         vum->dont_dump_vhost_user_memory = 1;
3228       else
3229         return clib_error_return (0, "unknown input `%U'",
3230                                   format_unformat_error, input);
3231     }
3232
3233   return 0;
3234 }
3235
3236 /* vhost-user { ... } configuration. */
3237 VLIB_CONFIG_FUNCTION (vhost_user_config, "vhost-user");
3238
3239 void
3240 vhost_user_unmap_all (void)
3241 {
3242   vhost_user_main_t *vum = &vhost_user_main;
3243   vhost_user_intf_t *vui;
3244
3245   if (vum->dont_dump_vhost_user_memory)
3246     {
3247       pool_foreach (vui, vum->vhost_user_interfaces,
3248                     unmap_all_mem_regions (vui);
3249         );
3250     }
3251 }
3252
3253 static clib_error_t *
3254 vhost_thread_command_fn (vlib_main_t * vm,
3255                          unformat_input_t * input, vlib_cli_command_t * cmd)
3256 {
3257   unformat_input_t _line_input, *line_input = &_line_input;
3258   u32 worker_thread_index;
3259   u32 sw_if_index;
3260   u8 del = 0;
3261   int rv;
3262
3263   /* Get a line of input. */
3264   if (!unformat_user (input, unformat_line_input, line_input))
3265     return 0;
3266
3267   if (!unformat
3268       (line_input, "%U %d", unformat_vnet_sw_interface, vnet_get_main (),
3269        &sw_if_index, &worker_thread_index))
3270     {
3271       unformat_free (line_input);
3272       return clib_error_return (0, "unknown input `%U'",
3273                                 format_unformat_error, input);
3274     }
3275
3276   if (unformat (line_input, "del"))
3277     del = 1;
3278
3279   if ((rv =
3280        vhost_user_thread_placement (sw_if_index, worker_thread_index, del)))
3281     return clib_error_return (0, "vhost_user_thread_placement returned %d",
3282                               rv);
3283   return 0;
3284 }
3285
3286
3287 /*?
3288  * This command is used to move the RX processing for the given
3289  * interfaces to the provided thread. If the '<em>del</em>' option is used,
3290  * the forced thread assignment is removed and the thread assigment is
3291  * reassigned automatically. Use '<em>show vhost-user <interface></em>'
3292  * to see the thread assignment.
3293  *
3294  * @cliexpar
3295  * Example of how to move the RX processing for a given interface to a given thread:
3296  * @cliexcmd{vhost thread VirtualEthernet0/0/0 1}
3297  * Example of how to remove the forced thread assignment for a given interface:
3298  * @cliexcmd{vhost thread VirtualEthernet0/0/0 1 del}
3299 ?*/
3300 /* *INDENT-OFF* */
3301 VLIB_CLI_COMMAND (vhost_user_thread_command, static) = {
3302     .path = "vhost thread",
3303     .short_help = "vhost thread <iface> <worker-index> [del]",
3304     .function = vhost_thread_command_fn,
3305 };
3306 /* *INDENT-ON* */
3307
3308 /*
3309  * fd.io coding-style-patch-verification: ON
3310  *
3311  * Local Variables:
3312  * eval: (c-set-style "gnu")
3313  * End:
3314  */