Skip to contentSkip to conversation

ISA document title question

DISCUSSION [email protected] 3 participants 3 messages Feb 7, 2024 BPF

lore
Share & tools
lore
#0 lore raw

The Internet Draft filename is draft-ietf-bpf-isa-XX, and the charter has:

Quoted 2 lines

[PS] the BPF instruction set architecture (ISA) that defines the instructions and low-level virtual machine for BPF programs,

That is, "instruction set architecture (ISA)", but the document itself has:

Quoted 5 lines

=======================================
BPF Instruction Set Specification, v1.0
=======================================

This document specifies version 1.0 of the BPF instruction set.

Notably, no "architecture (ISA)". Also, we now have a mechanism
to extend it with conformance groups over time, so "v1.0" seems less relevant and perhaps not important given there's only one version being standardized at present.

What do folks think about changing the doc to say:

Quoted 5 lines

=======================================
BPF Instruction Set Architecture
=======================================

This document specifies the BPF instruction set architecture (ISA).

?

Dave

#1 lore raw
Quoted 9 lines · On Wed, Feb 07, 2024 at 01:39:47PM -0800…

The Internet Draft filename is draft-ietf-bpf-isa-XX, and the charter has:

Quoted 2 lines

[PS] the BPF instruction set architecture (ISA) that defines the instructions and low-level virtual machine for BPF programs,

That is, "instruction set architecture (ISA)", but the document itself has:

Quoted 4 lines

=======================================
BPF Instruction Set Specification, v1.0
=======================================

Quoted 6 lines
Quoted 1 line

This document specifies version 1.0 of the BPF instruction set.

Notably, no "architecture (ISA)". Also, we now have a mechanism
to extend it with conformance groups over time, so "v1.0" seems less relevant and perhaps not important given there's only one version being standardized at present.

Not only this, but we may extend individual conformance groups to new versions, while leaving others the same. So versioning this document seems like the wrong granularity. If we want to version anything as 1.0, we should probably version the conformance groups.

Quoted 8 lines

What do folks think about changing the doc to say:

Quoted 5 lines

=======================================
BPF Instruction Set Architecture
=======================================

This document specifies the BPF instruction set architecture (ISA).

?

+1

Thanks,
David

#2 lore raw
In reply to [email protected]
Quoted 17 lines · On Wed, Feb 7, 2024 at 1:39 PM <[email protected]>…

The Internet Draft filename is draft-ietf-bpf-isa-XX, and the charter has:

Quoted 2 lines

[PS] the BPF instruction set architecture (ISA) that defines the instructions and low-level virtual machine for BPF programs,

That is, "instruction set architecture (ISA)", but the document itself has:

Quoted 5 lines

=======================================
BPF Instruction Set Specification, v1.0
=======================================

This document specifies version 1.0 of the BPF instruction set.

Notably, no "architecture (ISA)". Also, we now have a mechanism
to extend it with conformance groups over time, so "v1.0" seems less relevant and perhaps not important given there's only one version being standardized at present.

Quoted 7 lines

What do folks think about changing the doc to say:

Quoted 5 lines

=======================================
BPF Instruction Set Architecture
=======================================

This document specifies the BPF instruction set architecture (ISA).

?

Good idea. Makes sense to me.