FD.io VPP  v20.09-64-g4f7b92f0a
Vector Packet Processing
vapi_internal.h
Go to the documentation of this file.
1 /*
2  *------------------------------------------------------------------
3  * Copyright (c) 2017 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 VAPI_INTERNAL_H
19 #define VAPI_INTERNAL_H
20 
21 #include <endian.h>
22 #include <string.h>
23 #include <vppinfra/types.h>
24 
25 /**
26  * @file vapi_internal.h
27  *
28  * internal vpp api C declarations
29  *
30  * This file contains internal vpp api C declarations. It's not intended to be
31  * used by the client programmer and the API defined here might change at any
32  * time..
33  */
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 struct vapi_ctx_s;
40 
41 typedef struct __attribute__ ((__packed__))
42 {
43  u16 _vl_msg_id;
46 
47 typedef struct __attribute__ ((__packed__))
48 {
49  u16 _vl_msg_id;
53 
54 static inline void
56 {
57  h->_vl_msg_id = htobe16 (h->_vl_msg_id);
58 }
59 
60 static inline void
62 {
63  h->_vl_msg_id = be16toh (h->_vl_msg_id);
64 }
65 
66 static inline void
68 {
69  h->_vl_msg_id = htobe16 (h->_vl_msg_id);
70 }
71 
72 static inline void
74 {
75  h->_vl_msg_id = be16toh (h->_vl_msg_id);
76 }
77 
78 
79 #include <vapi/vapi.h>
80 
81 typedef vapi_error_e (*vapi_cb_t) (struct vapi_ctx_s *, void *, vapi_error_e,
82  bool, void *);
83 
84 typedef void (*generic_swap_fn_t) (void *payload);
85 
86 typedef struct
87 {
88  const char *name;
89  size_t name_len;
90  const char *name_with_crc;
93  unsigned int context_offset;
94  unsigned int payload_offset;
95  size_t size;
98  vapi_msg_id_t id; /* assigned at run-time */
100 
101 typedef struct
102 {
103  const char *name;
105  size_t size;
106  void (*swap_to_be) (void *payload);
107  void (*swap_to_host) (void *payload);
109 
120 void vapi_store_request (vapi_ctx_t ctx, u32 context, bool is_dump,
121  vapi_cb_t callback, void *callback_ctx);
123 void (*vapi_get_swap_to_host_func (vapi_msg_id_t id)) (void *payload);
124 void (*vapi_get_swap_to_be_func (vapi_msg_id_t id)) (void *payload);
128 size_t vapi_get_message_count();
129 const char *vapi_get_msg_name(vapi_msg_id_t id);
130 
131 vapi_error_e vapi_producer_lock (vapi_ctx_t ctx);
132 vapi_error_e vapi_producer_unlock (vapi_ctx_t ctx);
133 
134 #ifdef __cplusplus
135 }
136 #endif
137 
138 #endif
vapi_msg_id_t id
Definition: vapi_internal.h:98
unsigned int context_offset
Definition: vapi_internal.h:93
static void vapi_type_msg_header1_t_hton(vapi_type_msg_header1_t *h)
Definition: vapi_internal.h:55
int vapi_get_payload_offset(vapi_msg_id_t id)
Definition: vapi.c:883
const char * name
Definition: vapi_internal.h:88
Optimized string handling code, including c11-compliant "safe C library" variants.
static void vapi_type_msg_header2_t_hton(vapi_type_msg_header2_t *h)
Definition: vapi_internal.h:67
vapi_error_e vapi_producer_unlock(vapi_ctx_t ctx)
Definition: vapi.c:960
size_t vapi_get_request_count(vapi_ctx_t ctx)
Definition: vapi.c:102
bool vapi_is_nonblocking(vapi_ctx_t ctx)
Definition: vapi.c:871
bool vapi_requests_full(vapi_ctx_t ctx)
Definition: vapi.c:108
int vapi_get_client_index(vapi_ctx_t ctx)
Definition: vapi.c:865
void(*)(void *payload) vapi_get_swap_to_host_func(vapi_msg_id_t id)
unsigned int u32
Definition: types.h:88
vapi_error_e vapi_producer_lock(vapi_ctx_t ctx)
Definition: vapi.c:947
vapi_msg_id_t vapi_register_msg(vapi_message_desc_t *msg)
Definition: vapi.c:916
const char * name
bool vapi_requests_empty(vapi_ctx_t ctx)
Definition: vapi.c:114
const char * name_with_crc
Definition: vapi_internal.h:90
long ctx[MAX_CONNS]
Definition: main.c:144
unsigned short u16
Definition: types.h:57
vec_header_t h
Definition: buffer.c:322
common vpp api C declarations
size_t vapi_get_max_request_count(vapi_ctx_t ctx)
Definition: vapi.c:877
size_t vapi_get_context_offset(vapi_msg_id_t id)
Definition: vapi.c:909
size_t vapi_get_message_size(vapi_msg_id_t id)
Definition: vapi.c:902
vapi_error_e(* vapi_cb_t)(struct vapi_ctx_s *, void *, vapi_error_e, bool, void *)
Definition: vapi_internal.h:81
#define vl_msg_id(n, h)
Definition: nat_msg_enum.h:23
unsigned int payload_offset
Definition: vapi_internal.h:94
u32 vapi_gen_req_context(vapi_ctx_t ctx)
Definition: vapi.c:94
u16 vapi_lookup_vl_msg_id(vapi_ctx_t ctx, vapi_msg_id_t id)
Definition: vapi.c:858
static void vapi_type_msg_header2_t_ntoh(vapi_type_msg_header2_t *h)
Definition: vapi_internal.h:73
vapi_msg_id_t vapi_lookup_vapi_msg_id_t(vapi_ctx_t ctx, u16 vl_msg_id)
Definition: vapi.c:245
void(*)(void *payload) vapi_get_swap_to_be_func(vapi_msg_id_t id)
generic_swap_fn_t swap_to_host
Definition: vapi_internal.h:97
#define bool
Definition: radix.c:95
generic_swap_fn_t swap_to_be
Definition: vapi_internal.h:96
size_t vapi_get_message_count()
Definition: vapi.c:974
void vapi_store_request(vapi_ctx_t ctx, u32 context, bool is_dump, vapi_cb_t callback, void *callback_ctx)
Definition: vapi.c:126
const char * vapi_get_msg_name(vapi_msg_id_t id)
Definition: vapi.c:980
bool vapi_msg_is_with_context(vapi_msg_id_t id)
Definition: vapi.c:749
unsigned int vapi_msg_id_t
Definition: vapi_common.h:55
void(* generic_swap_fn_t)(void *payload)
Definition: vapi_internal.h:84
vapi_error_e
Definition: vapi_common.h:25
static void vapi_type_msg_header1_t_ntoh(vapi_type_msg_header1_t *h)
Definition: vapi_internal.h:61