rte_meter.h File Reference

#include <stdint.h>
#include <rte_compat.h>

Go to the source code of this file.

Data Structures
struct	rte_meter_srtcm_params
struct	rte_meter_trtcm_params
struct	rte_meter_trtcm

Enumerations
enum	rte_meter_color { e_RTE_METER_GREEN = 0, e_RTE_METER_YELLOW, e_RTE_METER_RED, e_RTE_METER_COLORS }

Functions
int __rte_experimental	rte_meter_srtcm_profile_config (struct rte_meter_srtcm_profile *p, struct rte_meter_srtcm_params *params)
int __rte_experimental	rte_meter_trtcm_profile_config (struct rte_meter_trtcm_profile *p, struct rte_meter_trtcm_params *params)
int	rte_meter_srtcm_config (struct rte_meter_srtcm *m, struct rte_meter_srtcm_profile *p)
int	rte_meter_trtcm_config (struct rte_meter_trtcm *m, struct rte_meter_trtcm_profile *p)
static enum rte_meter_color	rte_meter_srtcm_color_blind_check (struct rte_meter_srtcm *m, struct rte_meter_srtcm_profile *p, uint64_t time, uint32_t pkt_len)
static enum rte_meter_color	rte_meter_srtcm_color_aware_check (struct rte_meter_srtcm *m, struct rte_meter_srtcm_profile *p, uint64_t time, uint32_t pkt_len, enum rte_meter_color pkt_color)
static enum rte_meter_color	rte_meter_trtcm_color_blind_check (struct rte_meter_trtcm *m, struct rte_meter_trtcm_profile *p, uint64_t time, uint32_t pkt_len)
static enum rte_meter_color	rte_meter_trtcm_color_aware_check (struct rte_meter_trtcm *m, struct rte_meter_trtcm_profile *p, uint64_t time, uint32_t pkt_len, enum rte_meter_color pkt_color)

Detailed Description

RTE Traffic Metering

Traffic metering algorithms:

1. Single Rate Three Color Marker (srTCM): defined by IETF RFC 2697
2. Two Rate Three Color Marker (trTCM): defined by IETF RFC 2698

Definition in file rte_meter.h.

Enumeration Type Documentation

enum rte_meter_color

Packet Color Set

Enumerator:

e_RTE_METER_GREEN	Green
e_RTE_METER_YELLOW	Yellow
e_RTE_METER_RED	Red
e_RTE_METER_COLORS	Number of available colors

Definition at line 31 of file rte_meter.h.

Function Documentation

int __rte_experimental rte_meter_srtcm_profile_config	(	struct rte_meter_srtcm_profile *	p,
		struct rte_meter_srtcm_params *	params
	)

srTCM profile configuration

Parameters

p	Pointer to pre-allocated srTCM profile data structure
params	srTCM profile parameters

Returns

0 upon success, error code otherwise

Examples:

examples/qos_meter/main.c.

int __rte_experimental rte_meter_trtcm_profile_config	(	struct rte_meter_trtcm_profile *	p,
		struct rte_meter_trtcm_params *	params
	)

trTCM profile configuration

Parameters

p	Pointer to pre-allocated trTCM profile data structure
params	trTCM profile parameters

Returns

0 upon success, error code otherwise

Examples:

examples/qos_meter/main.c.

int rte_meter_srtcm_config	(	struct rte_meter_srtcm *	m,
		struct rte_meter_srtcm_profile *	p
	)

srTCM configuration per metered traffic flow

Parameters

m	Pointer to pre-allocated srTCM data structure
p	srTCM profile. Needs to be valid.

Returns

0 upon success, error code otherwise

int rte_meter_trtcm_config	(	struct rte_meter_trtcm *	m,
		struct rte_meter_trtcm_profile *	p
	)

trTCM configuration per metered traffic flow

Parameters

m	Pointer to pre-allocated trTCM data structure
p	trTCM profile. Needs to be valid.

Returns

0 upon success, error code otherwise

static enum rte_meter_color rte_meter_srtcm_color_blind_check ( struct rte_meter_srtcm *  m, struct rte_meter_srtcm_profile *  p, uint64_t  time, uint32_t  pkt_len  )

inlinestatic

srTCM color blind traffic metering

Parameters

m	Handle to srTCM instance
p	srTCM profile specified at srTCM object creation time
time	Current CPU time stamp (measured in CPU cycles)
pkt_len	Length of the current IP packet (measured in bytes)

Returns

Color assigned to the current IP packet

Definition at line 271 of file rte_meter.h.

static enum rte_meter_color rte_meter_srtcm_color_aware_check ( struct rte_meter_srtcm *  m, struct rte_meter_srtcm_profile *  p, uint64_t  time, uint32_t  pkt_len, enum rte_meter_color  pkt_color  )

inlinestatic

srTCM color aware traffic metering

Parameters

m	Handle to srTCM instance
p	srTCM profile specified at srTCM object creation time
time	Current CPU time stamp (measured in CPU cycles)
pkt_len	Length of the current IP packet (measured in bytes)
pkt_color	Input color of the current IP packet

Returns

Color assigned to the current IP packet

Definition at line 312 of file rte_meter.h.

static enum rte_meter_color rte_meter_trtcm_color_blind_check ( struct rte_meter_trtcm *  m, struct rte_meter_trtcm_profile *  p, uint64_t  time, uint32_t  pkt_len  )

inlinestatic

trTCM color blind traffic metering

Parameters

m	Handle to trTCM instance
p	trTCM profile specified at trTCM object creation time
time	Current CPU time stamp (measured in CPU cycles)
pkt_len	Length of the current IP packet (measured in bytes)

Returns

Color assigned to the current IP packet

Definition at line 354 of file rte_meter.h.

static enum rte_meter_color rte_meter_trtcm_color_aware_check ( struct rte_meter_trtcm *  m, struct rte_meter_trtcm_profile *  p, uint64_t  time, uint32_t  pkt_len, enum rte_meter_color  pkt_color  )

inlinestatic

trTCM color aware traffic metering

Parameters

m	Handle to trTCM instance
p	trTCM profile specified at trTCM object creation time
time	Current CPU time stamp (measured in CPU cycles)
pkt_len	Length of the current IP packet (measured in bytes)
pkt_color	Input color of the current IP packet

Returns

Color assigned to the current IP packet

Definition at line 396 of file rte_meter.h.