URI ist ein Value, der eine ASCII-Bytefolge nach der Grammatik des RFC-3986-URI (absoluter URI mit scheme) enthält. Er verwendet das Codepaar 0x074L/0x075L für gerade und ungerade Bytes.

EintragWert
NameURI (gerade/ungerade Paarung. Die Namen je Code stehen in der Mitgliedertabelle unten)
TAG ID0x074L·0x075L
Abschnitt3 0011 (Value), Offset im Abschnitt C = 20~21
KindValue · Familie: TEXT
IndexbeschreibungASCII-Bytefolge der RFC-3986-Produktion URI. Gerade/ungerade Bytes
Hugo-Pfadvalue/text/uri.md

Mitglieder

Diese Seite behandelt die zwei Codes einer gerade/ungerade-Paarung gemeinsam. Der gerade Code gilt für Werte mit gerader Byteanzahl, der ungerade Code für Werte mit ungerader Byteanzahl (Record und TAG WORD). Es gibt ein Codec-Dokument je Code. Die Felder beider Codec-Dokumente sind gleich; nur das DECLARE-Ziel und der Name (BIND) unterscheiden sich.

TAG IDNameByteanzahlCodec IDSpezifikationsdokumentTAG WORD
0x074LURI-EVENgerade0x000007400x00000000/codecs/0x00000740/0000 0111 0100 LLLL
0x075LURI-ODDungerade0x000007500x00000000/codecs/0x00000750/0000 0111 0101 LLLL

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELDs im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1bytes#2restliche Rohwert-Bytes (0xFFFF)

URI ist ein Value, der eine ASCII-Bytefolge nach der Grammatik URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] aus RFC 3986 enthält. Da er das scheme enthält, braucht die Interpretation keinen base URI.

Layout

  • Code: direkter Value-Code 0x074L (gerade Bytes) und 0x075L (ungerade Bytes). Familie TEXT.
  • Die Byteanzahl ergibt sich aus dem niedrigstwertigen Bit des Codecs und der Anzahl der Payload-WORDs. Sie ist 2 × Anzahl der Payload-WORDs − niedrigstwertiges Bit; einen Byte Count gibt es nicht (Value).
TAG WORD          0000 0111 010P LLLL      Codec 0x074L/0x075L
[Length-Erweiterungs-TAG] bei insgesamt 15 WORDs oder mehr
Payload WORD 1st ... Nth          URI bytes / final zero padding

Interpretation und Gültigkeit

  • Die Bytefolge muss der Grammatik URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] aus RFC 3986 entsprechen. Sie darf query und fragment enthalten.
  • Die Terminale der URI-Grammatik sind US-ASCII-Zeichen. Erlaubte ASCII-Zeichen werden unverändert gespeichert; beim Percent-Encoding eines Oktetts wird das Format pct-encoded = "%" HEXDIG HEXDIG verwendet. Nicht-ASCII-Zeichen dürfen nicht als literale Bytes direkt eingefügt werden.
  • scheme und : sind zwingend enthalten. Für relative Referenzen wird URI-RELATIVE-REF verwendet (IETF-Codec-Nummern 0x00008000·0x00008001).
  • Die URI-Produktion von RFC 3986 erlaubt keine leere Zeichenkette. Ein Record mit 0 Bytes ist ungültig.
  • Innerhalb eines WORDs steht das obere Byte zuerst. Bei ungerader Byteanzahl (ungerader Code) muss das ungenutzte untere Byte des letzten WORDs 00 sein.
  • Die Anzahl der Payload-WORDs ist ceil(Byteanzahl/2). Ist der Code ungerade und das untere Byte des letzten WORDs nicht 00, wird der Wert abgelehnt.

Normative Grundlage

Länge

  • Die Gesamtlänge ist die Summe der WORDs aus TAG (1 WORD), Length-Erweiterungs-TAG (falls vorhanden) und Payload. Bis 14 WORDs wird die direkte Länge verwendet, ab 15 WORDs die erweiterte Länge 1110·1111; auch der Erweiterungs-TAG zählt zur Gesamtanzahl (Length).

Beispiel

  • https://example.com/ hat 20 ASCII-Bytes (gerade) und ist daher URI-EVEN (0x074L).
  • Die Payload besteht aus 10 WORDs: 6874 7470 733A 2F2F 6578 616D 706C 652E 636F 6D2F.
  • TAG (1 WORD) und Payload (10 WORDs) ergeben insgesamt 11 WORDs, also LLLL=1010. Das Ganze ist 074A 6874 7470 733A 2F2F 6578 616D 706C 652E 636F 6D2F.

GEUL Archive URI

archive.geul.org ist als unveränderlicher Inhaltsspeicher gedacht, mit dem GEUL große Inhalte wie externe Binärdaten und Dokumente referenziert; er wird noch nicht betrieben. Das empfohlene Adressformat ist https://archive.geul.org/sha256/{digest}. Dieselbe Bytefolge muss denselben URI haben, und nach der Veröffentlichung dürfen die Bytes unter demselben URI nicht mehr geändert werden.

Ein URI-Value gibt nur den Ort oder die Adresszeichenkette eines externen Inhalts an; er garantiert weder die Identität noch die Unveränderlichkeit des Ziels selbst. Binärdaten und Texte, die den Höchstumfang eines Inline-Values überschreiten, können über einen Archive-URI referenziert werden. In den Metadaten des gespeicherten Objekts sind folgende Angaben festzuhalten.

  • Original-URI und Zeitpunkt der Erfassung
  • SHA-256 und Byte Length
  • MIME type
  • license identifier und version
  • Urheber, Quelle und Hinweise
  • URI der Lizenzgrundlage und, falls nötig, eine Kopie der Grundlage zum Zeitpunkt der Erfassung

Ob etwas erfasst werden darf, richtet sich nicht danach, ob es kostenlos zugänglich ist, sondern danach, ob das Recht zur Weiterverbreitung ausdrücklich bestätigt ist. Die geltenden Lizenzbedingungen wie Namensnennung, nicht kommerziell, keine Bearbeitung und Weitergabe unter gleichen Bedingungen sind einzuhalten. Für Dokumente und Inhalte wird eine ausdrückliche Lizenz wie Creative Commons angegeben, für Software möglichst eine SPDX License ID.

Auch wenn die Bereitstellung wegen Rechtsfragen oder Korrekturen eingestellt wird, dürfen unter dem bisherigen URI keine anderen Bytes abgelegt werden. Dieser URI muss einen Tombstone mit Grund und Zeitpunkt der Einstellung zurückgeben, und der ursprüngliche digest und die Prüfprotokolle müssen bewahrt werden. Verbietet jedoch eine gesetzliche Pflicht die Aufbewahrung der Prüfprotokolle, hat diese Pflicht Vorrang.

Ein Archive-URI liefert zugleich den Zugriffsort und den Inhalts-digest. Diese Regeln zu Content-Address und Unveränderlichkeit sind Richtlinie des GEUL-Archive-Profils; die allgemeine Grammatik des URI-Values hängt nicht von archive.geul.org ab.

Originaltext des Spezifikationsdokuments

So sieht das Spezifikationsdokument 0x00000000/codecs/0x00000740/latest.geul aus, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000074000000000
BODY
#1 DECLARE 0x0740
#2 FIELD #1 rest
#3 BIND #1 "URI-EVEN"
#4 BIND #2 "bytes"

Oben steht das Codec-Dokument von URI-EVEN (0x074L). Das Codec-Dokument des anderen Mitglieds (URI-ODD) unterscheidet sich nur in der Codec ID der DOC-ID, im DECLARE-Ziel und im unter #1 gebundenen Namen (BIND).