ext4_jbd2.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328
  1. /*
  2. * ext4_jbd2.h
  3. *
  4. * Written by Stephen C. Tweedie <sct@redhat.com>, 1999
  5. *
  6. * Copyright 1998--1999 Red Hat corp --- All Rights Reserved
  7. *
  8. * This file is part of the Linux kernel and is made available under
  9. * the terms of the GNU General Public License, version 2, or at your
  10. * option, any later version, incorporated herein by reference.
  11. *
  12. * Ext4-specific journaling extensions.
  13. */
  14. #ifndef _EXT4_JBD2_H
  15. #define _EXT4_JBD2_H
  16. #include <linux/fs.h>
  17. #include <linux/jbd2.h>
  18. #include "ext4.h"
  19. #define EXT4_JOURNAL(inode) (EXT4_SB((inode)->i_sb)->s_journal)
  20. /* Define the number of blocks we need to account to a transaction to
  21. * modify one block of data.
  22. *
  23. * We may have to touch one inode, one bitmap buffer, up to three
  24. * indirection blocks, the group and superblock summaries, and the data
  25. * block to complete the transaction.
  26. *
  27. * For extents-enabled fs we may have to allocate and modify up to
  28. * 5 levels of tree + root which are stored in the inode. */
  29. #define EXT4_SINGLEDATA_TRANS_BLOCKS(sb) \
  30. (EXT4_HAS_INCOMPAT_FEATURE(sb, EXT4_FEATURE_INCOMPAT_EXTENTS) \
  31. ? 27U : 8U)
  32. /* Extended attribute operations touch at most two data buffers,
  33. * two bitmap buffers, and two group summaries, in addition to the inode
  34. * and the superblock, which are already accounted for. */
  35. #define EXT4_XATTR_TRANS_BLOCKS 6U
  36. /* Define the minimum size for a transaction which modifies data. This
  37. * needs to take into account the fact that we may end up modifying two
  38. * quota files too (one for the group, one for the user quota). The
  39. * superblock only gets updated once, of course, so don't bother
  40. * counting that again for the quota updates. */
  41. #define EXT4_DATA_TRANS_BLOCKS(sb) (EXT4_SINGLEDATA_TRANS_BLOCKS(sb) + \
  42. EXT4_XATTR_TRANS_BLOCKS - 2 + \
  43. EXT4_MAXQUOTAS_TRANS_BLOCKS(sb))
  44. /*
  45. * Define the number of metadata blocks we need to account to modify data.
  46. *
  47. * This include super block, inode block, quota blocks and xattr blocks
  48. */
  49. #define EXT4_META_TRANS_BLOCKS(sb) (EXT4_XATTR_TRANS_BLOCKS + \
  50. EXT4_MAXQUOTAS_TRANS_BLOCKS(sb))
  51. /* Delete operations potentially hit one directory's namespace plus an
  52. * entire inode, plus arbitrary amounts of bitmap/indirection data. Be
  53. * generous. We can grow the delete transaction later if necessary. */
  54. #define EXT4_DELETE_TRANS_BLOCKS(sb) (2 * EXT4_DATA_TRANS_BLOCKS(sb) + 64)
  55. /* Define an arbitrary limit for the amount of data we will anticipate
  56. * writing to any given transaction. For unbounded transactions such as
  57. * write(2) and truncate(2) we can write more than this, but we always
  58. * start off at the maximum transaction size and grow the transaction
  59. * optimistically as we go. */
  60. #define EXT4_MAX_TRANS_DATA 64U
  61. /* We break up a large truncate or write transaction once the handle's
  62. * buffer credits gets this low, we need either to extend the
  63. * transaction or to start a new one. Reserve enough space here for
  64. * inode, bitmap, superblock, group and indirection updates for at least
  65. * one block, plus two quota updates. Quota allocations are not
  66. * needed. */
  67. #define EXT4_RESERVE_TRANS_BLOCKS 12U
  68. #define EXT4_INDEX_EXTRA_TRANS_BLOCKS 8
  69. #ifdef CONFIG_QUOTA
  70. /* Amount of blocks needed for quota update - we know that the structure was
  71. * allocated so we need to update only data block */
  72. #define EXT4_QUOTA_TRANS_BLOCKS(sb) (test_opt(sb, QUOTA) ? 1 : 0)
  73. /* Amount of blocks needed for quota insert/delete - we do some block writes
  74. * but inode, sb and group updates are done only once */
  75. #define EXT4_QUOTA_INIT_BLOCKS(sb) (test_opt(sb, QUOTA) ? (DQUOT_INIT_ALLOC*\
  76. (EXT4_SINGLEDATA_TRANS_BLOCKS(sb)-3)+3+DQUOT_INIT_REWRITE) : 0)
  77. #define EXT4_QUOTA_DEL_BLOCKS(sb) (test_opt(sb, QUOTA) ? (DQUOT_DEL_ALLOC*\
  78. (EXT4_SINGLEDATA_TRANS_BLOCKS(sb)-3)+3+DQUOT_DEL_REWRITE) : 0)
  79. #else
  80. #define EXT4_QUOTA_TRANS_BLOCKS(sb) 0
  81. #define EXT4_QUOTA_INIT_BLOCKS(sb) 0
  82. #define EXT4_QUOTA_DEL_BLOCKS(sb) 0
  83. #endif
  84. #define EXT4_MAXQUOTAS_TRANS_BLOCKS(sb) (MAXQUOTAS*EXT4_QUOTA_TRANS_BLOCKS(sb))
  85. #define EXT4_MAXQUOTAS_INIT_BLOCKS(sb) (MAXQUOTAS*EXT4_QUOTA_INIT_BLOCKS(sb))
  86. #define EXT4_MAXQUOTAS_DEL_BLOCKS(sb) (MAXQUOTAS*EXT4_QUOTA_DEL_BLOCKS(sb))
  87. int
  88. ext4_mark_iloc_dirty(handle_t *handle,
  89. struct inode *inode,
  90. struct ext4_iloc *iloc);
  91. /*
  92. * On success, We end up with an outstanding reference count against
  93. * iloc->bh. This _must_ be cleaned up later.
  94. */
  95. int ext4_reserve_inode_write(handle_t *handle, struct inode *inode,
  96. struct ext4_iloc *iloc);
  97. int ext4_mark_inode_dirty(handle_t *handle, struct inode *inode);
  98. /*
  99. * Wrapper functions with which ext4 calls into JBD.
  100. */
  101. void ext4_journal_abort_handle(const char *caller, unsigned int line,
  102. const char *err_fn,
  103. struct buffer_head *bh, handle_t *handle, int err);
  104. int __ext4_journal_get_write_access(const char *where, unsigned int line,
  105. handle_t *handle, struct buffer_head *bh);
  106. int __ext4_forget(const char *where, unsigned int line, handle_t *handle,
  107. int is_metadata, struct inode *inode,
  108. struct buffer_head *bh, ext4_fsblk_t blocknr);
  109. int __ext4_journal_get_create_access(const char *where, unsigned int line,
  110. handle_t *handle, struct buffer_head *bh);
  111. int __ext4_handle_dirty_metadata(const char *where, unsigned int line,
  112. handle_t *handle, struct inode *inode,
  113. struct buffer_head *bh);
  114. int __ext4_handle_dirty_super(const char *where, unsigned int line,
  115. handle_t *handle, struct super_block *sb);
  116. #define ext4_journal_get_write_access(handle, bh) \
  117. __ext4_journal_get_write_access(__func__, __LINE__, (handle), (bh))
  118. #define ext4_forget(handle, is_metadata, inode, bh, block_nr) \
  119. __ext4_forget(__func__, __LINE__, (handle), (is_metadata), (inode), \
  120. (bh), (block_nr))
  121. #define ext4_journal_get_create_access(handle, bh) \
  122. __ext4_journal_get_create_access(__func__, __LINE__, (handle), (bh))
  123. #define ext4_handle_dirty_metadata(handle, inode, bh) \
  124. __ext4_handle_dirty_metadata(__func__, __LINE__, (handle), (inode), \
  125. (bh))
  126. #define ext4_handle_dirty_super(handle, sb) \
  127. __ext4_handle_dirty_super(__func__, __LINE__, (handle), (sb))
  128. handle_t *ext4_journal_start_sb(struct super_block *sb, int nblocks);
  129. int __ext4_journal_stop(const char *where, unsigned int line, handle_t *handle);
  130. #define EXT4_NOJOURNAL_MAX_REF_COUNT ((unsigned long) 4096)
  131. /* Note: Do not use this for NULL handles. This is only to determine if
  132. * a properly allocated handle is using a journal or not. */
  133. static inline int ext4_handle_valid(handle_t *handle)
  134. {
  135. if ((unsigned long)handle < EXT4_NOJOURNAL_MAX_REF_COUNT)
  136. return 0;
  137. return 1;
  138. }
  139. static inline void ext4_handle_sync(handle_t *handle)
  140. {
  141. if (ext4_handle_valid(handle))
  142. handle->h_sync = 1;
  143. }
  144. static inline void ext4_handle_release_buffer(handle_t *handle,
  145. struct buffer_head *bh)
  146. {
  147. if (ext4_handle_valid(handle))
  148. jbd2_journal_release_buffer(handle, bh);
  149. }
  150. static inline int ext4_handle_is_aborted(handle_t *handle)
  151. {
  152. if (ext4_handle_valid(handle))
  153. return is_handle_aborted(handle);
  154. return 0;
  155. }
  156. static inline int ext4_handle_has_enough_credits(handle_t *handle, int needed)
  157. {
  158. if (ext4_handle_valid(handle) && handle->h_buffer_credits < needed)
  159. return 0;
  160. return 1;
  161. }
  162. static inline handle_t *ext4_journal_start(struct inode *inode, int nblocks)
  163. {
  164. return ext4_journal_start_sb(inode->i_sb, nblocks);
  165. }
  166. #define ext4_journal_stop(handle) \
  167. __ext4_journal_stop(__func__, __LINE__, (handle))
  168. static inline handle_t *ext4_journal_current_handle(void)
  169. {
  170. return journal_current_handle();
  171. }
  172. static inline int ext4_journal_extend(handle_t *handle, int nblocks)
  173. {
  174. if (ext4_handle_valid(handle))
  175. return jbd2_journal_extend(handle, nblocks);
  176. return 0;
  177. }
  178. static inline int ext4_journal_restart(handle_t *handle, int nblocks)
  179. {
  180. if (ext4_handle_valid(handle))
  181. return jbd2_journal_restart(handle, nblocks);
  182. return 0;
  183. }
  184. static inline int ext4_journal_blocks_per_page(struct inode *inode)
  185. {
  186. if (EXT4_JOURNAL(inode) != NULL)
  187. return jbd2_journal_blocks_per_page(inode);
  188. return 0;
  189. }
  190. static inline int ext4_journal_force_commit(journal_t *journal)
  191. {
  192. if (journal)
  193. return jbd2_journal_force_commit(journal);
  194. return 0;
  195. }
  196. static inline int ext4_jbd2_file_inode(handle_t *handle, struct inode *inode)
  197. {
  198. if (ext4_handle_valid(handle))
  199. return jbd2_journal_file_inode(handle, EXT4_I(inode)->jinode);
  200. return 0;
  201. }
  202. static inline void ext4_update_inode_fsync_trans(handle_t *handle,
  203. struct inode *inode,
  204. int datasync)
  205. {
  206. struct ext4_inode_info *ei = EXT4_I(inode);
  207. if (ext4_handle_valid(handle)) {
  208. ei->i_sync_tid = handle->h_transaction->t_tid;
  209. if (datasync)
  210. ei->i_datasync_tid = handle->h_transaction->t_tid;
  211. }
  212. }
  213. /* super.c */
  214. int ext4_force_commit(struct super_block *sb);
  215. /*
  216. * Ext4 inode journal modes
  217. */
  218. #define EXT4_INODE_JOURNAL_DATA_MODE 0x01 /* journal data mode */
  219. #define EXT4_INODE_ORDERED_DATA_MODE 0x02 /* ordered data mode */
  220. #define EXT4_INODE_WRITEBACK_DATA_MODE 0x04 /* writeback data mode */
  221. static inline int ext4_inode_journal_mode(struct inode *inode)
  222. {
  223. if (EXT4_JOURNAL(inode) == NULL)
  224. return EXT4_INODE_WRITEBACK_DATA_MODE; /* writeback */
  225. /* We do not support data journalling with delayed allocation */
  226. if (!S_ISREG(inode->i_mode) ||
  227. test_opt(inode->i_sb, DATA_FLAGS) == EXT4_MOUNT_JOURNAL_DATA)
  228. return EXT4_INODE_JOURNAL_DATA_MODE; /* journal data */
  229. if (ext4_test_inode_flag(inode, EXT4_INODE_JOURNAL_DATA) &&
  230. !test_opt(inode->i_sb, DELALLOC))
  231. return EXT4_INODE_JOURNAL_DATA_MODE; /* journal data */
  232. if (test_opt(inode->i_sb, DATA_FLAGS) == EXT4_MOUNT_ORDERED_DATA)
  233. return EXT4_INODE_ORDERED_DATA_MODE; /* ordered */
  234. if (test_opt(inode->i_sb, DATA_FLAGS) == EXT4_MOUNT_WRITEBACK_DATA)
  235. return EXT4_INODE_WRITEBACK_DATA_MODE; /* writeback */
  236. else
  237. BUG();
  238. }
  239. static inline int ext4_should_journal_data(struct inode *inode)
  240. {
  241. return ext4_inode_journal_mode(inode) & EXT4_INODE_JOURNAL_DATA_MODE;
  242. }
  243. static inline int ext4_should_order_data(struct inode *inode)
  244. {
  245. return ext4_inode_journal_mode(inode) & EXT4_INODE_ORDERED_DATA_MODE;
  246. }
  247. static inline int ext4_should_writeback_data(struct inode *inode)
  248. {
  249. return ext4_inode_journal_mode(inode) & EXT4_INODE_WRITEBACK_DATA_MODE;
  250. }
  251. /*
  252. * This function controls whether or not we should try to go down the
  253. * dioread_nolock code paths, which makes it safe to avoid taking
  254. * i_mutex for direct I/O reads. This only works for extent-based
  255. * files, and it doesn't work if data journaling is enabled, since the
  256. * dioread_nolock code uses b_private to pass information back to the
  257. * I/O completion handler, and this conflicts with the jbd's use of
  258. * b_private.
  259. */
  260. static inline int ext4_should_dioread_nolock(struct inode *inode)
  261. {
  262. if (!test_opt(inode->i_sb, DIOREAD_NOLOCK))
  263. return 0;
  264. if (!S_ISREG(inode->i_mode))
  265. return 0;
  266. if (!(ext4_test_inode_flag(inode, EXT4_INODE_EXTENTS)))
  267. return 0;
  268. if (ext4_should_journal_data(inode))
  269. return 0;
  270. return 1;
  271. }
  272. #endif /* _EXT4_JBD2_H */