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 <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);

__rte_experimental
int
rte_sched_subport_tc_ov_config(struct rte_sched_port *port, uint32_t subport_id, bool tc_ov_enable);

#ifdef __cplusplus
}
#endif

#endif /* __INCLUDE_RTE_SCHED_H__ */