include/uapi/linux/stat.h

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