From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-10.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 59EFCC433E3 for ; Mon, 3 Aug 2020 13:37:14 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 2E0412076C for ; Mon, 3 Aug 2020 13:37:14 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="Snqp99Le" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727908AbgHCNhO (ORCPT ); Mon, 3 Aug 2020 09:37:14 -0400 Received: from us-smtp-delivery-1.mimecast.com ([205.139.110.120]:22030 "EHLO us-smtp-1.mimecast.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1727889AbgHCNhN (ORCPT ); Mon, 3 Aug 2020 09:37:13 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1596461829; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=1DQiqfSzhKm/VJj/60a3tFHolg0Z1RwCdPQ7UUsoWJM=; b=Snqp99LeIBfcYL2JIiuuPC0kS+LOmmUJ7cdM8wlZ7fPM6yoh9SQSGvqBpkkf1SWWoNua4U s3RH2ouWRlje+rvCF9qXNp5ISOpYMGcA6wH3Yat8oNPJbGYRQ5k+1PCge8zT/WsDPWXLOo A5/PIoD5ukaP47V4mU4BoQlhr/NR3Ho= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-284-eCuTqacVPMOLCAfw2dKgXA-1; Mon, 03 Aug 2020 09:36:56 -0400 X-MC-Unique: eCuTqacVPMOLCAfw2dKgXA-1 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id BB4431005504; Mon, 3 Aug 2020 13:36:54 +0000 (UTC) Received: from warthog.procyon.org.uk (ovpn-112-32.rdu2.redhat.com [10.10.112.32]) by smtp.corp.redhat.com (Postfix) with ESMTP id 23DE819D7C; Mon, 3 Aug 2020 13:36:51 +0000 (UTC) Organization: Red Hat UK Ltd. Registered Address: Red Hat UK Ltd, Amberley Place, 107-111 Peascod Street, Windsor, Berkshire, SI4 1TE, United Kingdom. Registered in England and Wales under Company Registration No. 3798903 Subject: [PATCH 03/18] fsinfo: Provide a bitmap of the features a filesystem supports [ver #21] From: David Howells To: viro@zeniv.linux.org.uk Cc: dhowells@redhat.com, torvalds@linux-foundation.org, raven@themaw.net, mszeredi@redhat.com, christian@brauner.io, jannh@google.com, darrick.wong@oracle.com, kzak@redhat.com, jlayton@redhat.com, linux-api@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-security-module@vger.kernel.org, linux-kernel@vger.kernel.org Date: Mon, 03 Aug 2020 14:36:51 +0100 Message-ID: <159646181132.1784947.9295145006449682092.stgit@warthog.procyon.org.uk> In-Reply-To: <159646178122.1784947.11705396571718464082.stgit@warthog.procyon.org.uk> References: <159646178122.1784947.11705396571718464082.stgit@warthog.procyon.org.uk> User-Agent: StGit/0.23 MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Provide a bitmap of features that a filesystem may provide for the path being queried. Features include such things as: (1) The general class of filesystem, such as kernel-interface, block-based, flash-based, network-based. (2) Supported inode features, such as which timestamps are supported, whether simple numeric user, group or project IDs are supported and whether user identification is actually more complex behind the scenes. (3) Supported volume features, such as it having a UUID, a name or a filesystem ID. (4) Supported filesystem features, such as what types of file are supported, whether sparse files, extended attributes and quotas are supported. (5) Supported interface features, such as whether locking and leases are supported, what open flags are honoured and how i_version is managed. For some filesystems, this may be an immutable set and can just be memcpy'd into the reply buffer. Signed-off-by: David Howells --- fs/fsinfo.c | 34 +++++++++++++++++++++ include/linux/fsinfo.h | 38 +++++++++++++++++++++++ include/uapi/linux/fsinfo.h | 68 ++++++++++++++++++++++++++++++++++++++++++ samples/vfs/test-fsinfo.c | 70 +++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 210 insertions(+) diff --git a/fs/fsinfo.c b/fs/fsinfo.c index 7d9c73e9cbde..79c222d465d8 100644 --- a/fs/fsinfo.c +++ b/fs/fsinfo.c @@ -131,6 +131,39 @@ int fsinfo_generic_supports(struct path *path, struct fsinfo_context *ctx) } EXPORT_SYMBOL(fsinfo_generic_supports); +int fsinfo_generic_features(struct path *path, struct fsinfo_context *ctx) +{ + struct fsinfo_features *p = ctx->buffer; + struct super_block *sb = path->dentry->d_sb; + + fsinfo_init_features(p); + if (sb->s_mtd) + fsinfo_set_feature(p, FSINFO_FEAT_IS_FLASH_FS); + else if (sb->s_bdev) + fsinfo_set_feature(p, FSINFO_FEAT_IS_BLOCK_FS); + + if (sb->s_quota_types & QTYPE_MASK_USR) + fsinfo_set_feature(p, FSINFO_FEAT_USER_QUOTAS); + if (sb->s_quota_types & QTYPE_MASK_GRP) + fsinfo_set_feature(p, FSINFO_FEAT_GROUP_QUOTAS); + if (sb->s_quota_types & QTYPE_MASK_PRJ) + fsinfo_set_feature(p, FSINFO_FEAT_PROJECT_QUOTAS); + if (sb->s_d_op && sb->s_d_op->d_automount) + fsinfo_set_feature(p, FSINFO_FEAT_AUTOMOUNTS); + if (sb->s_id[0]) + fsinfo_set_feature(p, FSINFO_FEAT_VOLUME_ID); + if (sb->s_flags & SB_MANDLOCK) + fsinfo_set_feature(p, FSINFO_FEAT_MAND_LOCKS); + if (sb->s_flags & SB_POSIXACL) + fsinfo_set_feature(p, FSINFO_FEAT_HAS_ACL); + + fsinfo_set_feature(p, FSINFO_FEAT_HAS_ATIME); + fsinfo_set_feature(p, FSINFO_FEAT_HAS_CTIME); + fsinfo_set_feature(p, FSINFO_FEAT_HAS_MTIME); + return sizeof(*p); +} +EXPORT_SYMBOL(fsinfo_generic_features); + static const struct fsinfo_timestamp_info fsinfo_default_timestamp_info = { .atime = { .minimum = S64_MIN, @@ -206,6 +239,7 @@ static const struct fsinfo_attribute fsinfo_common_attributes[] = { FSINFO_VSTRUCT (FSINFO_ATTR_TIMESTAMP_INFO, fsinfo_generic_timestamp_info), FSINFO_STRING (FSINFO_ATTR_VOLUME_ID, fsinfo_generic_volume_id), FSINFO_VSTRUCT (FSINFO_ATTR_VOLUME_UUID, fsinfo_generic_volume_uuid), + FSINFO_VSTRUCT (FSINFO_ATTR_FEATURES, fsinfo_generic_features), FSINFO_LIST (FSINFO_ATTR_FSINFO_ATTRIBUTES, (void *)123UL), FSINFO_VSTRUCT_N(FSINFO_ATTR_FSINFO_ATTRIBUTE_INFO, (void *)123UL), diff --git a/include/linux/fsinfo.h b/include/linux/fsinfo.h index a811d69b02ff..517edd5a2791 100644 --- a/include/linux/fsinfo.h +++ b/include/linux/fsinfo.h @@ -68,6 +68,44 @@ extern int fsinfo_generic_supports(struct path *, struct fsinfo_context *); extern int fsinfo_generic_limits(struct path *, struct fsinfo_context *); extern int fsinfo_get_attribute(struct path *, struct fsinfo_context *, const struct fsinfo_attribute *); +extern int fsinfo_generic_features(struct path *, struct fsinfo_context *); + +static inline void fsinfo_init_features(struct fsinfo_features *p) +{ + p->nr_features = FSINFO_FEAT__NR; +} + +static inline void fsinfo_set_feature(struct fsinfo_features *p, + enum fsinfo_feature feature) +{ + p->features[feature / 8] |= 1 << (feature % 8); +} + +static inline void fsinfo_clear_feature(struct fsinfo_features *p, + enum fsinfo_feature feature) +{ + p->features[feature / 8] &= ~(1 << (feature % 8)); +} + +/** + * fsinfo_set_unix_features - Set standard UNIX features. + * @f: The features mask to alter + */ +static inline void fsinfo_set_unix_features(struct fsinfo_features *p) +{ + fsinfo_set_feature(p, FSINFO_FEAT_UIDS); + fsinfo_set_feature(p, FSINFO_FEAT_GIDS); + fsinfo_set_feature(p, FSINFO_FEAT_DIRECTORIES); + fsinfo_set_feature(p, FSINFO_FEAT_SYMLINKS); + fsinfo_set_feature(p, FSINFO_FEAT_HARD_LINKS); + fsinfo_set_feature(p, FSINFO_FEAT_DEVICE_FILES); + fsinfo_set_feature(p, FSINFO_FEAT_UNIX_SPECIALS); + fsinfo_set_feature(p, FSINFO_FEAT_SPARSE); + fsinfo_set_feature(p, FSINFO_FEAT_HAS_ATIME); + fsinfo_set_feature(p, FSINFO_FEAT_HAS_CTIME); + fsinfo_set_feature(p, FSINFO_FEAT_HAS_MTIME); + fsinfo_set_feature(p, FSINFO_FEAT_HAS_INODE_NUMBERS); +} #endif /* CONFIG_FSINFO */ diff --git a/include/uapi/linux/fsinfo.h b/include/uapi/linux/fsinfo.h index 65892239ba86..b8b2c836267b 100644 --- a/include/uapi/linux/fsinfo.h +++ b/include/uapi/linux/fsinfo.h @@ -23,6 +23,7 @@ #define FSINFO_ATTR_VOLUME_ID 0x05 /* Volume ID (string) */ #define FSINFO_ATTR_VOLUME_UUID 0x06 /* Volume UUID (LE uuid) */ #define FSINFO_ATTR_VOLUME_NAME 0x07 /* Volume name (string) */ +#define FSINFO_ATTR_FEATURES 0x08 /* Filesystem features (bits) */ #define FSINFO_ATTR_FSINFO_ATTRIBUTE_INFO 0x100 /* Information about attr N (for path) */ #define FSINFO_ATTR_FSINFO_ATTRIBUTES 0x101 /* List of supported attrs (for path) */ @@ -157,6 +158,73 @@ struct fsinfo_supports { #define FSINFO_ATTR_SUPPORTS__STRUCT struct fsinfo_supports +/* + * Information struct for fsinfo(FSINFO_ATTR_FEATURES). + * + * Bitmask indicating filesystem features where renderable as single bits. + */ +enum fsinfo_feature { + FSINFO_FEAT_IS_KERNEL_FS = 0, /* fs is kernel-special filesystem */ + FSINFO_FEAT_IS_BLOCK_FS = 1, /* fs is block-based filesystem */ + FSINFO_FEAT_IS_FLASH_FS = 2, /* fs is flash filesystem */ + FSINFO_FEAT_IS_NETWORK_FS = 3, /* fs is network filesystem */ + FSINFO_FEAT_IS_AUTOMOUNTER_FS = 4, /* fs is automounter special filesystem */ + FSINFO_FEAT_IS_MEMORY_FS = 5, /* fs is memory-based filesystem */ + FSINFO_FEAT_AUTOMOUNTS = 6, /* fs supports automounts */ + FSINFO_FEAT_ADV_LOCKS = 7, /* fs supports advisory file locking */ + FSINFO_FEAT_MAND_LOCKS = 8, /* fs supports mandatory file locking */ + FSINFO_FEAT_LEASES = 9, /* fs supports file leases */ + FSINFO_FEAT_UIDS = 10, /* fs supports numeric uids */ + FSINFO_FEAT_GIDS = 11, /* fs supports numeric gids */ + FSINFO_FEAT_PROJIDS = 12, /* fs supports numeric project ids */ + FSINFO_FEAT_STRING_USER_IDS = 13, /* fs supports string user identifiers */ + FSINFO_FEAT_GUID_USER_IDS = 14, /* fs supports GUID user identifiers */ + FSINFO_FEAT_WINDOWS_ATTRS = 15, /* fs has windows attributes */ + FSINFO_FEAT_USER_QUOTAS = 16, /* fs has per-user quotas */ + FSINFO_FEAT_GROUP_QUOTAS = 17, /* fs has per-group quotas */ + FSINFO_FEAT_PROJECT_QUOTAS = 18, /* fs has per-project quotas */ + FSINFO_FEAT_XATTRS = 19, /* fs has xattrs */ + FSINFO_FEAT_JOURNAL = 20, /* fs has a journal */ + FSINFO_FEAT_DATA_IS_JOURNALLED = 21, /* fs is using data journalling */ + FSINFO_FEAT_O_SYNC = 22, /* fs supports O_SYNC */ + FSINFO_FEAT_O_DIRECT = 23, /* fs supports O_DIRECT */ + FSINFO_FEAT_VOLUME_ID = 24, /* fs has a volume ID */ + FSINFO_FEAT_VOLUME_UUID = 25, /* fs has a volume UUID */ + FSINFO_FEAT_VOLUME_NAME = 26, /* fs has a volume name */ + FSINFO_FEAT_VOLUME_FSID = 27, /* fs has a volume FSID */ + FSINFO_FEAT_IVER_ALL_CHANGE = 28, /* i_version represents data + meta changes */ + FSINFO_FEAT_IVER_DATA_CHANGE = 29, /* i_version represents data changes only */ + FSINFO_FEAT_IVER_MONO_INCR = 30, /* i_version incremented monotonically */ + FSINFO_FEAT_DIRECTORIES = 31, /* fs supports (sub)directories */ + FSINFO_FEAT_SYMLINKS = 32, /* fs supports symlinks */ + FSINFO_FEAT_HARD_LINKS = 33, /* fs supports hard links */ + FSINFO_FEAT_HARD_LINKS_1DIR = 34, /* fs supports hard links in same dir only */ + FSINFO_FEAT_DEVICE_FILES = 35, /* fs supports bdev, cdev */ + FSINFO_FEAT_UNIX_SPECIALS = 36, /* fs supports pipe, fifo, socket */ + FSINFO_FEAT_RESOURCE_FORKS = 37, /* fs supports resource forks/streams */ + FSINFO_FEAT_NAME_CASE_INDEP = 38, /* Filename case independence is mandatory */ + FSINFO_FEAT_NAME_CASE_FOLD = 39, /* Filename case is folded on medium */ + FSINFO_FEAT_NAME_NON_UTF8 = 40, /* fs has non-utf8 names */ + FSINFO_FEAT_NAME_HAS_CODEPAGE = 41, /* fs has a filename codepage */ + FSINFO_FEAT_SPARSE = 42, /* fs supports sparse files */ + FSINFO_FEAT_NOT_PERSISTENT = 43, /* fs is not persistent */ + FSINFO_FEAT_NO_UNIX_MODE = 44, /* fs does not support unix mode bits */ + FSINFO_FEAT_HAS_ATIME = 45, /* fs supports access time */ + FSINFO_FEAT_HAS_BTIME = 46, /* fs supports birth/creation time */ + FSINFO_FEAT_HAS_CTIME = 47, /* fs supports change time */ + FSINFO_FEAT_HAS_MTIME = 48, /* fs supports modification time */ + FSINFO_FEAT_HAS_ACL = 49, /* fs supports ACLs of some sort */ + FSINFO_FEAT_HAS_INODE_NUMBERS = 50, /* fs has inode numbers */ + FSINFO_FEAT__NR +}; + +struct fsinfo_features { + __u32 nr_features; /* Number of supported features (FSINFO_FEAT__NR) */ + __u8 features[(FSINFO_FEAT__NR + 7) / 8]; +}; + +#define FSINFO_ATTR_FEATURES__STRUCT struct fsinfo_features + struct fsinfo_timestamp_one { __s64 minimum; /* Minimum timestamp value in seconds */ __s64 maximum; /* Maximum timestamp value in seconds */ diff --git a/samples/vfs/test-fsinfo.c b/samples/vfs/test-fsinfo.c index 934b25399ffe..c5932109f683 100644 --- a/samples/vfs/test-fsinfo.c +++ b/samples/vfs/test-fsinfo.c @@ -190,6 +190,75 @@ static void dump_fsinfo_generic_supports(void *reply, unsigned int size) printf("\twin_fattrs : %x\n", f->win_file_attrs); } +#define FSINFO_FEATURE_NAME(C) [FSINFO_FEAT_##C] = #C +static const char *fsinfo_feature_names[FSINFO_FEAT__NR] = { + FSINFO_FEATURE_NAME(IS_KERNEL_FS), + FSINFO_FEATURE_NAME(IS_BLOCK_FS), + FSINFO_FEATURE_NAME(IS_FLASH_FS), + FSINFO_FEATURE_NAME(IS_NETWORK_FS), + FSINFO_FEATURE_NAME(IS_AUTOMOUNTER_FS), + FSINFO_FEATURE_NAME(IS_MEMORY_FS), + FSINFO_FEATURE_NAME(AUTOMOUNTS), + FSINFO_FEATURE_NAME(ADV_LOCKS), + FSINFO_FEATURE_NAME(MAND_LOCKS), + FSINFO_FEATURE_NAME(LEASES), + FSINFO_FEATURE_NAME(UIDS), + FSINFO_FEATURE_NAME(GIDS), + FSINFO_FEATURE_NAME(PROJIDS), + FSINFO_FEATURE_NAME(STRING_USER_IDS), + FSINFO_FEATURE_NAME(GUID_USER_IDS), + FSINFO_FEATURE_NAME(WINDOWS_ATTRS), + FSINFO_FEATURE_NAME(USER_QUOTAS), + FSINFO_FEATURE_NAME(GROUP_QUOTAS), + FSINFO_FEATURE_NAME(PROJECT_QUOTAS), + FSINFO_FEATURE_NAME(XATTRS), + FSINFO_FEATURE_NAME(JOURNAL), + FSINFO_FEATURE_NAME(DATA_IS_JOURNALLED), + FSINFO_FEATURE_NAME(O_SYNC), + FSINFO_FEATURE_NAME(O_DIRECT), + FSINFO_FEATURE_NAME(VOLUME_ID), + FSINFO_FEATURE_NAME(VOLUME_UUID), + FSINFO_FEATURE_NAME(VOLUME_NAME), + FSINFO_FEATURE_NAME(VOLUME_FSID), + FSINFO_FEATURE_NAME(IVER_ALL_CHANGE), + FSINFO_FEATURE_NAME(IVER_DATA_CHANGE), + FSINFO_FEATURE_NAME(IVER_MONO_INCR), + FSINFO_FEATURE_NAME(DIRECTORIES), + FSINFO_FEATURE_NAME(SYMLINKS), + FSINFO_FEATURE_NAME(HARD_LINKS), + FSINFO_FEATURE_NAME(HARD_LINKS_1DIR), + FSINFO_FEATURE_NAME(DEVICE_FILES), + FSINFO_FEATURE_NAME(UNIX_SPECIALS), + FSINFO_FEATURE_NAME(RESOURCE_FORKS), + FSINFO_FEATURE_NAME(NAME_CASE_INDEP), + FSINFO_FEATURE_NAME(NAME_CASE_FOLD), + FSINFO_FEATURE_NAME(NAME_NON_UTF8), + FSINFO_FEATURE_NAME(NAME_HAS_CODEPAGE), + FSINFO_FEATURE_NAME(SPARSE), + FSINFO_FEATURE_NAME(NOT_PERSISTENT), + FSINFO_FEATURE_NAME(NO_UNIX_MODE), + FSINFO_FEATURE_NAME(HAS_ATIME), + FSINFO_FEATURE_NAME(HAS_BTIME), + FSINFO_FEATURE_NAME(HAS_CTIME), + FSINFO_FEATURE_NAME(HAS_MTIME), + FSINFO_FEATURE_NAME(HAS_ACL), + FSINFO_FEATURE_NAME(HAS_INODE_NUMBERS), +}; + +static void dump_fsinfo_generic_features(void *reply, unsigned int size) +{ + struct fsinfo_features *f = reply; + int i; + + printf("\n\t"); + for (i = 0; i < sizeof(f->features); i++) + printf("%02x", f->features[i]); + printf(" (nr=%u)\n", f->nr_features); + for (i = 0; i < FSINFO_FEAT__NR; i++) + if (f->features[i / 8] & (1 << (i % 8))) + printf("\t- %s\n", fsinfo_feature_names[i]); +} + static void print_time(struct fsinfo_timestamp_one *t, char stamp) { printf("\t%ctime : gran=%uE%d range=%llx-%llx\n", @@ -290,6 +359,7 @@ static const struct fsinfo_attribute fsinfo_attributes[] = { FSINFO_VSTRUCT (FSINFO_ATTR_IDS, fsinfo_generic_ids), FSINFO_VSTRUCT (FSINFO_ATTR_LIMITS, fsinfo_generic_limits), FSINFO_VSTRUCT (FSINFO_ATTR_SUPPORTS, fsinfo_generic_supports), + FSINFO_VSTRUCT (FSINFO_ATTR_FEATURES, fsinfo_generic_features), FSINFO_VSTRUCT (FSINFO_ATTR_TIMESTAMP_INFO, fsinfo_generic_timestamp_info), FSINFO_STRING (FSINFO_ATTR_VOLUME_ID, string), FSINFO_VSTRUCT (FSINFO_ATTR_VOLUME_UUID, fsinfo_generic_volume_uuid),