rte_regexdev.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(C) 2019 Marvell International Ltd.
 */

#ifndef _RTE_REGEXDEV_H_
#define _RTE_REGEXDEV_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <rte_common.h>
#include <rte_config.h>
#include <rte_dev.h>
#include <rte_errno.h>
#include <rte_memory.h>

uint8_t
rte_regex_dev_count(void);

int
rte_regex_dev_get_dev_id(const char *name);

/* Enumerates RegEx device capabilities */
#define RTE_REGEX_DEV_CAPA_RUNTIME_COMPILATION_F (1ULL << 0)

/* Enumerates unsupported PCRE features for the RegEx device */
#define RTE_REGEX_DEV_PCRE_UNSUP_START_ANCHOR_F (1ULL << 0)

#define RTE_REGEX_DEV_PCRE_UNSUP_ATOMIC_GROUPING_F (1ULL << 1)

#define RTE_REGEX_DEV_PCRE_UNSUP_BACKTRACKING_CTRL_F (1ULL << 2)

#define RTE_REGEX_DEV_PCRE_UNSUP_CALLOUTS_F (1ULL << 3)

#define RTE_REGEX_DEV_PCRE_UNSUP_BACKREFERENCE_F (1ULL << 4)

#define RTE_REGEX_DEV_PCRE_UNSUP_GREEDY_F (1ULL << 5)

#define RTE_REGEX_DEV_PCRE_UNSUP_LOOKAROUND_ASRT_F (1ULL << 6)

#define RTE_REGEX_DEV_PCRE_UNSUP_MATCH_POINT_RST_F (1ULL << 7)

#define RTE_REGEX_DEV_PCRE_UNSUP_NEWLINE_CONVENTIONS_F (1ULL << 8)

#define RTE_REGEX_DEV_PCRE_UNSUP_NEWLINE_SEQ_F (1ULL << 9)

#define RTE_REGEX_DEV_PCRE_UNSUP_POSSESSIVE_QUALIFIERS_F (1ULL << 10)

#define RTE_REGEX_DEV_PCRE_UNSUP_SUBROUTINE_REFERENCES_F (1ULL << 11)

#define RTE_REGEX_DEV_PCRE_UNSUP_UTF_8_F (1ULL << 12)

#define RTE_REGEX_DEV_PCRE_UNSUP_UTF_16_F (1ULL << 13)

#define RTE_REGEX_DEV_PCRE_UNSUP_UTF_32_F (1ULL << 14)

#define RTE_REGEX_DEV_PCRE_UNSUP_WORD_BOUNDARY_F (1ULL << 15)

#define RTE_REGEX_DEV_PCRE_UNSUP_FORWARD_REFERENCES_F (1ULL << 16)

/* Enumerates PCRE rule flags */
#define RTE_REGEX_PCRE_RULE_ALLOW_EMPTY_F (1ULL << 0)

#define RTE_REGEX_PCRE_RULE_ANCHORED_F (1ULL << 1)

#define RTE_REGEX_PCRE_RULE_CASELESS_F (1ULL << 2)

#define RTE_REGEX_PCRE_RULE_DOTALL_F (1ULL << 3)

#define RTE_REGEX_PCRE_RULE_DUPNAMES_F (1ULL << 4)

#define RTE_REGEX_PCRE_RULE_EXTENDED_F (1ULL << 5)

#define RTE_REGEX_PCRE_RULE_MATCH_UNSET_BACKREF_F (1ULL << 6)

#define RTE_REGEX_PCRE_RULE_MULTILINE_F (1ULL << 7)

#define RTE_REGEX_PCRE_RULE_NO_AUTO_CAPTURE_F (1ULL << 8)

#define RTE_REGEX_PCRE_RULE_UCP_F (1ULL << 9)

#define RTE_REGEX_PCRE_RULE_UNGREEDY_F (1ULL << 10)

#define RTE_REGEX_PCRE_RULE_UTF_F (1ULL << 11)

#define RTE_REGEX_PCRE_RULE_NEVER_BACKSLASH_C_F (1ULL << 12)

struct rte_regex_dev_info {
    const char *driver_name; 
    struct rte_device *dev; 
    uint8_t max_matches;
    uint16_t max_queue_pairs;
    uint16_t max_payload_size;
    uint16_t max_rules_per_group;
    uint16_t max_groups;
    uint32_t regex_dev_capa;
    uint64_t rule_flags;
    uint64_t pcre_unsup_flags;
};

int
rte_regex_dev_info_get(uint8_t dev_id, struct rte_regex_dev_info *dev_info);

/* Enumerates RegEx device configuration flags */
#define RTE_REGEX_DEV_CFG_CROSS_BUFFER_SCAN_F (1ULL << 0)

struct rte_regex_dev_config {
    uint8_t nb_max_matches;
    uint16_t nb_queue_pairs;
    uint16_t nb_rules_per_group;
    uint16_t nb_groups;
    const char *rule_db;
    uint32_t rule_db_len;
    uint32_t dev_cfg_flags;
};

int
rte_regex_dev_configure(uint8_t dev_id, const struct rte_regex_dev_config *cfg);

/* Enumerates RegEx queue pair configuration flags */
#define RTE_REGEX_QUEUE_PAIR_CFG_OOS_F (1ULL << 0)

struct rte_regex_ops;
typedef void (*regexdev_stop_flush_t)(uint8_t dev_id, uint16_t qp_id,
                      struct rte_regex_ops *op);
struct rte_regex_qp_conf {
    uint32_t qp_conf_flags;
    uint16_t nb_desc;
    regexdev_stop_flush_t cb;
};

int
rte_regex_queue_pair_setup(uint8_t dev_id, uint8_t queue_pair_id,
               const struct rte_regex_qp_conf *qp_conf);

int
rte_regex_dev_start(uint8_t dev_id);

void
rte_regex_dev_stop(uint8_t dev_id);

int
rte_regex_dev_close(uint8_t dev_id);

/* Device get/set attributes */

enum rte_regex_dev_attr_id {
    RTE_REGEX_DEV_ATTR_SOCKET_ID,
    RTE_REGEX_DEV_ATTR_MAX_MATCHES,
    RTE_REGEX_DEV_ATTR_MAX_SCAN_TIMEOUT,
    RTE_REGEX_DEV_ATTR_MAX_PREFIX,
};

int
rte_regex_dev_attr_get(uint8_t dev_id, enum rte_regex_dev_attr_id attr_id,
               void *attr_value);

int
rte_regex_dev_attr_set(uint8_t dev_id, enum rte_regex_dev_attr_id attr_id,
               const void *attr_value);

/* Rule related APIs */
enum rte_regex_rule_op {
    RTE_REGEX_RULE_OP_ADD,
    RTE_REGEX_RULE_OP_REMOVE
};

struct rte_regex_rule {
    enum rte_regex_rule_op op;
    uint16_t group_id;
    uint32_t rule_id;
    const char *pcre_rule;
    uint16_t pcre_rule_len;
    uint64_t rule_flags;
    /* PCRE rule flags. Supported device specific PCRE rules enumerated
     * in struct rte_regex_dev_info::rule_flags. For successful rule
     * database update, application needs to provide only supported
     * rule flags.
     * @See RTE_REGEX_PCRE_RULE_*, struct rte_regex_dev_info::rule_flags
     */
};

uint16_t
rte_regex_rule_db_update(uint8_t dev_id, const struct rte_regex_rule *rules,
             uint16_t nb_rules);

int
rte_regex_rule_db_import(uint8_t dev_id, const char *rule_db,
             uint32_t rule_db_len);

int
rte_regex_rule_db_export(uint8_t dev_id, char *rule_db);

/* Extended statistics */
#define RTE_REGEX_DEV_XSTATS_NAME_SIZE 64

struct rte_regex_dev_xstats_map {
    uint16_t id;
    char name[RTE_REGEX_DEV_XSTATS_NAME_SIZE];
};

int
rte_regex_dev_xstats_names_get(uint8_t dev_id,
                   struct rte_regex_dev_xstats_map *xstats_map);

int
rte_regex_dev_xstats_get(uint8_t dev_id, const uint16_t ids[],
             uint64_t values[], uint16_t n);

int
rte_regex_dev_xstats_by_name_get(uint8_t dev_id, const char *name,
                 uint16_t *id, uint64_t *value);

int
rte_regex_dev_xstats_reset(uint8_t dev_id, const uint16_t ids[],
               uint16_t nb_ids);

int rte_regex_dev_selftest(uint8_t dev_id);

int
rte_regex_dev_dump(uint8_t dev_id, FILE *f);

/* Fast path APIs */

struct rte_regex_match {
    RTE_STD_C11
    union {
        uint64_t u64;
        struct {
            uint32_t rule_id:20;
            uint32_t group_id:12;
            uint16_t offset;
            uint16_t len;
        };
    };
};

/* Enumerates RegEx request flags. */
#define RTE_REGEX_OPS_REQ_GROUP_ID1_VALID_F (1 << 0)

#define RTE_REGEX_OPS_REQ_GROUP_ID2_VALID_F (1 << 1)

#define RTE_REGEX_OPS_REQ_GROUP_ID3_VALID_F (1 << 2)

#define RTE_REGEX_OPS_REQ_STOP_ON_MATCH_F (1 << 4)

#define RTE_REGEX_OPS_REQ_MATCH_HIGH_PRIORITY_F (1 << 5)

/* Enumerates RegEx response flags. */
#define RTE_REGEX_OPS_RSP_PMI_SOJ_F (1 << 0)

#define RTE_REGEX_OPS_RSP_PMI_EOJ_F (1 << 1)

#define RTE_REGEX_OPS_RSP_MAX_SCAN_TIMEOUT_F (1 << 2)

#define RTE_REGEX_OPS_RSP_MAX_MATCH_F (1 << 3)

#define RTE_REGEX_OPS_RSP_MAX_PREFIX_F (1 << 4)

struct rte_regex_ops {
    /* W0 */
    uint16_t req_flags;
    uint16_t scan_size;
    uint16_t rsp_flags;
    uint8_t nb_actual_matches;
    uint8_t nb_matches;
    /* W1 */
    RTE_STD_C11
    union {
        uint64_t u64;
        void *buf_addr;
    };

    /* W2 */
    rte_iova_t buf_iova;
    /* W3 */
    uint16_t group_id0;
    uint16_t group_id1;
    uint16_t group_id2;
    uint16_t group_id3;
    /* W4 */
    RTE_STD_C11
    union {
        uint64_t user_id;
        void *user_ptr;
    };

    /* W5 */
    struct rte_regex_match matches[];
};

uint16_t
rte_regex_enqueue_burst(uint8_t dev_id, uint16_t qp_id,
            struct rte_regex_ops **ops, uint16_t nb_ops);

uint16_t
rte_regex_dequeue_burst(uint8_t dev_id, uint16_t qp_id,
            struct rte_regex_ops **ops, uint16_t nb_ops);

#ifdef __cplusplus
}
#endif

#endif /* _RTE_REGEXDEV_H_ */