include/xfs_trans.h

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * Copyright (c) 2000-2005 Silicon Graphics, Inc.
   4  * All Rights Reserved.
   5  */
   6
   7 #ifndef __XFS_TRANS_H__
   8 #define __XFS_TRANS_H__
   9
  10 struct xfs_mount;
  11 struct xfs_buftarg;
  12 struct xfs_buf;
  13 struct xfs_buf_map;
  14
  15 /*
  16  * Userspace Transaction interface
  17  */
  18
  19 typedef struct xfs_log_item {
  20         struct list_head                li_trans;       /* transaction list */
  21         xfs_lsn_t                       li_lsn;         /* last on-disk lsn */
  22         struct xfs_mount                *li_mountp;     /* ptr to fs mount */
  23         uint                            li_type;        /* item type */
  24         unsigned long                   li_flags;       /* misc flags */
  25 } xfs_log_item_t;
  26
  27 #define XFS_LI_DIRTY    3       /* log item dirty in transaction */
  28
  29 typedef struct xfs_inode_log_item {
  30         xfs_log_item_t          ili_item;               /* common portion */
  31         struct xfs_inode        *ili_inode;             /* inode pointer */
  32         unsigned short          ili_flags;              /* misc flags */
  33         unsigned short          ili_lock_flags;         /* lock flags */
  34         unsigned int            ili_fields;             /* fields to be logged */
  35         unsigned int            ili_last_fields;        /* fields when flushed*/
  36 } xfs_inode_log_item_t;
  37
  38 typedef struct xfs_buf_log_item {
  39         xfs_log_item_t          bli_item;       /* common item structure */
  40         struct xfs_buf          *bli_buf;       /* real buffer pointer */
  41         unsigned int            bli_flags;      /* misc flags */
  42         unsigned int            bli_recur;      /* recursion count */
  43         xfs_buf_log_format_t    bli_format;     /* in-log header */
  44 } xfs_buf_log_item_t;
  45
  46 #define XFS_BLI_DIRTY                   (1<<0)
  47 #define XFS_BLI_HOLD                    (1<<1)
  48 #define XFS_BLI_STALE                   (1<<2)
  49 #define XFS_BLI_INODE_ALLOC_BUF         (1<<3)
  50
  51 typedef struct xfs_dq_logitem {
  52         xfs_log_item_t          qli_item;       /* common portion */
  53         struct xfs_dquot        *qli_dquot;     /* dquot ptr */
  54         xfs_lsn_t               qli_flush_lsn;  /* lsn at last flush */
  55         xfs_dq_logformat_t      qli_format;     /* logged structure */
  56 } xfs_dq_logitem_t;
  57
  58 typedef struct xfs_qoff_logitem {
  59         xfs_log_item_t          qql_item;       /* common portion */
  60         struct xfs_qoff_logitem *qql_start_lip; /* qoff-start logitem, if any */
  61         xfs_qoff_logformat_t    qql_format;     /* logged structure */
  62 } xfs_qoff_logitem_t;
  63
  64 #define XFS_DEFER_OPS_NR_INODES 2       /* join up to two inodes */
  65 #define XFS_DEFER_OPS_NR_BUFS   2       /* join up to two buffers */
  66
  67 struct xfs_defer_ops {
  68         struct list_head                dop_intake;     /* unlogged pending work */
  69         struct list_head                dop_pending;    /* logged pending work */
  70 };
  71
  72 typedef struct xfs_trans {
  73         unsigned int    t_type;                 /* transaction type */
  74         unsigned int    t_log_res;              /* amt of log space resvd */
  75         unsigned int    t_log_count;            /* count for perm log res */
  76         unsigned int    t_blk_res;              /* # of blocks resvd */
  77         xfs_fsblock_t   t_firstblock;           /* first block allocated */
  78         struct xfs_mount *t_mountp;             /* ptr to fs mount struct */
  79         unsigned int    t_blk_res_used;         /* # of resvd blocks used */
  80         unsigned int    t_flags;                /* misc flags */
  81         long            t_icount_delta;         /* superblock icount change */
  82         long            t_ifree_delta;          /* superblock ifree change */
  83         long            t_fdblocks_delta;       /* superblock fdblocks chg */
  84         long            t_frextents_delta;      /* superblock freextents chg */
  85         struct list_head        t_items;        /* first log item desc chunk */
  86         struct xfs_defer_ops    *t_dfops;       /* deferred operations */
  87         struct xfs_defer_ops    t_dfops_internal;
  88
  89 } xfs_trans_t;
  90
  91 void    xfs_trans_init(struct xfs_mount *);
  92 int     xfs_trans_roll(struct xfs_trans **);
  93
  94 int     libxfs_trans_alloc(struct xfs_mount *mp, struct xfs_trans_res *resp,
  95                            uint blocks, uint rtextents, uint flags,
  96                            struct xfs_trans **tpp);
  97 int     libxfs_trans_alloc_rollable(struct xfs_mount *mp, uint blocks,
  98                                     struct xfs_trans **tpp);
  99 int     libxfs_trans_alloc_empty(struct xfs_mount *mp, struct xfs_trans **tpp);
 100 int     libxfs_trans_commit(struct xfs_trans *);
 101 void    libxfs_trans_cancel(struct xfs_trans *);
 102
 103 /* cancel dfops associated with a transaction */
 104 void xfs_defer_cancel(struct xfs_trans *);
 105
 106 struct xfs_buf *libxfs_trans_getsb(struct xfs_trans *, struct xfs_mount *, int);
 107
 108 int     libxfs_trans_iget(struct xfs_mount *, struct xfs_trans *, xfs_ino_t,
 109                                 uint, uint, struct xfs_inode **);
 110 void    libxfs_trans_ijoin(struct xfs_trans *, struct xfs_inode *, uint);
 111 void    libxfs_trans_ijoin_ref(struct xfs_trans *, struct xfs_inode *, int);
 112 void    libxfs_trans_log_inode (struct xfs_trans *, struct xfs_inode *,
 113                                 uint);
 114 int     libxfs_trans_roll_inode (struct xfs_trans **, struct xfs_inode *);
 115
 116 void    libxfs_trans_brelse(struct xfs_trans *, struct xfs_buf *);
 117 void    libxfs_trans_binval(struct xfs_trans *, struct xfs_buf *);
 118 void    libxfs_trans_bjoin(struct xfs_trans *, struct xfs_buf *);
 119 void    libxfs_trans_bhold(struct xfs_trans *, struct xfs_buf *);
 120 void    libxfs_trans_dirty_buf(struct xfs_trans *, struct xfs_buf *);
 121 void    libxfs_trans_log_buf(struct xfs_trans *, struct xfs_buf *,
 122                                 uint, uint);
 123 bool    libxfs_trans_ordered_buf(xfs_trans_t *, struct xfs_buf *);
 124
 125 struct xfs_buf  *libxfs_trans_get_buf_map(struct xfs_trans *tp,
 126                                         struct xfs_buftarg *btp,
 127                                         struct xfs_buf_map *map, int nmaps,
 128                                         uint flags);
 129
 130 int     libxfs_trans_read_buf_map(struct xfs_mount *mp, struct xfs_trans *tp,
 131                                   struct xfs_buftarg *btp,
 132                                   struct xfs_buf_map *map, int nmaps,
 133                                   uint flags, struct xfs_buf **bpp,
 134                                   const struct xfs_buf_ops *ops);
 135 static inline struct xfs_buf *
 136 libxfs_trans_get_buf(
 137         struct xfs_trans        *tp,
 138         struct xfs_buftarg      *btp,
 139         xfs_daddr_t             blkno,
 140         int                     numblks,
 141         uint                    flags)
 142 {
 143         DEFINE_SINGLE_BUF_MAP(map, blkno, numblks);
 144         return libxfs_trans_get_buf_map(tp, btp, &map, 1, flags);
 145 }
 146
 147 static inline int
 148 libxfs_trans_read_buf(
 149         struct xfs_mount        *mp,
 150         struct xfs_trans        *tp,
 151         struct xfs_buftarg      *btp,
 152         xfs_daddr_t             blkno,
 153         int                     numblks,
 154         uint                    flags,
 155         struct xfs_buf          **bpp,
 156         const struct xfs_buf_ops *ops)
 157 {
 158         DEFINE_SINGLE_BUF_MAP(map, blkno, numblks);
 159         return libxfs_trans_read_buf_map(mp, tp, btp, &map, 1, flags, bpp, ops);
 160 }
 161
 162 void xfs_extent_free_init_defer_op(void);
 163 void xfs_rmap_update_init_defer_op(void);
 164 void xfs_refcount_update_init_defer_op(void);
 165 void xfs_bmap_update_init_defer_op(void);
 166
 167 #endif  /* __XFS_TRANS_H__ */