LXR linux/fs/xfs/xfs

   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 * Copyright (c) 2000-2003,2005 Silicon Graphics, Inc.
   4 * All Rights Reserved.
   5 */
   6#ifndef __XFS_RTALLOC_H__
   7#define __XFS_RTALLOC_H__
   8
   9/* kernel only definitions and functions */
  10
  11struct xfs_mount;
  12struct xfs_trans;
  13
  14/*
  15 * XXX: Most of the realtime allocation functions deal in units of realtime
  16 * extents, not realtime blocks.  This looks funny when paired with the type
  17 * name and screams for a larger cleanup.
  18 */
  19struct xfs_rtalloc_rec {
  20        xfs_rtblock_t           ar_startext;
  21        xfs_rtblock_t           ar_extcount;
  22};
  23
  24typedef int (*xfs_rtalloc_query_range_fn)(
  25        struct xfs_trans                *tp,
  26        const struct xfs_rtalloc_rec    *rec,
  27        void                            *priv);
  28
  29#ifdef CONFIG_XFS_RT
  30/*
  31 * Function prototypes for exported functions.
  32 */
  33
  34/*
  35 * Allocate an extent in the realtime subvolume, with the usual allocation
  36 * parameters.  The length units are all in realtime extents, as is the
  37 * result block number.
  38 */
  39int                                     /* error */
  40xfs_rtallocate_extent(
  41        struct xfs_trans        *tp,    /* transaction pointer */
  42        xfs_rtblock_t           bno,    /* starting block number to allocate */
  43        xfs_extlen_t            minlen, /* minimum length to allocate */
  44        xfs_extlen_t            maxlen, /* maximum length to allocate */
  45        xfs_extlen_t            *len,   /* out: actual length allocated */
  46        int                     wasdel, /* was a delayed allocation extent */
  47        xfs_extlen_t            prod,   /* extent product factor */
  48        xfs_rtblock_t           *rtblock); /* out: start block allocated */
  49
  50/*
  51 * Free an extent in the realtime subvolume.  Length is expressed in
  52 * realtime extents, as is the block number.
  53 */
  54int                                     /* error */
  55xfs_rtfree_extent(
  56        struct xfs_trans        *tp,    /* transaction pointer */
  57        xfs_rtblock_t           bno,    /* starting block number to free */
  58        xfs_extlen_t            len);   /* length of extent freed */
  59
  60/*
  61 * Initialize realtime fields in the mount structure.
  62 */
  63int                                     /* error */
  64xfs_rtmount_init(
  65        struct xfs_mount        *mp);   /* file system mount structure */
  66void
  67xfs_rtunmount_inodes(
  68        struct xfs_mount        *mp);
  69
  70/*
  71 * Get the bitmap and summary inodes into the mount structure
  72 * at mount time.
  73 */
  74int                                     /* error */
  75xfs_rtmount_inodes(
  76        struct xfs_mount        *mp);   /* file system mount structure */
  77
  78/*
  79 * Pick an extent for allocation at the start of a new realtime file.
  80 * Use the sequence number stored in the atime field of the bitmap inode.
  81 * Translate this to a fraction of the rtextents, and return the product
  82 * of rtextents and the fraction.
  83 * The fraction sequence is 0, 1/2, 1/4, 3/4, 1/8, ..., 7/8, 1/16, ...
  84 */
  85int                                     /* error */
  86xfs_rtpick_extent(
  87        struct xfs_mount        *mp,    /* file system mount point */
  88        struct xfs_trans        *tp,    /* transaction pointer */
  89        xfs_extlen_t            len,    /* allocation length (rtextents) */
  90        xfs_rtblock_t           *pick); /* result rt extent */
  91
  92/*
  93 * Grow the realtime area of the filesystem.
  94 */
  95int
  96xfs_growfs_rt(
  97        struct xfs_mount        *mp,    /* file system mount structure */
  98        xfs_growfs_rt_t         *in);   /* user supplied growfs struct */
  99
 100/*
 101 * From xfs_rtbitmap.c
 102 */
 103int xfs_rtbuf_get(struct xfs_mount *mp, struct xfs_trans *tp,
 104                  xfs_rtblock_t block, int issum, struct xfs_buf **bpp);
 105int xfs_rtcheck_range(struct xfs_mount *mp, struct xfs_trans *tp,
 106                      xfs_rtblock_t start, xfs_extlen_t len, int val,
 107                      xfs_rtblock_t *new, int *stat);
 108int xfs_rtfind_back(struct xfs_mount *mp, struct xfs_trans *tp,
 109                    xfs_rtblock_t start, xfs_rtblock_t limit,
 110                    xfs_rtblock_t *rtblock);
 111int xfs_rtfind_forw(struct xfs_mount *mp, struct xfs_trans *tp,
 112                    xfs_rtblock_t start, xfs_rtblock_t limit,
 113                    xfs_rtblock_t *rtblock);
 114int xfs_rtmodify_range(struct xfs_mount *mp, struct xfs_trans *tp,
 115                       xfs_rtblock_t start, xfs_extlen_t len, int val);
 116int xfs_rtmodify_summary_int(struct xfs_mount *mp, struct xfs_trans *tp,
 117                             int log, xfs_rtblock_t bbno, int delta,
 118                             struct xfs_buf **rbpp, xfs_fsblock_t *rsb,
 119                             xfs_suminfo_t *sum);
 120int xfs_rtmodify_summary(struct xfs_mount *mp, struct xfs_trans *tp, int log,
 121                         xfs_rtblock_t bbno, int delta, struct xfs_buf **rbpp,
 122                         xfs_fsblock_t *rsb);
 123int xfs_rtfree_range(struct xfs_mount *mp, struct xfs_trans *tp,
 124                     xfs_rtblock_t start, xfs_extlen_t len,
 125                     struct xfs_buf **rbpp, xfs_fsblock_t *rsb);
 126int xfs_rtalloc_query_range(struct xfs_trans *tp,
 127                const struct xfs_rtalloc_rec *low_rec,
 128                const struct xfs_rtalloc_rec *high_rec,
 129                xfs_rtalloc_query_range_fn fn, void *priv);
 130int xfs_rtalloc_query_all(struct xfs_trans *tp,
 131                          xfs_rtalloc_query_range_fn fn,
 132                          void *priv);
 133bool xfs_verify_rtbno(struct xfs_mount *mp, xfs_rtblock_t rtbno);
 134int xfs_rtalloc_extent_is_free(struct xfs_mount *mp, struct xfs_trans *tp,
 135                               xfs_rtblock_t start, xfs_extlen_t len,
 136                               bool *is_free);
 137#else
 138# define xfs_rtallocate_extent(t,b,min,max,l,f,p,rb)    (ENOSYS)
 139# define xfs_rtfree_extent(t,b,l)                       (ENOSYS)
 140# define xfs_rtpick_extent(m,t,l,rb)                    (ENOSYS)
 141# define xfs_growfs_rt(mp,in)                           (ENOSYS)
 142# define xfs_rtalloc_query_range(t,l,h,f,p)             (ENOSYS)
 143# define xfs_rtalloc_query_all(t,f,p)                   (ENOSYS)
 144# define xfs_rtbuf_get(m,t,b,i,p)                       (ENOSYS)
 145# define xfs_verify_rtbno(m, r)                 (false)
 146# define xfs_rtalloc_extent_is_free(m,t,s,l,i)          (ENOSYS)
 147static inline int               /* error */
 148xfs_rtmount_init(
 149        xfs_mount_t     *mp)    /* file system mount structure */
 150{
 151        if (mp->m_sb.sb_rblocks == 0)
 152                return 0;
 153
 154        xfs_warn(mp, "Not built with CONFIG_XFS_RT");
 155        return -ENOSYS;
 156}
 157# define xfs_rtmount_inodes(m)  (((mp)->m_sb.sb_rblocks == 0)? 0 : (ENOSYS))
 158# define xfs_rtunmount_inodes(m)
 159#endif  /* CONFIG_XFS_RT */
 160
 161#endif  /* __XFS_RTALLOC_H__ */
 162