API: Python and Unix domain socket improvement
[vpp.git] / src / vlibmemory / socket_client.h
1 /*
2  *------------------------------------------------------------------
3  * Copyright (c) 2018 Cisco and/or its affiliates.
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at:
7  *
8  *     http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  *------------------------------------------------------------------
16  */
17
18 #ifndef SRC_VLIBMEMORY_SOCKET_CLIENT_H_
19 #define SRC_VLIBMEMORY_SOCKET_CLIENT_H_
20
21 #include <vppinfra/file.h>
22 #include <vppinfra/time.h>
23 #include <vlibmemory/memory_shared.h>
24
25 typedef struct
26 {
27   int socket_fd;
28   int socket_enable;            /**< Can temporarily disable the connection
29                                      but still can keep it around... */
30   u32 client_index;             /**< Client index allocated by VPP */
31
32   clib_socket_t client_socket;
33
34   u32 socket_buffer_size;
35   u8 *socket_tx_buffer;
36   u8 *socket_rx_buffer;
37   u32 socket_tx_nbytes;
38   int control_pings_outstanding;
39
40   u8 *name;
41   clib_time_t clib_time;
42   ssvm_private_t memfd_segment;
43
44   int want_shm_pthread;
45 } socket_client_main_t;
46
47 extern socket_client_main_t socket_client_main;
48
49 #define SOCKET_CLIENT_DEFAULT_BUFFER_SIZE 4096
50
51 int vl_socket_client_connect (char *socket_path, char *client_name,
52                               u32 socket_buffer_size);
53 void vl_socket_client_disconnect (void);
54 int vl_socket_client_read (int wait);
55 int vl_socket_client_write (void);
56 void vl_socket_client_enable_disable (int enable);
57 void *vl_socket_client_msg_alloc (int nbytes);
58 int vl_socket_client_init_shm (vl_api_shm_elem_config_t * config,
59                                int want_pthread);
60 clib_error_t *vl_socket_client_recv_fd_msg (int fds[], int n_fds, u32 wait);
61
62 #endif /* SRC_VLIBMEMORY_SOCKET_CLIENT_H_ */
63
64 /*
65  * fd.io coding-style-patch-verification: ON
66  *
67  * Local Variables:
68  * eval: (c-set-style "gnu")
69  * End:
70  */