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