FD.io VPP  v19.01.2-3-gf61a1a8
Vector Packet Processing
memclnt.api
Go to the documentation of this file.
1 /* Hey Emacs use -*- mode: C -*- */
2 /*
3  * Copyright (c) 2015 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 option version = "2.1.0";
18 
19 /*
20  * Define services not following the normal conventions here
21  */
23  rpc memclnt_rx_thread_suspend returns null;
24  rpc memclnt_read_timeout returns null;
25  rpc rx_thread_exit returns null;
26  rpc trace_plugin_msg_ids returns null;
27 };
28 
29 /*
30  * Create a client registration
31  */
32 manual_print
33 define memclnt_create {
34  u32 context; /* opaque value to be returned in the reply */
35  i32 ctx_quota; /* requested punt context quota */
36  u64 input_queue; /* client's queue */
37  u8 name[64]; /* for show, find by name, whatever */
38  u32 api_versions[8]; /* client-server pairs use as desired */
39 };
40 
41 define memclnt_create_reply {
42  u32 context; /* opaque value from the create request */
43  i32 response; /* Non-negative = success */
44  u64 handle; /* handle by which vlib knows this client */
45  u32 index; /* index, used e.g. by API trace replay */
46  u64 message_table; /* serialized message table in shmem */
47 };
48 
49 /*
50  * Delete a client registration
51  */
52 manual_print
53 define memclnt_delete {
54  u32 index; /* index, used e.g. by API trace replay */
55  u64 handle; /* handle by which vlib knows this client */
56  u8 do_cleanup; /* vlib to cleanup the registration */
57 };
58 
59 define memclnt_delete_reply {
60  i32 response; /* Non-negative = success */
61  u64 handle; /* in case the client wonders */
62 };
63 
64 /*
65  * Client RX thread exit
66  */
67 define rx_thread_exit {
69 };
70 
71 /*
72  * Client RX thread suspend
73  */
74 define memclnt_rx_thread_suspend {
76 };
77 
78 /*
79  * Client read timeout
80  */
81 define memclnt_read_timeout {
83 };
84 
85 /*
86  * RPC
87  */
88 autoreply define rpc_call {
91  u64 function;
96  u8 data[data_len];
97 };
98 
99 /*
100  * Lookup message-ID base by name
101  */
102 define get_first_msg_id {
105  u8 name[64];
106 };
107 
108 define get_first_msg_id_reply {
112 };
113 
114 /*
115  * Get API version table (includes built-in and plugins)
116  */
117 typeonly define module_version {
121  u8 name[64];
122 };
123 define api_versions {
126 };
127 define api_versions_reply {
132 };
133 
134 /*
135  * Trace the plugin message-id allocator
136  * so we stand a chance of dealing with different sets of plugins
137  * at api trace replay time
138  */
139 
140 manual_print define trace_plugin_msg_ids
141 {
144  u8 plugin_name[128];
147 };
148 
149 typedef message_table_entry
150 {
151  u16 index;
152  u8 name[64];
153 };
154 
155 /*
156  * Create a socket client registration.
157  */
158 define sockclnt_create {
159  u32 context; /* opaque value to be returned in the reply */
160  u8 name[64]; /* for show, find by name, whatever */
161 };
162 
163 define sockclnt_create_reply {
165  u32 context; /* opaque value from the create request */
166  i32 response; /* Non-negative = success */
167  u32 index; /* index, used e.g. by API trace replay */
169  vl_api_message_table_entry_t message_table[count];
170 };
171 
172 /*
173  * Delete a client registration
174  */
175 define sockclnt_delete {
178  u32 index; /* index, used e.g. by API trace replay */
179 };
180 
181 define sockclnt_delete_reply {
183  i32 response; /* Non-negative = success */
184 };
185 
186 /*
187  * Initialize shm api over socket api
188  */
189 autoreply define sock_init_shm {
194  u64 configs[nitems];
195 };
196 
197 /* define sock_init_shm_reply {
198  u32 client_index;
199  u32 context;
200  i32 retval;
201 }; */
202 
203 /*
204  * Memory client ping / response
205  * Only sent on inactive connections
206  */
207 autoreply define memclnt_keepalive
208 {
211 };
service
Definition: memclnt.api:22
typedef message_table_entry
Definition: memclnt.api:150
unsigned long u64
Definition: types.h:89
unsigned char u8
Definition: types.h:56
rpc memclnt_read_timeout returns null
Definition: memclnt.api:24
unsigned int u32
Definition: types.h:88
unsigned short u16
Definition: types.h:57
u8 name[64]
Definition: memclnt.api:152
signed int i32
Definition: types.h:77
option version
Definition: memclnt.api:17
size_t count
Definition: vapi.c:47