mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-28 20:02:17 +00:00
![Gustavo A. R. Silva](/assets/img/avatar_default.png)
There is a regular need in the kernel to provide a way to declare having a dynamically sized set of trailing elements in a structure. Kernel code should always use “flexible array members”[1] for these cases. The older style of one-element or zero-length arrays should no longer be used[2]. This code was transformed with the help of Coccinelle: (linux-5.19-rc2$ spatch --jobs $(getconf _NPROCESSORS_ONLN) --sp-file script.cocci --include-headers --dir . > output.patch) @@ identifier S, member, array; type T1, T2; @@ struct S { ... T1 member; T2 array[ - 0 ]; }; -fstrict-flex-arrays=3 is coming and we need to land these changes to prevent issues like these in the short future: ../fs/minix/dir.c:337:3: warning: 'strcpy' will always overflow; destination buffer has size 0, but the source string has length 2 (including NUL byte) [-Wfortify-source] strcpy(de3->name, "."); ^ Since these are all [0] to [] changes, the risk to UAPI is nearly zero. If this breaks anything, we can use a union with a new member name. [1] https://en.wikipedia.org/wiki/Flexible_array_member [2] https://www.kernel.org/doc/html/v5.16/process/deprecated.html#zero-length-and-one-element-arrays Link: https://github.com/KSPP/linux/issues/78 Build-tested-by: kernel test robot <lkp@intel.com> Link: https://lore.kernel.org/lkml/62b675ec.wKX6AOZ6cbE71vtF%25lkp@intel.com/ Acked-by: Dan Williams <dan.j.williams@intel.com> # For ndctl.h Signed-off-by: Gustavo A. R. Silva <gustavoars@kernel.org>
70 lines
2.7 KiB
C
70 lines
2.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
/*
|
|
* FS_IOC_FIEMAP ioctl infrastructure.
|
|
*
|
|
* Some portions copyright (C) 2007 Cluster File Systems, Inc
|
|
*
|
|
* Authors: Mark Fasheh <mfasheh@suse.com>
|
|
* Kalpak Shah <kalpak.shah@sun.com>
|
|
* Andreas Dilger <adilger@sun.com>
|
|
*/
|
|
|
|
#ifndef _UAPI_LINUX_FIEMAP_H
|
|
#define _UAPI_LINUX_FIEMAP_H
|
|
|
|
#include <linux/types.h>
|
|
|
|
struct fiemap_extent {
|
|
__u64 fe_logical; /* logical offset in bytes for the start of
|
|
* the extent from the beginning of the file */
|
|
__u64 fe_physical; /* physical offset in bytes for the start
|
|
* of the extent from the beginning of the disk */
|
|
__u64 fe_length; /* length in bytes for this extent */
|
|
__u64 fe_reserved64[2];
|
|
__u32 fe_flags; /* FIEMAP_EXTENT_* flags for this extent */
|
|
__u32 fe_reserved[3];
|
|
};
|
|
|
|
struct fiemap {
|
|
__u64 fm_start; /* logical offset (inclusive) at
|
|
* which to start mapping (in) */
|
|
__u64 fm_length; /* logical length of mapping which
|
|
* userspace wants (in) */
|
|
__u32 fm_flags; /* FIEMAP_FLAG_* flags for request (in/out) */
|
|
__u32 fm_mapped_extents;/* number of extents that were mapped (out) */
|
|
__u32 fm_extent_count; /* size of fm_extents array (in) */
|
|
__u32 fm_reserved;
|
|
struct fiemap_extent fm_extents[]; /* array of mapped extents (out) */
|
|
};
|
|
|
|
#define FIEMAP_MAX_OFFSET (~0ULL)
|
|
|
|
#define FIEMAP_FLAG_SYNC 0x00000001 /* sync file data before map */
|
|
#define FIEMAP_FLAG_XATTR 0x00000002 /* map extended attribute tree */
|
|
#define FIEMAP_FLAG_CACHE 0x00000004 /* request caching of the extents */
|
|
|
|
#define FIEMAP_FLAGS_COMPAT (FIEMAP_FLAG_SYNC | FIEMAP_FLAG_XATTR)
|
|
|
|
#define FIEMAP_EXTENT_LAST 0x00000001 /* Last extent in file. */
|
|
#define FIEMAP_EXTENT_UNKNOWN 0x00000002 /* Data location unknown. */
|
|
#define FIEMAP_EXTENT_DELALLOC 0x00000004 /* Location still pending.
|
|
* Sets EXTENT_UNKNOWN. */
|
|
#define FIEMAP_EXTENT_ENCODED 0x00000008 /* Data can not be read
|
|
* while fs is unmounted */
|
|
#define FIEMAP_EXTENT_DATA_ENCRYPTED 0x00000080 /* Data is encrypted by fs.
|
|
* Sets EXTENT_NO_BYPASS. */
|
|
#define FIEMAP_EXTENT_NOT_ALIGNED 0x00000100 /* Extent offsets may not be
|
|
* block aligned. */
|
|
#define FIEMAP_EXTENT_DATA_INLINE 0x00000200 /* Data mixed with metadata.
|
|
* Sets EXTENT_NOT_ALIGNED.*/
|
|
#define FIEMAP_EXTENT_DATA_TAIL 0x00000400 /* Multiple files in block.
|
|
* Sets EXTENT_NOT_ALIGNED.*/
|
|
#define FIEMAP_EXTENT_UNWRITTEN 0x00000800 /* Space allocated, but
|
|
* no data (i.e. zero). */
|
|
#define FIEMAP_EXTENT_MERGED 0x00001000 /* File does not natively
|
|
* support extents. Result
|
|
* merged for efficiency. */
|
|
#define FIEMAP_EXTENT_SHARED 0x00002000 /* Space shared with other
|
|
* files. */
|
|
|
|
#endif /* _UAPI_LINUX_FIEMAP_H */
|