mirror of
https://github.com/torvalds/linux.git
synced 2024-11-22 20:22:09 +00:00
tools: sync uapi/linux/fs.h header into tools subdir
We need this UAPI header in tools/include subdirectory for using it from BPF selftests. Link: https://lkml.kernel.org/r/20240627170900.1672542-6-andrii@kernel.org Signed-off-by: Andrii Nakryiko <andrii@kernel.org> Acked-by: Liam R. Howlett <Liam.Howlett@Oracle.com> Cc: Alexey Dobriyan <adobriyan@gmail.com> Cc: Al Viro <viro@zeniv.linux.org.uk> Cc: Christian Brauner <brauner@kernel.org> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Cc: Mike Rapoport (IBM) <rppt@kernel.org> Cc: Suren Baghdasaryan <surenb@google.com> Cc: Andi Kleen <ak@linux.intel.com> Cc: Arnd Bergmann <arnd@arndb.de> Cc: Stephen Rothwell <sfr@canb.auug.org.au> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
This commit is contained in:
Andrii Nakryiko
Andrew Morton
parent
c10cb9148e
commit
77179b6f30
@ -1,6 +1,6 @@
|
||||
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
||||
#ifndef _LINUX_FS_H
|
||||
#define _LINUX_FS_H
|
||||
#ifndef _UAPI_LINUX_FS_H
|
||||
#define _UAPI_LINUX_FS_H
|
||||
|
||||
/*
|
||||
* This file has definitions for some important file table structures
|
||||
@ -13,10 +13,14 @@
|
||||
#include <linux/limits.h>
|
||||
#include <linux/ioctl.h>
|
||||
#include <linux/types.h>
|
||||
#ifndef __KERNEL__
|
||||
#include <linux/fscrypt.h>
|
||||
#endif
|
||||
|
||||
/* Use of MS_* flags within the kernel is restricted to core mount(2) code. */
|
||||
#if !defined(__KERNEL__)
|
||||
#include <linux/mount.h>
|
||||
#endif
|
||||
|
||||
/*
|
||||
* It's silly to have NR_OPEN bigger than NR_FILE, but you can change
|
||||
@ -308,29 +312,31 @@ struct fsxattr {
|
||||
typedef int __bitwise __kernel_rwf_t;
|
||||
|
||||
/* high priority request, poll if possible */
|
||||
#define RWF_HIPRI ((__kernel_rwf_t)0x00000001)
|
||||
#define RWF_HIPRI ((__force __kernel_rwf_t)0x00000001)
|
||||
|
||||
/* per-IO O_DSYNC */
|
||||
#define RWF_DSYNC ((__kernel_rwf_t)0x00000002)
|
||||
#define RWF_DSYNC ((__force __kernel_rwf_t)0x00000002)
|
||||
|
||||
/* per-IO O_SYNC */
|
||||
#define RWF_SYNC ((__kernel_rwf_t)0x00000004)
|
||||
#define RWF_SYNC ((__force __kernel_rwf_t)0x00000004)
|
||||
|
||||
/* per-IO, return -EAGAIN if operation would block */
|
||||
#define RWF_NOWAIT ((__kernel_rwf_t)0x00000008)
|
||||
#define RWF_NOWAIT ((__force __kernel_rwf_t)0x00000008)
|
||||
|
||||
/* per-IO O_APPEND */
|
||||
#define RWF_APPEND ((__kernel_rwf_t)0x00000010)
|
||||
#define RWF_APPEND ((__force __kernel_rwf_t)0x00000010)
|
||||
|
||||
/* per-IO negation of O_APPEND */
|
||||
#define RWF_NOAPPEND ((__kernel_rwf_t)0x00000020)
|
||||
#define RWF_NOAPPEND ((__force __kernel_rwf_t)0x00000020)
|
||||
|
||||
/* mask of flags supported by the kernel */
|
||||
#define RWF_SUPPORTED (RWF_HIPRI | RWF_DSYNC | RWF_SYNC | RWF_NOWAIT |\
|
||||
RWF_APPEND | RWF_NOAPPEND)
|
||||
|
||||
#define PROCFS_IOCTL_MAGIC 'f'
|
||||
|
||||
/* Pagemap ioctl */
|
||||
#define PAGEMAP_SCAN _IOWR('f', 16, struct pm_scan_arg)
|
||||
#define PAGEMAP_SCAN _IOWR(PROCFS_IOCTL_MAGIC, 16, struct pm_scan_arg)
|
||||
|
||||
/* Bitmasks provided in pm_scan_args masks and reported in page_region.categories. */
|
||||
#define PAGE_IS_WPALLOWED (1 << 0)
|
||||
@ -389,4 +395,158 @@ struct pm_scan_arg {
|
||||
__u64 return_mask;
|
||||
};
|
||||
|
||||
#endif /* _LINUX_FS_H */
|
||||
/* /proc/<pid>/maps ioctl */
|
||||
#define PROCMAP_QUERY _IOWR(PROCFS_IOCTL_MAGIC, 17, struct procmap_query)
|
||||
|
||||
enum procmap_query_flags {
|
||||
/*
|
||||
* VMA permission flags.
|
||||
*
|
||||
* Can be used as part of procmap_query.query_flags field to look up
|
||||
* only VMAs satisfying specified subset of permissions. E.g., specifying
|
||||
* PROCMAP_QUERY_VMA_READABLE only will return both readable and read/write VMAs,
|
||||
* while having PROCMAP_QUERY_VMA_READABLE | PROCMAP_QUERY_VMA_WRITABLE will only
|
||||
* return read/write VMAs, though both executable/non-executable and
|
||||
* private/shared will be ignored.
|
||||
*
|
||||
* PROCMAP_QUERY_VMA_* flags are also returned in procmap_query.vma_flags
|
||||
* field to specify actual VMA permissions.
|
||||
*/
|
||||
PROCMAP_QUERY_VMA_READABLE = 0x01,
|
||||
PROCMAP_QUERY_VMA_WRITABLE = 0x02,
|
||||
PROCMAP_QUERY_VMA_EXECUTABLE = 0x04,
|
||||
PROCMAP_QUERY_VMA_SHARED = 0x08,
|
||||
/*
|
||||
* Query modifier flags.
|
||||
*
|
||||
* By default VMA that covers provided address is returned, or -ENOENT
|
||||
* is returned. With PROCMAP_QUERY_COVERING_OR_NEXT_VMA flag set, closest
|
||||
* VMA with vma_start > addr will be returned if no covering VMA is
|
||||
* found.
|
||||
*
|
||||
* PROCMAP_QUERY_FILE_BACKED_VMA instructs query to consider only VMAs that
|
||||
* have file backing. Can be combined with PROCMAP_QUERY_COVERING_OR_NEXT_VMA
|
||||
* to iterate all VMAs with file backing.
|
||||
*/
|
||||
PROCMAP_QUERY_COVERING_OR_NEXT_VMA = 0x10,
|
||||
PROCMAP_QUERY_FILE_BACKED_VMA = 0x20,
|
||||
};
|
||||
|
||||
/*
|
||||
* Input/output argument structured passed into ioctl() call. It can be used
|
||||
* to query a set of VMAs (Virtual Memory Areas) of a process.
|
||||
*
|
||||
* Each field can be one of three kinds, marked in a short comment to the
|
||||
* right of the field:
|
||||
* - "in", input argument, user has to provide this value, kernel doesn't modify it;
|
||||
* - "out", output argument, kernel sets this field with VMA data;
|
||||
* - "in/out", input and output argument; user provides initial value (used
|
||||
* to specify maximum allowable buffer size), and kernel sets it to actual
|
||||
* amount of data written (or zero, if there is no data).
|
||||
*
|
||||
* If matching VMA is found (according to criterias specified by
|
||||
* query_addr/query_flags, all the out fields are filled out, and ioctl()
|
||||
* returns 0. If there is no matching VMA, -ENOENT will be returned.
|
||||
* In case of any other error, negative error code other than -ENOENT is
|
||||
* returned.
|
||||
*
|
||||
* Most of the data is similar to the one returned as text in /proc/<pid>/maps
|
||||
* file, but procmap_query provides more querying flexibility. There are no
|
||||
* consistency guarantees between subsequent ioctl() calls, but data returned
|
||||
* for matched VMA is self-consistent.
|
||||
*/
|
||||
struct procmap_query {
|
||||
/* Query struct size, for backwards/forward compatibility */
|
||||
__u64 size;
|
||||
/*
|
||||
* Query flags, a combination of enum procmap_query_flags values.
|
||||
* Defines query filtering and behavior, see enum procmap_query_flags.
|
||||
*
|
||||
* Input argument, provided by user. Kernel doesn't modify it.
|
||||
*/
|
||||
__u64 query_flags; /* in */
|
||||
/*
|
||||
* Query address. By default, VMA that covers this address will
|
||||
* be looked up. PROCMAP_QUERY_* flags above modify this default
|
||||
* behavior further.
|
||||
*
|
||||
* Input argument, provided by user. Kernel doesn't modify it.
|
||||
*/
|
||||
__u64 query_addr; /* in */
|
||||
/* VMA starting (inclusive) and ending (exclusive) address, if VMA is found. */
|
||||
__u64 vma_start; /* out */
|
||||
__u64 vma_end; /* out */
|
||||
/* VMA permissions flags. A combination of PROCMAP_QUERY_VMA_* flags. */
|
||||
__u64 vma_flags; /* out */
|
||||
/* VMA backing page size granularity. */
|
||||
__u64 vma_page_size; /* out */
|
||||
/*
|
||||
* VMA file offset. If VMA has file backing, this specifies offset
|
||||
* within the file that VMA's start address corresponds to.
|
||||
* Is set to zero if VMA has no backing file.
|
||||
*/
|
||||
__u64 vma_offset; /* out */
|
||||
/* Backing file's inode number, or zero, if VMA has no backing file. */
|
||||
__u64 inode; /* out */
|
||||
/* Backing file's device major/minor number, or zero, if VMA has no backing file. */
|
||||
__u32 dev_major; /* out */
|
||||
__u32 dev_minor; /* out */
|
||||
/*
|
||||
* If set to non-zero value, signals the request to return VMA name
|
||||
* (i.e., VMA's backing file's absolute path, with " (deleted)" suffix
|
||||
* appended, if file was unlinked from FS) for matched VMA. VMA name
|
||||
* can also be some special name (e.g., "[heap]", "[stack]") or could
|
||||
* be even user-supplied with prctl(PR_SET_VMA, PR_SET_VMA_ANON_NAME).
|
||||
*
|
||||
* Kernel will set this field to zero, if VMA has no associated name.
|
||||
* Otherwise kernel will return actual amount of bytes filled in
|
||||
* user-supplied buffer (see vma_name_addr field below), including the
|
||||
* terminating zero.
|
||||
*
|
||||
* If VMA name is longer that user-supplied maximum buffer size,
|
||||
* -E2BIG error is returned.
|
||||
*
|
||||
* If this field is set to non-zero value, vma_name_addr should point
|
||||
* to valid user space memory buffer of at least vma_name_size bytes.
|
||||
* If set to zero, vma_name_addr should be set to zero as well
|
||||
*/
|
||||
__u32 vma_name_size; /* in/out */
|
||||
/*
|
||||
* If set to non-zero value, signals the request to extract and return
|
||||
* VMA's backing file's build ID, if the backing file is an ELF file
|
||||
* and it contains embedded build ID.
|
||||
*
|
||||
* Kernel will set this field to zero, if VMA has no backing file,
|
||||
* backing file is not an ELF file, or ELF file has no build ID
|
||||
* embedded.
|
||||
*
|
||||
* Build ID is a binary value (not a string). Kernel will set
|
||||
* build_id_size field to exact number of bytes used for build ID.
|
||||
* If build ID is requested and present, but needs more bytes than
|
||||
* user-supplied maximum buffer size (see build_id_addr field below),
|
||||
* -E2BIG error will be returned.
|
||||
*
|
||||
* If this field is set to non-zero value, build_id_addr should point
|
||||
* to valid user space memory buffer of at least build_id_size bytes.
|
||||
* If set to zero, build_id_addr should be set to zero as well
|
||||
*/
|
||||
__u32 build_id_size; /* in/out */
|
||||
/*
|
||||
* User-supplied address of a buffer of at least vma_name_size bytes
|
||||
* for kernel to fill with matched VMA's name (see vma_name_size field
|
||||
* description above for details).
|
||||
*
|
||||
* Should be set to zero if VMA name should not be returned.
|
||||
*/
|
||||
__u64 vma_name_addr; /* in */
|
||||
/*
|
||||
* User-supplied address of a buffer of at least build_id_size bytes
|
||||
* for kernel to fill with matched VMA's ELF build ID, if available
|
||||
* (see build_id_size field description above for details).
|
||||
*
|
||||
* Should be set to zero if build ID should not be returned.
|
||||
*/
|
||||
__u64 build_id_addr; /* in */
|
||||
};
|
||||
|
||||
#endif /* _UAPI_LINUX_FS_H */
|
||||
|
||||
Loading…
Reference in New Issue
Block a user