rte_sched.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2010-2014 Intel Corporation
 */
 
#ifndef __INCLUDE_RTE_SCHED_H__
#define __INCLUDE_RTE_SCHED_H__
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <sys/types.h>
#include <rte_compat.h>
#include <rte_mbuf.h>
#include <rte_meter.h>
 
#include "rte_red.h"
#include "rte_pie.h"
 
#define RTE_SCHED_QUEUES_PER_PIPE    16
 
#define RTE_SCHED_BE_QUEUES_PER_PIPE    4
 
#define RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE    \
(RTE_SCHED_QUEUES_PER_PIPE - RTE_SCHED_BE_QUEUES_PER_PIPE + 1)
 
#define RTE_SCHED_TRAFFIC_CLASS_BE    (RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE - 1)
 
/*
 * Ethernet framing overhead. Overhead fields per Ethernet frame:
 * 1. Preamble:                             7 bytes;
 * 2. Start of Frame Delimiter (SFD):       1 byte;
 * 3. Frame Check Sequence (FCS):           4 bytes;
 * 4. Inter Frame Gap (IFG):               12 bytes.
 *
 * The FCS is considered overhead only if not included in the packet
 * length (field pkt_len of struct rte_mbuf).
 *
 * @see struct rte_sched_port_params
 */
#ifndef RTE_SCHED_FRAME_OVERHEAD_DEFAULT
#define RTE_SCHED_FRAME_OVERHEAD_DEFAULT      24
#endif
 
enum rte_sched_cman_mode {
    RTE_SCHED_CMAN_RED, 
    RTE_SCHED_CMAN_PIE, 
};
 
/*
 * Pipe configuration parameters. The period and credits_per_period
 * parameters are measured in bytes, with one byte meaning the time
 * duration associated with the transmission of one byte on the
 * physical medium of the output port, with pipe or pipe traffic class
 * rate (measured as percentage of output port rate) determined as
 * credits_per_period divided by period. One credit represents one
 * byte.
 */
struct rte_sched_pipe_params {
    uint64_t tb_rate;
 
    uint64_t tb_size;
 
    uint64_t tc_rate[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
 
    uint64_t tc_period;
 
    uint8_t tc_ov_weight;
 
    uint8_t wrr_weights[RTE_SCHED_BE_QUEUES_PER_PIPE];
};
 
/*
 * Congestion Management configuration parameters.
 */
struct rte_sched_cman_params {
    enum rte_sched_cman_mode cman_mode;
 
    union {
        struct rte_red_params red_params[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE][RTE_COLORS];
 
        struct rte_pie_params pie_params[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
    };
};
 
/*
 * Subport configuration parameters. The period and credits_per_period
 * parameters are measured in bytes, with one byte meaning the time
 * duration associated with the transmission of one byte on the
 * physical medium of the output port, with pipe or pipe traffic class
 * rate (measured as percentage of output port rate) determined as
 * credits_per_period divided by period. One credit represents one
 * byte.
 */
struct rte_sched_subport_params {
    uint32_t n_pipes_per_subport_enabled;
 
    uint16_t qsize[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
 
    struct rte_sched_pipe_params *pipe_profiles;
 
    uint32_t n_pipe_profiles;
 
    uint32_t n_max_pipe_profiles;
 
    struct rte_sched_cman_params *cman_params;
};
 
struct rte_sched_subport_profile_params {
    uint64_t tb_rate;
 
    uint64_t tb_size;
 
    uint64_t tc_rate[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
 
    uint64_t tc_period;
};
 
struct rte_sched_subport_stats {
    uint64_t n_pkts_tc[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
 
    uint64_t n_pkts_tc_dropped[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
 
    uint64_t n_bytes_tc[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
 
    uint64_t n_bytes_tc_dropped[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
 
    uint64_t n_pkts_cman_dropped[RTE_SCHED_TRAFFIC_CLASSES_PER_PIPE];
};
 
struct rte_sched_queue_stats {
    uint64_t n_pkts;
 
    uint64_t n_pkts_dropped;
 
    uint64_t n_pkts_cman_dropped;
 
    uint64_t n_bytes;
 
    uint64_t n_bytes_dropped;
};
 
struct rte_sched_port_params {
    const char *name;
 
    int socket;
 
    uint64_t rate;
 
    uint32_t mtu;
 
    uint32_t frame_overhead;
 
    uint32_t n_subports_per_port;
 
    struct rte_sched_subport_profile_params *subport_profiles;
 
    uint32_t n_subport_profiles;
 
    uint32_t n_max_subport_profiles;
 
    uint32_t n_pipes_per_subport;
};
 
/*
 * Configuration
 *
 ***/
 
struct rte_sched_port *
rte_sched_port_config(struct rte_sched_port_params *params);
 
void
rte_sched_port_free(struct rte_sched_port *port);
 
int
rte_sched_subport_pipe_profile_add(struct rte_sched_port *port,
    uint32_t subport_id,
    struct rte_sched_pipe_params *params,
    uint32_t *pipe_profile_id);
 
__rte_experimental
int
rte_sched_port_subport_profile_add(struct rte_sched_port *port,
    struct rte_sched_subport_profile_params *profile,
    uint32_t *subport_profile_id);
 
int
rte_sched_subport_config(struct rte_sched_port *port,
    uint32_t subport_id,
    struct rte_sched_subport_params *params,
    uint32_t subport_profile_id);
 
int
rte_sched_pipe_config(struct rte_sched_port *port,
    uint32_t subport_id,
    uint32_t pipe_id,
    int32_t pipe_profile);
 
uint32_t
rte_sched_port_get_memory_footprint(struct rte_sched_port_params *port_params,
    struct rte_sched_subport_params **subport_params);
/*
 * Statistics
 *
 ***/
 
int
rte_sched_subport_read_stats(struct rte_sched_port *port,
    uint32_t subport_id,
    struct rte_sched_subport_stats *stats,
    uint32_t *tc_ov);
 
int
rte_sched_queue_read_stats(struct rte_sched_port *port,
    uint32_t queue_id,
    struct rte_sched_queue_stats *stats,
    uint16_t *qlen);
 
void
rte_sched_port_pkt_write(struct rte_sched_port *port,
             struct rte_mbuf *pkt,
             uint32_t subport, uint32_t pipe, uint32_t traffic_class,
             uint32_t queue, enum rte_color color);
 
void
rte_sched_port_pkt_read_tree_path(struct rte_sched_port *port,
                  const struct rte_mbuf *pkt,
                  uint32_t *subport, uint32_t *pipe,
                  uint32_t *traffic_class, uint32_t *queue);
 
enum rte_color
rte_sched_port_pkt_read_color(const struct rte_mbuf *pkt);
 
int
rte_sched_port_enqueue(struct rte_sched_port *port, struct rte_mbuf **pkts, uint32_t n_pkts);
 
int
rte_sched_port_dequeue(struct rte_sched_port *port, struct rte_mbuf **pkts, uint32_t n_pkts);
 
#ifdef __cplusplus
}
#endif
 
#endif /* __INCLUDE_RTE_SCHED_H__ */