Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 1 | /* |
Florin Coras | 66ec467 | 2020-06-15 07:59:40 -0700 | [diff] [blame] | 2 | * Copyright (c) 2017-2020 Cisco and/or its affiliates. |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 3 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 4 | * you may not use this file except in compliance with the License. |
| 5 | * You may obtain a copy of the License at: |
| 6 | * |
| 7 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 8 | * |
| 9 | * Unless required by applicable law or agreed to in writing, software |
| 10 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 11 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 12 | * See the License for the specific language governing permissions and |
| 13 | * limitations under the License. |
| 14 | */ |
| 15 | |
| 16 | #ifndef included_vppcom_h |
| 17 | #define included_vppcom_h |
| 18 | |
| 19 | #include <netdb.h> |
| 20 | #include <errno.h> |
Florin Coras | 57c8893 | 2019-08-29 12:03:17 -0700 | [diff] [blame] | 21 | #include <sys/fcntl.h> |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 22 | #include <sys/poll.h> |
Dave Wallace | f7f809c | 2017-10-03 01:48:42 -0400 | [diff] [blame] | 23 | #include <sys/epoll.h> |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 24 | |
Keith Burns (alagalah) | 5a2946c | 2018-02-02 08:21:56 -0800 | [diff] [blame] | 25 | /* *INDENT-OFF* */ |
| 26 | #ifdef __cplusplus |
| 27 | extern "C" |
| 28 | { |
| 29 | #endif |
| 30 | /* *INDENT-ON* */ |
| 31 | |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 32 | /* |
| 33 | * VPPCOM Public API Definitions, Enums, and Data Structures |
| 34 | */ |
Florin Coras | 7baeb71 | 2019-01-04 17:05:43 -0800 | [diff] [blame] | 35 | #define INVALID_SESSION_ID ((u32)~0) |
Florin Coras | 9936831 | 2018-08-02 10:45:44 -0700 | [diff] [blame] | 36 | #define VPPCOM_CONF_DEFAULT "/etc/vpp/vcl.conf" |
| 37 | #define VPPCOM_ENV_CONF "VCL_CONFIG" |
| 38 | #define VPPCOM_ENV_DEBUG "VCL_DEBUG" |
Florin Coras | 9936831 | 2018-08-02 10:45:44 -0700 | [diff] [blame] | 39 | #define VPPCOM_ENV_APP_PROXY_TRANSPORT_TCP "VCL_APP_PROXY_TRANSPORT_TCP" |
| 40 | #define VPPCOM_ENV_APP_PROXY_TRANSPORT_UDP "VCL_APP_PROXY_TRANSPORT_UDP" |
| 41 | #define VPPCOM_ENV_APP_NAMESPACE_ID "VCL_APP_NAMESPACE_ID" |
| 42 | #define VPPCOM_ENV_APP_NAMESPACE_SECRET "VCL_APP_NAMESPACE_SECRET" |
| 43 | #define VPPCOM_ENV_APP_SCOPE_LOCAL "VCL_APP_SCOPE_LOCAL" |
| 44 | #define VPPCOM_ENV_APP_SCOPE_GLOBAL "VCL_APP_SCOPE_GLOBAL" |
| 45 | #define VPPCOM_ENV_VPP_API_SOCKET "VCL_VPP_API_SOCKET" |
Florin Coras | 165f3ae | 2020-11-08 18:04:33 -0800 | [diff] [blame] | 46 | #define VPPCOM_ENV_VPP_SAPI_SOCKET "VCL_VPP_SAPI_SOCKET" |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 47 | |
Florin Coras | 4b47ee2 | 2020-11-19 13:38:26 -0800 | [diff] [blame] | 48 | typedef enum |
| 49 | { |
| 50 | VPPCOM_PROTO_TCP = 0, |
| 51 | VPPCOM_PROTO_UDP, |
| 52 | VPPCOM_PROTO_NONE, |
| 53 | VPPCOM_PROTO_TLS, |
| 54 | VPPCOM_PROTO_QUIC, |
| 55 | VPPCOM_PROTO_DTLS, |
Florin Coras | 6621abf | 2021-01-06 17:35:17 -0800 | [diff] [blame] | 56 | VPPCOM_PROTO_SRTP, |
Florin Coras | 4b47ee2 | 2020-11-19 13:38:26 -0800 | [diff] [blame] | 57 | } vppcom_proto_t; |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 58 | |
Florin Coras | 4b47ee2 | 2020-11-19 13:38:26 -0800 | [diff] [blame] | 59 | typedef enum |
| 60 | { |
| 61 | VPPCOM_IS_IP6 = 0, |
| 62 | VPPCOM_IS_IP4, |
| 63 | } vppcom_is_ip4_t; |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 64 | |
Florin Coras | 4b47ee2 | 2020-11-19 13:38:26 -0800 | [diff] [blame] | 65 | typedef struct vppcom_endpt_t_ |
| 66 | { |
| 67 | uint8_t is_cut_thru; |
| 68 | uint8_t is_ip4; |
| 69 | uint8_t *ip; |
| 70 | uint16_t port; |
| 71 | uint64_t parent_handle; |
| 72 | } vppcom_endpt_t; |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 73 | |
Florin Coras | 30e79c2 | 2019-01-02 19:31:22 -0800 | [diff] [blame] | 74 | typedef uint32_t vcl_session_handle_t; |
| 75 | |
Florin Coras | a5a9efd | 2021-01-05 17:03:29 -0800 | [diff] [blame] | 76 | typedef struct vppcom_cert_key_pair_ |
| 77 | { |
| 78 | char *cert; |
| 79 | char *key; |
| 80 | uint32_t cert_len; |
| 81 | uint32_t key_len; |
| 82 | } vppcom_cert_key_pair_t; |
| 83 | |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 84 | typedef enum |
| 85 | { |
| 86 | VPPCOM_OK = 0, |
| 87 | VPPCOM_EAGAIN = -EAGAIN, |
Florin Coras | 54693d2 | 2018-07-17 10:46:29 -0700 | [diff] [blame] | 88 | VPPCOM_EWOULDBLOCK = -EWOULDBLOCK, |
Florin Coras | 57c8893 | 2019-08-29 12:03:17 -0700 | [diff] [blame] | 89 | VPPCOM_EINPROGRESS = -EINPROGRESS, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 90 | VPPCOM_EFAULT = -EFAULT, |
Dave Wallace | 60caa06 | 2017-11-10 17:07:13 -0500 | [diff] [blame] | 91 | VPPCOM_ENOMEM = -ENOMEM, |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 92 | VPPCOM_EINVAL = -EINVAL, |
| 93 | VPPCOM_EBADFD = -EBADFD, |
| 94 | VPPCOM_EAFNOSUPPORT = -EAFNOSUPPORT, |
Dave Wallace | ee45d41 | 2017-11-24 21:44:06 -0500 | [diff] [blame] | 95 | VPPCOM_ECONNABORTED = -ECONNABORTED, |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 96 | VPPCOM_ECONNRESET = -ECONNRESET, |
Dave Wallace | 4878cbe | 2017-11-21 03:45:09 -0500 | [diff] [blame] | 97 | VPPCOM_ENOTCONN = -ENOTCONN, |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 98 | VPPCOM_ECONNREFUSED = -ECONNREFUSED, |
| 99 | VPPCOM_ETIMEDOUT = -ETIMEDOUT, |
Florin Coras | 04ae827 | 2021-04-12 19:55:37 -0700 | [diff] [blame] | 100 | VPPCOM_EEXIST = -EEXIST, |
Florin Coras | 2645f68 | 2021-06-04 15:59:41 -0700 | [diff] [blame] | 101 | VPPCOM_ENOPROTOOPT = -ENOPROTOOPT, |
liuyacan | 55c952e | 2021-06-13 14:54:55 +0800 | [diff] [blame] | 102 | VPPCOM_EPIPE = -EPIPE, |
Florin Coras | 2645f68 | 2021-06-04 15:59:41 -0700 | [diff] [blame] | 103 | VPPCOM_ENOENT = -ENOENT, |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 104 | } vppcom_error_t; |
| 105 | |
Dave Wallace | 35830af | 2017-10-09 01:43:42 -0400 | [diff] [blame] | 106 | typedef enum |
| 107 | { |
| 108 | VPPCOM_ATTR_GET_NREAD, |
Dave Wallace | 227867f | 2017-11-13 21:21:53 -0500 | [diff] [blame] | 109 | VPPCOM_ATTR_GET_NWRITE, |
Dave Wallace | 35830af | 2017-10-09 01:43:42 -0400 | [diff] [blame] | 110 | VPPCOM_ATTR_GET_FLAGS, |
| 111 | VPPCOM_ATTR_SET_FLAGS, |
| 112 | VPPCOM_ATTR_GET_LCL_ADDR, |
Florin Coras | ef7cbf6 | 2019-10-17 09:56:27 -0700 | [diff] [blame] | 113 | VPPCOM_ATTR_SET_LCL_ADDR, |
Dave Wallace | 35830af | 2017-10-09 01:43:42 -0400 | [diff] [blame] | 114 | VPPCOM_ATTR_GET_PEER_ADDR, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 115 | VPPCOM_ATTR_GET_LIBC_EPFD, |
| 116 | VPPCOM_ATTR_SET_LIBC_EPFD, |
| 117 | VPPCOM_ATTR_GET_PROTOCOL, |
| 118 | VPPCOM_ATTR_GET_LISTEN, |
| 119 | VPPCOM_ATTR_GET_ERROR, |
| 120 | VPPCOM_ATTR_GET_TX_FIFO_LEN, |
| 121 | VPPCOM_ATTR_SET_TX_FIFO_LEN, |
| 122 | VPPCOM_ATTR_GET_RX_FIFO_LEN, |
| 123 | VPPCOM_ATTR_SET_RX_FIFO_LEN, |
| 124 | VPPCOM_ATTR_GET_REUSEADDR, |
Steven | b5a1160 | 2017-10-11 09:59:30 -0700 | [diff] [blame] | 125 | VPPCOM_ATTR_SET_REUSEADDR, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 126 | VPPCOM_ATTR_GET_REUSEPORT, |
| 127 | VPPCOM_ATTR_SET_REUSEPORT, |
| 128 | VPPCOM_ATTR_GET_BROADCAST, |
Steven | b5a1160 | 2017-10-11 09:59:30 -0700 | [diff] [blame] | 129 | VPPCOM_ATTR_SET_BROADCAST, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 130 | VPPCOM_ATTR_GET_V6ONLY, |
Steven | b5a1160 | 2017-10-11 09:59:30 -0700 | [diff] [blame] | 131 | VPPCOM_ATTR_SET_V6ONLY, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 132 | VPPCOM_ATTR_GET_KEEPALIVE, |
Steven | bccd339 | 2017-10-12 20:42:21 -0700 | [diff] [blame] | 133 | VPPCOM_ATTR_SET_KEEPALIVE, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 134 | VPPCOM_ATTR_GET_TCP_NODELAY, |
| 135 | VPPCOM_ATTR_SET_TCP_NODELAY, |
| 136 | VPPCOM_ATTR_GET_TCP_KEEPIDLE, |
Steven | bccd339 | 2017-10-12 20:42:21 -0700 | [diff] [blame] | 137 | VPPCOM_ATTR_SET_TCP_KEEPIDLE, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 138 | VPPCOM_ATTR_GET_TCP_KEEPINTVL, |
Steven | bccd339 | 2017-10-12 20:42:21 -0700 | [diff] [blame] | 139 | VPPCOM_ATTR_SET_TCP_KEEPINTVL, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 140 | VPPCOM_ATTR_GET_TCP_USER_MSS, |
| 141 | VPPCOM_ATTR_SET_TCP_USER_MSS, |
Florin Coras | 1e96617 | 2020-05-16 18:18:14 +0000 | [diff] [blame] | 142 | VPPCOM_ATTR_SET_CONNECTED, |
Florin Coras | a5a9efd | 2021-01-05 17:03:29 -0800 | [diff] [blame] | 143 | VPPCOM_ATTR_SET_CKPAIR, |
Florin Coras | 6a6555a | 2021-01-28 11:39:27 -0800 | [diff] [blame] | 144 | VPPCOM_ATTR_SET_VRF, |
| 145 | VPPCOM_ATTR_GET_VRF, |
wanghanlin | 0674f85 | 2021-02-22 10:38:36 +0800 | [diff] [blame] | 146 | VPPCOM_ATTR_GET_DOMAIN, |
Florin Coras | 87f6389 | 2021-05-01 16:01:40 -0700 | [diff] [blame] | 147 | VPPCOM_ATTR_SET_ENDPT_EXT_CFG, |
Dave Wallace | 35830af | 2017-10-09 01:43:42 -0400 | [diff] [blame] | 148 | } vppcom_attr_op_t; |
| 149 | |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 150 | typedef struct _vcl_poll |
| 151 | { |
| 152 | uint32_t fds_ndx; |
Florin Coras | 7baeb71 | 2019-01-04 17:05:43 -0800 | [diff] [blame] | 153 | vcl_session_handle_t sh; |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 154 | short events; |
Florin Coras | 6917b94 | 2018-11-13 22:44:54 -0800 | [diff] [blame] | 155 | short revents; |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 156 | } vcl_poll_t; |
| 157 | |
Florin Coras | 2cba853 | 2018-09-11 16:33:36 -0700 | [diff] [blame] | 158 | typedef struct vppcom_data_segment_ |
| 159 | { |
| 160 | unsigned char *data; |
| 161 | uint32_t len; |
| 162 | } vppcom_data_segment_t; |
| 163 | |
| 164 | typedef vppcom_data_segment_t vppcom_data_segments_t[2]; |
| 165 | |
Florin Coras | 294afe2 | 2019-01-07 17:49:17 -0800 | [diff] [blame] | 166 | typedef unsigned long vcl_si_set; |
| 167 | |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 168 | /* |
| 169 | * VPPCOM Public API Functions |
| 170 | */ |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 171 | |
Florin Coras | 66ec467 | 2020-06-15 07:59:40 -0700 | [diff] [blame] | 172 | extern int vppcom_app_create (const char *app_name); |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 173 | extern void vppcom_app_destroy (void); |
| 174 | |
Dave Wallace | c04cbf1 | 2018-02-07 18:14:02 -0500 | [diff] [blame] | 175 | extern int vppcom_session_create (uint8_t proto, uint8_t is_nonblocking); |
liuyacan | 55c952e | 2021-06-13 14:54:55 +0800 | [diff] [blame] | 176 | extern int vppcom_session_shutdown (uint32_t session_handle, int how); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 177 | extern int vppcom_session_close (uint32_t session_handle); |
| 178 | extern int vppcom_session_bind (uint32_t session_handle, vppcom_endpt_t * ep); |
| 179 | extern int vppcom_session_listen (uint32_t session_handle, uint32_t q_len); |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 180 | |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 181 | extern int vppcom_session_accept (uint32_t session_handle, |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 182 | vppcom_endpt_t * client_ep, uint32_t flags); |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 183 | |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 184 | extern int vppcom_session_connect (uint32_t session_handle, |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 185 | vppcom_endpt_t * server_ep); |
Nathan Skrzypczak | 9fd9962 | 2019-05-16 14:38:44 +0200 | [diff] [blame] | 186 | extern int vppcom_session_stream_connect (uint32_t session_handle, |
| 187 | uint32_t parent_session_handle); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 188 | extern int vppcom_session_read (uint32_t session_handle, void *buf, size_t n); |
| 189 | extern int vppcom_session_write (uint32_t session_handle, void *buf, |
| 190 | size_t n); |
Florin Coras | b0f662f | 2018-12-27 14:51:46 -0800 | [diff] [blame] | 191 | extern int vppcom_session_write_msg (uint32_t session_handle, void *buf, |
| 192 | size_t n); |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 193 | |
Florin Coras | 294afe2 | 2019-01-07 17:49:17 -0800 | [diff] [blame] | 194 | extern int vppcom_select (int n_bits, vcl_si_set * read_map, |
| 195 | vcl_si_set * write_map, vcl_si_set * except_map, |
| 196 | double wait_for_time); |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 197 | |
Dave Wallace | f7f809c | 2017-10-03 01:48:42 -0400 | [diff] [blame] | 198 | extern int vppcom_epoll_create (void); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 199 | extern int vppcom_epoll_ctl (uint32_t vep_handle, int op, |
| 200 | uint32_t session_handle, |
Dave Wallace | f7f809c | 2017-10-03 01:48:42 -0400 | [diff] [blame] | 201 | struct epoll_event *event); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 202 | extern int vppcom_epoll_wait (uint32_t vep_handle, struct epoll_event *events, |
Dave Wallace | f7f809c | 2017-10-03 01:48:42 -0400 | [diff] [blame] | 203 | int maxevents, double wait_for_time); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 204 | extern int vppcom_session_attr (uint32_t session_handle, uint32_t op, |
Dave Wallace | 35830af | 2017-10-09 01:43:42 -0400 | [diff] [blame] | 205 | void *buffer, uint32_t * buflen); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 206 | extern int vppcom_session_recvfrom (uint32_t session_handle, void *buffer, |
Steven | ac1f96d | 2017-10-24 16:03:58 -0700 | [diff] [blame] | 207 | uint32_t buflen, int flags, |
| 208 | vppcom_endpt_t * ep); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 209 | extern int vppcom_session_sendto (uint32_t session_handle, void *buffer, |
Steven | ac1f96d | 2017-10-24 16:03:58 -0700 | [diff] [blame] | 210 | uint32_t buflen, int flags, |
| 211 | vppcom_endpt_t * ep); |
Dave Wallace | 048b1d6 | 2018-01-03 22:24:41 -0500 | [diff] [blame] | 212 | extern int vppcom_poll (vcl_poll_t * vp, uint32_t n_sids, |
| 213 | double wait_for_time); |
Florin Coras | 9936831 | 2018-08-02 10:45:44 -0700 | [diff] [blame] | 214 | extern int vppcom_mq_epoll_fd (void); |
Florin Coras | 30e79c2 | 2019-01-02 19:31:22 -0800 | [diff] [blame] | 215 | extern int vppcom_session_index (vcl_session_handle_t session_handle); |
| 216 | extern int vppcom_session_worker (vcl_session_handle_t session_handle); |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 217 | |
Florin Coras | 2cba853 | 2018-09-11 16:33:36 -0700 | [diff] [blame] | 218 | extern int vppcom_session_read_segments (uint32_t session_handle, |
Florin Coras | d68faf8 | 2020-09-25 15:18:13 -0700 | [diff] [blame] | 219 | vppcom_data_segment_t * ds, |
| 220 | uint32_t n_segments, |
| 221 | uint32_t max_bytes); |
Florin Coras | 2cba853 | 2018-09-11 16:33:36 -0700 | [diff] [blame] | 222 | extern void vppcom_session_free_segments (uint32_t session_handle, |
Florin Coras | d68faf8 | 2020-09-25 15:18:13 -0700 | [diff] [blame] | 223 | uint32_t n_bytes); |
Florin Coras | a5a9efd | 2021-01-05 17:03:29 -0800 | [diff] [blame] | 224 | extern int vppcom_add_cert_key_pair (vppcom_cert_key_pair_t *ckpair); |
| 225 | extern int vppcom_del_cert_key_pair (uint32_t ckpair_index); |
Nathan Skrzypczak | 9fd9962 | 2019-05-16 14:38:44 +0200 | [diff] [blame] | 226 | extern int vppcom_unformat_proto (uint8_t * proto, char *proto_str); |
| 227 | extern int vppcom_session_is_connectable_listener (uint32_t session_handle); |
| 228 | extern int vppcom_session_listener (uint32_t session_handle); |
| 229 | extern int vppcom_session_n_accepted (uint32_t session_handle); |
Florin Coras | 2cba853 | 2018-09-11 16:33:36 -0700 | [diff] [blame] | 230 | |
Florin Coras | 66ec467 | 2020-06-15 07:59:40 -0700 | [diff] [blame] | 231 | extern const char *vppcom_proto_str (vppcom_proto_t proto); |
| 232 | extern const char *vppcom_retval_str (int retval); |
| 233 | |
Florin Coras | 134a996 | 2018-08-28 11:32:04 -0700 | [diff] [blame] | 234 | /** |
| 235 | * Request from application to register a new worker |
| 236 | * |
| 237 | * Expectation is that applications will make use of this after a new pthread |
| 238 | * is spawned. |
| 239 | */ |
| 240 | extern int vppcom_worker_register (void); |
Dave Wallace | f7f809c | 2017-10-03 01:48:42 -0400 | [diff] [blame] | 241 | |
Florin Coras | dfe4cf4 | 2018-11-28 22:13:45 -0800 | [diff] [blame] | 242 | /** |
Florin Coras | 369db83 | 2019-07-08 12:34:45 -0700 | [diff] [blame] | 243 | * Unregister current worker |
| 244 | */ |
| 245 | extern void vppcom_worker_unregister (void); |
| 246 | |
| 247 | /** |
Florin Coras | dfe4cf4 | 2018-11-28 22:13:45 -0800 | [diff] [blame] | 248 | * Retrieve current worker index |
| 249 | */ |
| 250 | extern int vppcom_worker_index (void); |
| 251 | |
Florin Coras | e0982e5 | 2019-01-25 13:19:56 -0800 | [diff] [blame] | 252 | /** |
Pivo | 6017ff0 | 2020-05-04 17:57:33 +0200 | [diff] [blame] | 253 | * Set current worker index |
| 254 | */ |
| 255 | extern void vppcom_worker_index_set (int); |
| 256 | |
| 257 | /** |
Florin Coras | e0982e5 | 2019-01-25 13:19:56 -0800 | [diff] [blame] | 258 | * Returns the current worker's message queues epoll fd |
| 259 | * |
| 260 | * This only works if vcl is configured to do eventfd based message queue |
| 261 | * notifications. |
| 262 | */ |
| 263 | extern int vppcom_worker_mqs_epfd (void); |
| 264 | |
Keith Burns (alagalah) | 5a2946c | 2018-02-02 08:21:56 -0800 | [diff] [blame] | 265 | /* *INDENT-OFF* */ |
| 266 | #ifdef __cplusplus |
| 267 | } |
| 268 | #endif |
| 269 | /* *INDENT-ON* */ |
| 270 | |
Dave Wallace | 543852a | 2017-08-03 02:11:34 -0400 | [diff] [blame] | 271 | #endif /* included_vppcom_h */ |
| 272 | |
| 273 | /* |
| 274 | * fd.io coding-style-patch-verification: ON |
| 275 | * |
| 276 | * Local Variables: |
| 277 | * eval: (c-set-style "gnu") |
| 278 | * End: |
| 279 | */ |