tools: bpf: synchronise BPF UAPI header with tools

Synchronise the bpf.h header under tools, to report the fixes and
additions recently brought to the documentation for the BPF helpers.

Signed-off-by: Quentin Monnet <quentin.monnet@netronome.com>
Acked-by: Jakub Kicinski <jakub.kicinski@netronome.com>
Signed-off-by: Daniel Borkmann <daniel@iogearbox.net>

1 files changed, 75 insertions, 70 deletions

diff --git a/tools/include/uapi/linux/bpf.h b/tools/include/uapi/linux/bpf.h
index 72336bac7573..63e0cf66f01a 100644
--- a/tools/include/uapi/linux/bpf.h
+++ b/tools/include/uapi/linux/bpf.h
@@ -629,7 +629,7 @@ union bpf_attr {
  *              **BPF_F_INVALIDATE_HASH** (set *skb*\ **->hash**, *skb*\
  *              **->swhash** and *skb*\ **->l4hash** to 0).
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -654,7 +654,7 @@ union bpf_attr {
  *              flexibility and can handle sizes larger than 2 or 4 for the
  *              checksum to update.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -686,7 +686,7 @@ union bpf_attr {
  *              flexibility and can handle sizes larger than 2 or 4 for the
  *              checksum to update.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -741,7 +741,7 @@ union bpf_attr {
  *              efficient, but it is handled through an action code where the
  *              redirection happens only after the eBPF program has returned.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -806,7 +806,7 @@ union bpf_attr {
  *              **ETH_P_8021Q** and **ETH_P_8021AD**, it is considered to
  *              be **ETH_P_8021Q**.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -818,7 +818,7 @@ union bpf_attr {
  *      Description
  *              Pop a VLAN header from the packet associated to *skb*.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1168,7 +1168,7 @@ union bpf_attr {
  *              All values for *flags* are reserved for future usage, and must
  *              be left at zero.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1281,7 +1281,7 @@ union bpf_attr {
  *              implicitly linearizes, unclones and drops offloads from the
  *              *skb*.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1317,7 +1317,7 @@ union bpf_attr {
  *              **bpf_skb_pull_data()** to effectively unclone the *skb* from
  *              the very beginning in case it is indeed cloned.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1369,7 +1369,7 @@ union bpf_attr {
  *              All values for *flags* are reserved for future usage, and must
  *              be left at zero.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1384,7 +1384,7 @@ union bpf_attr {
  *              can be used to prepare the packet for pushing or popping
  *              headers.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1518,20 +1518,20 @@ union bpf_attr {
  *              * **BPF_F_ADJ_ROOM_FIXED_GSO**: Do not adjust gso_size.
  *                Adjusting mss in this way is not allowed for datagrams.
  *
- *              * **BPF_F_ADJ_ROOM_ENCAP_L3_IPV4 **:
- *              * **BPF_F_ADJ_ROOM_ENCAP_L3_IPV6 **:
+ *              * **BPF_F_ADJ_ROOM_ENCAP_L3_IPV4**,
+ *                **BPF_F_ADJ_ROOM_ENCAP_L3_IPV6**:
  *                Any new space is reserved to hold a tunnel header.
  *                Configure skb offsets and other fields accordingly.
  *
- *              * **BPF_F_ADJ_ROOM_ENCAP_L4_GRE **:
- *              * **BPF_F_ADJ_ROOM_ENCAP_L4_UDP **:
+ *              * **BPF_F_ADJ_ROOM_ENCAP_L4_GRE**,
+ *                **BPF_F_ADJ_ROOM_ENCAP_L4_UDP**:
  *                Use with ENCAP_L3 flags to further specify the tunnel type.
  *
- *              * **BPF_F_ADJ_ROOM_ENCAP_L2(len) **:
+ *              * **BPF_F_ADJ_ROOM_ENCAP_L2**\ (*len*):
  *                Use with ENCAP_L3/L4 flags to further specify the tunnel
- *                type; **len** is the length of the inner MAC header.
+ *                type; *len* is the length of the inner MAC header.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1610,7 +1610,7 @@ union bpf_attr {
  *              more flexibility as the user is free to store whatever meta
  *              data they need.
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1852,7 +1852,7 @@ union bpf_attr {
  *              copied if necessary (i.e. if data was not linear and if start
  *              and end pointers do not point to the same chunk).
  *
- *              A call to this helper is susceptible to change the underlaying
+ *              A call to this helper is susceptible to change the underlying
  *              packet buffer. Therefore, at load time, all checks on pointers
  *              previously done by the verifier are invalidated and must be
  *              performed again, if the helper is used in combination with
@@ -1886,7 +1886,7 @@ union bpf_attr {