1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright 2018 Gaƫtan Rivet
11 * DPDK device class interface.
13 * This file describes the interface of the device class
16 * A device class defines the type of function a device
17 * will be used for e.g.: Ethernet adapter (eth),
18 * cryptographic coprocessor (crypto), etc.
25 #include <sys/queue.h>
29 /** Double linked list of classes */
30 TAILQ_HEAD(rte_class_list, rte_class);
33 * A structure describing a generic device class.
36 TAILQ_ENTRY(rte_class) next; /**< Next device class in linked list */
37 const char *name; /**< Name of the class */
41 * Class comparison function.
47 * Data to compare against.
50 * 0 if the class matches the data.
51 * !0 if the class does not match.
52 * <0 if ordering is possible and the class is lower than the data.
53 * >0 if ordering is possible and the class is greater than the data.
55 typedef int (*rte_class_cmp_t)(const struct rte_class *cls, const void *data);
58 * Class iterator to find a particular class.
60 * This function compares each registered class to find one that matches
61 * the data passed as parameter.
63 * If the comparison function returns zero this function will stop iterating
64 * over any more classes. To continue a search the class of a previous search
65 * can be passed via the start parameter.
68 * Starting point for the iteration.
71 * Comparison function.
74 * Data to pass to comparison function.
77 * A pointer to a rte_class structure or NULL in case no class matches
81 rte_class_find(const struct rte_class *start, rte_class_cmp_t cmp,
85 * Find the registered class for a given name.
89 rte_class_find_by_name(const char *name);
92 * Register a Class handle.
95 * A pointer to a rte_class structure describing the class
99 void rte_class_register(struct rte_class *cls);
102 * Unregister a Class handle.
105 * A pointer to a rte_class structure describing the class
106 * to be unregistered.
109 void rte_class_unregister(struct rte_class *cls);
112 * Helper for Class registration.
113 * The constructor has lower priority than Bus constructors.
114 * The constructor has higher priority than PMD constructors.
116 #define RTE_REGISTER_CLASS(nm, cls) \
117 RTE_INIT_PRIO(classinitfn_ ##nm, CLASS) \
119 (cls).name = RTE_STR(nm); \
120 rte_class_register(&cls); \
123 #define RTE_UNREGISTER_CLASS(nm, cls) \
124 RTE_FINI_PRIO(classfinifn_ ##nm, CLASS) \
126 rte_class_unregister(&cls); \
133 #endif /* _RTE_CLASS_H_ */