include/ext4_journal.h

   1 /*
   2  * Copyright (c) 2015 Grzegorz Kostka (kostka.grzegorz@gmail.com)
   3  * Copyright (c) 2015 Kaho Ng (ngkaho1234@gmail.com)
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  *
   9  * - Redistributions of source code must retain the above copyright
  10  *   notice, this list of conditions and the following disclaimer.
  11  * - Redistributions in binary form must reproduce the above copyright
  12  *   notice, this list of conditions and the following disclaimer in the
  13  *   documentation and/or other materials provided with the distribution.
  14  * - The name of the author may not be used to endorse or promote products
  15  *   derived from this software without specific prior written permission.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27  */
  28
  29 /** @addtogroup lwext4
  30  * @{
  31  */
  32 /**
  33  * @file  ext4_journal.h
  34  * @brief Journal handle functions
  35  */
  36
  37 #ifndef EXT4_JOURNAL_H_
  38 #define EXT4_JOURNAL_H_
  39
  40 #ifdef __cplusplus
  41 extern "C" {
  42 #endif
  43
  44 #include "ext4_config.h"
  45 #include "ext4_types.h"
  46 #include "misc/queue.h"
  47 #include "misc/tree.h"
  48
  49 struct jbd_fs {
  50         struct ext4_blockdev *bdev;
  51         struct ext4_inode_ref inode_ref;
  52         struct jbd_sb sb;
  53
  54         bool dirty;
  55 };
  56
  57 struct jbd_buf {
  58         uint32_t jbd_lba;
  59         struct ext4_block block;
  60         struct jbd_trans *trans;
  61         struct jbd_block_rec *block_rec;
  62         TAILQ_ENTRY(jbd_buf) buf_node;
  63         TAILQ_ENTRY(jbd_buf) dirty_buf_node;
  64 };
  65
  66 struct jbd_revoke_rec {
  67         ext4_fsblk_t lba;
  68         RB_ENTRY(jbd_revoke_rec) revoke_node;
  69 };
  70
  71 struct jbd_block_rec {
  72         ext4_fsblk_t lba;
  73         struct jbd_trans *trans;
  74         RB_ENTRY(jbd_block_rec) block_rec_node;
  75         LIST_ENTRY(jbd_block_rec) tbrec_node;
  76         TAILQ_HEAD(jbd_buf_dirty, jbd_buf) dirty_buf_queue;
  77 };
  78
  79 struct jbd_trans {
  80         uint32_t trans_id;
  81
  82         uint32_t start_iblock;
  83         int alloc_blocks;
  84         int data_cnt;
  85         uint32_t data_csum;
  86         int written_cnt;
  87         int error;
  88
  89         struct jbd_journal *journal;
  90
  91         TAILQ_HEAD(jbd_trans_buf, jbd_buf) buf_queue;
  92         RB_HEAD(jbd_revoke_tree, jbd_revoke_rec) revoke_root;
  93         LIST_HEAD(jbd_trans_block_rec, jbd_block_rec) tbrec_list;
  94         TAILQ_ENTRY(jbd_trans) trans_node;
  95 };
  96
  97 struct jbd_journal {
  98         uint32_t first;
  99         uint32_t start;
 100         uint32_t last;
 101         uint32_t trans_id;
 102         uint32_t alloc_trans_id;
 103
 104         uint32_t block_size;
 105
 106         TAILQ_HEAD(jbd_cp_queue, jbd_trans) cp_queue;
 107         RB_HEAD(jbd_block, jbd_block_rec) block_rec_root;
 108
 109         struct jbd_fs *jbd_fs;
 110 };
 111
 112 int jbd_get_fs(struct ext4_fs *fs,
 113                struct jbd_fs *jbd_fs);
 114 int jbd_put_fs(struct jbd_fs *jbd_fs);
 115 int jbd_inode_bmap(struct jbd_fs *jbd_fs,
 116                    ext4_lblk_t iblock,
 117                    ext4_fsblk_t *fblock);
 118 int jbd_recover(struct jbd_fs *jbd_fs);
 119 int jbd_journal_start(struct jbd_fs *jbd_fs,
 120                       struct jbd_journal *journal);
 121 int jbd_journal_stop(struct jbd_journal *journal);
 122 struct jbd_trans *
 123 jbd_journal_new_trans(struct jbd_journal *journal);
 124 int jbd_trans_set_block_dirty(struct jbd_trans *trans,
 125                               struct ext4_block *block);
 126 int jbd_trans_revoke_block(struct jbd_trans *trans,
 127                            ext4_fsblk_t lba);
 128 int jbd_trans_try_revoke_block(struct jbd_trans *trans,
 129                                ext4_fsblk_t lba);
 130 void jbd_journal_free_trans(struct jbd_journal *journal,
 131                             struct jbd_trans *trans,
 132                             bool abort);
 133 int jbd_journal_commit_trans(struct jbd_journal *journal,
 134                              struct jbd_trans *trans);
 135 void
 136 jbd_journal_purge_cp_trans(struct jbd_journal *journal,
 137                            bool flush,
 138                            bool once);
 139
 140 #ifdef __cplusplus
 141 }
 142 #endif
 143
 144 #endif /* EXT4_JOURNAL_H_ */
 145
 146 /**
 147  * @}
 148  */