From patchwork Sat Jul 13 18:15:46 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13732468 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3311F225D6; Sat, 13 Jul 2024 18:15:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720894559; cv=none; b=rbuhiJHBx9DKnvwOt9Fio3u0o2WnakmKwxA4YTAP67ekeoZv+mKw7kqmWWNhJzbpVSoHd6vy5ZRUmdTFdMEhJ3+IkRQPXfyt7tBW/NqBprlmZ9ViG4wVW+BzhCTkndNs/IlPvAZ0gJ8Mkv69yVF7r+iGNl65sOwZ/BAJPmXdAiI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720894559; c=relaxed/simple; bh=mFtpr0dY9Cb2O+EY7ksWwDDqCjYXeDMbFuFEwfTXW3I=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=HjJrMkezcwVe/b2iLY+LcpON8lnedHaWQTmROx013lL4A9y/MrvHcGwvSgIHr8dZZErtuPrjb6GWRjeSzPg3t4nSHHozfT+kpf5JnduxJ07U2rIKdJ8wbJjcVZCwWHYzYJlrkGdjjAE0ED9tfWUv7YIg9kTQTw9CRgIGnU87EZg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=cs806t9d; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="cs806t9d" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 40922C32781; Sat, 13 Jul 2024 18:15:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1720894558; bh=mFtpr0dY9Cb2O+EY7ksWwDDqCjYXeDMbFuFEwfTXW3I=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=cs806t9dZGGTP1v0MHuRtE9KB/Wx+N70EHU3FCTpMSoImkOa+BIKlXopGaCJEb8mq KRecXYbL89Jr/SCvk042h32Nxup4dEby1PZ/74vZZS5Rwz7kPXXzh6opGqmhzPoGF/ x4bS9fJurVnlyt9H7yv3JM8uVsMdNzlG7+Oq+ExP0A3wW62zgSvGE/m98ikbXEBpqs UtFUr85koOc6Pp954Qeam+bjaRkt1QYV3TC2cC1Q3lcJOWNRUrSiWUbybmVdKpdar6 QYx4KGCyqrS2AROURuZMTFX8qMfDjR1ZuyvXF+Rp2n7z2SUvNaR4V6S4+vBuKNIg1F C+b0WhggJ7IIQ== From: cel@kernel.org To: alx@kernel.org Cc: linux-man@vger.kernel.org, linux-fsdevel@vger.kernel.org, amir73il@gmail.com, Chuck Lever Subject: [PATCH v2 1/3] fanotify_mark(2): Support for FA_ flags has been backported to LTS kernels Date: Sat, 13 Jul 2024 14:15:46 -0400 Message-ID: <20240713181548.38002-2-cel@kernel.org> X-Mailer: git-send-email 2.45.1 In-Reply-To: <20240713181548.38002-1-cel@kernel.org> References: <20240713181548.38002-1-cel@kernel.org> Precedence: bulk X-Mailing-List: linux-fsdevel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: Chuck Lever Reviewed-by: Amir Goldstein Signed-off-by: Chuck Lever --- man/man2/fanotify_mark.2 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/man/man2/fanotify_mark.2 b/man/man2/fanotify_mark.2 index f3fce0c4e4c4..edeadc883029 100644 --- a/man/man2/fanotify_mark.2 +++ b/man/man2/fanotify_mark.2 @@ -176,7 +176,7 @@ the update fails with .B EEXIST error. .TP -.BR FAN_MARK_IGNORE " (since Linux 6.0)" +.BR FAN_MARK_IGNORE " (since Linux 6.0, 5.15.154, and 5.10.220)" .\" commit e252f2ed1c8c6c3884ab5dd34e003ed21f1fe6e0 This flag has a similar effect as setting the .B FAN_MARK_IGNORED_MASK @@ -271,7 +271,7 @@ error. This is a synonym for .RB ( FAN_MARK_IGNORE | FAN_MARK_IGNORED_SURV_MODIFY ). .TP -.BR FAN_MARK_EVICTABLE " (since Linux 5.19)" +.BR FAN_MARK_EVICTABLE " (since Linux 5.19, 5.15.154, and 5.10.220)" .\" commit 5f9d3bd520261fd7a850818c71809fd580e0f30c When an inode mark is created with this flag, the inode object will not be pinned to the inode cache, @@ -362,7 +362,7 @@ Create an event when a marked file or directory itself is deleted. An fanotify group that identifies filesystem objects by file handles is required. .TP -.BR FAN_FS_ERROR " (since Linux 5.16)" +.BR FAN_FS_ERROR " (since Linux 5.16, 5.15.154, and 5.10.220)" .\" commit 9709bd548f11a092d124698118013f66e1740f9b Create an event when a filesystem error leading to inconsistent filesystem metadata is detected. @@ -399,7 +399,7 @@ directory. An fanotify group that identifies filesystem objects by file handles is required. .TP -.BR FAN_RENAME " (since Linux 5.17)" +.BR FAN_RENAME " (since Linux 5.17, 5.15.154, and 5.10.220)" .\" commit 8cc3b1ccd930fe6971e1527f0c4f1bdc8cb56026 This event contains the same information provided by events .B FAN_MOVED_FROM From patchwork Sat Jul 13 18:15:47 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13732469 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C76EE38DE9; Sat, 13 Jul 2024 18:16:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720894563; cv=none; b=a6P4GrUYcl0R4cZQPLhcQWKyHEIHe2Jkxla3SrsYOsiIOkzKJE2REK7ihuBOncEKZIsAxGatM6t+wmpUwwkaEkqJwQ2BnpSWHsJ5i1VAneBIqxsEiQbGf8CEdMugwovSbdrxseKE8ISt4ojAB57Q0T0raC6ipk/niKKbpqVXV/M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720894563; c=relaxed/simple; bh=+qTLGq03NqhUfWuqMDQ4NcOhN6T1QhHQ8lm52omYFzQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=a71iF28CWuAIWBHcUv1xl8kdhK/Bx740RjJx8JTY8hLYofabmdJDw9HkMDucqHdlMr89+YAOqjZjsgXg/8c8DIH4+/Xb5ELrLTqsjT950ClkInYCqY8HYWVLjpN4/HrTk0k3/sgYUYhgE4/tRiCWYQLASTKwqw3yZLMF3IRL89U= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=dRIafl81; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="dRIafl81" Received: by smtp.kernel.org (Postfix) with ESMTPSA id D7262C32781; Sat, 13 Jul 2024 18:16:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1720894563; bh=+qTLGq03NqhUfWuqMDQ4NcOhN6T1QhHQ8lm52omYFzQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=dRIafl81T+UTCIk7Gl+8ahE4raeQLpSAvACRno93farIwTs7pbH/UInNlIEdfei8g jRj3GXlu9QGeKEgti5qUEn7EZ+tUbBrAFBOWxlY/gFGzSIvDT2b61Pq3/K78cOCQ+K B3eEo/SMTDMDteuC6lP35ImBEj1hae8i8shn+b7h72pKeT+G+A6zVs9gu0f3eenBBD f46B6UqXc0G1IOBaLzH/Jl5Cg/J/Kxn2LRTaBdSZIyTxo7GRcuR3GQMR2gweXbawVE C+TY+5hqV14ap7zhHXcfChBFyg0iSkaI3d+BcfO1kN4DjhPFk7MiziPEJjqGzsx961 fj6ooQXVzwHbg== From: cel@kernel.org To: alx@kernel.org Cc: linux-man@vger.kernel.org, linux-fsdevel@vger.kernel.org, amir73il@gmail.com, Chuck Lever Subject: [PATCH v2 2/3] fanotify_init(2): Support for FA_ flags has been backported to LTS kernels Date: Sat, 13 Jul 2024 14:15:47 -0400 Message-ID: <20240713181548.38002-3-cel@kernel.org> X-Mailer: git-send-email 2.45.1 In-Reply-To: <20240713181548.38002-1-cel@kernel.org> References: <20240713181548.38002-1-cel@kernel.org> Precedence: bulk X-Mailing-List: linux-fsdevel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: Chuck Lever Signed-off-by: Chuck Lever Reviewed-by: Amir Goldstein --- man/man2/fanotify_init.2 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/man/man2/fanotify_init.2 b/man/man2/fanotify_init.2 index e5f9cbf298ee..12378ac05255 100644 --- a/man/man2/fanotify_init.2 +++ b/man/man2/fanotify_init.2 @@ -295,7 +295,7 @@ for additional details. This is a synonym for .RB ( FAN_REPORT_DIR_FID | FAN_REPORT_NAME ). .TP -.BR FAN_REPORT_TARGET_FID " (since Linux 5.17)" +.BR FAN_REPORT_TARGET_FID " (since Linux 5.17, 5.15.154, and 5.10.220)" .\" commit d61fd650e9d206a71fda789f02a1ced4b19944c4 Events for fanotify groups initialized with this flag will contain additional information about the child @@ -330,7 +330,7 @@ that the directory entry is referring to. This is a synonym for .RB ( FAN_REPORT_DFID_NAME | FAN_REPORT_FID | FAN_REPORT_TARGET_FID ). .TP -.BR FAN_REPORT_PIDFD " (since Linux 5.15)" +.BR FAN_REPORT_PIDFD " (since Linux 5.15 and 5.10.220)" .\" commit af579beb666aefb17e9a335c12c788c92932baf1 Events for fanotify groups initialized with this flag will contain an additional information record alongside the generic @@ -460,14 +460,14 @@ The fanotify API is available only if the kernel was configured with .B EPERM The operation is not permitted because the caller lacks a required capability. .SH VERSIONS -Prior to Linux 5.13, +Prior to Linux 5.13 (and 5.10.220), .\" commit 7cea2a3c505e87a9d6afc78be4a7f7be636a73a7 calling .BR fanotify_init () required the .B CAP_SYS_ADMIN capability. -Since Linux 5.13, +Since Linux 5.13 (and 5.10.220), .\" commit 7cea2a3c505e87a9d6afc78be4a7f7be636a73a7 users may call .BR fanotify_init () From patchwork Sat Jul 13 18:15:48 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13732470 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 1947838DE9; Sat, 13 Jul 2024 18:16:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720894568; cv=none; b=t1IpHezFQsSAbcgPk7R2P6mYNGU0TtFSXvmUqhGrV7bXrpE/VscZw52ODz2nLyRkfWt+Bgs9igB2avOKSvbY0Cl/nJZ21k6T7SlEKatx/6Joc6ZraKz9Mv8bqRUW6Ew1jHFTi2DUiL8wzxiXwAkp94y3tDFhPgol6udMim4X648= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720894568; c=relaxed/simple; bh=bB0TA5dG6tc/W3ylFVE6nqtio2DT5XLtrjbsTls3Uc4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=lz7fDuW7WUWDQFdWcurVncjwQVCvkzEhMZi2rEGIusskmIkqk1oVWSNQsbS2JQ7NvlxAlAmyveMEGfO01cDLI3WQgCkUh3fzJZaxg4IuQkKjQGku+qn5i9O1YIpdloFz2SzQthexPq7JxqUKEvNMKPdL87xLwtoccUmPCSKrjvc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=kI3F/I1I; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="kI3F/I1I" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 129AAC32781; Sat, 13 Jul 2024 18:16:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1720894567; bh=bB0TA5dG6tc/W3ylFVE6nqtio2DT5XLtrjbsTls3Uc4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=kI3F/I1IvXsQY7ItWWxWvCS3yz+kPFWxuW39O1OLmYgsuaxCIYXJ0bCm+Ge9Pk3en zy00UqUm17ecGjM8lxGwxaSqajPXG5lw3MKAdmPcjwRj0D63k9oD6dZTmKXT/z3Unk gx+7r2FRXUGmCF3hCkhnwSm/5CGZ6fP4XLm2/NUwRt7tM52DDJ6RS3ad8XP8BXVcQk Taelg5uqAlDTBwJkA0xBxfEqGdN+p6bZZmSrU2zMBll4XKAzQx1ZBpe9khVe9CyHE9 QQuuqSejgVaNPzGO9huzan+tvaEzU8tOvslv5td+oPRFa43K3b504gFcORNpN2/o4X cC1d3vIVrrZyw== From: cel@kernel.org To: alx@kernel.org Cc: linux-man@vger.kernel.org, linux-fsdevel@vger.kernel.org, amir73il@gmail.com, Chuck Lever Subject: [PATCH v2 3/3] fanotify(7): Document changes backported to LTS kernels Date: Sat, 13 Jul 2024 14:15:48 -0400 Message-ID: <20240713181548.38002-4-cel@kernel.org> X-Mailer: git-send-email 2.45.1 In-Reply-To: <20240713181548.38002-1-cel@kernel.org> References: <20240713181548.38002-1-cel@kernel.org> Precedence: bulk X-Mailing-List: linux-fsdevel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: Chuck Lever Signed-off-by: Chuck Lever Reviewed-by: Amir Goldstein --- man/man7/fanotify.7 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/man/man7/fanotify.7 b/man/man7/fanotify.7 index 3733543013d5..449af949c0a8 100644 --- a/man/man7/fanotify.7 +++ b/man/man7/fanotify.7 @@ -825,7 +825,7 @@ See .BR proc (5) for details. .P -Since Linux 5.13, +Since Linux 5.13 (and 5.10.220), .\" commit 5b8fea65d197f408bb00b251c70d842826d6b70b the following interfaces can be used to control the amount of kernel resources consumed by fanotify: