diff options
Diffstat (limited to '')
| -rw-r--r-- | templates/man7/bpf-helpers.7.pot | 500 |
1 files changed, 399 insertions, 101 deletions
diff --git a/templates/man7/bpf-helpers.7.pot b/templates/man7/bpf-helpers.7.pot index 3bdcc79b..91b0c981 100644 --- a/templates/man7/bpf-helpers.7.pot +++ b/templates/man7/bpf-helpers.7.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-02-15 17:55+0100\n" +"POT-Creation-Date: 2024-05-01 15:35+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -24,15 +24,15 @@ msgid "BPF-HELPERS" msgstr "" #. type: TH -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "2023-04-11" +msgid "2023-11-10" msgstr "" #. type: TH -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "Linux v6.2" +msgid "Linux v6.8" msgstr "" #. type: SH @@ -279,34 +279,30 @@ msgid "B<long bpf_trace_printk(const char *>I<fmt>B<, u32 >I<fmt_size>B<, ...)>" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "This helper is a \"printk()-like\" facility for debugging. It prints a " "message defined by format I<fmt> (of size I<fmt_size>) to file I</sys/" -"kernel/debug/tracing/trace> from DebugFS, if available. It can take up to " -"three additional B<u64> arguments (as an eBPF helpers, the total number of " +"kernel/tracing/trace> from TraceFS, if available. It can take up to three " +"additional B<u64> arguments (as an eBPF helpers, the total number of " "arguments is limited to five)." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Each time the helper is called, it appends a line to the trace. Lines are " -"discarded while I</sys/kernel/debug/tracing/trace> is open, use I</sys/" -"kernel/debug/tracing/trace_pipe> to avoid this. The format of the trace is " -"customizable, and the exact output one will get depends on the options set " -"in I</sys/kernel/debug/tracing/trace_options> (see also the I<README> file " -"under the same directory). However, it usually defaults to something like:" +"discarded while I</sys/kernel/tracing/trace> is open, use I</sys/kernel/" +"tracing/trace_pipe> to avoid this. The format of the trace is customizable, " +"and the exact output one will get depends on the options set in I</sys/" +"kernel/tracing/trace_options> (see also the I<README> file under the same " +"directory). However, it usually defaults to something like:" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "" -"^\".ft C$\n" -"telnet-470 [001] .N.. 419421.045894: 0x00000001: E<lt>fmtE<gt>\n" -"^\".ft P$\n" +msgid "telnet-470 [001] .N.. 419421.045894: 0x00000001: E<lt>formatted msgE<gt>\n" msgstr "" #. type: Plain text @@ -364,8 +360,8 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed -msgid "B<E<lt>fmtE<gt>> is the message formatted with I<fmt>\\&." +#: archlinux debian-bookworm debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "B<E<lt>formatted msgE<gt>> is the message formatted with I<fmt>\\&." msgstr "" #. type: Plain text @@ -607,6 +603,14 @@ msgid "" "after the eBPF program has returned." msgstr "" +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"0 on success, or a negative error in case of failure. Positive error " +"indicates a potential drop or congestion in the target device. The " +"particular positive error codes are not defined." +msgstr "" + #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: opensuse-tumbleweed @@ -796,11 +800,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" -"^\".ft C$\n" "int ret;\n" "struct bpf_tunnel_key key = {};\n" msgstr "" @@ -825,12 +827,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "" -"return TC_ACT_OK; // accept packet\n" -"^\".ft P$\n" +msgid "return TC_ACT_OK; // accept packet\n" msgstr "" #. type: Plain text @@ -926,6 +925,19 @@ msgid "" "future." msgstr "" +#. type: TP +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<BPF_F_NO_TUNNEL_KEY>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"Add a flag to tunnel metadata indicating that no tunnel key should be set in " +"the resulting tunnel header." +msgstr "" + #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: opensuse-tumbleweed @@ -933,16 +945,13 @@ msgid "Here is a typical usage on the transmit path:" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" -"^\".ft C$\n" "struct bpf_tunnel_key key;\n" " populate key ...\n" "bpf_skb_set_tunnel_key(skb, &key, sizeof(key), 0);\n" "bpf_clone_redirect(skb, vxlan_dev_ifindex, 0);\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -1300,13 +1309,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "" -"^\".ft C$\n" -"# sysctl kernel.perf_event_max_stack=E<lt>new valueE<gt>\n" -"^\".ft P$\n" +msgid "# sysctl kernel.perf_event_max_stack=E<lt>new valueE<gt>\n" msgstr "" #. type: Plain text @@ -2091,11 +2096,10 @@ msgid "B<struct bpf_sock_ops> for B<BPF_PROG_TYPE_SOCK_OPS>\\&." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"B<struct bpf_sock_addr> for B<BPF_CGROUP_INET4_CONNECT> and " -"B<BPF_CGROUP_INET6_CONNECT>\\&." +"B<struct bpf_sock_addr> for B<BPF_CGROUP_INET4_CONNECT>, " +"B<BPF_CGROUP_INET6_CONNECT> and B<BPF_CGROUP_UNIX_CONNECT>\\&." msgstr "" #. type: Plain text @@ -2238,6 +2242,14 @@ msgid "" "further specify the L2 type as Ethernet." msgstr "" +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"B<BPF_F_ADJ_ROOM_DECAP_L3_IPV4>, B<BPF_F_ADJ_ROOM_DECAP_L3_IPV6>: Indicate " +"the new IP header version after decapsulating the outer IP header. Used when " +"the inner and outer IP versions are different." +msgstr "" + #. type: TP #: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed #, no-wrap @@ -2424,13 +2436,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "" -"^\".ft C$\n" -"normalized_counter = counter * t_enabled / t_running\n" -"^\".ft P$\n" +msgid "normalized_counter = counter * t_enabled / t_running\n" msgstr "" #. type: Plain text @@ -2453,10 +2461,9 @@ msgid "B<long bpf_perf_prog_read_value(struct bpf_perf_event_data *>I<ctx>B<, st msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"For en eBPF program attached to a perf event, retrieve the value of the " +"For an eBPF program attached to a perf event, retrieve the value of the " "event counter associated to I<ctx> and store it in the structure pointed by " "I<buf> and of size I<buf_size>\\&. Enabled and running times are also stored " "in the structure (see description of helper B<bpf_perf_event_read_value>() " @@ -3044,6 +3051,19 @@ msgid "Do a direct table lookup vs full lookup using FIB rules." msgstr "" #. type: TP +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<BPF_FIB_LOOKUP_TBID>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"Used with BPF_FIB_LOOKUP_DIRECT. Use the routing table ID present in " +"I<params>-E<gt>tbid for the fib lookup." +msgstr "" + +#. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: opensuse-tumbleweed #, no-wrap @@ -3056,6 +3076,35 @@ msgstr "" msgid "Perform lookup from an egress perspective (default is ingress)." msgstr "" +#. type: TP +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<BPF_FIB_LOOKUP_SKIP_NEIGH>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"Skip the neighbour table lookup. I<params>-E<gt>dmac and I<params>-E<gt>smac " +"will not be set as output. A common use case is to call " +"B<bpf_redirect_neigh>() after doing B<bpf_fib_lookup>()." +msgstr "" + +#. type: TP +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<BPF_FIB_LOOKUP_SRC>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"Derive and set source IP addr in I<params>-E<gt>ipv{4,6}_src for the " +"nexthop. If the src addr cannot be derived, B<BPF_FIB_LKUP_RET_NO_SRC_ADDR> " +"is returned. In this case, I<params>-E<gt>dmac and I<params>-E<gt>smac are " +"not set either." +msgstr "" + #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: opensuse-tumbleweed @@ -4587,28 +4636,19 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" -"^\".ft C$\n" "SEC(\"kprobe/sys_open\")\n" "void bpf_sys_open(struct pt_regs *ctx)\n" "{\n" " char buf[PATHLEN]; // PATHLEN is defined to 256\n" -" int res;\n" -msgstr "" - -#. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed -#, no-wrap -msgid "" -" res = bpf_probe_read_user_str(buf, sizeof(buf),\n" -" ctx-E<gt>di);\n" +" int res = bpf_probe_read_user_str(buf, sizeof(buf),\n" +" ctx-E<gt>di);\n" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" " // Consume buf, for example push it to\n" @@ -4616,7 +4656,6 @@ msgid "" " // can use res (the string length) as event\n" " // size, after checking its boundaries.\n" "}\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -4941,12 +4980,6 @@ msgid "" "outside of TC ingress." msgstr "" -#. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed -msgid "B<-ESOCKTNOSUPPORT> if the socket type is not supported (reuseport)." -msgstr "" - #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: opensuse-tumbleweed @@ -5523,13 +5556,20 @@ msgid "B<long bpf_get_task_stack(struct task_struct *>I<task>B<, void *>I<buf>B< msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"Return a user or a kernel stack in bpf program provided buffer. To achieve " -"this, the helper needs I<task>, which is a valid pointer to B<struct " -"task_struct>\\&. To store the stacktrace, the bpf program provides I<buf> " -"with a nonnegative I<size>\\&." +"Return a user or a kernel stack in bpf program provided buffer. Note: the " +"user stack will only be populated if the I<task> is the current task; all " +"other tasks will return -EOPNOTSUPP. To achieve this, the helper needs " +"I<task>, which is a valid pointer to B<struct task_struct>\\&. To store the " +"stacktrace, the bpf program provides I<buf> with a nonnegative I<size>\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"Collect a user space stack instead of a kernel stack. The I<task> must be " +"the current task." msgstr "" #. type: Plain text @@ -6720,6 +6760,34 @@ msgid "" msgstr "" #. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "I<flags> can be one of:" +msgstr "" + +#. type: TP +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<BPF_F_TIMER_ABS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"Start the timer in absolute expire value instead of the default relative one." +msgstr "" + +#. type: TP +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<BPF_F_TIMER_CPU_PIN>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "Timer will be pinned to the CPU of the caller." +msgstr "" + +#. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: opensuse-tumbleweed msgid "" @@ -6764,11 +6832,18 @@ msgid "Get address of the traced function (for tracing and kprobe programs)." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"Address of the traced function. 0 for kprobes placed within the function " -"(not at the entry)." +"When called for kprobe program attached as uprobe it returns probe address " +"for both entry and return uprobe." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"Address of the traced function for kprobe. 0 for kprobes placed within the " +"function (not at the entry). Address of the probe for uprobe and return " +"uprobe." msgstr "" #. type: TP @@ -7533,19 +7608,44 @@ msgid "B<long bpf_dynptr_write(const struct bpf_dynptr *>I<dst>B<, u32 >I<offset msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Write I<len> bytes from I<src> into I<dst>, starting from I<offset> into " -"I<dst>\\&. I<flags> is currently unused." +"I<dst>\\&." msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "I<flags> must be 0 except for skb-type dynptrs." +msgstr "" + +#. type: TP +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<For skb-type dynptrs:>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"All data slices of the dynptr are automatically invalidated after " +"B<bpf_dynptr_write>(). This is because writing may pull the skb and change " +"the underlying packet buffer." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"For I<flags>, please see the flags accepted by B<bpf_skb_store_bytes>()." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "0 on success, -E2BIG if I<offset> + I<len> exceeds the length of " "I<dst>\\(aqs data, -EINVAL if I<dst> is an invalid dynptr or if I<dst> is a " -"read-only dynptr or if I<flags> is not 0." +"read-only dynptr or if I<flags> is not correct. For skb-type dynptrs, other " +"errors correspond to errors returned by B<bpf_skb_store_bytes>()." msgstr "" #. type: TP @@ -7569,6 +7669,13 @@ msgid "" msgstr "" #. type: Plain text +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "" +"skb and xdp type dynptrs may not use bpf_dynptr_data. They should instead " +"use bpf_dynptr_slice and bpf_dynptr_slice_rdwr." +msgstr "" + +#. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: opensuse-tumbleweed msgid "" @@ -7839,14 +7946,14 @@ msgid "LICENSE" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "eBPF programs can have an associated license, passed along with the bytecode " "instructions to the kernel when the programs are loaded. The format for that " "string is identical to the one in use for kernel modules (Dual licenses, " "such as \"Dual BSD/GPL\", may be used). Some helper functions are only " -"accessible to programs that are compatible with the GNU Privacy License " -"(GPL)." +"accessible to programs that are compatible with the GNU General Public " +"License (GNU GPL)." msgstr "" #. type: Plain text @@ -7860,12 +7967,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "" -"^\".ft C$\n" -"char ____license[] __attribute__((section(\"license\"), used)) = \"GPL\";\n" -"^\".ft P$\n" +msgid "char ____license[] __attribute__((section(\"license\"), used)) = \"GPL\";\n" msgstr "" #. type: SH @@ -8023,6 +8127,17 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +msgid "" +"Each time the helper is called, it appends a line to the trace. Lines are " +"discarded while I</sys/kernel/debug/tracing/trace> is open, use I</sys/" +"kernel/debug/tracing/trace_pipe> to avoid this. The format of the trace is " +"customizable, and the exact output one will get depends on the options set " +"in I</sys/kernel/debug/tracing/trace_options> (see also the I<README> file " +"under the same directory). However, it usually defaults to something like:" +msgstr "" + +#. type: Plain text #: debian-bookworm #, no-wrap msgid "" @@ -8039,11 +8154,6 @@ msgstr "" #. type: Plain text #: debian-bookworm -msgid "B<E<lt>formatted msgE<gt>> is the message formatted with I<fmt>\\&." -msgstr "" - -#. type: Plain text -#: debian-bookworm msgid "" "Also, note that B<bpf_trace_printk>() is slow, and should only be used for " "debugging purposes. For this reason, a notice block (spanning several lines) " @@ -8097,6 +8207,23 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +#, no-wrap +msgid "" +"^\".ft C$\n" +"int ret;\n" +"struct bpf_tunnel_key key = {};\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 +#, no-wrap +msgid "" +"return TC_ACT_OK; // accept packet\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "This interface can also be used with all encapsulation devices that can " @@ -8107,6 +8234,18 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +#, no-wrap +msgid "" +"^\".ft C$\n" +"struct bpf_tunnel_key key;\n" +" populate key ...\n" +"bpf_skb_set_tunnel_key(skb, &key, sizeof(key), 0);\n" +"bpf_clone_redirect(skb, vxlan_dev_ifindex, 0);\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "Since Linux 4.7, usage of this helper has mostly been replaced by " @@ -8118,6 +8257,15 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +#, no-wrap +msgid "" +"^\".ft C$\n" +"# sysctl kernel.perf_event_max_stack=E<lt>new valueE<gt>\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "This helper can be used with encapsulation devices that can operate in " @@ -8131,6 +8279,13 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +msgid "" +"B<struct bpf_sock_addr> for B<BPF_CGROUP_INET4_CONNECT> and " +"B<BPF_CGROUP_INET6_CONNECT>\\&." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "B<SOL_SOCKET>, which supports the following I<optname>s: B<SO_RCVBUF>, " @@ -8166,6 +8321,25 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +#, no-wrap +msgid "" +"^\".ft C$\n" +"normalized_counter = counter * t_enabled / t_running\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 +msgid "" +"For en eBPF program attached to a perf event, retrieve the value of the " +"event counter associated to I<ctx> and store it in the structure pointed by " +"I<buf> and of size I<buf_size>\\&. Enabled and running times are also stored " +"in the structure (see description of helper B<bpf_perf_event_read_value>() " +"for more details)." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "This helper actually implements a subset of B<getsockopt()>\\&. It supports " @@ -8289,6 +8463,18 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +#, no-wrap +msgid "" +" // Consume buf, for example push it to\n" +" // userspace via bpf_perf_event_output(); we\n" +" // can use res (the string length) as event\n" +" // size, after checking its boundaries.\n" +"}\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "B<-EINVAL> if dev and inum supplied don\\[aq]t match dev_t and inode number " @@ -8296,6 +8482,11 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +msgid "B<-ESOCKTNOSUPPORT> if the socket type is not supported (reuseport)." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "B<-EPROTOTYPE> if socket L4 protocol (I<sk-E<gt>protocol>) doesn\\[aq]t " @@ -8310,6 +8501,15 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +msgid "" +"Return a user or a kernel stack in bpf program provided buffer. To achieve " +"this, the helper needs I<task>, which is a valid pointer to B<struct " +"task_struct>\\&. To store the stacktrace, the bpf program provides I<buf> " +"with a nonnegative I<size>\\&." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "If the searching kind is an experimental kind (i.e. 253 or 254 according to " @@ -8460,6 +8660,13 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +msgid "" +"Address of the traced function. 0 for kprobes placed within the function " +"(not at the entry)." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "Do strncmp() between B<s1> and B<s2>\\&. B<s1> doesn\\[aq]t need to be null-" @@ -8550,6 +8757,13 @@ msgid "B<long bpf_dynptr_write(struct bpf_dynptr *>I<dst>B<, u32 >I<offset>B<, v msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 +msgid "" +"Write I<len> bytes from I<src> into I<dst>, starting from I<offset> into " +"I<dst>\\&. I<flags> is currently unused." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "0 on success, -E2BIG if I<offset> + I<len> exceeds the length of " @@ -8587,3 +8801,87 @@ msgid "" "char ____license[] __attribute__((section(\\[dq]license\\[dq]), used)) = \\[dq]GPL\\[dq];\n" "^\".ft P$\n" msgstr "" + +#. type: TH +#: fedora-40 +#, no-wrap +msgid "2023-04-11" +msgstr "" + +#. type: TH +#: fedora-40 +#, no-wrap +msgid "Linux v6.2" +msgstr "" + +#. type: Plain text +#: fedora-40 +msgid "" +"This helper is a \"printk()-like\" facility for debugging. It prints a " +"message defined by format I<fmt> (of size I<fmt_size>) to file I</sys/" +"kernel/debug/tracing/trace> from DebugFS, if available. It can take up to " +"three additional B<u64> arguments (as an eBPF helpers, the total number of " +"arguments is limited to five)." +msgstr "" + +#. type: Plain text +#: fedora-40 +#, no-wrap +msgid "" +"^\".ft C$\n" +"telnet-470 [001] .N.. 419421.045894: 0x00000001: E<lt>fmtE<gt>\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: fedora-40 +msgid "B<E<lt>fmtE<gt>> is the message formatted with I<fmt>\\&." +msgstr "" + +#. type: Plain text +#: fedora-40 +#, no-wrap +msgid "" +"^\".ft C$\n" +"SEC(\"kprobe/sys_open\")\n" +"void bpf_sys_open(struct pt_regs *ctx)\n" +"{\n" +" char buf[PATHLEN]; // PATHLEN is defined to 256\n" +" int res;\n" +msgstr "" + +#. type: Plain text +#: fedora-40 +#, no-wrap +msgid "" +" res = bpf_probe_read_user_str(buf, sizeof(buf),\n" +" ctx-E<gt>di);\n" +msgstr "" + +#. type: Plain text +#: fedora-40 +msgid "" +"0 on success, -E2BIG if I<offset> + I<len> exceeds the length of " +"I<dst>\\(aqs data, -EINVAL if I<dst> is an invalid dynptr or if I<dst> is a " +"read-only dynptr or if I<flags> is not 0." +msgstr "" + +#. type: Plain text +#: fedora-40 +msgid "" +"eBPF programs can have an associated license, passed along with the bytecode " +"instructions to the kernel when the programs are loaded. The format for that " +"string is identical to the one in use for kernel modules (Dual licenses, " +"such as \"Dual BSD/GPL\", may be used). Some helper functions are only " +"accessible to programs that are compatible with the GNU Privacy License " +"(GPL)." +msgstr "" + +#. type: Plain text +#: fedora-40 +#, no-wrap +msgid "" +"^\".ft C$\n" +"char ____license[] __attribute__((section(\"license\"), used)) = \"GPL\";\n" +"^\".ft P$\n" +msgstr "" |