vlib: add missing file template descriptions
[vpp.git] / src / vlibmemory / socket_api.c
1 /*
2  *------------------------------------------------------------------
3  * socket_api.c
4  *
5  * Copyright (c) 2009 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 <sys/types.h>
21 #include <sys/socket.h>
22 #include <netinet/in.h>
23 #include <sys/ioctl.h>
24 #include <fcntl.h>
25 #include <sys/stat.h>
26
27 #include <vppinfra/byte_order.h>
28 #include <svm/ssvm.h>
29 #include <vlibmemory/api.h>
30
31 #include <vlibmemory/vl_memory_msg_enum.h>
32
33 #define vl_typedefs             /* define message structures */
34 #include <vlibmemory/vl_memory_api_h.h>
35 #undef vl_typedefs
36
37 /* instantiate all the print functions we know about */
38 #define vl_print(handle, ...) vlib_cli_output (handle, __VA_ARGS__)
39 #define vl_printfun
40 #include <vlibmemory/vl_memory_api_h.h>
41 #undef vl_printfun
42
43 /* instantiate all the endian swap functions we know about */
44 #define vl_endianfun
45 #include <vlibmemory/vl_memory_api_h.h>
46 #undef vl_endianfun
47
48 socket_main_t socket_main;
49
50 #define SOCK_API_REG_HANDLE_BIT (1<<31)
51
52 static u32
53 sock_api_registration_handle (vl_api_registration_t * regp)
54 {
55   ASSERT (regp->vl_api_registration_pool_index < SOCK_API_REG_HANDLE_BIT);
56   return regp->vl_api_registration_pool_index | SOCK_API_REG_HANDLE_BIT;
57 }
58
59 static u32
60 socket_api_registration_handle_to_index (u32 reg_index)
61 {
62   return (reg_index & ~SOCK_API_REG_HANDLE_BIT);
63 }
64
65 u8
66 vl_socket_api_registration_handle_is_valid (u32 reg_handle)
67 {
68   return ((reg_handle & SOCK_API_REG_HANDLE_BIT) != 0);
69 }
70
71 void
72 vl_sock_api_dump_clients (vlib_main_t * vm, api_main_t * am)
73 {
74   vl_api_registration_t *reg;
75   socket_main_t *sm = &socket_main;
76   clib_file_t *f;
77
78   /*
79    * Must have at least one active client, not counting the
80    * REGISTRATION_TYPE_SOCKET_LISTEN bind/accept socket
81    */
82   if (pool_elts (sm->registration_pool) < 2)
83     return;
84
85   vlib_cli_output (vm, "Socket clients");
86   vlib_cli_output (vm, "%20s %8s", "Name", "Fildesc");
87     /* *INDENT-OFF* */
88     pool_foreach (reg, sm->registration_pool)
89      {
90         if (reg->registration_type == REGISTRATION_TYPE_SOCKET_SERVER) {
91             f = vl_api_registration_file (reg);
92             vlib_cli_output (vm, "%20s %8d", reg->name, f->file_descriptor);
93         }
94     }
95 /* *INDENT-ON* */
96 }
97
98 vl_api_registration_t *
99 vl_socket_api_client_handle_to_registration (u32 handle)
100 {
101   socket_main_t *sm = &socket_main;
102   u32 index = socket_api_registration_handle_to_index (handle);
103   if (pool_is_free_index (sm->registration_pool, index))
104     {
105 #if DEBUG > 2
106       clib_warning ("Invalid index %d\n", index);
107 #endif
108       return 0;
109     }
110   return pool_elt_at_index (sm->registration_pool, index);
111 }
112
113 void
114 vl_socket_api_send (vl_api_registration_t * rp, u8 * elem)
115 {
116 #if CLIB_DEBUG > 1
117   u32 output_length;
118 #endif
119   socket_main_t *sm = &socket_main;
120   u16 msg_id = ntohs (*(u16 *) elem);
121   api_main_t *am = vlibapi_get_main ();
122   msgbuf_t *mb = (msgbuf_t *) (elem - offsetof (msgbuf_t, data));
123   vl_api_registration_t *sock_rp;
124   clib_file_main_t *fm = &file_main;
125   clib_error_t *error;
126   clib_file_t *cf;
127
128   cf = vl_api_registration_file (rp);
129   ASSERT (rp->registration_type > REGISTRATION_TYPE_SHMEM);
130
131   if (msg_id >= vec_len (am->api_trace_cfg))
132     {
133       clib_warning ("id out of range: %d", msg_id);
134       vl_msg_api_free ((void *) elem);
135       return;
136     }
137
138   sock_rp = pool_elt_at_index (sm->registration_pool,
139                                rp->vl_api_registration_pool_index);
140   ASSERT (sock_rp);
141
142   /* Add the msgbuf_t to the output vector */
143   vec_add (sock_rp->output_vector, (u8 *) mb, sizeof (*mb));
144
145   /* Try to send the message and save any error like
146    * we do in the input epoll loop */
147   vec_add (sock_rp->output_vector, elem, ntohl (mb->data_len));
148   error = clib_file_write (cf);
149   unix_save_error (&unix_main, error);
150
151   /* If we didn't finish sending everything, wait for tx space */
152   if (vec_len (sock_rp->output_vector) > 0
153       && !(cf->flags & UNIX_FILE_DATA_AVAILABLE_TO_WRITE))
154     {
155       cf->flags |= UNIX_FILE_DATA_AVAILABLE_TO_WRITE;
156       fm->file_update (cf, UNIX_FILE_UPDATE_MODIFY);
157     }
158
159 #if CLIB_DEBUG > 1
160   output_length = sizeof (*mb) + ntohl (mb->data_len);
161   clib_warning ("wrote %u bytes to fd %d", output_length,
162                 cf->file_descriptor);
163 #endif
164
165   vl_msg_api_free ((void *) elem);
166 }
167
168 void
169 vl_socket_free_registration_index (u32 pool_index)
170 {
171   int i;
172   vl_api_registration_t *rp;
173   void vl_api_call_reaper_functions (u32 client_index);
174
175   if (pool_is_free_index (socket_main.registration_pool, pool_index))
176     {
177       clib_warning ("main pool index %d already free", pool_index);
178       return;
179     }
180   rp = pool_elt_at_index (socket_main.registration_pool, pool_index);
181
182   vl_api_call_reaper_functions (pool_index);
183
184   ASSERT (rp->registration_type != REGISTRATION_TYPE_FREE);
185   for (i = 0; i < vec_len (rp->additional_fds_to_close); i++)
186     if (close (rp->additional_fds_to_close[i]) < 0)
187       clib_unix_warning ("close");
188   vec_free (rp->additional_fds_to_close);
189   vec_free (rp->name);
190   vec_free (rp->unprocessed_input);
191   vec_free (rp->output_vector);
192   rp->registration_type = REGISTRATION_TYPE_FREE;
193   pool_put (socket_main.registration_pool, rp);
194 }
195
196 void
197 vl_socket_process_api_msg (vl_api_registration_t * rp, i8 * input_v)
198 {
199   msgbuf_t *mbp = (msgbuf_t *) input_v;
200
201   u8 *the_msg = (u8 *) (mbp->data);
202   socket_main.current_rp = rp;
203   vl_msg_api_socket_handler (the_msg);
204   socket_main.current_rp = 0;
205 }
206
207 /*
208  * Read function for API socket.
209  *
210  * Read data from socket, invoke SOCKET_READ_EVENT
211  * for each fully read API message, return 0.
212  * Store incomplete data for next invocation to continue.
213  *
214  * On severe read error, the file is closed.
215  *
216  * As reading is single threaded,
217  * socket_main.input_buffer is used temporarily.
218  * Even its length is modified, but always restored before return.
219  *
220  * Incomplete data is copied into a vector,
221  * pointer saved in registration's unprocessed_input.
222  */
223 clib_error_t *
224 vl_socket_read_ready (clib_file_t * uf)
225 {
226   clib_file_main_t *fm = &file_main;
227   vlib_main_t *vm = vlib_get_main ();
228   vl_api_registration_t *rp;
229   /* n is the size of data read to input_buffer */
230   int n;
231   /* msg_buffer vector can point to input_buffer or unprocessed_input */
232   i8 *msg_buffer = 0;
233   /* data_for_process is a vector containing one full message, incl msgbuf_t */
234   u8 *data_for_process;
235   /* msgbuf_len is the size of one message, including sizeof (msgbuf_t) */
236   u32 msgbuf_len;
237   u32 save_input_buffer_length = vec_len (socket_main.input_buffer);
238   vl_socket_args_for_process_t *a;
239   u32 reg_index = uf->private_data;
240
241   rp = vl_socket_get_registration (reg_index);
242
243   /* Ignore unprocessed_input for now, n describes input_buffer for now. */
244   n = read (uf->file_descriptor, socket_main.input_buffer,
245             vec_len (socket_main.input_buffer));
246
247   if (n <= 0)
248     {
249       if (errno != EAGAIN)
250         {
251           /* Severe error, close the file. */
252           clib_file_del (fm, uf);
253           vl_socket_free_registration_index (reg_index);
254         }
255       /* EAGAIN means we do not close the file, but no data to process anyway. */
256       return 0;
257     }
258
259   /* Fake smaller length teporarily, so input_buffer can be used as msg_buffer. */
260   _vec_len (socket_main.input_buffer) = n;
261
262   /*
263    * Look for bugs here. This code is tricky because
264    * data read from a stream socket does not honor message
265    * boundaries. In the case of a long message (>4K bytes)
266    * we have to do (at least) 2 reads, etc.
267    */
268   /* Determine msg_buffer. */
269   if (vec_len (rp->unprocessed_input))
270     {
271       vec_append (rp->unprocessed_input, socket_main.input_buffer);
272       msg_buffer = rp->unprocessed_input;
273     }
274   else
275     {
276       msg_buffer = socket_main.input_buffer;
277     }
278   /* Loop to process any full messages. */
279   ASSERT (vec_len (msg_buffer) > 0);
280   do
281     {
282       /* Here, we are not sure how big a chunk of message we have left. */
283       /* Do we at least know how big the full message will be? */
284       if (vec_len (msg_buffer) <= sizeof (msgbuf_t))
285         /* No, so fragment is not a full message. */
286         goto save_and_split;
287
288       /* Now we know how big the full message will be. */
289       msgbuf_len =
290         ntohl (((msgbuf_t *) msg_buffer)->data_len) + sizeof (msgbuf_t);
291
292       /* But do we have a full message? */
293       if (msgbuf_len > vec_len (msg_buffer))
294         {
295         save_and_split:
296           /* We don't have the entire message yet. */
297           /* If msg_buffer is unprocessed_input, nothing needs to be done. */
298           if (msg_buffer == socket_main.input_buffer)
299             /* But if we were using the input buffer, save the fragment. */
300             {
301               ASSERT (vec_len (rp->unprocessed_input) == 0);
302               vec_validate (rp->unprocessed_input, vec_len (msg_buffer) - 1);
303               clib_memcpy_fast (rp->unprocessed_input, msg_buffer,
304                                 vec_len (msg_buffer));
305               _vec_len (rp->unprocessed_input) = vec_len (msg_buffer);
306             }
307           /* No more full messages, restore original input_buffer length. */
308           _vec_len (socket_main.input_buffer) = save_input_buffer_length;
309           return 0;
310         }
311
312       /*
313        * We have at least one full message.
314        * But msg_buffer can contain more data, so copy one message data
315        * so we can overwrite its length to what single message has.
316        */
317       data_for_process = (u8 *) vec_dup (msg_buffer);
318       _vec_len (data_for_process) = msgbuf_len;
319       /* Everything is ready to signal the SOCKET_READ_EVENT. */
320       pool_get (socket_main.process_args, a);
321       a->reg_index = reg_index;
322       a->data = data_for_process;
323
324       vlib_process_signal_event (vm, vl_api_clnt_node.index,
325                                  SOCKET_READ_EVENT,
326                                  a - socket_main.process_args);
327       if (vec_len (msg_buffer) > msgbuf_len)
328         /* There are some fragments left. Shrink the msg_buffer to simplify logic. */
329         vec_delete (msg_buffer, msgbuf_len, 0);
330       else
331         /* We are done with msg_buffer. */
332         _vec_len (msg_buffer) = 0;
333     }
334   while (vec_len (msg_buffer) > 0);
335
336   /* Restore input_buffer, it could have been msg_buffer. */
337   _vec_len (socket_main.input_buffer) = save_input_buffer_length;
338   return 0;
339 }
340
341 clib_error_t *
342 vl_socket_write_ready (clib_file_t * uf)
343 {
344   clib_file_main_t *fm = &file_main;
345   vl_api_registration_t *rp;
346   int n;
347
348   rp = pool_elt_at_index (socket_main.registration_pool, uf->private_data);
349
350   /* Flush output vector. */
351   size_t total_bytes = vec_len (rp->output_vector);
352   size_t bytes_to_send, remaining_bytes = total_bytes;
353   void *p = rp->output_vector;
354   while (remaining_bytes > 0)
355     {
356       bytes_to_send = remaining_bytes > 4096 ? 4096 : remaining_bytes;
357       n = write (uf->file_descriptor, p, bytes_to_send);
358       if (n < 0)
359         {
360           if (errno == EAGAIN)
361             {
362               break;
363             }
364 #if DEBUG > 2
365           clib_warning ("write error, close the file...\n");
366 #endif
367           clib_file_del (fm, uf);
368           vl_socket_free_registration_index (rp -
369                                              socket_main.registration_pool);
370           return 0;
371         }
372       remaining_bytes -= bytes_to_send;
373       p += bytes_to_send;
374     }
375
376   vec_delete (rp->output_vector, total_bytes - remaining_bytes, 0);
377   if (vec_len (rp->output_vector) <= 0
378       && (uf->flags & UNIX_FILE_DATA_AVAILABLE_TO_WRITE))
379     {
380       uf->flags &= ~UNIX_FILE_DATA_AVAILABLE_TO_WRITE;
381       fm->file_update (uf, UNIX_FILE_UPDATE_MODIFY);
382     }
383
384   return 0;
385 }
386
387 clib_error_t *
388 vl_socket_error_ready (clib_file_t * uf)
389 {
390   vl_api_registration_t *rp;
391   clib_file_main_t *fm = &file_main;
392
393   rp = pool_elt_at_index (socket_main.registration_pool, uf->private_data);
394   clib_file_del (fm, uf);
395   vl_socket_free_registration_index (rp - socket_main.registration_pool);
396
397   return 0;
398 }
399
400 void
401 socksvr_file_add (clib_file_main_t * fm, int fd)
402 {
403   vl_api_registration_t *rp;
404   clib_file_t template = { 0 };
405
406   pool_get (socket_main.registration_pool, rp);
407   clib_memset (rp, 0, sizeof (*rp));
408
409   template.read_function = vl_socket_read_ready;
410   template.write_function = vl_socket_write_ready;
411   template.error_function = vl_socket_error_ready;
412   template.file_descriptor = fd;
413   template.description = format (0, "socksrv");
414   template.private_data = rp - socket_main.registration_pool;
415
416   rp->registration_type = REGISTRATION_TYPE_SOCKET_SERVER;
417   rp->vl_api_registration_pool_index = rp - socket_main.registration_pool;
418   rp->clib_file_index = clib_file_add (fm, &template);
419 }
420
421 static clib_error_t *
422 socksvr_accept_ready (clib_file_t * uf)
423 {
424   clib_file_main_t *fm = &file_main;
425   socket_main_t *sm = &socket_main;
426   clib_socket_t *sock = &sm->socksvr_listen_socket;
427   clib_socket_t client;
428   clib_error_t *error;
429
430   error = clib_socket_accept (sock, &client);
431   if (error)
432     return error;
433
434   socksvr_file_add (fm, client.fd);
435   return 0;
436 }
437
438 static clib_error_t *
439 socksvr_bogus_write (clib_file_t * uf)
440 {
441   clib_warning ("why am I here?");
442   return 0;
443 }
444
445 /*
446  * vl_api_sockclnt_create_t_handler
447  */
448 void
449 vl_api_sockclnt_create_t_handler (vl_api_sockclnt_create_t * mp)
450 {
451   vl_api_registration_t *regp;
452   vl_api_sockclnt_create_reply_t *rp;
453   api_main_t *am = vlibapi_get_main ();
454   hash_pair_t *hp;
455   int rv = 0;
456   u32 nmsg = hash_elts (am->msg_index_by_name_and_crc);
457   u32 i = 0;
458
459   regp = socket_main.current_rp;
460
461   ASSERT (regp->registration_type == REGISTRATION_TYPE_SOCKET_SERVER);
462
463   regp->name = format (0, "%s%c", mp->name, 0);
464
465   u32 size = sizeof (*rp) + (nmsg * sizeof (vl_api_message_table_entry_t));
466   rp = vl_msg_api_alloc_zero (size);
467   rp->_vl_msg_id = htons (VL_API_SOCKCLNT_CREATE_REPLY);
468   rp->index = htonl (sock_api_registration_handle (regp));
469   rp->context = mp->context;
470   rp->response = htonl (rv);
471   rp->count = htons (nmsg);
472
473   /* *INDENT-OFF* */
474   hash_foreach_pair (hp, am->msg_index_by_name_and_crc,
475   ({
476     rp->message_table[i].index = htons(hp->value[0]);
477     (void) strncpy_s((char *)rp->message_table[i].name,
478                      64 /* bytes of space at dst */,
479                      (char *)hp->key,
480                      64-1 /* chars to copy, without zero byte. */);
481     i++;
482   }));
483   /* *INDENT-ON* */
484   vl_api_send_msg (regp, (u8 *) rp);
485 }
486
487 /*
488  * vl_api_sockclnt_delete_t_handler
489  */
490 void
491 vl_api_sockclnt_delete_t_handler (vl_api_sockclnt_delete_t * mp)
492 {
493   vl_api_registration_t *regp;
494   vl_api_sockclnt_delete_reply_t *rp;
495
496   regp = vl_api_client_index_to_registration (mp->client_index);
497   if (!regp)
498     return;
499
500   u32 reg_index = socket_api_registration_handle_to_index (ntohl (mp->index));
501   rp = vl_msg_api_alloc (sizeof (*rp));
502   rp->_vl_msg_id = htons (VL_API_SOCKCLNT_DELETE_REPLY);
503   rp->context = mp->context;
504
505   if (!pool_is_free_index (socket_main.registration_pool, reg_index))
506     {
507       rp->response = htonl (1);
508       vl_api_send_msg (regp, (u8 *) rp);
509
510       vl_api_registration_del_file (regp);
511       vl_socket_free_registration_index (reg_index);
512     }
513   else
514     {
515       clib_warning ("unknown client ID %d", reg_index);
516       rp->response = htonl (-1);
517       vl_api_send_msg (regp, (u8 *) rp);
518     }
519 }
520
521 clib_error_t *
522 vl_sock_api_send_fd_msg (int socket_fd, int fds[], int n_fds)
523 {
524   struct msghdr mh = { 0 };
525   struct iovec iov[1];
526   char ctl[CMSG_SPACE (sizeof (int) * n_fds)];
527   struct cmsghdr *cmsg;
528   char *msg = "fdmsg";
529   int rv;
530
531   iov[0].iov_base = msg;
532   iov[0].iov_len = strlen (msg);
533   mh.msg_iov = iov;
534   mh.msg_iovlen = 1;
535
536   clib_memset (&ctl, 0, sizeof (ctl));
537   mh.msg_control = ctl;
538   mh.msg_controllen = sizeof (ctl);
539   cmsg = CMSG_FIRSTHDR (&mh);
540   cmsg->cmsg_len = CMSG_LEN (sizeof (int) * n_fds);
541   cmsg->cmsg_level = SOL_SOCKET;
542   cmsg->cmsg_type = SCM_RIGHTS;
543   clib_memcpy_fast (CMSG_DATA (cmsg), fds, sizeof (int) * n_fds);
544
545   while ((rv = sendmsg (socket_fd, &mh, 0)) < 0 && errno == EAGAIN)
546     ;
547   if (rv < 0)
548     return clib_error_return_unix (0, "sendmsg");
549   return 0;
550 }
551
552 vl_api_shm_elem_config_t *
553 vl_api_make_shm_config (vl_api_sock_init_shm_t * mp)
554 {
555   vl_api_shm_elem_config_t *config = 0, *c;
556   u64 cfg;
557   int i;
558
559   if (!mp->nitems)
560     {
561       vec_validate (config, 6);
562       config[0].type = VL_API_VLIB_RING;
563       config[0].size = 256;
564       config[0].count = 32;
565
566       config[1].type = VL_API_VLIB_RING;
567       config[1].size = 1024;
568       config[1].count = 16;
569
570       config[2].type = VL_API_VLIB_RING;
571       config[2].size = 4096;
572       config[2].count = 2;
573
574       config[3].type = VL_API_CLIENT_RING;
575       config[3].size = 256;
576       config[3].count = 32;
577
578       config[4].type = VL_API_CLIENT_RING;
579       config[4].size = 1024;
580       config[4].count = 16;
581
582       config[5].type = VL_API_CLIENT_RING;
583       config[5].size = 4096;
584       config[5].count = 2;
585
586       config[6].type = VL_API_QUEUE;
587       config[6].count = 128;
588       config[6].size = sizeof (uword);
589     }
590   else
591     {
592       vec_validate (config, mp->nitems - 1);
593       for (i = 0; i < mp->nitems; i++)
594         {
595           cfg = mp->configs[i];
596           /* Pretty much a hack but it avoids defining our own api type
597            * in memclnt.api */
598           c = (vl_api_shm_elem_config_t *) & cfg;
599           config[i].type = c->type;
600           config[i].count = c->count;
601           config[i].size = c->size;
602         }
603     }
604   return config;
605 }
606
607 /*
608  * Bootstrap shm api using the socket api
609  */
610 void
611 vl_api_sock_init_shm_t_handler (vl_api_sock_init_shm_t * mp)
612 {
613   vl_api_sock_init_shm_reply_t *rmp;
614   ssvm_private_t _memfd_private, *memfd = &_memfd_private;
615   svm_map_region_args_t _args, *a = &_args;
616   vl_api_registration_t *regp;
617   api_main_t *am = vlibapi_get_main ();
618   svm_region_t *vlib_rp;
619   clib_file_t *cf;
620   vl_api_shm_elem_config_t *config = 0;
621   vl_shmem_hdr_t *shmem_hdr;
622   int rv, tries = 1000;
623
624   regp = vl_api_client_index_to_registration (mp->client_index);
625   if (regp == 0)
626     {
627       clib_warning ("API client disconnected");
628       return;
629     }
630   if (regp->registration_type != REGISTRATION_TYPE_SOCKET_SERVER)
631     {
632       rv = -31;                 /* VNET_API_ERROR_INVALID_REGISTRATION */
633       goto reply;
634     }
635
636   /*
637    * Set up a memfd segment of the requested size wherein the
638    * shmem data structures will be initialized
639    */
640   clib_memset (memfd, 0, sizeof (*memfd));
641   memfd->ssvm_size = mp->requested_size;
642   memfd->requested_va = 0ULL;
643   memfd->is_server = 1;
644   memfd->name = format (0, "%s%c", regp->name, 0);
645
646   if ((rv = ssvm_server_init_memfd (memfd)))
647     goto reply;
648
649   /* delete the unused heap created in ssvm_server_init_memfd and mark it
650    * accessible again for ASAN */
651   clib_mem_destroy_heap (memfd->sh->heap);
652   CLIB_MEM_UNPOISON ((void *) memfd->sh->ssvm_va, memfd->ssvm_size);
653
654   /* Remember to close this fd when the socket connection goes away */
655   vec_add1 (regp->additional_fds_to_close, memfd->fd);
656
657   /*
658    * Create a plausible svm_region in the memfd backed segment
659    */
660   clib_memset (a, 0, sizeof (*a));
661   a->baseva = memfd->sh->ssvm_va + MMAP_PAGESIZE;
662   a->size = memfd->ssvm_size - MMAP_PAGESIZE;
663   /* $$$$ might want a different config parameter */
664   a->pvt_heap_size = am->api_pvt_heap_size;
665   a->flags = SVM_FLAGS_MHEAP;
666   svm_region_init_mapped_region (a, (svm_region_t *) a->baseva);
667
668   /*
669    * Part deux, initialize the svm_region_t shared-memory header
670    * api allocation rings, and so on.
671    */
672   config = vl_api_make_shm_config (mp);
673   vlib_rp = (svm_region_t *) a->baseva;
674   vl_init_shmem (vlib_rp, config, 1 /* is_vlib (dont-care) */ ,
675                  1 /* is_private */ );
676
677   /* Remember who created this. Needs to be post vl_init_shmem */
678   shmem_hdr = (vl_shmem_hdr_t *) vlib_rp->user_ctx;
679   shmem_hdr->clib_file_index = vl_api_registration_file_index (regp);
680
681   vec_add1 (am->vlib_private_rps, vlib_rp);
682   memfd->sh->ready = 1;
683   vec_free (config);
684
685   /* Recompute the set of input queues to poll in memclnt_process */
686   vec_reset_length (vl_api_queue_cursizes);
687
688 reply:
689
690   rmp = vl_msg_api_alloc (sizeof (*rmp));
691   rmp->_vl_msg_id = htons (VL_API_SOCK_INIT_SHM_REPLY);
692   rmp->context = mp->context;
693   rmp->retval = htonl (rv);
694
695   /*
696    * Note: The reply message needs to make it out the back door
697    * before we send the magic fd message. That's taken care of by
698    * the send function.
699    */
700   vl_socket_api_send (regp, (u8 *) rmp);
701
702   if (rv != 0)
703     return;
704
705   /* Send the magic "here's your sign (aka fd)" socket message */
706   cf = vl_api_registration_file (regp);
707
708   /* Wait for reply to be consumed before sending the fd */
709   while (tries-- > 0)
710     {
711       int bytes;
712       rv = ioctl (cf->file_descriptor, TIOCOUTQ, &bytes);
713       if (rv < 0)
714         {
715           clib_unix_warning ("ioctl returned");
716           break;
717         }
718       if (bytes == 0)
719         break;
720       usleep (1e3);
721     }
722
723   vl_sock_api_send_fd_msg (cf->file_descriptor, &memfd->fd, 1);
724 }
725
726 #define foreach_vlib_api_msg                            \
727   _(SOCKCLNT_CREATE, sockclnt_create, 1)                \
728   _(SOCKCLNT_DELETE, sockclnt_delete, 1)                \
729   _(SOCK_INIT_SHM, sock_init_shm, 1)
730
731 clib_error_t *
732 vl_sock_api_init (vlib_main_t * vm)
733 {
734   clib_file_main_t *fm = &file_main;
735   clib_file_t template = { 0 };
736   vl_api_registration_t *rp;
737   socket_main_t *sm = &socket_main;
738   clib_socket_t *sock = &sm->socksvr_listen_socket;
739   clib_error_t *error;
740
741   /* If not explicitly configured, do not bind/enable, etc. */
742   if (sm->socket_name == 0)
743     return 0;
744
745 #define _(N,n,t)                                                \
746     vl_msg_api_set_handlers(VL_API_##N, #n,                     \
747                            vl_api_##n##_t_handler,              \
748                            vl_noop_handler,                     \
749                            vl_api_##n##_t_endian,               \
750                            vl_api_##n##_t_print,                \
751                            sizeof(vl_api_##n##_t), t);
752   foreach_vlib_api_msg;
753 #undef _
754
755   vec_resize (sm->input_buffer, 4096);
756
757   sock->config = (char *) sm->socket_name;
758   sock->flags = CLIB_SOCKET_F_IS_SERVER | CLIB_SOCKET_F_ALLOW_GROUP_WRITE;
759   error = clib_socket_init (sock);
760   if (error)
761     return error;
762
763   pool_get (sm->registration_pool, rp);
764   clib_memset (rp, 0, sizeof (*rp));
765
766   rp->registration_type = REGISTRATION_TYPE_SOCKET_LISTEN;
767
768   template.read_function = socksvr_accept_ready;
769   template.write_function = socksvr_bogus_write;
770   template.file_descriptor = sock->fd;
771   template.description = format (0, "socksvr %s", sock->config);
772   template.private_data = rp - sm->registration_pool;
773
774   rp->clib_file_index = clib_file_add (fm, &template);
775   return 0;
776 }
777
778 static clib_error_t *
779 socket_exit (vlib_main_t * vm)
780 {
781   socket_main_t *sm = &socket_main;
782   vl_api_registration_t *rp;
783
784   /* Defensive driving in case something wipes out early */
785   if (sm->registration_pool)
786     {
787       u32 index;
788         /* *INDENT-OFF* */
789         pool_foreach (rp, sm->registration_pool)  {
790           vl_api_registration_del_file (rp);
791           index = rp->vl_api_registration_pool_index;
792           vl_socket_free_registration_index (index);
793         }
794 /* *INDENT-ON* */
795     }
796
797   return 0;
798 }
799
800 VLIB_MAIN_LOOP_EXIT_FUNCTION (socket_exit);
801
802 static clib_error_t *
803 socksvr_config (vlib_main_t * vm, unformat_input_t * input)
804 {
805   socket_main_t *sm = &socket_main;
806
807   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
808     {
809       if (unformat (input, "socket-name %s", &sm->socket_name))
810         ;
811       /* DEPRECATE: default keyword is ignored */
812       else if (unformat (input, "default"))
813         ;
814       else
815         {
816           return clib_error_return (0, "unknown input '%U'",
817                                     format_unformat_error, input);
818         }
819     }
820
821   if (!vec_len (sm->socket_name))
822     sm->socket_name = format (0, "%s/%s", vlib_unix_get_runtime_dir (),
823                               API_SOCKET_FILENAME);
824   vec_terminate_c_string (sm->socket_name);
825
826   return 0;
827 }
828
829 VLIB_CONFIG_FUNCTION (socksvr_config, "socksvr");
830
831 void
832 vlibsocket_reference ()
833 {
834 }
835
836 /*
837  * fd.io coding-style-patch-verification: ON
838  *
839  * Local Variables:
840  * eval: (c-set-style "gnu")
841  * End:
842  */