On Thu, Dec 9, 2021 at 3:23 PM grantseltzer <grantseltzer@xxxxxxxxx> wrote: > > From: Grant Seltzer <grantseltzer@xxxxxxxxx> > > This adds doc comments for the two bpf_program pinning functions, > bpf_program__pin() and bpf_program__unpin() > > Signed-off-by: Grant Seltzer <grantseltzer@xxxxxxxxx> > --- Applied to bpf-next with few minor tweaks. Thanks. > tools/lib/bpf/libbpf.h | 24 ++++++++++++++++++++++++ > 1 file changed, 24 insertions(+) > > diff --git a/tools/lib/bpf/libbpf.h b/tools/lib/bpf/libbpf.h > index 4802c1e73..d6518f30a 100644 > --- a/tools/lib/bpf/libbpf.h > +++ b/tools/lib/bpf/libbpf.h > @@ -299,7 +299,31 @@ LIBBPF_DEPRECATED_SINCE(0, 7, "multi-instance bpf_program support is deprecated" > LIBBPF_API int bpf_program__unpin_instance(struct bpf_program *prog, > const char *path, > int instance); > + > +/** > + * @brief **bpf_program__pin()** pins the BPF program to a file > + * in the BPFFS specified by a path. This increments the programs > + * reference count, allowing it to stay loaded after the process > + * which loaded it has exited. > + * > + * @param prog BPF program to pin, must already be loaded > + * @param path filepath in a BPF Filesystem > + * @return int error code, 0 if no error (errno is also set to error) > + */ > LIBBPF_API int bpf_program__pin(struct bpf_program *prog, const char *path); > + > +/** > + * @brief **bpf_program__unpin()** unpins the BPF program from a file > + * in the BPFFS specified by a path. This decrements the programs > + * reference count. > + * > + * The file pinning the BPF program can also be unlinked by a different > + * process in which case this function will return an error > + * > + * @param prog BPF program to unpin > + * @param path filepath to the pin in a BPF Filesystem > + * @return int error code, 0 if no error (errno is also set to error) > + */ > LIBBPF_API int bpf_program__unpin(struct bpf_program *prog, const char *path); > LIBBPF_API void bpf_program__unload(struct bpf_program *prog); > > -- > 2.33.1 >
