/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */

[0] Fix | Delete

#ifndef _LINUX_STAT_H

[1] Fix | Delete

#define _LINUX_STAT_H

[2] Fix | Delete

[3] Fix | Delete

#include <linux/types.h>

[4] Fix | Delete

[5] Fix | Delete

#if defined(__KERNEL__) || !defined(__GLIBC__) || (__GLIBC__ < 2)

[6] Fix | Delete

[7] Fix | Delete

#define S_IFMT 00170000

[8] Fix | Delete

#define S_IFSOCK 0140000

[9] Fix | Delete

#define S_IFLNK 0120000

[10] Fix | Delete

#define S_IFREG 0100000

[11] Fix | Delete

#define S_IFBLK 0060000

[12] Fix | Delete

#define S_IFDIR 0040000

[13] Fix | Delete

#define S_IFCHR 0020000

[14] Fix | Delete

#define S_IFIFO 0010000

[15] Fix | Delete

#define S_ISUID 0004000

[16] Fix | Delete

#define S_ISGID 0002000

[17] Fix | Delete

#define S_ISVTX 0001000

[18] Fix | Delete

[19] Fix | Delete

#define S_ISLNK(m) (((m) & S_IFMT) == S_IFLNK)

[20] Fix | Delete

#define S_ISREG(m) (((m) & S_IFMT) == S_IFREG)

[21] Fix | Delete

#define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)

[22] Fix | Delete

#define S_ISCHR(m) (((m) & S_IFMT) == S_IFCHR)

[23] Fix | Delete

#define S_ISBLK(m) (((m) & S_IFMT) == S_IFBLK)

[24] Fix | Delete

#define S_ISFIFO(m) (((m) & S_IFMT) == S_IFIFO)

[25] Fix | Delete

#define S_ISSOCK(m) (((m) & S_IFMT) == S_IFSOCK)

[26] Fix | Delete

[27] Fix | Delete

#define S_IRWXU 00700

[28] Fix | Delete

#define S_IRUSR 00400

[29] Fix | Delete

#define S_IWUSR 00200

[30] Fix | Delete

#define S_IXUSR 00100

[31] Fix | Delete

[32] Fix | Delete

#define S_IRWXG 00070

[33] Fix | Delete

#define S_IRGRP 00040

[34] Fix | Delete

#define S_IWGRP 00020

[35] Fix | Delete

#define S_IXGRP 00010

[36] Fix | Delete

[37] Fix | Delete

#define S_IRWXO 00007

[38] Fix | Delete

#define S_IROTH 00004

[39] Fix | Delete

#define S_IWOTH 00002

[40] Fix | Delete

#define S_IXOTH 00001

[41] Fix | Delete

[42] Fix | Delete

#endif

[43] Fix | Delete

[44] Fix | Delete

/*

[45] Fix | Delete

* Timestamp structure for the timestamps in struct statx.

[46] Fix | Delete

*

[47] Fix | Delete

* tv_sec holds the number of seconds before (negative) or after (positive)

[48] Fix | Delete

* 00:00:00 1st January 1970 UTC.

[49] Fix | Delete

*

[50] Fix | Delete

* tv_nsec holds a number of nanoseconds (0..999,999,999) after the tv_sec time.

[51] Fix | Delete

*

[52] Fix | Delete

* __reserved is held in case we need a yet finer resolution.

[53] Fix | Delete

*/

[54] Fix | Delete

struct statx_timestamp {

[55] Fix | Delete

__s64 tv_sec;

[56] Fix | Delete

__u32 tv_nsec;

[57] Fix | Delete

__s32 __reserved;

[58] Fix | Delete

};

[59] Fix | Delete

[60] Fix | Delete

/*

[61] Fix | Delete

* Structures for the extended file attribute retrieval system call

[62] Fix | Delete

* (statx()).

[63] Fix | Delete

*

[64] Fix | Delete

* The caller passes a mask of what they're specifically interested in as a

[65] Fix | Delete

* parameter to statx(). What statx() actually got will be indicated in

[66] Fix | Delete

* st_mask upon return.

[67] Fix | Delete

*

[68] Fix | Delete

* For each bit in the mask argument:

[69] Fix | Delete

*

[70] Fix | Delete

* - if the datum is not supported:

[71] Fix | Delete

*

[72] Fix | Delete

* - the bit will be cleared, and

[73] Fix | Delete

*

[74] Fix | Delete

* - the datum will be set to an appropriate fabricated value if one is

[75] Fix | Delete

* available (eg. CIFS can take a default uid and gid), otherwise

[76] Fix | Delete

*

[77] Fix | Delete

* - the field will be cleared;

[78] Fix | Delete

*

[79] Fix | Delete

* - otherwise, if explicitly requested:

[80] Fix | Delete

*

[81] Fix | Delete

* - the datum will be synchronised to the server if AT_STATX_FORCE_SYNC is

[82] Fix | Delete

* set or if the datum is considered out of date, and

[83] Fix | Delete

*

[84] Fix | Delete

* - the field will be filled in and the bit will be set;

[85] Fix | Delete

*

[86] Fix | Delete

* - otherwise, if not requested, but available in approximate form without any

[87] Fix | Delete

* effort, it will be filled in anyway, and the bit will be set upon return

[88] Fix | Delete

* (it might not be up to date, however, and no attempt will be made to

[89] Fix | Delete

* synchronise the internal state first);

[90] Fix | Delete

*

[91] Fix | Delete

* - otherwise the field and the bit will be cleared before returning.

[92] Fix | Delete

*

[93] Fix | Delete

* Items in STATX_BASIC_STATS may be marked unavailable on return, but they

[94] Fix | Delete

* will have values installed for compatibility purposes so that stat() and

[95] Fix | Delete

* co. can be emulated in userspace.

[96] Fix | Delete

*/

[97] Fix | Delete

struct statx {

[98] Fix | Delete

/* 0x00 */

[99] Fix | Delete

__u32 stx_mask; /* What results were written [uncond] */

[100] Fix | Delete

__u32 stx_blksize; /* Preferred general I/O size [uncond] */

[101] Fix | Delete

__u64 stx_attributes; /* Flags conveying information about the file [uncond] */

[102] Fix | Delete

/* 0x10 */

[103] Fix | Delete

__u32 stx_nlink; /* Number of hard links */

[104] Fix | Delete

__u32 stx_uid; /* User ID of owner */

[105] Fix | Delete

__u32 stx_gid; /* Group ID of owner */

[106] Fix | Delete

__u16 stx_mode; /* File mode */

[107] Fix | Delete

__u16 __spare0[1];

[108] Fix | Delete

/* 0x20 */

[109] Fix | Delete

__u64 stx_ino; /* Inode number */

[110] Fix | Delete

__u64 stx_size; /* File size */

[111] Fix | Delete

__u64 stx_blocks; /* Number of 512-byte blocks allocated */

[112] Fix | Delete

__u64 stx_attributes_mask; /* Mask to show what's supported in stx_attributes */

[113] Fix | Delete

/* 0x40 */

[114] Fix | Delete

struct statx_timestamp stx_atime; /* Last access time */

[115] Fix | Delete

struct statx_timestamp stx_btime; /* File creation time */

[116] Fix | Delete

struct statx_timestamp stx_ctime; /* Last attribute change time */

[117] Fix | Delete

struct statx_timestamp stx_mtime; /* Last data modification time */

[118] Fix | Delete

/* 0x80 */

[119] Fix | Delete

__u32 stx_rdev_major; /* Device ID of special file [if bdev/cdev] */

[120] Fix | Delete

__u32 stx_rdev_minor;

[121] Fix | Delete

__u32 stx_dev_major; /* ID of device containing file [uncond] */

[122] Fix | Delete

__u32 stx_dev_minor;

[123] Fix | Delete

/* 0x90 */

[124] Fix | Delete

__u64 __spare2[14]; /* Spare space for future expansion */

[125] Fix | Delete

/* 0x100 */

[126] Fix | Delete

};

[127] Fix | Delete

[128] Fix | Delete

/*

[129] Fix | Delete

* Flags to be stx_mask

[130] Fix | Delete

*

[131] Fix | Delete

* Query request/result mask for statx() and struct statx::stx_mask.

[132] Fix | Delete

*

[133] Fix | Delete

* These bits should be set in the mask argument of statx() to request

[134] Fix | Delete

* particular items when calling statx().

[135] Fix | Delete

*/

[136] Fix | Delete

#define STATX_TYPE 0x00000001U /* Want/got stx_mode & S_IFMT */

[137] Fix | Delete

#define STATX_MODE 0x00000002U /* Want/got stx_mode & ~S_IFMT */

[138] Fix | Delete

#define STATX_NLINK 0x00000004U /* Want/got stx_nlink */

[139] Fix | Delete

#define STATX_UID 0x00000008U /* Want/got stx_uid */

[140] Fix | Delete

#define STATX_GID 0x00000010U /* Want/got stx_gid */

[141] Fix | Delete

#define STATX_ATIME 0x00000020U /* Want/got stx_atime */

[142] Fix | Delete

#define STATX_MTIME 0x00000040U /* Want/got stx_mtime */

[143] Fix | Delete

#define STATX_CTIME 0x00000080U /* Want/got stx_ctime */

[144] Fix | Delete

#define STATX_INO 0x00000100U /* Want/got stx_ino */

[145] Fix | Delete

#define STATX_SIZE 0x00000200U /* Want/got stx_size */

[146] Fix | Delete

#define STATX_BLOCKS 0x00000400U /* Want/got stx_blocks */

[147] Fix | Delete

#define STATX_BASIC_STATS 0x000007ffU /* The stuff in the normal stat struct */

[148] Fix | Delete

#define STATX_BTIME 0x00000800U /* Want/got stx_btime */

[149] Fix | Delete

#define STATX_ALL 0x00000fffU /* All currently supported flags */

[150] Fix | Delete

#define STATX__RESERVED 0x80000000U /* Reserved for future struct statx expansion */

[151] Fix | Delete

[152] Fix | Delete

/*

[153] Fix | Delete

* Attributes to be found in stx_attributes and masked in stx_attributes_mask.

[154] Fix | Delete

*

[155] Fix | Delete

* These give information about the features or the state of a file that might

[156] Fix | Delete

* be of use to ordinary userspace programs such as GUIs or ls rather than

[157] Fix | Delete

* specialised tools.

[158] Fix | Delete

*

[159] Fix | Delete

* Note that the flags marked [I] correspond to the FS_IOC_SETFLAGS flags

[160] Fix | Delete

* semantically. Where possible, the numerical value is picked to correspond

[161] Fix | Delete

* also. Note that the DAX attribute indicates that the file is in the CPU

[162] Fix | Delete

* direct access state. It does not correspond to the per-inode flag that

[163] Fix | Delete

* some filesystems support.

[164] Fix | Delete

*

[165] Fix | Delete

*/

[166] Fix | Delete

#define STATX_ATTR_COMPRESSED 0x00000004 /* [I] File is compressed by the fs */

[167] Fix | Delete

#define STATX_ATTR_IMMUTABLE 0x00000010 /* [I] File is marked immutable */

[168] Fix | Delete

#define STATX_ATTR_APPEND 0x00000020 /* [I] File is append-only */

[169] Fix | Delete

#define STATX_ATTR_NODUMP 0x00000040 /* [I] File is not to be dumped */

[170] Fix | Delete

#define STATX_ATTR_ENCRYPTED 0x00000800 /* [I] File requires key to decrypt in fs */

[171] Fix | Delete

[172] Fix | Delete

#define STATX_ATTR_AUTOMOUNT 0x00001000 /* Dir: Automount trigger */

[173] Fix | Delete

#define STATX_ATTR_DAX 0x00200000 /* File is currently in DAX state */

[174] Fix | Delete

[175] Fix | Delete

[176] Fix | Delete

#endif /* _LINUX_STAT_H */

[177] Fix | Delete

[178] Fix | Delete