Skip to contentSkip to conversation

bpf, docs: Add introduction for use in the ISA Internet Draft

PATCH Applied Dave Thaler 3 participants 5 messages Apr 22, 2024 – Apr 26, 2024

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 bpf, docs: Add introduction for use in the ISA Internet Draft

The proposed intro paragraph text is derived from the first paragraph of the IETF BPF WG charter at https://datatracker.ietf.org/wg/bpf/about/

---
 Documentation/bpf/standardization/instruction-set.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
Documentation/bpf/standardization/instruction-set.rst +5 -1
index d03d90afb..b44bdacd0 100644
@@ -5,7 +5,11 @@
 BPF Instruction Set Architecture (ISA)
 ======================================
 
-This document specifies the BPF instruction set architecture (ISA).
+eBPF (which is no longer an acronym for anything), also commonly
+referred to as BPF, is a technology with origins in the Linux kernel
+that can run untrusted programs in a privileged context such as an
+operating system kernel. This document specifies the BPF instruction
+set architecture (ISA).
 
 Documentation conventions
 =========================
Signature · 1 line
2.40.1
reviewer Acked-by on v1 1/1
#1 lore raw
Quoted 13 lines · Dave Thaler

The proposed intro paragraph text is derived from the first paragraph of the IETF BPF WG charter at https://datatracker.ietf.org/wg/bpf/about/

---
 Documentation/bpf/standardization/instruction-set.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
Documentation/bpf/standardization/instruction-set.rst +0 -0
index d03d90afb..b44bdacd0 100644

Documentation/bpf/standardization/instruction-set.rst line 10

Quoted 7 lines
Documentation/bpf/standardization/instruction-set.rst +3 -1
@@ -5,7 +5,11 @@
 BPF Instruction Set Architecture (ISA)
 ======================================
 
-This document specifies the BPF instruction set architecture (ISA).
+eBPF (which is no longer an acronym for anything), also commonly
+referred to as BPF, is a technology with origins in the Linux kernel
+that can run untrusted programs in a privileged context such as an

Perhaps this should be phrased as:

...that can run untrusted programs in privileged contexts such as the operating system kernel.

Not sure if that's actually a grammar correction but it sounds more correct in my head. Wdyt?

Regardless:

Quoted 12 lines
Documentation/bpf/standardization/instruction-set.rst +2 -0
+operating system kernel. This document specifies the BPF instruction
+set architecture (ISA).
 
 Documentation conventions
 =========================
Signature · 6 lines
2.40.1

-- 
Bpf mailing list
[email protected]
https://www.ietf.org/mailman/listinfo/bpf
#2 lore raw
Quoted 19 lines · David Vernet
Quoted 18 lines · Dave Thaler

The proposed intro paragraph text is derived from the first paragraph of the IETF BPF WG charter at
https://datatracker.ietf.org/wg/bpf/about/

---
 Documentation/bpf/standardization/instruction-set.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
Documentation/bpf/standardization/instruction-set.rst +0 -0
index d03d90afb..b44bdacd0 100644
@@ -5,7 +5,11 @@
 BPF Instruction Set Architecture (ISA)

======================================

Quoted 8 lines

Documentation/bpf/standardization/instruction-set.rst line 10

Quoted 4 lines
Documentation/bpf/standardization/instruction-set.rst +3 -1
-This document specifies the BPF instruction set architecture (ISA).
+eBPF (which is no longer an acronym for anything), also commonly
+referred to as BPF, is a technology with origins in the Linux kernel
+that can run untrusted programs in a privileged context such as an

Perhaps this should be phrased as:

...that can run untrusted programs in privileged contexts such as the

operating

Quoted 3 lines

system kernel.

Not sure if that's actually a grammar correction but it sounds more

correct in my

Quoted 1 line

head. Wdyt?

That sounds less grammatically correct to my reading, since "contexts" would
be plural but "kernel" is singular. The intent of the original sentence
was that
multiple programs (plural) can run in the same privileged context (singular) such
as a kernel (singular).

Dave

reviewer
#3 lore raw
Quoted 30 lines · On Mon, Apr 22, 2024 at 01:18:05PM -0700, [email protected] wrote:
Quoted 29 lines · David Vernet
Quoted 18 lines · Dave Thaler

The proposed intro paragraph text is derived from the first paragraph of the IETF BPF WG charter at
https://datatracker.ietf.org/wg/bpf/about/

---
 Documentation/bpf/standardization/instruction-set.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
Documentation/bpf/standardization/instruction-set.rst +0 -0
index d03d90afb..b44bdacd0 100644
@@ -5,7 +5,11 @@
 BPF Instruction Set Architecture (ISA)

======================================

Documentation/bpf/standardization/instruction-set.rst line 10

Quoted 4 lines
Documentation/bpf/standardization/instruction-set.rst +3 -1
-This document specifies the BPF instruction set architecture (ISA).
+eBPF (which is no longer an acronym for anything), also commonly
+referred to as BPF, is a technology with origins in the Linux kernel
+that can run untrusted programs in a privileged context such as an

Perhaps this should be phrased as:

...that can run untrusted programs in privileged contexts such as the operating system kernel.

Quoted 7 lines
Quoted 2 lines

Not sure if that's actually a grammar correction but it sounds more correct in my head. Wdyt?

That sounds less grammatically correct to my reading, since "contexts"
would be plural but "kernel" is singular. The intent of the original
sentence was that multiple programs (plural) can run in the same privileged context (singular) such as a kernel (singular).

Fair enough. My ack above stands.

Thanks,
David

#4 lore raw
In reply to Dave Thaler
This patch was applied to bpf/bpf-next.git (master) by Alexei Starovoitov <[email protected]>:

Hello:

This patch was applied to bpf/bpf-next.git (master) by Alexei Starovoitov <[email protected]>:

Quoted 7 lines · On Mon, 22 Apr 2024 12:09:42 -0700 you wrote:

The proposed intro paragraph text is derived from the first paragraph of the IETF BPF WG charter at https://datatracker.ietf.org/wg/bpf/about/

---
 Documentation/bpf/standardization/instruction-set.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

Here is the summary with links:
- [bpf-next] bpf, docs: Add introduction for use in the ISA Internet Draft

    https://git.kernel.org/bpf/bpf-next/c/e51b907d4032

You are awesome, thank you!

Signature · 2 lines
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html