1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
// SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause)
/*
* XDP management utility functions
*
* Copyright (C) 2020 Toke Høiland-Jørgensen <toke@redhat.com>
*/
#ifndef __LIBXDP_LIBXDP_H
#define __LIBXDP_LIBXDP_H
#include <stdio.h>
#include <linux/bpf.h>
#include <bpf/libbpf.h>
#include <bpf/bpf.h>
#include "xdp_helpers.h"
#ifdef __cplusplus
extern "C" {
#endif
#define XDP_BPFFS_ENVVAR "LIBXDP_BPFFS"
#define XDP_BPFFS_MOUNT_ENVVAR "LIBXDP_BPFFS_AUTOMOUNT"
#define XDP_OBJECT_ENVVAR "LIBXDP_OBJECT_PATH"
enum xdp_attach_mode {
XDP_MODE_UNSPEC = 0,
XDP_MODE_NATIVE,
XDP_MODE_SKB,
XDP_MODE_HW
};
/* This is compatible with libbpf logging levels */
enum libxdp_print_level {
LIBXDP_WARN,
LIBXDP_INFO,
LIBXDP_DEBUG,
};
typedef int (*libxdp_print_fn_t)(enum libxdp_print_level level,
const char *, va_list ap);
libxdp_print_fn_t libxdp_set_print(libxdp_print_fn_t fn);
struct xdp_program;
struct xdp_multiprog;
long libxdp_get_error(const void *ptr);
int libxdp_strerror(int err, char *buf, size_t size);
int libxdp_clean_references(int ifindex);
struct xdp_program *xdp_program__from_bpf_obj(struct bpf_object *obj,
const char *section_name);
struct xdp_program *xdp_program__find_file(const char *filename,
const char *section_name,
struct bpf_object_open_opts *opts);
struct xdp_program *xdp_program__open_file(const char *filename,
const char *section_name,
struct bpf_object_open_opts *opts);
struct xdp_program *xdp_program__from_fd(int fd);
struct xdp_program *xdp_program__from_id(__u32 prog_id);
struct xdp_program *xdp_program__from_pin(const char *pin_path);
struct xdp_program *xdp_program__clone(struct xdp_program *xdp_prog,
unsigned int flags);
void xdp_program__close(struct xdp_program *xdp_prog);
int xdp_program__test_run(struct xdp_program *xdp_prog,
struct bpf_test_run_opts *opts,
unsigned int flags);
enum xdp_attach_mode xdp_program__is_attached(const struct xdp_program *xdp_prog,
int ifindex);
const char *xdp_program__name(const struct xdp_program *xdp_prog);
const unsigned char *xdp_program__tag(const struct xdp_program *xdp_prog);
struct bpf_object *xdp_program__bpf_obj(struct xdp_program *xdp_prog);
const struct btf *xdp_program__btf(struct xdp_program *xdp_prog);
uint32_t xdp_program__id(const struct xdp_program *xdp_prog);
int xdp_program__fd(const struct xdp_program *xdp_prog);
unsigned int xdp_program__run_prio(const struct xdp_program *xdp_prog);
int xdp_program__set_run_prio(struct xdp_program *xdp_prog,
unsigned int run_prio);
bool xdp_program__chain_call_enabled(const struct xdp_program *xdp_prog,
enum xdp_action action);
int xdp_program__set_chain_call_enabled(struct xdp_program *prog,
unsigned int action,
bool enabled);
int xdp_program__print_chain_call_actions(const struct xdp_program *prog,
char *buf,
size_t buf_len);
bool xdp_program__xdp_frags_support(const struct xdp_program *prog);
int xdp_program__set_xdp_frags_support(struct xdp_program *prog, bool frags);
int xdp_program__pin(struct xdp_program *xdp_prog, const char *pin_path);
int xdp_program__attach(struct xdp_program *xdp_prog,
int ifindex, enum xdp_attach_mode mode,
unsigned int flags);
int xdp_program__attach_multi(struct xdp_program **progs, size_t num_progs,
int ifindex, enum xdp_attach_mode mode,
unsigned int flags);
int xdp_program__detach(struct xdp_program *xdp_prog,
int ifindex, enum xdp_attach_mode mode,
unsigned int flags);
int xdp_program__detach_multi(struct xdp_program **progs, size_t num_progs,
int ifindex, enum xdp_attach_mode mode,
unsigned int flags);
struct xdp_multiprog *xdp_multiprog__get_from_ifindex(int ifindex);
struct xdp_program *xdp_multiprog__next_prog(const struct xdp_program *prog,
const struct xdp_multiprog *mp);
void xdp_multiprog__close(struct xdp_multiprog *mp);
int xdp_multiprog__detach(struct xdp_multiprog *mp);
enum xdp_attach_mode xdp_multiprog__attach_mode(const struct xdp_multiprog *mp);
struct xdp_program *xdp_multiprog__main_prog(const struct xdp_multiprog *mp);
struct xdp_program *xdp_multiprog__hw_prog(const struct xdp_multiprog *mp);
bool xdp_multiprog__is_legacy(const struct xdp_multiprog *mp);
int xdp_multiprog__program_count(const struct xdp_multiprog *mp);
bool xdp_multiprog__xdp_frags_support(const struct xdp_multiprog *mp);
/* Only following members can be set at once:
*
* @obj, @prog_name
* Create using BPF program with name @prog_name in BPF object @obj
*
* @prog_name is optional. In absence of @prog_name, first program of BPF
* object is picked.
*
* @find_filename, @prog_name, @opts
* Create using BPF program with name @prog_name in BPF object located in
* LIBXDP_OBJECT_PATH with filename @find_filename, using
* bpf_object_open_opts @opts.
*
* @prog_name and @opts is optional. In absence of @prog_name, first
* program of BPF object is picked.
*
* @open_filename, @prog_name, @opts
* Create using BPF program with name @prog_name in BPF object located at
* path @open_filename, using bpf_object_open_opts @opts.
*
* @prog_name and @opts is optional. In absence of @prog_name, first
* program of BPF object is picked.
*
* @id
* Load from BPF program with ID @id
*
* @fd
* Load from BPF program with fd @fd
*
* When one of these combinations is set, all other members of the opts struct
* must be zeroed out.
*/
struct xdp_program_opts {
size_t sz;
struct bpf_object *obj;
struct bpf_object_open_opts *opts;
const char *prog_name;
const char *find_filename;
const char *open_filename;
const char *pin_path;
__u32 id;
int fd;
size_t :0;
};
#define xdp_program_opts__last_field fd
#define DECLARE_LIBXDP_OPTS DECLARE_LIBBPF_OPTS
struct xdp_program *xdp_program__create(struct xdp_program_opts *opts);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif
|
