xfs_trans.h 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271
  1. // SPDX-License-Identifier: GPL-2.0
  2. /*
  3. * Copyright (c) 2000-2002,2005 Silicon Graphics, Inc.
  4. * All Rights Reserved.
  5. */
  6. #ifndef __XFS_TRANS_H__
  7. #define __XFS_TRANS_H__
  8. /* kernel only transaction subsystem defines */
  9. struct xfs_buf;
  10. struct xfs_buftarg;
  11. struct xfs_efd_log_item;
  12. struct xfs_efi_log_item;
  13. struct xfs_inode;
  14. struct xfs_item_ops;
  15. struct xfs_log_iovec;
  16. struct xfs_mount;
  17. struct xfs_trans;
  18. struct xfs_trans_res;
  19. struct xfs_dquot_acct;
  20. struct xfs_rud_log_item;
  21. struct xfs_rui_log_item;
  22. struct xfs_btree_cur;
  23. struct xfs_cui_log_item;
  24. struct xfs_cud_log_item;
  25. struct xfs_bui_log_item;
  26. struct xfs_bud_log_item;
  27. struct xfs_log_item {
  28. struct list_head li_ail; /* AIL pointers */
  29. struct list_head li_trans; /* transaction list */
  30. xfs_lsn_t li_lsn; /* last on-disk lsn */
  31. struct xfs_mount *li_mountp; /* ptr to fs mount */
  32. struct xfs_ail *li_ailp; /* ptr to AIL */
  33. uint li_type; /* item type */
  34. unsigned long li_flags; /* misc flags */
  35. struct xfs_buf *li_buf; /* real buffer pointer */
  36. struct list_head li_bio_list; /* buffer item list */
  37. const struct xfs_item_ops *li_ops; /* function list */
  38. /* delayed logging */
  39. struct list_head li_cil; /* CIL pointers */
  40. struct xfs_log_vec *li_lv; /* active log vector */
  41. struct xfs_log_vec *li_lv_shadow; /* standby vector */
  42. xfs_lsn_t li_seq; /* CIL commit seq */
  43. };
  44. /*
  45. * li_flags use the (set/test/clear)_bit atomic interfaces because updates can
  46. * race with each other and we don't want to have to use the AIL lock to
  47. * serialise all updates.
  48. */
  49. #define XFS_LI_IN_AIL 0
  50. #define XFS_LI_ABORTED 1
  51. #define XFS_LI_FAILED 2
  52. #define XFS_LI_DIRTY 3 /* log item dirty in transaction */
  53. #define XFS_LI_FLAGS \
  54. { (1 << XFS_LI_IN_AIL), "IN_AIL" }, \
  55. { (1 << XFS_LI_ABORTED), "ABORTED" }, \
  56. { (1 << XFS_LI_FAILED), "FAILED" }, \
  57. { (1 << XFS_LI_DIRTY), "DIRTY" }
  58. struct xfs_item_ops {
  59. unsigned flags;
  60. void (*iop_size)(struct xfs_log_item *, int *, int *);
  61. void (*iop_format)(struct xfs_log_item *, struct xfs_log_vec *);
  62. void (*iop_pin)(struct xfs_log_item *);
  63. void (*iop_unpin)(struct xfs_log_item *, int remove);
  64. uint (*iop_push)(struct xfs_log_item *, struct list_head *);
  65. void (*iop_committing)(struct xfs_log_item *, xfs_lsn_t commit_lsn);
  66. void (*iop_release)(struct xfs_log_item *);
  67. xfs_lsn_t (*iop_committed)(struct xfs_log_item *, xfs_lsn_t);
  68. int (*iop_recover)(struct xfs_log_item *lip,
  69. struct list_head *capture_list);
  70. bool (*iop_match)(struct xfs_log_item *item, uint64_t id);
  71. struct xfs_log_item *(*iop_relog)(struct xfs_log_item *intent,
  72. struct xfs_trans *tp);
  73. };
  74. /* Is this log item a deferred action intent? */
  75. static inline bool
  76. xlog_item_is_intent(struct xfs_log_item *lip)
  77. {
  78. return lip->li_ops->iop_recover != NULL &&
  79. lip->li_ops->iop_match != NULL;
  80. }
  81. /* Is this a log intent-done item? */
  82. static inline bool
  83. xlog_item_is_intent_done(struct xfs_log_item *lip)
  84. {
  85. return lip->li_ops->iop_unpin == NULL &&
  86. lip->li_ops->iop_push == NULL;
  87. }
  88. /*
  89. * Release the log item as soon as committed. This is for items just logging
  90. * intents that never need to be written back in place.
  91. */
  92. #define XFS_ITEM_RELEASE_WHEN_COMMITTED (1 << 0)
  93. void xfs_log_item_init(struct xfs_mount *mp, struct xfs_log_item *item,
  94. int type, const struct xfs_item_ops *ops);
  95. /*
  96. * Return values for the iop_push() routines.
  97. */
  98. #define XFS_ITEM_SUCCESS 0
  99. #define XFS_ITEM_PINNED 1
  100. #define XFS_ITEM_LOCKED 2
  101. #define XFS_ITEM_FLUSHING 3
  102. /*
  103. * Deferred operation item relogging limits.
  104. */
  105. #define XFS_DEFER_OPS_NR_INODES 2 /* join up to two inodes */
  106. #define XFS_DEFER_OPS_NR_BUFS 2 /* join up to two buffers */
  107. /*
  108. * This is the structure maintained for every active transaction.
  109. */
  110. typedef struct xfs_trans {
  111. unsigned int t_magic; /* magic number */
  112. unsigned int t_log_res; /* amt of log space resvd */
  113. unsigned int t_log_count; /* count for perm log res */
  114. unsigned int t_blk_res; /* # of blocks resvd */
  115. unsigned int t_blk_res_used; /* # of resvd blocks used */
  116. unsigned int t_rtx_res; /* # of rt extents resvd */
  117. unsigned int t_rtx_res_used; /* # of resvd rt extents used */
  118. unsigned int t_flags; /* misc flags */
  119. xfs_fsblock_t t_firstblock; /* first block allocated */
  120. struct xlog_ticket *t_ticket; /* log mgr ticket */
  121. struct xfs_mount *t_mountp; /* ptr to fs mount struct */
  122. struct xfs_dquot_acct *t_dqinfo; /* acctg info for dquots */
  123. int64_t t_icount_delta; /* superblock icount change */
  124. int64_t t_ifree_delta; /* superblock ifree change */
  125. int64_t t_fdblocks_delta; /* superblock fdblocks chg */
  126. int64_t t_res_fdblocks_delta; /* on-disk only chg */
  127. int64_t t_frextents_delta;/* superblock freextents chg*/
  128. int64_t t_res_frextents_delta; /* on-disk only chg */
  129. #if defined(DEBUG) || defined(XFS_WARN)
  130. int64_t t_ag_freeblks_delta; /* debugging counter */
  131. int64_t t_ag_flist_delta; /* debugging counter */
  132. int64_t t_ag_btree_delta; /* debugging counter */
  133. #endif
  134. int64_t t_dblocks_delta;/* superblock dblocks change */
  135. int64_t t_agcount_delta;/* superblock agcount change */
  136. int64_t t_imaxpct_delta;/* superblock imaxpct change */
  137. int64_t t_rextsize_delta;/* superblock rextsize chg */
  138. int64_t t_rbmblocks_delta;/* superblock rbmblocks chg */
  139. int64_t t_rblocks_delta;/* superblock rblocks change */
  140. int64_t t_rextents_delta;/* superblocks rextents chg */
  141. int64_t t_rextslog_delta;/* superblocks rextslog chg */
  142. struct list_head t_items; /* log item descriptors */
  143. struct list_head t_busy; /* list of busy extents */
  144. struct list_head t_dfops; /* deferred operations */
  145. unsigned long t_pflags; /* saved process flags state */
  146. } xfs_trans_t;
  147. /*
  148. * XFS transaction mechanism exported interfaces that are
  149. * actually macros.
  150. */
  151. #define xfs_trans_set_sync(tp) ((tp)->t_flags |= XFS_TRANS_SYNC)
  152. #if defined(DEBUG) || defined(XFS_WARN)
  153. #define xfs_trans_agblocks_delta(tp, d) ((tp)->t_ag_freeblks_delta += (int64_t)d)
  154. #define xfs_trans_agflist_delta(tp, d) ((tp)->t_ag_flist_delta += (int64_t)d)
  155. #define xfs_trans_agbtree_delta(tp, d) ((tp)->t_ag_btree_delta += (int64_t)d)
  156. #else
  157. #define xfs_trans_agblocks_delta(tp, d)
  158. #define xfs_trans_agflist_delta(tp, d)
  159. #define xfs_trans_agbtree_delta(tp, d)
  160. #endif
  161. /*
  162. * XFS transaction mechanism exported interfaces.
  163. */
  164. int xfs_trans_alloc(struct xfs_mount *mp, struct xfs_trans_res *resp,
  165. uint blocks, uint rtextents, uint flags,
  166. struct xfs_trans **tpp);
  167. int xfs_trans_alloc_empty(struct xfs_mount *mp,
  168. struct xfs_trans **tpp);
  169. void xfs_trans_mod_sb(xfs_trans_t *, uint, int64_t);
  170. int xfs_trans_get_buf_map(struct xfs_trans *tp, struct xfs_buftarg *target,
  171. struct xfs_buf_map *map, int nmaps, xfs_buf_flags_t flags,
  172. struct xfs_buf **bpp);
  173. static inline int
  174. xfs_trans_get_buf(
  175. struct xfs_trans *tp,
  176. struct xfs_buftarg *target,
  177. xfs_daddr_t blkno,
  178. int numblks,
  179. uint flags,
  180. struct xfs_buf **bpp)
  181. {
  182. DEFINE_SINGLE_BUF_MAP(map, blkno, numblks);
  183. return xfs_trans_get_buf_map(tp, target, &map, 1, flags, bpp);
  184. }
  185. int xfs_trans_read_buf_map(struct xfs_mount *mp,
  186. struct xfs_trans *tp,
  187. struct xfs_buftarg *target,
  188. struct xfs_buf_map *map, int nmaps,
  189. xfs_buf_flags_t flags,
  190. struct xfs_buf **bpp,
  191. const struct xfs_buf_ops *ops);
  192. static inline int
  193. xfs_trans_read_buf(
  194. struct xfs_mount *mp,
  195. struct xfs_trans *tp,
  196. struct xfs_buftarg *target,
  197. xfs_daddr_t blkno,
  198. int numblks,
  199. xfs_buf_flags_t flags,
  200. struct xfs_buf **bpp,
  201. const struct xfs_buf_ops *ops)
  202. {
  203. DEFINE_SINGLE_BUF_MAP(map, blkno, numblks);
  204. return xfs_trans_read_buf_map(mp, tp, target, &map, 1,
  205. flags, bpp, ops);
  206. }
  207. struct xfs_buf *xfs_trans_getsb(struct xfs_trans *);
  208. void xfs_trans_brelse(xfs_trans_t *, struct xfs_buf *);
  209. void xfs_trans_bjoin(xfs_trans_t *, struct xfs_buf *);
  210. void xfs_trans_bhold(xfs_trans_t *, struct xfs_buf *);
  211. void xfs_trans_bhold_release(xfs_trans_t *, struct xfs_buf *);
  212. void xfs_trans_binval(xfs_trans_t *, struct xfs_buf *);
  213. void xfs_trans_inode_buf(xfs_trans_t *, struct xfs_buf *);
  214. void xfs_trans_stale_inode_buf(xfs_trans_t *, struct xfs_buf *);
  215. bool xfs_trans_ordered_buf(xfs_trans_t *, struct xfs_buf *);
  216. void xfs_trans_dquot_buf(xfs_trans_t *, struct xfs_buf *, uint);
  217. void xfs_trans_inode_alloc_buf(xfs_trans_t *, struct xfs_buf *);
  218. void xfs_trans_ichgtime(struct xfs_trans *, struct xfs_inode *, int);
  219. void xfs_trans_ijoin(struct xfs_trans *, struct xfs_inode *, uint);
  220. void xfs_trans_log_buf(struct xfs_trans *, struct xfs_buf *, uint,
  221. uint);
  222. void xfs_trans_dirty_buf(struct xfs_trans *, struct xfs_buf *);
  223. bool xfs_trans_buf_is_dirty(struct xfs_buf *bp);
  224. void xfs_trans_log_inode(xfs_trans_t *, struct xfs_inode *, uint);
  225. int xfs_trans_commit(struct xfs_trans *);
  226. int xfs_trans_roll(struct xfs_trans **);
  227. int xfs_trans_roll_inode(struct xfs_trans **, struct xfs_inode *);
  228. void xfs_trans_cancel(xfs_trans_t *);
  229. int xfs_trans_ail_init(struct xfs_mount *);
  230. void xfs_trans_ail_destroy(struct xfs_mount *);
  231. void xfs_trans_buf_set_type(struct xfs_trans *, struct xfs_buf *,
  232. enum xfs_blft);
  233. void xfs_trans_buf_copy_type(struct xfs_buf *dst_bp,
  234. struct xfs_buf *src_bp);
  235. extern kmem_zone_t *xfs_trans_zone;
  236. static inline struct xfs_log_item *
  237. xfs_trans_item_relog(
  238. struct xfs_log_item *lip,
  239. struct xfs_trans *tp)
  240. {
  241. return lip->li_ops->iop_relog(lip, tp);
  242. }
  243. #endif /* __XFS_TRANS_H__ */