include/uapi/linux/stat.h

   1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
   2 #ifndef _UAPI_LINUX_STAT_H
   3 #define _UAPI_LINUX_STAT_H
   4
   5 #include <linux/types.h>
   6
   7 #if defined(__KERNEL__) || !defined(__GLIBC__) || (__GLIBC__ < 2)
   8
   9 #define S_IFMT  00170000
  10 #define S_IFSOCK 0140000
  11 #define S_IFLNK  0120000
  12 #define S_IFREG  0100000
  13 #define S_IFBLK  0060000
  14 #define S_IFDIR  0040000
  15 #define S_IFCHR  0020000
  16 #define S_IFIFO  0010000
  17 #define S_ISUID  0004000
  18 #define S_ISGID  0002000
  19 #define S_ISVTX  0001000
  20
  21 #define S_ISLNK(m)      (((m) & S_IFMT) == S_IFLNK)
  22 #define S_ISREG(m)      (((m) & S_IFMT) == S_IFREG)
  23 #define S_ISDIR(m)      (((m) & S_IFMT) == S_IFDIR)
  24 #define S_ISCHR(m)      (((m) & S_IFMT) == S_IFCHR)
  25 #define S_ISBLK(m)      (((m) & S_IFMT) == S_IFBLK)
  26 #define S_ISFIFO(m)     (((m) & S_IFMT) == S_IFIFO)
  27 #define S_ISSOCK(m)     (((m) & S_IFMT) == S_IFSOCK)
  28
  29 #define S_IRWXU 00700
  30 #define S_IRUSR 00400
  31 #define S_IWUSR 00200
  32 #define S_IXUSR 00100
  33
  34 #define S_IRWXG 00070
  35 #define S_IRGRP 00040
  36 #define S_IWGRP 00020
  37 #define S_IXGRP 00010
  38
  39 #define S_IRWXO 00007
  40 #define S_IROTH 00004
  41 #define S_IWOTH 00002
  42 #define S_IXOTH 00001
  43
  44 #endif
  45
  46 /*
  47  * Timestamp structure for the timestamps in struct statx.
  48  *
  49  * tv_sec holds the number of seconds before (negative) or after (positive)
  50  * 00:00:00 1st January 1970 UTC.
  51  *
  52  * tv_nsec holds a number of nanoseconds (0..999,999,999) after the tv_sec time.
  53  *
  54  * __reserved is held in case we need a yet finer resolution.
  55  */
  56 struct statx_timestamp {
  57         __s64   tv_sec;
  58         __u32   tv_nsec;
  59         __s32   __reserved;
  60 };
  61
  62 /*
  63  * Structures for the extended file attribute retrieval system call
  64  * (statx()).
  65  *
  66  * The caller passes a mask of what they're specifically interested in as a
  67  * parameter to statx().  What statx() actually got will be indicated in
  68  * st_mask upon return.
  69  *
  70  * For each bit in the mask argument:
  71  *
  72  * - if the datum is not supported:
  73  *
  74  *   - the bit will be cleared, and
  75  *
  76  *   - the datum will be set to an appropriate fabricated value if one is
  77  *     available (eg. CIFS can take a default uid and gid), otherwise
  78  *
  79  *   - the field will be cleared;
  80  *
  81  * - otherwise, if explicitly requested:
  82  *
  83  *   - the datum will be synchronised to the server if AT_STATX_FORCE_SYNC is
  84  *     set or if the datum is considered out of date, and
  85  *
  86  *   - the field will be filled in and the bit will be set;
  87  *
  88  * - otherwise, if not requested, but available in approximate form without any
  89  *   effort, it will be filled in anyway, and the bit will be set upon return
  90  *   (it might not be up to date, however, and no attempt will be made to
  91  *   synchronise the internal state first);
  92  *
  93  * - otherwise the field and the bit will be cleared before returning.
  94  *
  95  * Items in STATX_BASIC_STATS may be marked unavailable on return, but they
  96  * will have values installed for compatibility purposes so that stat() and
  97  * co. can be emulated in userspace.
  98  */
  99 struct statx {
 100         /* 0x00 */
 101         __u32   stx_mask;       /* What results were written [uncond] */
 102         __u32   stx_blksize;    /* Preferred general I/O size [uncond] */
 103         __u64   stx_attributes; /* Flags conveying information about the file [uncond] */
 104         /* 0x10 */
 105         __u32   stx_nlink;      /* Number of hard links */
 106         __u32   stx_uid;        /* User ID of owner */
 107         __u32   stx_gid;        /* Group ID of owner */
 108         __u16   stx_mode;       /* File mode */
 109         __u16   __spare0[1];
 110         /* 0x20 */
 111         __u64   stx_ino;        /* Inode number */
 112         __u64   stx_size;       /* File size */
 113         __u64   stx_blocks;     /* Number of 512-byte blocks allocated */
 114         __u64   stx_attributes_mask; /* Mask to show what's supported in stx_attributes */
 115         /* 0x40 */
 116         struct statx_timestamp  stx_atime;      /* Last access time */
 117         struct statx_timestamp  stx_btime;      /* File creation time */
 118         struct statx_timestamp  stx_ctime;      /* Last attribute change time */
 119         struct statx_timestamp  stx_mtime;      /* Last data modification time */
 120         /* 0x80 */
 121         __u32   stx_rdev_major; /* Device ID of special file [if bdev/cdev] */
 122         __u32   stx_rdev_minor;
 123         __u32   stx_dev_major;  /* ID of device containing file [uncond] */
 124         __u32   stx_dev_minor;
 125         /* 0x90 */
 126         __u64   __spare2[14];   /* Spare space for future expansion */
 127         /* 0x100 */
 128 };
 129
 130 /*
 131  * Flags to be stx_mask
 132  *
 133  * Query request/result mask for statx() and struct statx::stx_mask.
 134  *
 135  * These bits should be set in the mask argument of statx() to request
 136  * particular items when calling statx().
 137  */
 138 #define STATX_TYPE              0x00000001U     /* Want/got stx_mode & S_IFMT */
 139 #define STATX_MODE              0x00000002U     /* Want/got stx_mode & ~S_IFMT */
 140 #define STATX_NLINK             0x00000004U     /* Want/got stx_nlink */
 141 #define STATX_UID               0x00000008U     /* Want/got stx_uid */
 142 #define STATX_GID               0x00000010U     /* Want/got stx_gid */
 143 #define STATX_ATIME             0x00000020U     /* Want/got stx_atime */
 144 #define STATX_MTIME             0x00000040U     /* Want/got stx_mtime */
 145 #define STATX_CTIME             0x00000080U     /* Want/got stx_ctime */
 146 #define STATX_INO               0x00000100U     /* Want/got stx_ino */
 147 #define STATX_SIZE              0x00000200U     /* Want/got stx_size */
 148 #define STATX_BLOCKS            0x00000400U     /* Want/got stx_blocks */
 149 #define STATX_BASIC_STATS       0x000007ffU     /* The stuff in the normal stat struct */
 150 #define STATX_BTIME             0x00000800U     /* Want/got stx_btime */
 151 #define STATX_ALL               0x00000fffU     /* All currently supported flags */
 152 #define STATX__RESERVED         0x80000000U     /* Reserved for future struct statx expansion */
 153
 154 /*
 155  * Attributes to be found in stx_attributes and masked in stx_attributes_mask.
 156  *
 157  * These give information about the features or the state of a file that might
 158  * be of use to ordinary userspace programs such as GUIs or ls rather than
 159  * specialised tools.
 160  *
 161  * Note that the flags marked [I] correspond to generic FS_IOC_FLAGS
 162  * semantically.  Where possible, the numerical value is picked to correspond
 163  * also.
 164  */
 165 #define STATX_ATTR_COMPRESSED           0x00000004 /* [I] File is compressed by the fs */
 166 #define STATX_ATTR_IMMUTABLE            0x00000010 /* [I] File is marked immutable */
 167 #define STATX_ATTR_APPEND               0x00000020 /* [I] File is append-only */
 168 #define STATX_ATTR_NODUMP               0x00000040 /* [I] File is not to be dumped */
 169 #define STATX_ATTR_ENCRYPTED            0x00000800 /* [I] File requires key to decrypt in fs */
 170
 171 #define STATX_ATTR_AUTOMOUNT            0x00001000 /* Dir: Automount trigger */
 172
 173
 174 #endif /* _UAPI_LINUX_STAT_H */