FD.io VPP  v21.06-3-gbb25fbf28
Vector Packet Processing
policer_api.c
Go to the documentation of this file.
1 /*
2  *------------------------------------------------------------------
3  * policer_api.c - policer api
4  *
5  * Copyright (c) 2016 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 <vnet/vnet.h>
21 #include <vlibmemory/api.h>
22 
23 #include <vnet/interface.h>
24 #include <vnet/api_errno.h>
25 #include <vnet/policer/policer.h>
26 
27 #include <vnet/vnet_msg_enum.h>
28 
29 #define vl_typedefs /* define message structures */
30 #include <vnet/vnet_all_api_h.h>
31 #undef vl_typedefs
32 
33 #define vl_endianfun /* define message structures */
34 #include <vnet/vnet_all_api_h.h>
35 #undef vl_endianfun
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 <vnet/vnet_all_api_h.h>
41 #undef vl_printfun
42 
44 
45 #define foreach_vpe_api_msg \
46  _ (POLICER_ADD_DEL, policer_add_del) \
47  _ (POLICER_BIND, policer_bind) \
48  _ (POLICER_INPUT, policer_input) \
49  _ (POLICER_DUMP, policer_dump)
50 
51 static void
53 {
56  int rv = 0;
57  u8 *name = NULL;
60  u32 policer_index;
61 
62  name = format (0, "%s", mp->name);
64 
65  clib_memset (&cfg, 0, sizeof (cfg));
66  cfg.rfc = (qos_policer_type_en) mp->type;
67  cfg.rnd_type = (qos_round_type_en) mp->round_type;
68  cfg.rate_type = (qos_rate_type_en) mp->rate_type;
69  cfg.rb.kbps.cir_kbps = ntohl (mp->cir);
70  cfg.rb.kbps.eir_kbps = ntohl (mp->eir);
71  cfg.rb.kbps.cb_bytes = clib_net_to_host_u64 (mp->cb);
72  cfg.rb.kbps.eb_bytes = clib_net_to_host_u64 (mp->eb);
74  (qos_action_type_en) mp->conform_action.type;
75  cfg.conform_action.dscp = mp->conform_action.dscp;
76  cfg.exceed_action.action_type = (qos_action_type_en) mp->exceed_action.type;
77  cfg.exceed_action.dscp = mp->exceed_action.dscp;
79  (qos_action_type_en) mp->violate_action.type;
80  cfg.violate_action.dscp = mp->violate_action.dscp;
81 
82  cfg.color_aware = mp->color_aware;
83 
84  error = policer_add_del (vm, name, &cfg, &policer_index, mp->is_add);
85 
86  if (error)
87  rv = VNET_API_ERROR_UNSPECIFIED;
88 
89  /* *INDENT-OFF* */
90  REPLY_MACRO2(VL_API_POLICER_ADD_DEL_REPLY,
91  ({
92  if (rv == 0 && mp->is_add)
93  rmp->policer_index = ntohl(policer_index);
94  else
95  rmp->policer_index = ~0;
96  }));
97  /* *INDENT-ON* */
98 }
99 
100 static void
102 {
103  vl_api_policer_bind_reply_t *rmp;
104  u8 *name;
105  u32 worker_index;
106  u8 bind_enable;
107  int rv;
108 
109  name = format (0, "%s", mp->name);
111 
112  worker_index = ntohl (mp->worker_index);
113  bind_enable = mp->bind_enable;
114 
115  rv = policer_bind_worker (name, worker_index, bind_enable);
116  vec_free (name);
117  REPLY_MACRO (VL_API_POLICER_BIND_REPLY);
118 }
119 
120 static void
122 {
123  vl_api_policer_bind_reply_t *rmp;
124  u8 *name;
126  u8 apply;
127  int rv;
128 
130 
131  name = format (0, "%s", mp->name);
133 
134  sw_if_index = ntohl (mp->sw_if_index);
135  apply = mp->apply;
136 
138  vec_free (name);
139 
141  REPLY_MACRO (VL_API_POLICER_INPUT_REPLY);
142 }
143 
144 static void
146  policer_t *templ, vl_api_registration_t *reg,
147  u32 context)
148 {
150 
151  mp = vl_msg_api_alloc (sizeof (*mp));
152  clib_memset (mp, 0, sizeof (*mp));
153  mp->_vl_msg_id = ntohs (VL_API_POLICER_DETAILS);
154  mp->context = context;
155  mp->cir = htonl (config->rb.kbps.cir_kbps);
156  mp->eir = htonl (config->rb.kbps.eir_kbps);
157  mp->cb = clib_host_to_net_u64 (config->rb.kbps.cb_bytes);
158  mp->eb = clib_host_to_net_u64 (config->rb.kbps.eb_bytes);
159  mp->rate_type = (vl_api_sse2_qos_rate_type_t) config->rate_type;
160  mp->round_type = (vl_api_sse2_qos_round_type_t) config->rnd_type;
161  mp->type = (vl_api_sse2_qos_policer_type_t) config->rfc;
162  mp->conform_action.type =
163  (vl_api_sse2_qos_action_type_t) config->conform_action.action_type;
164  mp->conform_action.dscp = config->conform_action.dscp;
165  mp->exceed_action.type =
166  (vl_api_sse2_qos_action_type_t) config->exceed_action.action_type;
167  mp->exceed_action.dscp = config->exceed_action.dscp;
168  mp->violate_action.type =
169  (vl_api_sse2_qos_action_type_t) config->violate_action.action_type;
170  mp->violate_action.dscp = config->violate_action.dscp;
171  mp->single_rate = templ->single_rate ? 1 : 0;
172  mp->color_aware = templ->color_aware ? 1 : 0;
173  mp->scale = htonl (templ->scale);
174  mp->cir_tokens_per_period = htonl (templ->cir_tokens_per_period);
175  mp->pir_tokens_per_period = htonl (templ->pir_tokens_per_period);
176  mp->current_limit = htonl (templ->current_limit);
177  mp->current_bucket = htonl (templ->current_bucket);
178  mp->extended_limit = htonl (templ->extended_limit);
179  mp->extended_bucket = htonl (templ->extended_bucket);
180  mp->last_update_time = clib_host_to_net_u64 (templ->last_update_time);
181 
182  strncpy ((char *) mp->name, (char *) name, ARRAY_LEN (mp->name) - 1);
183 
184  vl_api_send_msg (reg, (u8 *) mp);
185 }
186 
187 static void
189 {
192  hash_pair_t *hp;
193  uword *p;
194  u32 pool_index;
195  u8 *match_name = 0;
196  u8 *name;
197  qos_pol_cfg_params_st *config;
198  policer_t *templ;
199 
201  if (!reg)
202  return;
203 
204  if (mp->match_name_valid)
205  {
206  match_name = format (0, "%s%c", mp->match_name, 0);
207  vec_terminate_c_string (match_name);
208  }
209 
210  if (mp->match_name_valid)
211  {
212  p = hash_get_mem (pm->policer_config_by_name, match_name);
213  if (p)
214  {
215  pool_index = p[0];
216  config = pool_elt_at_index (pm->configs, pool_index);
217  templ = pool_elt_at_index (pm->policer_templates, pool_index);
218  send_policer_details (match_name, config, templ, reg, mp->context);
219  }
220  }
221  else
222  {
223  /* *INDENT-OFF* */
225  ({
226  name = (u8 *) hp->key;
227  pool_index = hp->value[0];
228  config = pool_elt_at_index (pm->configs, pool_index);
229  templ = pool_elt_at_index (pm->policer_templates, pool_index);
230  send_policer_details(name, config, templ, reg, mp->context);
231  }));
232  /* *INDENT-ON* */
233  }
234 }
235 
236 /*
237  * policer_api_hookup
238  * Add vpe's API message handlers to the table.
239  * vlib has already mapped shared memory and
240  * added the client registration handlers.
241  * See .../vlib-api/vlibmemory/memclnt_vlib.c:memclnt_process()
242  */
243 #define vl_msg_name_crc_list
244 #include <vnet/vnet_all_api_h.h>
245 #undef vl_msg_name_crc_list
246 
247 static void
249 {
250 #define _(id,n,crc) vl_msg_api_add_msg_name_crc (am, #n "_" #crc, id);
251  foreach_vl_msg_name_crc_policer;
252 #undef _
253 }
254 
255 static clib_error_t *
257 {
259 
260 #define _(N,n) \
261  vl_msg_api_set_handlers(VL_API_##N, #n, \
262  vl_api_##n##_t_handler, \
263  vl_noop_handler, \
264  vl_api_##n##_t_endian, \
265  vl_api_##n##_t_print, \
266  sizeof(vl_api_##n##_t), 1);
268 #undef _
269  /*
270  * Set up the (msg_name, crc, message-id) table
271  */
273 
274  return 0;
275 }
276 
278 
279 /*
280  * fd.io coding-style-patch-verification: ON
281  *
282  * Local Variables:
283  * eval: (c-set-style "gnu")
284  * End:
285  */
vl_api_policer_add_del_reply_t
Add/del policer response.
Definition: policer.api:97
vnet_policer_main_t::configs
qos_pol_cfg_params_st * configs
Definition: policer.h:32
policer_t::color_aware
u32 color_aware
Definition: police.h:79
vl_api_policer_details_t::rate_type
vl_api_sse2_qos_rate_type_t rate_type
Definition: policer.api:152
vnet_policer_main_t
Definition: policer.h:26
VALIDATE_SW_IF_INDEX
#define VALIDATE_SW_IF_INDEX(mp)
Definition: api_helper_macros.h:281
vl_api_client_index_to_registration
static vl_api_registration_t * vl_api_client_index_to_registration(u32 index)
Definition: api.h:79
vnet_policer_main_t::policer_config_by_name
uword * policer_config_by_name
Definition: policer.h:36
api.h
vl_api_policer_add_del_reply_t::policer_index
u32 policer_index
Definition: policer.api:101
policer_input
int policer_input(u8 *name, u32 sw_if_index, bool apply)
Definition: policer.c:169
vl_api_policer_details_t::conform_action
vl_api_sse2_qos_action_t conform_action
Definition: policer.api:155
ntohs
#define ntohs(x)
Definition: af_xdp.bpf.c:29
policer_t::extended_bucket
u32 extended_bucket
Definition: police.h:95
vl_api_policer_details_t::violate_action
vl_api_sse2_qos_action_t violate_action
Definition: policer.api:157
qos_pol_cfg_params_st_::color_aware
u8 color_aware
Definition: xlate.h:137
REPLY_MACRO2
#define REPLY_MACRO2(t, body)
Definition: api_helper_macros.h:65
vl_api_policer_details_t::eir
u32 eir
Definition: policer.api:149
vnet_policer_main
vnet_policer_main_t vnet_policer_main
Definition: policer.c:22
vl_api_policer_dump_t::match_name
string match_name[64]
Definition: policer.api:116
vl_api_send_msg
static void vl_api_send_msg(vl_api_registration_t *rp, u8 *elem)
Definition: api.h:35
pool_elt_at_index
#define pool_elt_at_index(p, i)
Returns pointer to element at given index.
Definition: pool.h:553
vl_api_policer_details_t::round_type
vl_api_sse2_qos_round_type_t round_type
Definition: policer.api:153
name
string name[64]
Definition: fib.api:25
policer_t::current_bucket
u32 current_bucket
Definition: police.h:93
vl_api_policer_details_t::exceed_action
vl_api_sse2_qos_action_t exceed_action
Definition: policer.api:156
vl_api_policer_details_t::current_bucket
u32 current_bucket
Definition: policer.api:164
vl_api_policer_dump_t::match_name_valid
bool match_name_valid
Definition: policer.api:115
vl_api_policer_add_del_t::violate_action
vl_api_sse2_qos_action_t violate_action
Definition: policer.api:89
vl_api_policer_dump_t
Get list of policers.
Definition: policer.api:110
policer_t
Definition: police.h:73
policer_t::current_limit
u32 current_limit
Definition: police.h:92
vl_api_policer_add_del_t::type
vl_api_sse2_qos_policer_type_t type
Definition: policer.api:85
qos_pol_cfg_params_st_::rfc
qos_policer_type_en rfc
Definition: xlate.h:136
vl_api_policer_add_del_t::cb
u64 cb
Definition: policer.api:81
am
app_main_t * am
Definition: application.c:489
qos_pol_cfg_params_st_
Definition: xlate.h:115
vm
vlib_main_t * vm
X-connect all packets from the HOST to the PHY.
Definition: nat44_ei.c:3047
vl_api_policer_add_del_t::eir
u32 eir
Definition: policer.api:80
policer.h
vl_api_policer_details_t::type
vl_api_sse2_qos_policer_type_t type
Definition: policer.api:154
vl_api_policer_add_del_t::is_add
bool is_add
Definition: policer.api:77
qos_pol_cfg_params_st_::conform_action
qos_pol_action_params_st conform_action
Definition: xlate.h:141
vl_api_policer_input_t::apply
bool apply
Definition: policer.api:52
send_policer_details
static void send_policer_details(u8 *name, qos_pol_cfg_params_st *config, policer_t *templ, vl_api_registration_t *reg, u32 context)
Definition: policer_api.c:145
foreach_vpe_api_msg
#define foreach_vpe_api_msg
Definition: policer_api.c:45
error
Definition: cJSON.c:88
vl_api_policer_add_del_t_handler
static void vl_api_policer_add_del_t_handler(vl_api_policer_add_del_t *mp)
Definition: policer_api.c:52
hash_foreach_pair
#define hash_foreach_pair(p, v, body)
Iterate over hash pairs.
Definition: hash.h:373
policer_t::cir_tokens_per_period
u32 cir_tokens_per_period
Definition: police.h:89
vl_api_policer_add_del_t::name
string name[64]
Definition: policer.api:78
vl_api_policer_bind_t::bind_enable
bool bind_enable
Definition: policer.api:35
vl_api_policer_add_del_t::conform_action
vl_api_sse2_qos_action_t conform_action
Definition: policer.api:87
vl_api_policer_details_t::pir_tokens_per_period
u32 pir_tokens_per_period
Definition: policer.api:162
policer_t::pir_tokens_per_period
u32 pir_tokens_per_period
Definition: police.h:90
policer_t::scale
u32 scale
Definition: police.h:80
policer_add_del
clib_error_t * policer_add_del(vlib_main_t *vm, u8 *name, qos_pol_cfg_params_st *cfg, u32 *policer_index, u8 is_add)
Definition: policer.c:53
vl_api_policer_input_t_handler
static void vl_api_policer_input_t_handler(vl_api_policer_input_t *mp)
Definition: policer_api.c:121
setup_message_id_table
static void setup_message_id_table(api_main_t *am)
Definition: policer_api.c:248
policer_t::single_rate
u32 single_rate
Definition: police.h:78
vnet_msg_enum.h
vl_api_registration_
An API client registration, only in vpp/vlib.
Definition: api_common.h:47
REPLY_MACRO
#define REPLY_MACRO(t)
Definition: api_helper_macros.h:30
ARRAY_LEN
#define ARRAY_LEN(x)
Definition: clib.h:70
vl_api_policer_details_t::scale
u32 scale
Definition: policer.api:160
vl_api_policer_dump_t::client_index
u32 client_index
Definition: policer.api:112
uword
u64 uword
Definition: types.h:112
vl_api_policer_details_t::single_rate
bool single_rate
Definition: policer.api:158
vl_api_policer_details_t::cir
u32 cir
Definition: policer.api:148
vlibapi_get_main
static api_main_t * vlibapi_get_main(void)
Definition: api_common.h:390
vl_api_policer_dump_t_handler
static void vl_api_policer_dump_t_handler(vl_api_policer_dump_t *mp)
Definition: policer_api.c:188
interface.h
vl_api_policer_add_del_t::rate_type
vl_api_sse2_qos_rate_type_t rate_type
Definition: policer.api:83
qos_pol_action_params_st_::dscp
ip_dscp_t dscp
Definition: xlate.h:81
vl_api_policer_bind_t
policer bind: Associate/disassociate a policer with a worker thread.
Definition: policer.api:28
vl_api_policer_details_t::color_aware
bool color_aware
Definition: policer.api:159
apply
static int apply(phash_main_t *pm, u32 tail, u32 rollback)
Definition: phash.c:408
qos_pol_cfg_params_st_::exceed_action
qos_pol_action_params_st exceed_action
Definition: xlate.h:142
qos_pol_cfg_params_st_::rb
union qos_pol_cfg_params_st_::@490 rb
vl_api_policer_input_t
policer input: Apply policer as an input feature.
Definition: policer.api:45
qos_policer_type_en
enum qos_policer_type_en_ qos_policer_type_en
vl_api_policer_details_t::context
u32 context
Definition: policer.api:145
BAD_SW_IF_INDEX_LABEL
#define BAD_SW_IF_INDEX_LABEL
Definition: api_helper_macros.h:289
api_main_t
API main structure, used by both vpp and binary API clients.
Definition: api_common.h:228
vl_api_policer_details_t::extended_limit
u32 extended_limit
Definition: policer.api:165
vnet_policer_main_t::policer_templates
policer_t * policer_templates
Definition: policer.h:33
vl_api_policer_bind_t::worker_index
u32 worker_index
Definition: policer.api:34
qos_pol_cfg_params_st_::rnd_type
qos_round_type_en rnd_type
Definition: xlate.h:135
policer_t::extended_limit
u32 extended_limit
Definition: police.h:94
vec_free
#define vec_free(V)
Free vector's memory (no header).
Definition: vec.h:395
vl_api_policer_details_t
Policer operational state response.
Definition: policer.api:143
qos_pol_cfg_params_st_::violate_action
qos_pol_action_params_st violate_action
Definition: xlate.h:143
vl_api_policer_bind_t::name
string name[64]
Definition: policer.api:33
vl_api_policer_add_del_t::round_type
vl_api_sse2_qos_round_type_t round_type
Definition: policer.api:84
hash_get_mem
#define hash_get_mem(h, key)
Definition: hash.h:269
policer_api_hookup
static clib_error_t * policer_api_hookup(vlib_main_t *vm)
Definition: policer_api.c:256
format
description fragment has unexpected format
Definition: map.api:433
vl_api_policer_dump_t::context
u32 context
Definition: policer.api:113
u32
unsigned int u32
Definition: types.h:88
qos_pol_cfg_params_st_::rate_type
qos_rate_type_en rate_type
Definition: xlate.h:134
vl_api_policer_add_del_t::exceed_action
vl_api_sse2_qos_action_t exceed_action
Definition: policer.api:88
vl_api_policer_add_del_t::cir
u32 cir
Definition: policer.api:79
vl_api_policer_add_del_t::eb
u64 eb
Definition: policer.api:82
api_helper_macros.h
vl_api_policer_details_t::current_limit
u32 current_limit
Definition: policer.api:163
vl_api_policer_add_del_t
Add/del policer.
Definition: policer.api:72
policer_bind_worker
int policer_bind_worker(u8 *name, u32 worker, bool bind)
Definition: policer.c:138
vl_api_policer_details_t::eb
u64 eb
Definition: policer.api:151
vl_api_policer_details_t::name
string name[64]
Definition: policer.api:147
clib_memset
clib_memset(h->entries, 0, sizeof(h->entries[0]) *entries)
vlib_main_t
Definition: main.h:102
vl_api_policer_details_t::last_update_time
u64 last_update_time
Definition: policer.api:167
vlib_get_main
static vlib_main_t * vlib_get_main(void)
Definition: global_funcs.h:38
u8
unsigned char u8
Definition: types.h:56
clib_error_t
Definition: clib_error.h:21
vl_api_policer_details_t::cb
u64 cb
Definition: policer.api:150
VLIB_API_INIT_FUNCTION
VLIB_API_INIT_FUNCTION(policer_api_hookup)
vec_terminate_c_string
#define vec_terminate_c_string(V)
(If necessary) NULL terminate a vector containing a c-string.
Definition: vec.h:1132
vl_api_policer_input_t::sw_if_index
vl_api_interface_index_t sw_if_index
Definition: policer.api:51
vnet_all_api_h.h
context
u32 context
Definition: ip.api:780
rv
int __clib_unused rv
Definition: application.c:491
vnet.h
qos_pol_cfg_params_st_::kbps
struct qos_pol_cfg_params_st_::@490::@491 kbps
api_errno.h
qos_pol_action_params_st_::action_type
qos_action_type_en action_type
Definition: xlate.h:80
policer_t::last_update_time
u64 last_update_time
Definition: police.h:97
sw_if_index
vl_api_interface_index_t sw_if_index
Definition: wireguard.api:34
vl_api_policer_details_t::extended_bucket
u32 extended_bucket
Definition: policer.api:166
vl_api_policer_bind_t_handler
static void vl_api_policer_bind_t_handler(vl_api_policer_bind_t *mp)
Definition: policer_api.c:101
vl_api_policer_add_del_t::color_aware
bool color_aware
Definition: policer.api:86
hash_pair_t
Definition: hash.h:159
vl_api_policer_details_t::cir_tokens_per_period
u32 cir_tokens_per_period
Definition: policer.api:161
vl_api_policer_input_t::name
string name[64]
Definition: policer.api:50
vl_msg_api_alloc
void * vl_msg_api_alloc(int nbytes)
Definition: memory_shared.c:199