src/journal/journal-def.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #pragma once
   4
   5 /***
   6   This file is part of systemd.
   7
   8   Copyright 2011 Lennart Poettering
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 ***/
  23
  24 #include "sparse-endian.h"
  25
  26 #include <systemd/sd-id128.h>
  27
  28 #include "macro.h"
  29
  30 typedef struct Header Header;
  31
  32 typedef struct ObjectHeader ObjectHeader;
  33 typedef union Object Object;
  34
  35 typedef struct DataObject DataObject;
  36 typedef struct FieldObject FieldObject;
  37 typedef struct EntryObject EntryObject;
  38 typedef struct HashTableObject HashTableObject;
  39 typedef struct EntryArrayObject EntryArrayObject;
  40 typedef struct TagObject TagObject;
  41
  42 typedef struct EntryItem EntryItem;
  43 typedef struct HashItem HashItem;
  44
  45 typedef struct FSSHeader FSSHeader;
  46
  47 /* Object types */
  48 enum {
  49         OBJECT_UNUSED,
  50         OBJECT_DATA,               /* !!! */
  51         OBJECT_FIELD,
  52         OBJECT_ENTRY,
  53         OBJECT_DATA_HASH_TABLE,
  54         OBJECT_FIELD_HASH_TABLE,
  55         OBJECT_ENTRY_ARRAY,        /* !!! */
  56         OBJECT_TAG,
  57         _OBJECT_TYPE_MAX
  58 };
  59
  60 /* Object flags */
  61 enum {
  62         OBJECT_COMPRESSED = 1
  63 };
  64
  65 _packed_ struct ObjectHeader {
  66         uint8_t type;
  67         uint8_t flags;
  68         uint8_t reserved[6];
  69         le64_t size;
  70         uint8_t payload[];
  71 };
  72
  73 _packed_ struct DataObject {
  74         ObjectHeader object;
  75         le64_t hash;
  76         le64_t next_hash_offset;
  77         le64_t next_field_offset;
  78         le64_t entry_offset; /* the first array entry we store inline */
  79         le64_t entry_array_offset;
  80         le64_t n_entries;
  81         uint8_t payload[];
  82 };
  83
  84 _packed_ struct FieldObject {
  85         ObjectHeader object;
  86         le64_t hash;
  87         le64_t next_hash_offset;
  88         le64_t head_data_offset;
  89         uint8_t payload[];
  90 };
  91
  92 _packed_ struct EntryItem {
  93         le64_t object_offset;
  94         le64_t hash;
  95 };
  96
  97 _packed_ struct EntryObject {
  98         ObjectHeader object;
  99         le64_t seqnum;
 100         le64_t realtime;
 101         le64_t monotonic;
 102         sd_id128_t boot_id;
 103         le64_t xor_hash;
 104         EntryItem items[];
 105 };
 106
 107 _packed_ struct HashItem {
 108         le64_t head_hash_offset;
 109         le64_t tail_hash_offset;
 110 };
 111
 112 _packed_ struct HashTableObject {
 113         ObjectHeader object;
 114         HashItem items[];
 115 };
 116
 117 _packed_ struct EntryArrayObject {
 118         ObjectHeader object;
 119         le64_t next_entry_array_offset;
 120         le64_t items[];
 121 };
 122
 123 #define TAG_LENGTH (256/8)
 124
 125 _packed_ struct TagObject {
 126         ObjectHeader object;
 127         uint64_t seqnum;
 128         uint64_t epoch;
 129         uint8_t tag[TAG_LENGTH]; /* SHA-256 HMAC */
 130 };
 131
 132 union Object {
 133         ObjectHeader object;
 134         DataObject data;
 135         FieldObject field;
 136         EntryObject entry;
 137         HashTableObject hash_table;
 138         EntryArrayObject entry_array;
 139         TagObject tag;
 140 };
 141
 142 enum {
 143         STATE_OFFLINE = 0,
 144         STATE_ONLINE = 1,
 145         STATE_ARCHIVED = 2,
 146         _STATE_MAX
 147 };
 148
 149 /* Header flags */
 150 enum {
 151         HEADER_INCOMPATIBLE_COMPRESSED = 1
 152 };
 153
 154 enum {
 155         HEADER_COMPATIBLE_SEALED = 1
 156 };
 157
 158 #define HEADER_SIGNATURE ((char[]) { 'L', 'P', 'K', 'S', 'H', 'H', 'R', 'H' })
 159
 160 _packed_ struct Header {
 161         uint8_t signature[8]; /* "LPKSHHRH" */
 162         le32_t compatible_flags;
 163         le32_t incompatible_flags;
 164         uint8_t state;
 165         uint8_t reserved[7];
 166         sd_id128_t file_id;
 167         sd_id128_t machine_id;
 168         sd_id128_t boot_id;    /* last writer */
 169         sd_id128_t seqnum_id;
 170         le64_t header_size;
 171         le64_t arena_size;
 172         le64_t data_hash_table_offset;     /* for looking up data objects */
 173         le64_t data_hash_table_size;
 174         le64_t field_hash_table_offset;     /* for looking up field objects */
 175         le64_t field_hash_table_size;
 176         le64_t tail_object_offset;
 177         le64_t n_objects;
 178         le64_t n_entries;
 179         le64_t tail_entry_seqnum;
 180         le64_t head_entry_seqnum;
 181         le64_t entry_array_offset;
 182         le64_t head_entry_realtime;
 183         le64_t tail_entry_realtime;
 184         le64_t tail_entry_monotonic;
 185         /* Added in 187 */
 186         le64_t n_data;
 187         le64_t n_fields;
 188         /* Added in 189 */
 189         le64_t n_tags;
 190         le64_t n_entry_arrays;
 191
 192         /* Size: 224 */
 193 };
 194
 195 #define FSS_HEADER_SIGNATURE ((char[]) { 'K', 'S', 'H', 'H', 'R', 'H', 'L', 'P' })
 196
 197 _packed_ struct FSSHeader {
 198         uint8_t signature[8]; /* "KSHHRHLP" */
 199         le32_t compatible_flags;
 200         le32_t incompatible_flags;
 201         sd_id128_t machine_id;
 202         sd_id128_t boot_id;    /* last writer */
 203         le64_t header_size;
 204         le64_t start_usec;
 205         le64_t interval_usec;
 206         le16_t fsprg_secpar;
 207         le16_t reserved[3];
 208         le64_t fsprg_state_size;
 209 };