From 21a7a35e7ad1fe70815601693a83f7c5f6e298ed Mon Sep 17 00:00:00 2001 From: Takashi Iwai Date: Apr 19 2024 16:27:39 +0000 Subject: Documentation: Add missing documentation for EXPORT_OP flags (stable-fixes). --- diff --git a/patches.suse/Documentation-Add-missing-documentation-for-EXPORT_O.patch b/patches.suse/Documentation-Add-missing-documentation-for-EXPORT_O.patch new file mode 100644 index 0000000..b9cf3ae --- /dev/null +++ b/patches.suse/Documentation-Add-missing-documentation-for-EXPORT_O.patch @@ -0,0 +1,55 @@ +From b38a6023da6a12b561f0421c6a5a1f7624a1529c Mon Sep 17 00:00:00 2001 +From: Chuck Lever +Date: Fri, 25 Aug 2023 15:04:23 -0400 +Subject: [PATCH] Documentation: Add missing documentation for EXPORT_OP flags +Git-commit: b38a6023da6a12b561f0421c6a5a1f7624a1529c +Patch-mainline: v6.6-rc1 +References: stable-fixes + +The commits that introduced these flags neglected to update the +Documentation/filesystems/nfs/exporting.rst file. + +Signed-off-by: Chuck Lever +Acked-by: Takashi Iwai + +--- + Documentation/filesystems/nfs/exporting.rst | 26 +++++++++++++++++++++ + 1 file changed, 26 insertions(+) + +diff --git a/Documentation/filesystems/nfs/exporting.rst b/Documentation/filesystems/nfs/exporting.rst +index 3d97b8d8f735..4b30daee399a 100644 +--- a/Documentation/filesystems/nfs/exporting.rst ++++ b/Documentation/filesystems/nfs/exporting.rst +@@ -215,3 +215,29 @@ following flags are defined: + This flag causes nfsd to close any open files for this inode _before_ + calling into the vfs to do an unlink or a rename that would replace + an existing file. ++ ++ EXPORT_OP_REMOTE_FS - Backing storage for this filesystem is remote ++ PF_LOCAL_THROTTLE exists for loopback NFSD, where a thread needs to ++ write to one bdi (the final bdi) in order to free up writes queued ++ to another bdi (the client bdi). Such threads get a private balance ++ of dirty pages so that dirty pages for the client bdi do not imact ++ the daemon writing to the final bdi. For filesystems whose durable ++ storage is not local (such as exported NFS filesystems), this ++ constraint has negative consequences. EXPORT_OP_REMOTE_FS enables ++ an export to disable writeback throttling. ++ ++ EXPORT_OP_NOATOMIC_ATTR - Filesystem does not update attributes atomically ++ EXPORT_OP_NOATOMIC_ATTR indicates that the exported filesystem ++ cannot provide the semantics required by the "atomic" boolean in ++ NFSv4's change_info4. This boolean indicates to a client whether the ++ returned before and after change attributes were obtained atomically ++ with the respect to the requested metadata operation (UNLINK, ++ OPEN/CREATE, MKDIR, etc). ++ ++ EXPORT_OP_FLUSH_ON_CLOSE - Filesystem flushes file data on close(2) ++ On most filesystems, inodes can remain under writeback after the ++ file is closed. NFSD relies on client activity or local flusher ++ threads to handle writeback. Certain filesystems, such as NFS, flush ++ all of an inode's dirty data on last close. Exports that behave this ++ way should set EXPORT_OP_FLUSH_ON_CLOSE so that NFSD knows to skip ++ waiting for writeback when closing such files. +-- +2.43.0 + diff --git a/series.conf b/series.conf index 8395d8f..da0c5f7 100644 --- a/series.conf +++ b/series.conf @@ -43762,6 +43762,7 @@ patches.suse/jfs-validate-max-amount-of-blocks-before-allocation.patch patches.suse/fs-lockd-avoid-possible-wrong-NULL-parameter.patch patches.suse/NFSD-da_addr_body-field-missing-in-some-GETDEVICEINF.patch + patches.suse/Documentation-Add-missing-documentation-for-EXPORT_O.patch patches.suse/NFSv4-pnfs-minor-fix-for-cleanup-path-in-nfs4_get_de.patch patches.suse/nfs-blocklayout-Use-the-passed-in-gfp-flags.patch patches.suse/NFS-Fix-a-potential-data-corruption.patch