* [PATCH bpf-next] libbpf: Add doc comments for bpf_program__(un)pin()
@ 2021-12-09 23:22 grantseltzer
2021-12-13 21:56 ` Andrii Nakryiko
0 siblings, 1 reply; 2+ messages in thread
From: grantseltzer @ 2021-12-09 23:22 UTC (permalink / raw)
To: bpf; +Cc: andrii, grantseltzer
From: Grant Seltzer <grantseltzer@gmail.com>
This adds doc comments for the two bpf_program pinning functions,
bpf_program__pin() and bpf_program__unpin()
Signed-off-by: Grant Seltzer <grantseltzer@gmail.com>
---
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
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: [PATCH bpf-next] libbpf: Add doc comments for bpf_program__(un)pin()
2021-12-09 23:22 [PATCH bpf-next] libbpf: Add doc comments for bpf_program__(un)pin() grantseltzer
@ 2021-12-13 21:56 ` Andrii Nakryiko
0 siblings, 0 replies; 2+ messages in thread
From: Andrii Nakryiko @ 2021-12-13 21:56 UTC (permalink / raw)
To: grantseltzer; +Cc: bpf, Andrii Nakryiko
On Thu, Dec 9, 2021 at 3:23 PM grantseltzer <grantseltzer@gmail.com> wrote:
>
> From: Grant Seltzer <grantseltzer@gmail.com>
>
> This adds doc comments for the two bpf_program pinning functions,
> bpf_program__pin() and bpf_program__unpin()
>
> Signed-off-by: Grant Seltzer <grantseltzer@gmail.com>
> ---
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
>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2021-12-13 21:56 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-12-09 23:22 [PATCH bpf-next] libbpf: Add doc comments for bpf_program__(un)pin() grantseltzer
2021-12-13 21:56 ` Andrii Nakryiko
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.