LXR linux/fs/xfs/libxfs/xfs

   1/* SPDX-License-Identifier: LGPL-2.1 */
   2/*
   3 * Copyright (c) 1995-2005 Silicon Graphics, Inc.
   4 * All Rights Reserved.
   5 */
   6#ifndef __XFS_FS_H__
   7#define __XFS_FS_H__
   8
   9/*
  10 * SGI's XFS filesystem's major stuff (constants, structures)
  11 */
  12
  13/*
  14 * Direct I/O attribute record used with XFS_IOC_DIOINFO
  15 * d_miniosz is the min xfer size, xfer size multiple and file seek offset
  16 * alignment.
  17 */
  18#ifndef HAVE_DIOATTR
  19struct dioattr {
  20        __u32           d_mem;          /* data buffer memory alignment */
  21        __u32           d_miniosz;      /* min xfer size                */
  22        __u32           d_maxiosz;      /* max xfer size                */
  23};
  24#endif
  25
  26/*
  27 * Structure for XFS_IOC_GETBMAP.
  28 * On input, fill in bmv_offset and bmv_length of the first structure
  29 * to indicate the area of interest in the file, and bmv_entries with
  30 * the number of array elements given back.  The first structure is
  31 * updated on return to give the offset and length for the next call.
  32 */
  33#ifndef HAVE_GETBMAP
  34struct getbmap {
  35        __s64           bmv_offset;     /* file offset of segment in blocks */
  36        __s64           bmv_block;      /* starting block (64-bit daddr_t)  */
  37        __s64           bmv_length;     /* length of segment, blocks        */
  38        __s32           bmv_count;      /* # of entries in array incl. 1st  */
  39        __s32           bmv_entries;    /* # of entries filled in (output)  */
  40};
  41#endif
  42
  43/*
  44 *      Structure for XFS_IOC_GETBMAPX.  Fields bmv_offset through bmv_entries
  45 *      are used exactly as in the getbmap structure.  The getbmapx structure
  46 *      has additional bmv_iflags and bmv_oflags fields. The bmv_iflags field
  47 *      is only used for the first structure.  It contains input flags
  48 *      specifying XFS_IOC_GETBMAPX actions.  The bmv_oflags field is filled
  49 *      in by the XFS_IOC_GETBMAPX command for each returned structure after
  50 *      the first.
  51 */
  52#ifndef HAVE_GETBMAPX
  53struct getbmapx {
  54        __s64           bmv_offset;     /* file offset of segment in blocks */
  55        __s64           bmv_block;      /* starting block (64-bit daddr_t)  */
  56        __s64           bmv_length;     /* length of segment, blocks        */
  57        __s32           bmv_count;      /* # of entries in array incl. 1st  */
  58        __s32           bmv_entries;    /* # of entries filled in (output). */
  59        __s32           bmv_iflags;     /* input flags (1st structure)      */
  60        __s32           bmv_oflags;     /* output flags (after 1st structure)*/
  61        __s32           bmv_unused1;    /* future use                       */
  62        __s32           bmv_unused2;    /* future use                       */
  63};
  64#endif
  65
  66/*      bmv_iflags values - set by XFS_IOC_GETBMAPX caller.     */
  67#define BMV_IF_ATTRFORK         0x1     /* return attr fork rather than data */
  68#define BMV_IF_NO_DMAPI_READ    0x2     /* Deprecated */
  69#define BMV_IF_PREALLOC         0x4     /* rtn status BMV_OF_PREALLOC if req */
  70#define BMV_IF_DELALLOC         0x8     /* rtn status BMV_OF_DELALLOC if req */
  71#define BMV_IF_NO_HOLES         0x10    /* Do not return holes */
  72#define BMV_IF_COWFORK          0x20    /* return CoW fork rather than data */
  73#define BMV_IF_VALID    \
  74        (BMV_IF_ATTRFORK|BMV_IF_NO_DMAPI_READ|BMV_IF_PREALLOC|  \
  75         BMV_IF_DELALLOC|BMV_IF_NO_HOLES|BMV_IF_COWFORK)
  76
  77/*      bmv_oflags values - returned for each non-header segment */
  78#define BMV_OF_PREALLOC         0x1     /* segment = unwritten pre-allocation */
  79#define BMV_OF_DELALLOC         0x2     /* segment = delayed allocation */
  80#define BMV_OF_LAST             0x4     /* segment is the last in the file */
  81#define BMV_OF_SHARED           0x8     /* segment shared with another file */
  82
  83/*      fmr_owner special values for FS_IOC_GETFSMAP */
  84#define XFS_FMR_OWN_FREE        FMR_OWN_FREE      /* free space */
  85#define XFS_FMR_OWN_UNKNOWN     FMR_OWN_UNKNOWN   /* unknown owner */
  86#define XFS_FMR_OWN_FS          FMR_OWNER('X', 1) /* static fs metadata */
  87#define XFS_FMR_OWN_LOG         FMR_OWNER('X', 2) /* journalling log */
  88#define XFS_FMR_OWN_AG          FMR_OWNER('X', 3) /* per-AG metadata */
  89#define XFS_FMR_OWN_INOBT       FMR_OWNER('X', 4) /* inode btree blocks */
  90#define XFS_FMR_OWN_INODES      FMR_OWNER('X', 5) /* inodes */
  91#define XFS_FMR_OWN_REFC        FMR_OWNER('X', 6) /* refcount tree */
  92#define XFS_FMR_OWN_COW         FMR_OWNER('X', 7) /* cow staging */
  93#define XFS_FMR_OWN_DEFECTIVE   FMR_OWNER('X', 8) /* bad blocks */
  94
  95/*
  96 * Structure for XFS_IOC_FSSETDM.
  97 * For use by backup and restore programs to set the XFS on-disk inode
  98 * fields di_dmevmask and di_dmstate.  These must be set to exactly and
  99 * only values previously obtained via xfs_bulkstat!  (Specifically the
 100 * struct xfs_bstat fields bs_dmevmask and bs_dmstate.)
 101 */
 102#ifndef HAVE_FSDMIDATA
 103struct fsdmidata {
 104        __u32           fsd_dmevmask;   /* corresponds to di_dmevmask */
 105        __u16           fsd_padding;
 106        __u16           fsd_dmstate;    /* corresponds to di_dmstate  */
 107};
 108#endif
 109
 110/*
 111 * File segment locking set data type for 64 bit access.
 112 * Also used for all the RESV/FREE interfaces.
 113 */
 114typedef struct xfs_flock64 {
 115        __s16           l_type;
 116        __s16           l_whence;
 117        __s64           l_start;
 118        __s64           l_len;          /* len == 0 means until end of file */
 119        __s32           l_sysid;
 120        __u32           l_pid;
 121        __s32           l_pad[4];       /* reserve area                     */
 122} xfs_flock64_t;
 123
 124/*
 125 * Output for XFS_IOC_FSGEOMETRY_V1
 126 */
 127struct xfs_fsop_geom_v1 {
 128        __u32           blocksize;      /* filesystem (data) block size */
 129        __u32           rtextsize;      /* realtime extent size         */
 130        __u32           agblocks;       /* fsblocks in an AG            */
 131        __u32           agcount;        /* number of allocation groups  */
 132        __u32           logblocks;      /* fsblocks in the log          */
 133        __u32           sectsize;       /* (data) sector size, bytes    */
 134        __u32           inodesize;      /* inode size in bytes          */
 135        __u32           imaxpct;        /* max allowed inode space(%)   */
 136        __u64           datablocks;     /* fsblocks in data subvolume   */
 137        __u64           rtblocks;       /* fsblocks in realtime subvol  */
 138        __u64           rtextents;      /* rt extents in realtime subvol*/
 139        __u64           logstart;       /* starting fsblock of the log  */
 140        unsigned char   uuid[16];       /* unique id of the filesystem  */
 141        __u32           sunit;          /* stripe unit, fsblocks        */
 142        __u32           swidth;         /* stripe width, fsblocks       */
 143        __s32           version;        /* structure version            */
 144        __u32           flags;          /* superblock version flags     */
 145        __u32           logsectsize;    /* log sector size, bytes       */
 146        __u32           rtsectsize;     /* realtime sector size, bytes  */
 147        __u32           dirblocksize;   /* directory block size, bytes  */
 148};
 149
 150/*
 151 * Output for XFS_IOC_FSGEOMETRY_V4
 152 */
 153struct xfs_fsop_geom_v4 {
 154        __u32           blocksize;      /* filesystem (data) block size */
 155        __u32           rtextsize;      /* realtime extent size         */
 156        __u32           agblocks;       /* fsblocks in an AG            */
 157        __u32           agcount;        /* number of allocation groups  */
 158        __u32           logblocks;      /* fsblocks in the log          */
 159        __u32           sectsize;       /* (data) sector size, bytes    */
 160        __u32           inodesize;      /* inode size in bytes          */
 161        __u32           imaxpct;        /* max allowed inode space(%)   */
 162        __u64           datablocks;     /* fsblocks in data subvolume   */
 163        __u64           rtblocks;       /* fsblocks in realtime subvol  */
 164        __u64           rtextents;      /* rt extents in realtime subvol*/
 165        __u64           logstart;       /* starting fsblock of the log  */
 166        unsigned char   uuid[16];       /* unique id of the filesystem  */
 167        __u32           sunit;          /* stripe unit, fsblocks        */
 168        __u32           swidth;         /* stripe width, fsblocks       */
 169        __s32           version;        /* structure version            */
 170        __u32           flags;          /* superblock version flags     */
 171        __u32           logsectsize;    /* log sector size, bytes       */
 172        __u32           rtsectsize;     /* realtime sector size, bytes  */
 173        __u32           dirblocksize;   /* directory block size, bytes  */
 174        __u32           logsunit;       /* log stripe unit, bytes       */
 175};
 176
 177/*
 178 * Output for XFS_IOC_FSGEOMETRY
 179 */
 180struct xfs_fsop_geom {
 181        __u32           blocksize;      /* filesystem (data) block size */
 182        __u32           rtextsize;      /* realtime extent size         */
 183        __u32           agblocks;       /* fsblocks in an AG            */
 184        __u32           agcount;        /* number of allocation groups  */
 185        __u32           logblocks;      /* fsblocks in the log          */
 186        __u32           sectsize;       /* (data) sector size, bytes    */
 187        __u32           inodesize;      /* inode size in bytes          */
 188        __u32           imaxpct;        /* max allowed inode space(%)   */
 189        __u64           datablocks;     /* fsblocks in data subvolume   */
 190        __u64           rtblocks;       /* fsblocks in realtime subvol  */
 191        __u64           rtextents;      /* rt extents in realtime subvol*/
 192        __u64           logstart;       /* starting fsblock of the log  */
 193        unsigned char   uuid[16];       /* unique id of the filesystem  */
 194        __u32           sunit;          /* stripe unit, fsblocks        */
 195        __u32           swidth;         /* stripe width, fsblocks       */
 196        __s32           version;        /* structure version            */
 197        __u32           flags;          /* superblock version flags     */
 198        __u32           logsectsize;    /* log sector size, bytes       */
 199        __u32           rtsectsize;     /* realtime sector size, bytes  */
 200        __u32           dirblocksize;   /* directory block size, bytes  */
 201        __u32           logsunit;       /* log stripe unit, bytes       */
 202        uint32_t        sick;           /* o: unhealthy fs & rt metadata */
 203        uint32_t        checked;        /* o: checked fs & rt metadata  */
 204        __u64           reserved[17];   /* reserved space               */
 205};
 206
 207#define XFS_FSOP_GEOM_SICK_COUNTERS     (1 << 0)  /* summary counters */
 208#define XFS_FSOP_GEOM_SICK_UQUOTA       (1 << 1)  /* user quota */
 209#define XFS_FSOP_GEOM_SICK_GQUOTA       (1 << 2)  /* group quota */
 210#define XFS_FSOP_GEOM_SICK_PQUOTA       (1 << 3)  /* project quota */
 211#define XFS_FSOP_GEOM_SICK_RT_BITMAP    (1 << 4)  /* realtime bitmap */
 212#define XFS_FSOP_GEOM_SICK_RT_SUMMARY   (1 << 5)  /* realtime summary */
 213
 214/* Output for XFS_FS_COUNTS */
 215typedef struct xfs_fsop_counts {
 216        __u64   freedata;       /* free data section blocks */
 217        __u64   freertx;        /* free rt extents */
 218        __u64   freeino;        /* free inodes */
 219        __u64   allocino;       /* total allocated inodes */
 220} xfs_fsop_counts_t;
 221
 222/* Input/Output for XFS_GET_RESBLKS and XFS_SET_RESBLKS */
 223typedef struct xfs_fsop_resblks {
 224        __u64  resblks;
 225        __u64  resblks_avail;
 226} xfs_fsop_resblks_t;
 227
 228#define XFS_FSOP_GEOM_VERSION           0
 229#define XFS_FSOP_GEOM_VERSION_V5        5
 230
 231#define XFS_FSOP_GEOM_FLAGS_ATTR        (1 << 0)  /* attributes in use     */
 232#define XFS_FSOP_GEOM_FLAGS_NLINK       (1 << 1)  /* 32-bit nlink values   */
 233#define XFS_FSOP_GEOM_FLAGS_QUOTA       (1 << 2)  /* quotas enabled        */
 234#define XFS_FSOP_GEOM_FLAGS_IALIGN      (1 << 3)  /* inode alignment       */
 235#define XFS_FSOP_GEOM_FLAGS_DALIGN      (1 << 4)  /* large data alignment  */
 236#define XFS_FSOP_GEOM_FLAGS_SHARED      (1 << 5)  /* read-only shared      */
 237#define XFS_FSOP_GEOM_FLAGS_EXTFLG      (1 << 6)  /* special extent flag   */
 238#define XFS_FSOP_GEOM_FLAGS_DIRV2       (1 << 7)  /* directory version 2   */
 239#define XFS_FSOP_GEOM_FLAGS_LOGV2       (1 << 8)  /* log format version 2  */
 240#define XFS_FSOP_GEOM_FLAGS_SECTOR      (1 << 9)  /* sector sizes >1BB     */
 241#define XFS_FSOP_GEOM_FLAGS_ATTR2       (1 << 10) /* inline attributes rework */
 242#define XFS_FSOP_GEOM_FLAGS_PROJID32    (1 << 11) /* 32-bit project IDs    */
 243#define XFS_FSOP_GEOM_FLAGS_DIRV2CI     (1 << 12) /* ASCII only CI names   */
 244        /*  -- Do not use --            (1 << 13)    SGI parent pointers   */
 245#define XFS_FSOP_GEOM_FLAGS_LAZYSB      (1 << 14) /* lazy superblock counters */
 246#define XFS_FSOP_GEOM_FLAGS_V5SB        (1 << 15) /* version 5 superblock  */
 247#define XFS_FSOP_GEOM_FLAGS_FTYPE       (1 << 16) /* inode directory types */
 248#define XFS_FSOP_GEOM_FLAGS_FINOBT      (1 << 17) /* free inode btree      */
 249#define XFS_FSOP_GEOM_FLAGS_SPINODES    (1 << 18) /* sparse inode chunks   */
 250#define XFS_FSOP_GEOM_FLAGS_RMAPBT      (1 << 19) /* reverse mapping btree */
 251#define XFS_FSOP_GEOM_FLAGS_REFLINK     (1 << 20) /* files can share blocks */
 252#define XFS_FSOP_GEOM_FLAGS_BIGTIME     (1 << 21) /* 64-bit nsec timestamps */
 253#define XFS_FSOP_GEOM_FLAGS_INOBTCNT    (1 << 22) /* inobt btree counter */
 254
 255/*
 256 * Minimum and maximum sizes need for growth checks.
 257 *
 258 * Block counts are in units of filesystem blocks, not basic blocks.
 259 */
 260#define XFS_MIN_AG_BLOCKS       64
 261#define XFS_MIN_LOG_BLOCKS      512ULL
 262#define XFS_MAX_LOG_BLOCKS      (1024 * 1024ULL)
 263#define XFS_MIN_LOG_BYTES       (10 * 1024 * 1024ULL)
 264
 265/*
 266 * Limits on sb_agblocks/sb_agblklog -- mkfs won't format AGs smaller than
 267 * 16MB or larger than 1TB.
 268 */
 269#define XFS_MIN_AG_BYTES        (1ULL << 24)    /* 16 MB */
 270#define XFS_MAX_AG_BYTES        (1ULL << 40)    /* 1 TB */
 271
 272/* keep the maximum size under 2^31 by a small amount */
 273#define XFS_MAX_LOG_BYTES \
 274        ((2 * 1024 * 1024 * 1024ULL) - XFS_MIN_LOG_BYTES)
 275
 276/* Used for sanity checks on superblock */
 277#define XFS_MAX_DBLOCKS(s) ((xfs_rfsblock_t)(s)->sb_agcount * (s)->sb_agblocks)
 278#define XFS_MIN_DBLOCKS(s) ((xfs_rfsblock_t)((s)->sb_agcount - 1) *     \
 279                         (s)->sb_agblocks + XFS_MIN_AG_BLOCKS)
 280
 281/*
 282 * Output for XFS_IOC_AG_GEOMETRY
 283 */
 284struct xfs_ag_geometry {
 285        uint32_t        ag_number;      /* i/o: AG number */
 286        uint32_t        ag_length;      /* o: length in blocks */
 287        uint32_t        ag_freeblks;    /* o: free space */
 288        uint32_t        ag_icount;      /* o: inodes allocated */
 289        uint32_t        ag_ifree;       /* o: inodes free */
 290        uint32_t        ag_sick;        /* o: sick things in ag */
 291        uint32_t        ag_checked;     /* o: checked metadata in ag */
 292        uint32_t        ag_flags;       /* i/o: flags for this ag */
 293        uint64_t        ag_reserved[12];/* o: zero */
 294};
 295#define XFS_AG_GEOM_SICK_SB     (1 << 0)  /* superblock */
 296#define XFS_AG_GEOM_SICK_AGF    (1 << 1)  /* AGF header */
 297#define XFS_AG_GEOM_SICK_AGFL   (1 << 2)  /* AGFL header */
 298#define XFS_AG_GEOM_SICK_AGI    (1 << 3)  /* AGI header */
 299#define XFS_AG_GEOM_SICK_BNOBT  (1 << 4)  /* free space by block */
 300#define XFS_AG_GEOM_SICK_CNTBT  (1 << 5)  /* free space by length */
 301#define XFS_AG_GEOM_SICK_INOBT  (1 << 6)  /* inode index */
 302#define XFS_AG_GEOM_SICK_FINOBT (1 << 7)  /* free inode index */
 303#define XFS_AG_GEOM_SICK_RMAPBT (1 << 8)  /* reverse mappings */
 304#define XFS_AG_GEOM_SICK_REFCNTBT (1 << 9)  /* reference counts */
 305
 306/*
 307 * Structures for XFS_IOC_FSGROWFSDATA, XFS_IOC_FSGROWFSLOG & XFS_IOC_FSGROWFSRT
 308 */
 309typedef struct xfs_growfs_data {
 310        __u64           newblocks;      /* new data subvol size, fsblocks */
 311        __u32           imaxpct;        /* new inode space percentage limit */
 312} xfs_growfs_data_t;
 313
 314typedef struct xfs_growfs_log {
 315        __u32           newblocks;      /* new log size, fsblocks */
 316        __u32           isint;          /* 1 if new log is internal */
 317} xfs_growfs_log_t;
 318
 319typedef struct xfs_growfs_rt {
 320        __u64           newblocks;      /* new realtime size, fsblocks */
 321        __u32           extsize;        /* new realtime extent size, fsblocks */
 322} xfs_growfs_rt_t;
 323
 324
 325/*
 326 * Structures returned from ioctl XFS_IOC_FSBULKSTAT & XFS_IOC_FSBULKSTAT_SINGLE
 327 */
 328typedef struct xfs_bstime {
 329        __kernel_long_t tv_sec;         /* seconds              */
 330        __s32           tv_nsec;        /* and nanoseconds      */
 331} xfs_bstime_t;
 332
 333struct xfs_bstat {
 334        __u64           bs_ino;         /* inode number                 */
 335        __u16           bs_mode;        /* type and mode                */
 336        __u16           bs_nlink;       /* number of links              */
 337        __u32           bs_uid;         /* user id                      */
 338        __u32           bs_gid;         /* group id                     */
 339        __u32           bs_rdev;        /* device value                 */
 340        __s32           bs_blksize;     /* block size                   */
 341        __s64           bs_size;        /* file size                    */
 342        xfs_bstime_t    bs_atime;       /* access time                  */
 343        xfs_bstime_t    bs_mtime;       /* modify time                  */
 344        xfs_bstime_t    bs_ctime;       /* inode change time            */
 345        int64_t         bs_blocks;      /* number of blocks             */
 346        __u32           bs_xflags;      /* extended flags               */
 347        __s32           bs_extsize;     /* extent size                  */
 348        __s32           bs_extents;     /* number of extents            */
 349        __u32           bs_gen;         /* generation count             */
 350        __u16           bs_projid_lo;   /* lower part of project id     */
 351#define bs_projid       bs_projid_lo    /* (previously just bs_projid)  */
 352        __u16           bs_forkoff;     /* inode fork offset in bytes   */
 353        __u16           bs_projid_hi;   /* higher part of project id    */
 354        uint16_t        bs_sick;        /* sick inode metadata          */
 355        uint16_t        bs_checked;     /* checked inode metadata       */
 356        unsigned char   bs_pad[2];      /* pad space, unused            */
 357        __u32           bs_cowextsize;  /* cow extent size              */
 358        __u32           bs_dmevmask;    /* DMIG event mask              */
 359        __u16           bs_dmstate;     /* DMIG state info              */
 360        __u16           bs_aextents;    /* attribute number of extents  */
 361};
 362
 363/* New bulkstat structure that reports v5 features and fixes padding issues */
 364struct xfs_bulkstat {
 365        uint64_t        bs_ino;         /* inode number                 */
 366        uint64_t        bs_size;        /* file size                    */
 367
 368        uint64_t        bs_blocks;      /* number of blocks             */
 369        uint64_t        bs_xflags;      /* extended flags               */
 370
 371        int64_t         bs_atime;       /* access time, seconds         */
 372        int64_t         bs_mtime;       /* modify time, seconds         */
 373
 374        int64_t         bs_ctime;       /* inode change time, seconds   */
 375        int64_t         bs_btime;       /* creation time, seconds       */
 376
 377        uint32_t        bs_gen;         /* generation count             */
 378        uint32_t        bs_uid;         /* user id                      */
 379        uint32_t        bs_gid;         /* group id                     */
 380        uint32_t        bs_projectid;   /* project id                   */
 381
 382        uint32_t        bs_atime_nsec;  /* access time, nanoseconds     */
 383        uint32_t        bs_mtime_nsec;  /* modify time, nanoseconds     */
 384        uint32_t        bs_ctime_nsec;  /* inode change time, nanoseconds */
 385        uint32_t        bs_btime_nsec;  /* creation time, nanoseconds   */
 386
 387        uint32_t        bs_blksize;     /* block size                   */
 388        uint32_t        bs_rdev;        /* device value                 */
 389        uint32_t        bs_cowextsize_blks; /* cow extent size hint, blocks */
 390        uint32_t        bs_extsize_blks; /* extent size hint, blocks    */
 391
 392        uint32_t        bs_nlink;       /* number of links              */
 393        uint32_t        bs_extents;     /* number of extents            */
 394        uint32_t        bs_aextents;    /* attribute number of extents  */
 395        uint16_t        bs_version;     /* structure version            */
 396        uint16_t        bs_forkoff;     /* inode fork offset in bytes   */
 397
 398        uint16_t        bs_sick;        /* sick inode metadata          */
 399        uint16_t        bs_checked;     /* checked inode metadata       */
 400        uint16_t        bs_mode;        /* type and mode                */
 401        uint16_t        bs_pad2;        /* zeroed                       */
 402
 403        uint64_t        bs_pad[7];      /* zeroed                       */
 404};
 405
 406#define XFS_BULKSTAT_VERSION_V1 (1)
 407#define XFS_BULKSTAT_VERSION_V5 (5)
 408
 409/* bs_sick flags */
 410#define XFS_BS_SICK_INODE       (1 << 0)  /* inode core */
 411#define XFS_BS_SICK_BMBTD       (1 << 1)  /* data fork */
 412#define XFS_BS_SICK_BMBTA       (1 << 2)  /* attr fork */
 413#define XFS_BS_SICK_BMBTC       (1 << 3)  /* cow fork */
 414#define XFS_BS_SICK_DIR         (1 << 4)  /* directory */
 415#define XFS_BS_SICK_XATTR       (1 << 5)  /* extended attributes */
 416#define XFS_BS_SICK_SYMLINK     (1 << 6)  /* symbolic link remote target */
 417#define XFS_BS_SICK_PARENT      (1 << 7)  /* parent pointers */
 418
 419/*
 420 * Project quota id helpers (previously projid was 16bit only
 421 * and using two 16bit values to hold new 32bit projid was chosen
 422 * to retain compatibility with "old" filesystems).
 423 */
 424static inline uint32_t
 425bstat_get_projid(const struct xfs_bstat *bs)
 426{
 427        return (uint32_t)bs->bs_projid_hi << 16 | bs->bs_projid_lo;
 428}
 429
 430/*
 431 * The user-level BulkStat Request interface structure.
 432 */
 433struct xfs_fsop_bulkreq {
 434        __u64           __user *lastip; /* last inode # pointer         */
 435        __s32           icount;         /* count of entries in buffer   */
 436        void            __user *ubuffer;/* user buffer for inode desc.  */
 437        __s32           __user *ocount; /* output count pointer         */
 438};
 439
 440/*
 441 * Structures returned from xfs_inumbers routine (XFS_IOC_FSINUMBERS).
 442 */
 443struct xfs_inogrp {
 444        __u64           xi_startino;    /* starting inode number        */
 445        __s32           xi_alloccount;  /* # bits set in allocmask      */
 446        __u64           xi_allocmask;   /* mask of allocated inodes     */
 447};
 448
 449/* New inumbers structure that reports v5 features and fixes padding issues */
 450struct xfs_inumbers {
 451        uint64_t        xi_startino;    /* starting inode number        */
 452        uint64_t        xi_allocmask;   /* mask of allocated inodes     */
 453        uint8_t         xi_alloccount;  /* # bits set in allocmask      */
 454        uint8_t         xi_version;     /* version                      */
 455        uint8_t         xi_padding[6];  /* zero                         */
 456};
 457
 458#define XFS_INUMBERS_VERSION_V1 (1)
 459#define XFS_INUMBERS_VERSION_V5 (5)
 460
 461/* Header for bulk inode requests. */
 462struct xfs_bulk_ireq {
 463        uint64_t        ino;            /* I/O: start with this inode   */
 464        uint32_t        flags;          /* I/O: operation flags         */
 465        uint32_t        icount;         /* I: count of entries in buffer */
 466        uint32_t        ocount;         /* O: count of entries filled out */
 467        uint32_t        agno;           /* I: see comment for IREQ_AGNO */
 468        uint64_t        reserved[5];    /* must be zero                 */
 469};
 470
 471/*
 472 * Only return results from the specified @agno.  If @ino is zero, start
 473 * with the first inode of @agno.
 474 */
 475#define XFS_BULK_IREQ_AGNO      (1 << 0)
 476
 477/*
 478 * Return bulkstat information for a single inode, where @ino value is a
 479 * special value, not a literal inode number.  See the XFS_BULK_IREQ_SPECIAL_*
 480 * values below.  Not compatible with XFS_BULK_IREQ_AGNO.
 481 */
 482#define XFS_BULK_IREQ_SPECIAL   (1 << 1)
 483
 484#define XFS_BULK_IREQ_FLAGS_ALL (XFS_BULK_IREQ_AGNO | \
 485                                 XFS_BULK_IREQ_SPECIAL)
 486
 487/* Operate on the root directory inode. */
 488#define XFS_BULK_IREQ_SPECIAL_ROOT      (1)
 489
 490/*
 491 * ioctl structures for v5 bulkstat and inumbers requests
 492 */
 493struct xfs_bulkstat_req {
 494        struct xfs_bulk_ireq    hdr;
 495        struct xfs_bulkstat     bulkstat[];
 496};
 497#define XFS_BULKSTAT_REQ_SIZE(nr)       (sizeof(struct xfs_bulkstat_req) + \
 498                                         (nr) * sizeof(struct xfs_bulkstat))
 499
 500struct xfs_inumbers_req {
 501        struct xfs_bulk_ireq    hdr;
 502        struct xfs_inumbers     inumbers[];
 503};
 504#define XFS_INUMBERS_REQ_SIZE(nr)       (sizeof(struct xfs_inumbers_req) + \
 505                                         (nr) * sizeof(struct xfs_inumbers))
 506
 507/*
 508 * Error injection.
 509 */
 510typedef struct xfs_error_injection {
 511        __s32           fd;
 512        __s32           errtag;
 513} xfs_error_injection_t;
 514
 515
 516/*
 517 * Speculative preallocation trimming.
 518 */
 519#define XFS_EOFBLOCKS_VERSION           1
 520struct xfs_fs_eofblocks {
 521        __u32           eof_version;
 522        __u32           eof_flags;
 523        uid_t           eof_uid;
 524        gid_t           eof_gid;
 525        prid_t          eof_prid;
 526        __u32           pad32;
 527        __u64           eof_min_file_size;
 528        __u64           pad64[12];
 529};
 530
 531/* eof_flags values */
 532#define XFS_EOF_FLAGS_SYNC              (1 << 0) /* sync/wait mode scan */
 533#define XFS_EOF_FLAGS_UID               (1 << 1) /* filter by uid */
 534#define XFS_EOF_FLAGS_GID               (1 << 2) /* filter by gid */
 535#define XFS_EOF_FLAGS_PRID              (1 << 3) /* filter by project id */
 536#define XFS_EOF_FLAGS_MINFILESIZE       (1 << 4) /* filter by min file size */
 537#define XFS_EOF_FLAGS_UNION             (1 << 5) /* union filter algorithm;
 538                                                  * kernel only, not included in
 539                                                  * valid mask */
 540#define XFS_EOF_FLAGS_VALID     \
 541        (XFS_EOF_FLAGS_SYNC |   \
 542         XFS_EOF_FLAGS_UID |    \
 543         XFS_EOF_FLAGS_GID |    \
 544         XFS_EOF_FLAGS_PRID |   \
 545         XFS_EOF_FLAGS_MINFILESIZE)
 546
 547
 548/*
 549 * The user-level Handle Request interface structure.
 550 */
 551typedef struct xfs_fsop_handlereq {
 552        __u32           fd;             /* fd for FD_TO_HANDLE          */
 553        void            __user *path;   /* user pathname                */
 554        __u32           oflags;         /* open flags                   */
 555        void            __user *ihandle;/* user supplied handle         */
 556        __u32           ihandlen;       /* user supplied length         */
 557        void            __user *ohandle;/* user buffer for handle       */
 558        __u32           __user *ohandlen;/* user buffer length          */
 559} xfs_fsop_handlereq_t;
 560
 561/*
 562 * Compound structures for passing args through Handle Request interfaces
 563 * xfs_fssetdm_by_handle, xfs_attrlist_by_handle, xfs_attrmulti_by_handle
 564 * - ioctls: XFS_IOC_FSSETDM_BY_HANDLE, XFS_IOC_ATTRLIST_BY_HANDLE, and
 565 *           XFS_IOC_ATTRMULTI_BY_HANDLE
 566 */
 567
 568typedef struct xfs_fsop_setdm_handlereq {
 569        struct xfs_fsop_handlereq       hreq;   /* handle information   */
 570        struct fsdmidata                __user *data;   /* DMAPI data   */
 571} xfs_fsop_setdm_handlereq_t;
 572
 573/*
 574 * Flags passed in xfs_attr_multiop.am_flags for the attr ioctl interface.
 575 *
 576 * NOTE: Must match the values declared in libattr without the XFS_IOC_ prefix.
 577 */
 578#define XFS_IOC_ATTR_ROOT       0x0002  /* use attrs in root namespace */
 579#define XFS_IOC_ATTR_SECURE     0x0008  /* use attrs in security namespace */
 580#define XFS_IOC_ATTR_CREATE     0x0010  /* fail if attr already exists */
 581#define XFS_IOC_ATTR_REPLACE    0x0020  /* fail if attr does not exist */
 582
 583typedef struct xfs_attrlist_cursor {
 584        __u32           opaque[4];
 585} xfs_attrlist_cursor_t;
 586
 587/*
 588 * Define how lists of attribute names are returned to userspace from the
 589 * XFS_IOC_ATTRLIST_BY_HANDLE ioctl.  struct xfs_attrlist is the header at the
 590 * beginning of the returned buffer, and a each entry in al_offset contains the
 591 * relative offset of an xfs_attrlist_ent containing the actual entry.
 592 *
 593 * NOTE: struct xfs_attrlist must match struct attrlist defined in libattr, and
 594 * struct xfs_attrlist_ent must match struct attrlist_ent defined in libattr.
 595 */
 596struct xfs_attrlist {
 597        __s32   al_count;       /* number of entries in attrlist */
 598        __s32   al_more;        /* T/F: more attrs (do call again) */
 599        __s32   al_offset[1];   /* byte offsets of attrs [var-sized] */
 600};
 601
 602struct xfs_attrlist_ent {       /* data from attr_list() */
 603        __u32   a_valuelen;     /* number bytes in value of attr */
 604        char    a_name[1];      /* attr name (NULL terminated) */
 605};
 606
 607typedef struct xfs_fsop_attrlist_handlereq {
 608        struct xfs_fsop_handlereq       hreq; /* handle interface structure */
 609        struct xfs_attrlist_cursor      pos; /* opaque cookie, list offset */
 610        __u32                           flags;  /* which namespace to use */
 611        __u32                           buflen; /* length of buffer supplied */
 612        void                            __user *buffer; /* returned names */
 613} xfs_fsop_attrlist_handlereq_t;
 614
 615typedef struct xfs_attr_multiop {
 616        __u32           am_opcode;
 617#define ATTR_OP_GET     1       /* return the indicated attr's value */
 618#define ATTR_OP_SET     2       /* set/create the indicated attr/value pair */
 619#define ATTR_OP_REMOVE  3       /* remove the indicated attr */
 620        __s32           am_error;
 621        void            __user *am_attrname;
 622        void            __user *am_attrvalue;
 623        __u32           am_length;
 624        __u32           am_flags; /* XFS_IOC_ATTR_* */
 625} xfs_attr_multiop_t;
 626
 627typedef struct xfs_fsop_attrmulti_handlereq {
 628        struct xfs_fsop_handlereq       hreq; /* handle interface structure */
 629        __u32                           opcount;/* count of following multiop */
 630        struct xfs_attr_multiop         __user *ops; /* attr_multi data */
 631} xfs_fsop_attrmulti_handlereq_t;
 632
 633/*
 634 * per machine unique filesystem identifier types.
 635 */
 636typedef struct { __u32 val[2]; } xfs_fsid_t; /* file system id type */
 637
 638typedef struct xfs_fid {
 639        __u16   fid_len;                /* length of remainder  */
 640        __u16   fid_pad;
 641        __u32   fid_gen;                /* generation number    */
 642        __u64   fid_ino;                /* 64 bits inode number */
 643} xfs_fid_t;
 644
 645typedef struct xfs_handle {
 646        union {
 647                __s64       align;      /* force alignment of ha_fid     */
 648                xfs_fsid_t  _ha_fsid;   /* unique file system identifier */
 649        } ha_u;
 650        xfs_fid_t       ha_fid;         /* file system specific file ID  */
 651} xfs_handle_t;
 652#define ha_fsid ha_u._ha_fsid
 653
 654/*
 655 * Structure passed to XFS_IOC_SWAPEXT
 656 */
 657typedef struct xfs_swapext
 658{
 659        int64_t         sx_version;     /* version */
 660#define XFS_SX_VERSION          0
 661        int64_t         sx_fdtarget;    /* fd of target file */
 662        int64_t         sx_fdtmp;       /* fd of tmp file */
 663        xfs_off_t       sx_offset;      /* offset into file */
 664        xfs_off_t       sx_length;      /* leng from offset */
 665        char            sx_pad[16];     /* pad space, unused */
 666        struct xfs_bstat sx_stat;       /* stat of target b4 copy */
 667} xfs_swapext_t;
 668
 669/*
 670 * Flags for going down operation
 671 */
 672#define XFS_FSOP_GOING_FLAGS_DEFAULT            0x0     /* going down */
 673#define XFS_FSOP_GOING_FLAGS_LOGFLUSH           0x1     /* flush log but not data */
 674#define XFS_FSOP_GOING_FLAGS_NOLOGFLUSH         0x2     /* don't flush log nor data */
 675
 676/* metadata scrubbing */
 677struct xfs_scrub_metadata {
 678        __u32 sm_type;          /* What to check? */
 679        __u32 sm_flags;         /* flags; see below. */
 680        __u64 sm_ino;           /* inode number. */
 681        __u32 sm_gen;           /* inode generation. */
 682        __u32 sm_agno;          /* ag number. */
 683        __u64 sm_reserved[5];   /* pad to 64 bytes */
 684};
 685
 686/*
 687 * Metadata types and flags for scrub operation.
 688 */
 689
 690/* Scrub subcommands. */
 691#define XFS_SCRUB_TYPE_PROBE    0       /* presence test ioctl */
 692#define XFS_SCRUB_TYPE_SB       1       /* superblock */
 693#define XFS_SCRUB_TYPE_AGF      2       /* AG free header */
 694#define XFS_SCRUB_TYPE_AGFL     3       /* AG free list */
 695#define XFS_SCRUB_TYPE_AGI      4       /* AG inode header */
 696#define XFS_SCRUB_TYPE_BNOBT    5       /* freesp by block btree */
 697#define XFS_SCRUB_TYPE_CNTBT    6       /* freesp by length btree */
 698#define XFS_SCRUB_TYPE_INOBT    7       /* inode btree */
 699#define XFS_SCRUB_TYPE_FINOBT   8       /* free inode btree */
 700#define XFS_SCRUB_TYPE_RMAPBT   9       /* reverse mapping btree */
 701#define XFS_SCRUB_TYPE_REFCNTBT 10      /* reference count btree */
 702#define XFS_SCRUB_TYPE_INODE    11      /* inode record */
 703#define XFS_SCRUB_TYPE_BMBTD    12      /* data fork block mapping */
 704#define XFS_SCRUB_TYPE_BMBTA    13      /* attr fork block mapping */
 705#define XFS_SCRUB_TYPE_BMBTC    14      /* CoW fork block mapping */
 706#define XFS_SCRUB_TYPE_DIR      15      /* directory */
 707#define XFS_SCRUB_TYPE_XATTR    16      /* extended attribute */
 708#define XFS_SCRUB_TYPE_SYMLINK  17      /* symbolic link */
 709#define XFS_SCRUB_TYPE_PARENT   18      /* parent pointers */
 710#define XFS_SCRUB_TYPE_RTBITMAP 19      /* realtime bitmap */
 711#define XFS_SCRUB_TYPE_RTSUM    20      /* realtime summary */
 712#define XFS_SCRUB_TYPE_UQUOTA   21      /* user quotas */
 713#define XFS_SCRUB_TYPE_GQUOTA   22      /* group quotas */
 714#define XFS_SCRUB_TYPE_PQUOTA   23      /* project quotas */
 715#define XFS_SCRUB_TYPE_FSCOUNTERS 24    /* fs summary counters */
 716
 717/* Number of scrub subcommands. */
 718#define XFS_SCRUB_TYPE_NR       25
 719
 720/* i: Repair this metadata. */
 721#define XFS_SCRUB_IFLAG_REPAIR          (1 << 0)
 722
 723/* o: Metadata object needs repair. */
 724#define XFS_SCRUB_OFLAG_CORRUPT         (1 << 1)
 725
 726/*
 727 * o: Metadata object could be optimized.  It's not corrupt, but
 728 *    we could improve on it somehow.
 729 */
 730#define XFS_SCRUB_OFLAG_PREEN           (1 << 2)
 731
 732/* o: Cross-referencing failed. */
 733#define XFS_SCRUB_OFLAG_XFAIL           (1 << 3)
 734
 735/* o: Metadata object disagrees with cross-referenced metadata. */
 736#define XFS_SCRUB_OFLAG_XCORRUPT        (1 << 4)
 737
 738/* o: Scan was not complete. */
 739#define XFS_SCRUB_OFLAG_INCOMPLETE      (1 << 5)
 740
 741/* o: Metadata object looked funny but isn't corrupt. */
 742#define XFS_SCRUB_OFLAG_WARNING         (1 << 6)
 743
 744/*
 745 * o: IFLAG_REPAIR was set but metadata object did not need fixing or
 746 *    optimization and has therefore not been altered.
 747 */
 748#define XFS_SCRUB_OFLAG_NO_REPAIR_NEEDED (1 << 7)
 749
 750#define XFS_SCRUB_FLAGS_IN      (XFS_SCRUB_IFLAG_REPAIR)
 751#define XFS_SCRUB_FLAGS_OUT     (XFS_SCRUB_OFLAG_CORRUPT | \
 752                                 XFS_SCRUB_OFLAG_PREEN | \
 753                                 XFS_SCRUB_OFLAG_XFAIL | \
 754                                 XFS_SCRUB_OFLAG_XCORRUPT | \
 755                                 XFS_SCRUB_OFLAG_INCOMPLETE | \
 756                                 XFS_SCRUB_OFLAG_WARNING | \
 757                                 XFS_SCRUB_OFLAG_NO_REPAIR_NEEDED)
 758#define XFS_SCRUB_FLAGS_ALL     (XFS_SCRUB_FLAGS_IN | XFS_SCRUB_FLAGS_OUT)
 759
 760/*
 761 * ioctl limits
 762 */
 763#ifdef XATTR_LIST_MAX
 764#  define XFS_XATTR_LIST_MAX XATTR_LIST_MAX
 765#else
 766#  define XFS_XATTR_LIST_MAX 65536
 767#endif
 768
 769
 770/*
 771 * ioctl commands that are used by Linux filesystems
 772 */
 773#define XFS_IOC_GETXFLAGS       FS_IOC_GETFLAGS
 774#define XFS_IOC_SETXFLAGS       FS_IOC_SETFLAGS
 775#define XFS_IOC_GETVERSION      FS_IOC_GETVERSION
 776
 777/*
 778 * ioctl commands that replace IRIX fcntl()'s
 779 * For 'documentation' purposed more than anything else,
 780 * the "cmd #" field reflects the IRIX fcntl number.
 781 */
 782#define XFS_IOC_ALLOCSP         _IOW ('X', 10, struct xfs_flock64)
 783#define XFS_IOC_FREESP          _IOW ('X', 11, struct xfs_flock64)
 784#define XFS_IOC_DIOINFO         _IOR ('X', 30, struct dioattr)
 785#define XFS_IOC_FSGETXATTR      FS_IOC_FSGETXATTR
 786#define XFS_IOC_FSSETXATTR      FS_IOC_FSSETXATTR
 787#define XFS_IOC_ALLOCSP64       _IOW ('X', 36, struct xfs_flock64)
 788#define XFS_IOC_FREESP64        _IOW ('X', 37, struct xfs_flock64)
 789#define XFS_IOC_GETBMAP         _IOWR('X', 38, struct getbmap)
 790#define XFS_IOC_FSSETDM         _IOW ('X', 39, struct fsdmidata)
 791#define XFS_IOC_RESVSP          _IOW ('X', 40, struct xfs_flock64)
 792#define XFS_IOC_UNRESVSP        _IOW ('X', 41, struct xfs_flock64)
 793#define XFS_IOC_RESVSP64        _IOW ('X', 42, struct xfs_flock64)
 794#define XFS_IOC_UNRESVSP64      _IOW ('X', 43, struct xfs_flock64)
 795#define XFS_IOC_GETBMAPA        _IOWR('X', 44, struct getbmap)
 796#define XFS_IOC_FSGETXATTRA     _IOR ('X', 45, struct fsxattr)
 797/*      XFS_IOC_SETBIOSIZE ---- deprecated 46      */
 798/*      XFS_IOC_GETBIOSIZE ---- deprecated 47      */
 799#define XFS_IOC_GETBMAPX        _IOWR('X', 56, struct getbmap)
 800#define XFS_IOC_ZERO_RANGE      _IOW ('X', 57, struct xfs_flock64)
 801#define XFS_IOC_FREE_EOFBLOCKS  _IOR ('X', 58, struct xfs_fs_eofblocks)
 802/*      XFS_IOC_GETFSMAP ------ hoisted 59         */
 803#define XFS_IOC_SCRUB_METADATA  _IOWR('X', 60, struct xfs_scrub_metadata)
 804#define XFS_IOC_AG_GEOMETRY     _IOWR('X', 61, struct xfs_ag_geometry)
 805
 806/*
 807 * ioctl commands that replace IRIX syssgi()'s
 808 */
 809#define XFS_IOC_FSGEOMETRY_V1        _IOR ('X', 100, struct xfs_fsop_geom_v1)
 810#define XFS_IOC_FSBULKSTAT           _IOWR('X', 101, struct xfs_fsop_bulkreq)
 811#define XFS_IOC_FSBULKSTAT_SINGLE    _IOWR('X', 102, struct xfs_fsop_bulkreq)
 812#define XFS_IOC_FSINUMBERS           _IOWR('X', 103, struct xfs_fsop_bulkreq)
 813#define XFS_IOC_PATH_TO_FSHANDLE     _IOWR('X', 104, struct xfs_fsop_handlereq)
 814#define XFS_IOC_PATH_TO_HANDLE       _IOWR('X', 105, struct xfs_fsop_handlereq)
 815#define XFS_IOC_FD_TO_HANDLE         _IOWR('X', 106, struct xfs_fsop_handlereq)
 816#define XFS_IOC_OPEN_BY_HANDLE       _IOWR('X', 107, struct xfs_fsop_handlereq)
 817#define XFS_IOC_READLINK_BY_HANDLE   _IOWR('X', 108, struct xfs_fsop_handlereq)
 818#define XFS_IOC_SWAPEXT              _IOWR('X', 109, struct xfs_swapext)
 819#define XFS_IOC_FSGROWFSDATA         _IOW ('X', 110, struct xfs_growfs_data)
 820#define XFS_IOC_FSGROWFSLOG          _IOW ('X', 111, struct xfs_growfs_log)
 821#define XFS_IOC_FSGROWFSRT           _IOW ('X', 112, struct xfs_growfs_rt)
 822#define XFS_IOC_FSCOUNTS             _IOR ('X', 113, struct xfs_fsop_counts)
 823#define XFS_IOC_SET_RESBLKS          _IOWR('X', 114, struct xfs_fsop_resblks)
 824#define XFS_IOC_GET_RESBLKS          _IOR ('X', 115, struct xfs_fsop_resblks)
 825#define XFS_IOC_ERROR_INJECTION      _IOW ('X', 116, struct xfs_error_injection)
 826#define XFS_IOC_ERROR_CLEARALL       _IOW ('X', 117, struct xfs_error_injection)
 827/*      XFS_IOC_ATTRCTL_BY_HANDLE -- deprecated 118      */
 828
 829#define XFS_IOC_FREEZE               _IOWR('X', 119, int)       /* aka FIFREEZE */
 830#define XFS_IOC_THAW                 _IOWR('X', 120, int)       /* aka FITHAW */
 831
 832#define XFS_IOC_FSSETDM_BY_HANDLE    _IOW ('X', 121, struct xfs_fsop_setdm_handlereq)
 833#define XFS_IOC_ATTRLIST_BY_HANDLE   _IOW ('X', 122, struct xfs_fsop_attrlist_handlereq)
 834#define XFS_IOC_ATTRMULTI_BY_HANDLE  _IOW ('X', 123, struct xfs_fsop_attrmulti_handlereq)
 835#define XFS_IOC_FSGEOMETRY_V4        _IOR ('X', 124, struct xfs_fsop_geom_v4)
 836#define XFS_IOC_GOINGDOWN            _IOR ('X', 125, uint32_t)
 837#define XFS_IOC_FSGEOMETRY           _IOR ('X', 126, struct xfs_fsop_geom)
 838#define XFS_IOC_BULKSTAT             _IOR ('X', 127, struct xfs_bulkstat_req)
 839#define XFS_IOC_INUMBERS             _IOR ('X', 128, struct xfs_inumbers_req)
 840/*      XFS_IOC_GETFSUUID ---------- deprecated 140      */
 841
 842
 843#ifndef HAVE_BBMACROS
 844/*
 845 * Block I/O parameterization.  A basic block (BB) is the lowest size of
 846 * filesystem allocation, and must equal 512.  Length units given to bio
 847 * routines are in BB's.
 848 */
 849#define BBSHIFT         9
 850#define BBSIZE          (1<<BBSHIFT)
 851#define BBMASK          (BBSIZE-1)
 852#define BTOBB(bytes)    (((__u64)(bytes) + BBSIZE - 1) >> BBSHIFT)
 853#define BTOBBT(bytes)   ((__u64)(bytes) >> BBSHIFT)
 854#define BBTOB(bbs)      ((bbs) << BBSHIFT)
 855#endif
 856
 857#endif  /* __XFS_FS_H__ */
 858