c06ddf9698
This patch adds support for meter configuration profiles.
Benefits: simplified configuration procedure, improved performance.
Q1: What is the configuration profile and why does it make sense?
A1: The configuration profile represents the set of configuration
parameters for a given meter object, such as the rates and sizes for
the token buckets. The configuration profile concept makes sense when
many meter objects share the same configuration, which is the typical
usage model: thousands of traffic flows are each individually metered
according to just a few service levels (i.e. profiles).
Q2: How is the configuration profile improving the performance?
A2: The performance improvement is achieved by reducing the memory
footprint of a meter object, which results in better cache utilization
for the typical case when large arrays of meter objects are used. The
internal data structures stored for each meter object contain:
a) Constant fields: Low level translation of the configuration
parameters that does not change post-configuration. This is
really duplicated for all meters that use the same
configuration. This is the configuration profile data that is
moved away from the meter object. Current size (implementation
dependent): srTCM = 32 bytes, trTCM = 32 bytes.
b) Variable fields: Time stamps and running counters that change
during the on-going traffic metering process. Current size
(implementation dependent): srTCM = 24 bytes, trTCM = 32 bytes.
Therefore, by moving the constant fields to a separate profile
data structure shared by all the meters with the same
configuration, the size of the meter object is reduced by ~50%.
Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
Signed-off-by: Jasvinder Singh <jasvinder.singh@intel.com>
113 lines
2.5 KiB
C
113 lines
2.5 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause
|
|
* Copyright(c) 2010-2014 Intel Corporation
|
|
*/
|
|
|
|
#include <inttypes.h>
|
|
#include <stdio.h>
|
|
#include <math.h>
|
|
|
|
#include <rte_common.h>
|
|
#include <rte_log.h>
|
|
#include <rte_cycles.h>
|
|
|
|
#include "rte_meter.h"
|
|
|
|
#ifndef RTE_METER_TB_PERIOD_MIN
|
|
#define RTE_METER_TB_PERIOD_MIN 100
|
|
#endif
|
|
|
|
static void
|
|
rte_meter_get_tb_params(uint64_t hz, uint64_t rate, uint64_t *tb_period, uint64_t *tb_bytes_per_period)
|
|
{
|
|
double period = ((double) hz) / ((double) rate);
|
|
|
|
if (period >= RTE_METER_TB_PERIOD_MIN) {
|
|
*tb_bytes_per_period = 1;
|
|
*tb_period = (uint64_t) period;
|
|
} else {
|
|
*tb_bytes_per_period = (uint64_t) ceil(RTE_METER_TB_PERIOD_MIN / period);
|
|
*tb_period = (hz * (*tb_bytes_per_period)) / rate;
|
|
}
|
|
}
|
|
|
|
int __rte_experimental
|
|
rte_meter_srtcm_profile_config(struct rte_meter_srtcm_profile *p,
|
|
struct rte_meter_srtcm_params *params)
|
|
{
|
|
uint64_t hz = rte_get_tsc_hz();
|
|
|
|
/* Check input parameters */
|
|
if ((p == NULL) ||
|
|
(params == NULL) ||
|
|
(params->cir == 0) ||
|
|
((params->cbs == 0) && (params->ebs == 0)))
|
|
return -EINVAL;
|
|
|
|
/* Initialize srTCM run-time structure */
|
|
p->cbs = params->cbs;
|
|
p->ebs = params->ebs;
|
|
rte_meter_get_tb_params(hz, params->cir, &p->cir_period,
|
|
&p->cir_bytes_per_period);
|
|
|
|
return 0;
|
|
}
|
|
|
|
int
|
|
rte_meter_srtcm_config(struct rte_meter_srtcm *m,
|
|
struct rte_meter_srtcm_profile *p)
|
|
{
|
|
/* Check input parameters */
|
|
if ((m == NULL) || (p == NULL))
|
|
return -EINVAL;
|
|
|
|
/* Initialize srTCM run-time structure */
|
|
m->time = rte_get_tsc_cycles();
|
|
m->tc = p->cbs;
|
|
m->te = p->ebs;
|
|
|
|
return 0;
|
|
}
|
|
|
|
int __rte_experimental
|
|
rte_meter_trtcm_profile_config(struct rte_meter_trtcm_profile *p,
|
|
struct rte_meter_trtcm_params *params)
|
|
{
|
|
uint64_t hz = rte_get_tsc_hz();
|
|
|
|
/* Check input parameters */
|
|
if ((p == NULL) ||
|
|
(params == NULL) ||
|
|
(params->cir == 0) ||
|
|
(params->pir == 0) ||
|
|
(params->pir < params->cir) ||
|
|
(params->cbs == 0) ||
|
|
(params->pbs == 0))
|
|
return -EINVAL;
|
|
|
|
/* Initialize trTCM run-time structure */
|
|
p->cbs = params->cbs;
|
|
p->pbs = params->pbs;
|
|
rte_meter_get_tb_params(hz, params->cir, &p->cir_period,
|
|
&p->cir_bytes_per_period);
|
|
rte_meter_get_tb_params(hz, params->pir, &p->pir_period,
|
|
&p->pir_bytes_per_period);
|
|
|
|
return 0;
|
|
}
|
|
|
|
int
|
|
rte_meter_trtcm_config(struct rte_meter_trtcm *m,
|
|
struct rte_meter_trtcm_profile *p)
|
|
{
|
|
/* Check input parameters */
|
|
if ((m == NULL) || (p == NULL))
|
|
return -EINVAL;
|
|
|
|
/* Initialize trTCM run-time structure */
|
|
m->time_tc = m->time_tp = rte_get_tsc_cycles();
|
|
m->tc = p->cbs;
|
|
m->tp = p->pbs;
|
|
|
|
return 0;
|
|
}
|