Meta bukan tentang isi dunia, melainkan record tentang dokumen. Kecuali record struktur dokumen (DOC, BODY, END), semuanya ditaruh di HEAD dokumen. Selain Meta, di HEAD juga ada Edge dasar untuk seluruh dokumen SOURCE beserta QUALIFIER-nya.

Layout

TAG WORD          000K KKKC CCCC LLLL      bagian 14 dan 15 (0x1C0L~0x1FFL)
[TAG ekstensi Length]
Payload           nilai mentah, atau record Value atau Reference bawaan
  • Meta tidak memiliki format Issuer. Meta adalah spesifikasi bersama yang diikuti semua Issuer, dan hanya GEUL yang mendefinisikannya.
  • LLLL adalah jumlah WORD total termasuk TAG WORD dikurangi 1. Codec yang tidak ada di tabel adalah Reserved.

Format Payload

FormatKapanContoh
nilai mentahBila formatnya tunggal. Tidak bergantung pada Codec record lainpanjang DOC-*, SPEC-VERSION, ISSUER-KEY
Value bawaanBila memilih di antara beberapa format. TAG Value memberi tahu formatnyaPROFILE, EFFECTIVE-*, waktu, hash isi
Reference bawaanBila menunjuk sasaran seperti orang, organisasi, alat, atau dokumenDOC-ID, AUTHOR, CO-AUTHOR, RECORDED-BY, SIGNED-OFF, penanda tangan pada SIGNATURE
tidak adaPenanda 1 WORDBODY, END
  • Record bawaan bukan record mandiri, melainkan bagian dari Meta itu. Masing-masing menemukan batasnya dengan Length, dan posisi setelah membaca record terakhir harus tepat sama dengan akhir Meta.
  • Meta yang hanya boleh satu dalam satu dokumen dan Meta yang boleh banyak ditentukan oleh “Jumlah” pada dokumen tiap Codec.

Kelas

Nomor Meta berlanjut dari 0x1C0L tanpa Reserved. Bit nomor tidak menunjukkan kelas. Kelas diketahui dari tabel rentang di bawah.

KelasKode langsungYang dicakup
struktur0x1C0L~0x1C4Lbatas dan panjang dokumen
definisi0x1C5L~0x1CALdeklarasi interpretasi
asal-usul0x1CBL~0x1D0Lsiapa, kapan, di mana
silsilah0x1D1L~0x1DDLberasal dari apa dan bagaimana
kebijakan0x1DEL~0x1E3Lbagaimana ditangani
IMPORT0x1E4Lmengimpor dokumen eksternal
verifikasi0x1E5L~0x1E9Lapakah dapat dipercaya
Reserved (khusus verifikasi)0x1EAL~0x1FFL
  • Kelas verifikasi adalah record dengan C >= 5 pada bagian 15, yaitu w >= 0x1E50. Dengan ini kelas verifikasi diketahui tanpa buku Codec dan dikeluarkan dari hash isi.
  • Reserved belakang 0x1EAL~0x1FFL khusus verifikasi. Meta baru di luar verifikasi tidak dapat ditaruh sebelum verifikasi, dan jika ditaruh di Reserved belakang, ia dikeluarkan dari hash isi.
  • Kelas struktur, definisi, dan IMPORT tidak dibaca dengan bit. Dekoder mengetahuinya dari tabel nomor bawaan.
  • Meta yang diperlukan untuk interpretasi: struktur, definisi, IMPORT. Jika dihapus, record tidak dapat dibaca atau interpretasinya berubah. Semua dekoder harus menanganinya. Codec ini termasuk dalam buku Codec inti GEUL.
  • Meta yang tidak mengubah interpretasi: asal-usul, silsilah, verifikasi, kebijakan. Jika dihapus, isi pernyataan tetap sama. Hanya bahan untuk menilai kepercayaan dan penanganan yang hilang.
  • Dasar ditulis bukan dengan Meta, melainkan dengan Edge dasar SOURCE dan QUALIFIER. Dasar untuk record individual ditaruh di BODY, sedangkan sumber asal seluruh dokumen ditaruh di HEAD sebagai SOURCE dengan Target 0 (dokumen).

Struktur

Kelas struktur Meta (Codec 0x1C0L~0x1C4L) menentukan batas dan panjang dokumen. Satuan data GEUL adalah satu dokumen.

DOC-*                  ← awal HEAD
  Meta definisi, asal-usul, silsilah, verifikasi, kebijakan, IMPORT
  SOURCE untuk seluruh dokumen dan QUALIFIER-nya
BODY                   ← awal BODY
  Reference, Value, Edge
END                    ← menutup dokumen
  • Setiap dokumen dibuka dengan DOC-1WORD/2WORD/4WORD yang menetapkan panjang total. Dengan panjang ini dekoder dapat melompati seluruh dokumen sekaligus.
  • BODY dan END adalah record 1 WORD tanpa Payload. END wajib.
  • Dokumen tidak bersarang. Dokumen lain ditunjuk dengan IMPORT.
  • Jika HEAD (Meta, serta SOURCE untuk seluruh dokumen dan QUALIFIER-nya) kosong, BODY dihilangkan. BODY hanya boleh ditaruh sekali per dokumen.

Struktur dokumen selengkapnya ada di dokumen.

CodecNamaArti
0x1C0L~0x1C2LDOC-1WORD / 2WORD / 4WORDMembuka dokumen dengan menetapkan panjang total
0x1C3LBODYMengakhiri HEAD dan membuka BODY
0x1C4LENDMenutup dokumen

Aturan terperinci ada di dokumen.

Definisi

Kelas definisi Meta (Codec 0x1C5L~0x1CAL) adalah deklarasi interpretasi. Deklarasi mengubah aturan interpretasi sehingga semua dekoder harus menanganinya. Cakupan deklarasi adalah dokumen itu.

  • SPEC-VERSION menentukan cara membaca record lainnya, sehingga hanya berupa bilangan bulat tanpa Value bawaan. GEUL v1 adalah 0x0001 (record 1C51 0001).
  • DOC-ID adalah DOC-POINTER (Issuer, ID dokumen, versi 0) yang menunjuk dokumen itu sendiri. Dokumen Codec memakai CODEC-POINTER (Issuer, Codec ID, versi 0). Jika tidak ada, dokumen itu tidak bernama dan hanya dapat ditunjuk dengan hash isi.
  • Tidak ada alamat nama dokumen. Judul yang dapat dibaca manusia dilekatkan dengan LABEL pernyataan (alamat publikasi dan daftar versi).
CodecNamaArti
0x1C5LSPEC-VERSIONEdisi spesifikasi yang diikuti. Satu bilangan bulat
0x1C6LPROFILEProfil yang diterapkan
0x1C7LDOC-IDPengenal dokumen ini. DOC-POINTER yang menunjuk dirinya sendiri (versi 0). Dokumen Codec: CODEC-POINTER (versi 0)
0x1C8LEFFECTIVE-FROMTanggal mulai berlaku versi ini. Jika tidak ada, waktu publikasi
0x1C9LEFFECTIVE-UNTILAkhir masa berlaku versi ini (undang-undang berjangka waktu). Jika tidak ada, sampai versi berikutnya mulai berlaku
0x1CALDEFAULT-LANGUAGEBahasa default

Asal-usul

Kelas asal-usul Meta (Codec 0x1CBL~0x1D0L) mencatat siapa yang membuat dan merekam dokumen, dan kapan.

  • Penulis, perekam, dan waktunya mengikuti model author dan committer pada git (AUTHOR dan CREATED-AT, RECORDED-BY dan RECORDED-AT).
  • Jika asal-usul dihapus, isi pernyataan tidak berubah. Hanya bahan penilaian kepercayaan yang hilang.
  • Bahan sumber tidak ada di kelas ini. Sumber asal seluruh dokumen ditulis di HEAD, dan sumber asal record individual ditulis di BODY, dengan Edge dasar SOURCE. Rentang yang sesuai dalam teks asli, waktu perolehan, dan hash teks asli adalah QUALIFIER yang dilekatkan pada SOURCE itu (halaman P304 dan bagian P958, tanggal akses P813, checksum P4092).
  • Jika sifat yang melekat pada sumber (rentang teks asli, waktu perolehan) dijadikan Meta, tidak dapat ditentukan milik sumber yang mana ketika sumbernya banyak. Karena itu ditulis sebagai QUALIFIER yang menjadikan SOURCE sebagai Target.
CodecNamaArti
0x1CBLAUTHORPenulis (Reference)
0x1CCLCO-AUTHORPenulis bersama
0x1CDLCREATED-ATWaktu penulisan
0x1CELMODIFIED-ATWaktu perubahan
0x1CFLRECORDED-BYPihak perekam
0x1D0LRECORDED-ATWaktu perekaman
  • Bahan sumber ditulis bukan dengan Meta, melainkan dengan Edge dasar SOURCE di HEAD (Target 0), dan rentang teks asli, waktu perolehan, serta hash teks asli ditulis sebagai QUALIFIER yang dilekatkan pada SOURCE itu.

Silsilah

Kelas silsilah Meta (Codec 0x1D1L~0x1DDL) mencatat dari apa dan bagaimana dokumen berasal. Silsilah mengikuti model commit git, dan satuan yang setara dengan commit adalah dokumen.

  • Hash isi menunjuk isi satu salinan dokumen (git commit id). Berupa SHA-256 dari record pembuka (DOC-*) sampai tepat sebelum END, dan record kelas verifikasi (C >= 5 pada bagian 15, w >= 0x1E50) dikeluarkan dari perhitungan.
  • ID versi adalah bilangan bulat 2 WORD yang bernomor mulai dari 1 menurut urutan publikasi dalam dokumen bernama. 0 berarti versi tidak dicantumkan.
  • Meta silsilah menunjuk versi dengan hash isi. PARENT di dalam dokumen juga termasuk dalam hash, sehingga hash isi menjadi rantai hash yang menyambung seluruh riwayat.
  • Riwayat tidak dihapus. Isi yang diperbaiki diterbitkan sebagai versi baru. Pointer yang berubah seperti branch tidak ditaruh di dokumen.
  • DELTA-BASE dan DELTA-REMOVE adalah format yang menyimpan versi sebagai diff terhadap versi dasar. Versi selalu didefinisikan sebagai snapshot.

Aturan revisi ada di dokumen.

Silsilah mengikuti model commit git. Satuan yang setara dengan commit adalah dokumen.

CodecNamaArti
0x1D1LPARENTHash isi versi sebelumnya. Jika lebih dari satu, penggabungan
0x1D2LDERIVED-FROMDiturunkan dari bahan silsilah lain
0x1D3LGENERATED-BYPihak pembuat (manusia, model, mesin aturan)
0x1D4LTRANSFORMED-BYAlat konversi dan versi sumbernya (digest commit)
0x1D5LCHERRY-PICKED-FROMVersi asal perubahan yang diambil
0x1D6LREVERTSVersi target yang dibatalkan
0x1D7LREPLACESVersi target yang ditulis ulang. Versi asli tidak dihapus
0x1D8LSQUASHED-FROMVersi-versi asal yang digabung menjadi satu
0x1D9LMESSAGEAlasan perubahan. Satu per bahasa
0x1DALTAGNama imutabel yang diberikan pada versi
0x1DBLDELTA-BASEFile ini adalah diff terhadap versi dasar
0x1DCLDELTA-REMOVEDaftar LOCAL ID yang dibuang dari diff
0x1DDLNEXT-LOCAL-IDLOCAL ID yang akan dialokasikan berikutnya. Ditaruh pada dokumen daftar versi
  • Riwayat tidak dihapus. Isi yang diperbaiki diterbitkan sebagai versi baru.
  • Pointer yang berubah seperti branch tidak ditaruh di dokumen. Penyimpanan dan indeks yang mengelolanya.

Verifikasi

Kelas verifikasi Meta (Codec 0x1E5L~0x1E9L) mencatat bahan untuk menilai apakah dokumen dapat dipercaya. Yaitu kunci publik Issuer yang diterbitkan sendiri, tanda tangan, konfirmasi hak kontribusi, tingkat keyakinan, dan hasil penilaian seluruh dokumen.

  • Kelas verifikasi dikeluarkan dari perhitungan hash isi. Karena itu meskipun tanda tangan ditaruh di dalam dokumen, atau tanda tangan ditambah banyak, hash isi tidak berubah (sama seperti gpgsig git).
  • Kelas verifikasi adalah record dengan C >= 5 pada bagian 15, yaitu w >= 0x1E50, sehingga hash dapat dihitung tanpa buku Codec. Reserved belakang 0x1EAL~0x1FFL juga khusus verifikasi sehingga dikeluarkan dari hash.
  • Penilaian per node atau record menjadi tugas Edge TOULMIN VERDICT (0x118L).
CodecNamaArti
0x1E5LISSUER-KEYAlgoritma tanda tangan dan kunci publik Issuer yang diterbitkan sendiri
0x1E6LSIGNATURETanda tangan atas hash isi. Algoritma, penanda tangan, tanda tangan
0x1E7LSIGNED-OFFKonfirmasi hak kontribusi
0x1E8LCONFIDENCETingkat keyakinan
0x1E9LVERDICTHasil penilaian seluruh dokumen (Pass, Review, Fail)
  • Kelas verifikasi dikeluarkan dari perhitungan hash isi. Karena itu meskipun tanda tangan ditaruh di dalam dokumen, atau tanda tangan ditambah banyak, hash isi tidak berubah.

Kebijakan

Kelas kebijakan Meta (Codec 0x1DEL~0x1E3L) menentukan bagaimana dokumen ditangani. Yaitu lisensi, cakupan keterbukaan, tingkat data pribadi, batas waktu penyimpanan, persetujuan, dan pembatasan penggunaan.

  • Kebijakan tidak mengubah interpretasi, melainkan menentukan cara penanganan.
  • Lisensi asli dari karya di dalam rangkaian byte dicatat dengan LICENSE.
CodecNamaArti
0x1DELLICENSELisensi
0x1DFLACCESSCakupan keterbukaan
0x1E0LPRIVACYTingkat data pribadi
0x1E1LRETENTIONBatas waktu penyimpanan
0x1E2LCONSENTCakupan dan dasar persetujuan
0x1E3LUSAGEPembatasan penggunaan
  • Kebijakan tidak mengubah interpretasi, melainkan menentukan cara penanganan.

IMPORT

Kelas IMPORT Meta (Codec 0x1E4L) mengimpor dokumen eksternal dengan IMPORT ID. Codec-nya hanya satu, IMPORT-DOC (0x1E4L).

  • IMPORT hanya mengimpor dokumen. Sasaran di dalam dokumen yang diimpor ditunjuk dengan Reference EXTERNAL-POINTER-* (IMPORT ID, ID LOCAL) di BODY (Reference).
  • Jika ID versi dicantumkan, terikat pada edisi itu; jika 0, terikat pada edisi terbaru saat interpretasi. Dokumen yang dipublikasikan mencantumkan versi.
  • HEAD dari dokumen yang diimpor tidak ikut diimpor. Record Reference dan Value tidak diimpor, melainkan disalin.
TAG WORD          0001 1110 0100 LLLL      IMPORT-DOC (0x1E4L)
[TAG ekstensi Length]
dokumen           record DOC-POINTER (Issuer, ID dokumen, ID versi). Dokumen Codec: CODEC-POINTER
IMPORT ID         sisanya. Bilangan bulat dengan lebar tersempit
  • Hanya IMPORT-DOC (0x1E4L) yang dipakai. IMPORT hanya mengimpor dokumen. Sasaran di dalam dokumen yang diimpor ditunjuk dengan EXTERNAL-POINTER-* (IMPORT ID, ID LOCAL) di BODY.
  • Jika ID versi dicantumkan, terikat pada edisi itu; jika 0, terikat pada edisi terbaru saat interpretasi. Dokumen yang dipublikasikan mencantumkan versi.
  • IMPORT ID yang sama tidak dialokasikan dua kali dalam satu dokumen.
  • HEAD dari dokumen yang diimpor tidak ikut diimpor. Sasaran dokumen itu ditafsirkan sesuai deklarasi dokumen itu.

Contoh: mengimpor versi terbaru dokumen 0x0000000000000002 milik Issuer 0x00000002 dengan IMPORT ID 1.

1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001