src/journal/journal-file.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #ifndef foojournalfilehfoo
   4 #define foojournalfilehfoo
   5
   6 /***
   7   This file is part of systemd.
   8
   9   Copyright 2011 Lennart Poettering
  10
  11   systemd is free software; you can redistribute it and/or modify it
  12   under the terms of the GNU General Public License as published by
  13   the Free Software Foundation; either version 2 of the License, or
  14   (at your option) any later version.
  15
  16   systemd is distributed in the hope that it will be useful, but
  17   WITHOUT ANY WARRANTY; without even the implied warranty of
  18   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  19   General Public License for more details.
  20
  21   You should have received a copy of the GNU General Public License
  22   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  23 ***/
  24
  25 #include <inttypes.h>
  26
  27 #include "journal-def.h"
  28 #include "util.h"
  29 #include "sd-id128.h"
  30
  31 typedef struct Window {
  32         void *ptr;
  33         uint64_t offset;
  34         uint64_t size;
  35 } Window;
  36
  37 enum {
  38         WINDOW_UNKNOWN = OBJECT_UNUSED,
  39         WINDOW_DATA = OBJECT_DATA,
  40         WINDOW_ENTRY = OBJECT_ENTRY,
  41         WINDOW_DATA_HASH_TABLE = OBJECT_DATA_HASH_TABLE,
  42         WINDOW_FIELD_HASH_TABLE = OBJECT_FIELD_HASH_TABLE,
  43         WINDOW_ENTRY_ARRAY = OBJECT_ENTRY_ARRAY,
  44         WINDOW_HEADER,
  45         _WINDOW_MAX
  46 };
  47
  48 typedef struct JournalMetrics {
  49         uint64_t max_use;
  50         uint64_t max_size;
  51         uint64_t min_size;
  52         uint64_t keep_free;
  53 } JournalMetrics;
  54
  55 typedef struct JournalFile {
  56         int fd;
  57         char *path;
  58         struct stat last_stat;
  59         mode_t mode;
  60         int flags;
  61         int prot;
  62         bool writable;
  63         bool tail_entry_monotonic_valid;
  64
  65         Header *header;
  66         HashItem *data_hash_table;
  67         HashItem *field_hash_table;
  68
  69         Window windows[_WINDOW_MAX];
  70
  71         uint64_t current_offset;
  72
  73         JournalMetrics metrics;
  74
  75         bool compress;
  76
  77 #ifdef HAVE_XZ
  78         void *compress_buffer;
  79         size_t compress_buffer_size;
  80 #endif
  81 } JournalFile;
  82
  83 typedef enum direction {
  84         DIRECTION_UP,
  85         DIRECTION_DOWN
  86 } direction_t;
  87
  88 int journal_file_open(const char *fname, int flags, mode_t mode, JournalFile *template, JournalFile **ret);
  89 void journal_file_close(JournalFile *j);
  90
  91 int journal_file_move_to_object(JournalFile *f, int type, uint64_t offset, Object **ret);
  92
  93 uint64_t journal_file_entry_n_items(Object *o);
  94
  95 int journal_file_append_entry(JournalFile *f, const dual_timestamp *ts, const struct iovec iovec[], unsigned n_iovec, uint64_t *seqno, Object **ret, uint64_t *offset);
  96
  97 int journal_file_find_data_object(JournalFile *f, const void *data, uint64_t size, Object **ret, uint64_t *offset);
  98 int journal_file_find_data_object_with_hash(JournalFile *f, const void *data, uint64_t size, uint64_t hash, Object **ret, uint64_t *offset);
  99
 100 int journal_file_next_entry(JournalFile *f, Object *o, uint64_t p, direction_t direction, Object **ret, uint64_t *offset);
 101 int journal_file_skip_entry(JournalFile *f, Object *o, uint64_t p, int64_t skip, Object **ret, uint64_t *offset);
 102
 103 int journal_file_next_entry_for_data(JournalFile *f, Object *o, uint64_t p, uint64_t data_offset, direction_t direction, Object **ret, uint64_t *offset);
 104
 105 int journal_file_move_to_entry_by_seqnum(JournalFile *f, uint64_t seqnum, direction_t direction, Object **ret, uint64_t *offset);
 106 int journal_file_move_to_entry_by_realtime(JournalFile *f, uint64_t realtime, direction_t direction, Object **ret, uint64_t *offset);
 107 int journal_file_move_to_entry_by_monotonic(JournalFile *f, sd_id128_t boot_id, uint64_t monotonic, direction_t direction, Object **ret, uint64_t *offset);
 108
 109 int journal_file_move_to_entry_by_seqnum_for_data(JournalFile *f, uint64_t data_offset, uint64_t seqnum, direction_t direction, Object **ret, uint64_t *offset);
 110 int journal_file_move_to_entry_by_realtime_for_data(JournalFile *f, uint64_t data_offset, uint64_t realtime, direction_t direction, Object **ret, uint64_t *offset);
 111
 112 int journal_file_copy_entry(JournalFile *from, JournalFile *to, Object *o, uint64_t p, uint64_t *seqnum, Object **ret, uint64_t *offset);
 113
 114 void journal_file_dump(JournalFile *f);
 115
 116 int journal_file_rotate(JournalFile **f);
 117
 118 int journal_directory_vacuum(const char *directory, uint64_t max_use, uint64_t min_free);
 119
 120 void journal_file_post_change(JournalFile *f);
 121
 122 void journal_default_metrics(JournalMetrics *m, int fd);
 123
 124 #endif