Hi all,

Today's linux-next merge of the jc_docs tree got a conflict in:

  Documentation/filesystems/f2fs.rst

between commits:

  38dff4e50c12 ("f2fs: add inline encryption support")
  a7c77c387b60 ("f2fs: fix to document reserved special compression extension")

from the fscrypt and f2fs trees and commit:

  9aa1ccb4e588 ("docs: f2fs: fix a broken table")

from the jc_docs tree.

I fixed it up (see below) and can carry the fix as necessary. This
is now fixed as far as linux-next is concerned, but any non trivial
conflicts should be mentioned to your upstream maintainer when your tree
is submitted for merging.  You may also want to consider cooperating
with the maintainer of the conflicting tree to minimise any particularly
complex conflicts.

-- 
Cheers,
Stephen Rothwell

diff --cc Documentation/filesystems/f2fs.rst
index 7b2649ee2ad7,1e7dade24a19..000000000000
--- a/Documentation/filesystems/f2fs.rst
+++ b/Documentation/filesystems/f2fs.rst
@@@ -101,173 -101,164 +101,173 @@@ Mount Option
  =============
  
  
- ====================== 
============================================================
- background_gc=%s       Turn on/off cleaning operations, namely garbage
-                        collection, triggered in background when I/O subsystem 
is
-                        idle. If background_gc=on, it will turn on the garbage
-                        collection and if background_gc=off, garbage collection
-                        will be turned off. If background_gc=sync, it will turn
-                        on synchronous garbage collection running in 
background.
-                        Default value for this option is on. So garbage
-                        collection is on by default.
- disable_roll_forward   Disable the roll-forward recovery routine
- norecovery             Disable the roll-forward recovery routine, mounted 
read-
-                        only (i.e., -o ro,disable_roll_forward)
- discard/nodiscard      Enable/disable real-time discard in f2fs, if discard is
-                        enabled, f2fs will issue discard/TRIM commands when a
-                      segment is cleaned.
- no_heap                Disable heap-style segment allocation which finds free
-                        segments for data from the beginning of main area, 
while
-                      for node from the end of main area.
- nouser_xattr           Disable Extended User Attributes. Note: xattr is 
enabled
-                        by default if CONFIG_F2FS_FS_XATTR is selected.
- noacl                  Disable POSIX Access Control List. Note: acl is enabled
-                        by default if CONFIG_F2FS_FS_POSIX_ACL is selected.
- active_logs=%u         Support configuring the number of active logs. In the
-                        current design, f2fs supports only 2, 4, and 6 logs.
-                        Default number is 6.
- disable_ext_identify   Disable the extension list configured by mkfs, so f2fs
-                        does not aware of cold files such as media files.
- inline_xattr           Enable the inline xattrs feature.
- noinline_xattr         Disable the inline xattrs feature.
- inline_xattr_size=%u   Support configuring inline xattr size, it depends on
-                      flexible inline xattr feature.
- inline_data            Enable the inline data feature: New created 
small(<~3.4k)
-                        files can be written into inode block.
- inline_dentry          Enable the inline dir feature: data in new created
-                        directory entries can be written into inode block. The
-                        space of inode block which is used to store inline
-                        dentries is limited to ~3.4k.
- noinline_dentry        Disable the inline dentry feature.
- flush_merge          Merge concurrent cache_flush commands as much as possible
-                        to eliminate redundant command issues. If the 
underlying
-                      device handles the cache_flush command relatively slowly,
-                      recommend to enable this option.
- nobarrier              This option can be used if underlying storage 
guarantees
-                        its cached data should be written to the novolatile 
area.
-                      If this option is set, no cache_flush commands are issued
-                      but f2fs still guarantees the write ordering of all the
-                      data writes.
- fastboot               This option is used when a system wants to reduce mount
-                        time as much as possible, even though normal 
performance
-                      can be sacrificed.
- extent_cache           Enable an extent cache based on rb-tree, it can cache
-                        as many as extent which map between contiguous logical
-                        address and physical address per inode, resulting in
-                        increasing the cache hit ratio. Set by default.
- noextent_cache         Disable an extent cache based on rb-tree explicitly, 
see
-                        the above extent_cache mount option.
- noinline_data          Disable the inline data feature, inline data feature is
-                        enabled by default.
- data_flush             Enable data flushing before checkpoint in order to
-                        persist data of regular and symlink.
- reserve_root=%d        Support configuring reserved space which is used for
-                        allocation from a privileged user with specified uid or
-                        gid, unit: 4KB, the default limit is 0.2% of user 
blocks.
- resuid=%d              The user ID which may use the reserved blocks.
- resgid=%d              The group ID which may use the reserved blocks.
- fault_injection=%d     Enable fault injection in all supported types with
-                        specified injection rate.
- fault_type=%d          Support configuring fault injection type, should be
-                        enabled with fault_injection option, fault type value
-                        is shown below, it supports single or combined type.
+ ======================== 
============================================================
+ background_gc=%s       Turn on/off cleaning operations, namely garbage
+                        collection, triggered in background when I/O subsystem 
is
+                        idle. If background_gc=on, it will turn on the garbage
+                        collection and if background_gc=off, garbage collection
+                        will be turned off. If background_gc=sync, it will turn
+                        on synchronous garbage collection running in 
background.
+                        Default value for this option is on. So garbage
+                        collection is on by default.
+ disable_roll_forward   Disable the roll-forward recovery routine
+ norecovery             Disable the roll-forward recovery routine, mounted 
read-
+                        only (i.e., -o ro,disable_roll_forward)
+ discard/nodiscard      Enable/disable real-time discard in f2fs, if discard is
+                        enabled, f2fs will issue discard/TRIM commands when a
+                        segment is cleaned.
+ no_heap                        Disable heap-style segment allocation which 
finds free
+                        segments for data from the beginning of main area, 
while
+                        for node from the end of main area.
+ nouser_xattr           Disable Extended User Attributes. Note: xattr is 
enabled
+                        by default if CONFIG_F2FS_FS_XATTR is selected.
+ noacl                  Disable POSIX Access Control List. Note: acl is enabled
+                        by default if CONFIG_F2FS_FS_POSIX_ACL is selected.
+ active_logs=%u                 Support configuring the number of active logs. 
In the
+                        current design, f2fs supports only 2, 4, and 6 logs.
+                        Default number is 6.
+ disable_ext_identify   Disable the extension list configured by mkfs, so f2fs
+                        does not aware of cold files such as media files.
+ inline_xattr           Enable the inline xattrs feature.
+ noinline_xattr                 Disable the inline xattrs feature.
+ inline_xattr_size=%u   Support configuring inline xattr size, it depends on
+                        flexible inline xattr feature.
+ inline_data            Enable the inline data feature: New created 
small(<~3.4k)
+                        files can be written into inode block.
+ inline_dentry          Enable the inline dir feature: data in new created
+                        directory entries can be written into inode block. The
+                        space of inode block which is used to store inline
+                        dentries is limited to ~3.4k.
+ noinline_dentry                Disable the inline dentry feature.
+ flush_merge            Merge concurrent cache_flush commands as much as 
possible
+                        to eliminate redundant command issues. If the 
underlying
+                        device handles the cache_flush command relatively 
slowly,
+                        recommend to enable this option.
+ nobarrier              This option can be used if underlying storage 
guarantees
+                        its cached data should be written to the novolatile 
area.
+                        If this option is set, no cache_flush commands are 
issued
+                        but f2fs still guarantees the write ordering of all the
+                        data writes.
+ fastboot               This option is used when a system wants to reduce mount
+                        time as much as possible, even though normal 
performance
+                        can be sacrificed.
+ extent_cache           Enable an extent cache based on rb-tree, it can cache
+                        as many as extent which map between contiguous logical
+                        address and physical address per inode, resulting in
+                        increasing the cache hit ratio. Set by default.
+ noextent_cache                 Disable an extent cache based on rb-tree 
explicitly, see
+                        the above extent_cache mount option.
+ noinline_data          Disable the inline data feature, inline data feature is
+                        enabled by default.
+ data_flush             Enable data flushing before checkpoint in order to
+                        persist data of regular and symlink.
+ reserve_root=%d                Support configuring reserved space which is 
used for
+                        allocation from a privileged user with specified uid or
+                        gid, unit: 4KB, the default limit is 0.2% of user 
blocks.
+ resuid=%d              The user ID which may use the reserved blocks.
+ resgid=%d              The group ID which may use the reserved blocks.
+ fault_injection=%d     Enable fault injection in all supported types with
+                        specified injection rate.
+ fault_type=%d          Support configuring fault injection type, should be
+                        enabled with fault_injection option, fault type value
+                        is shown below, it supports single or combined type.
  
-                        ===================    ===========
-                        Type_Name              Type_Value
-                        ===================    ===========
-                        FAULT_KMALLOC          0x000000001
-                        FAULT_KVMALLOC         0x000000002
-                        FAULT_PAGE_ALLOC               0x000000004
-                        FAULT_PAGE_GET         0x000000008
-                        FAULT_ALLOC_BIO                0x000000010
-                        FAULT_ALLOC_NID                0x000000020
-                        FAULT_ORPHAN           0x000000040
-                        FAULT_BLOCK            0x000000080
-                        FAULT_DIR_DEPTH                0x000000100
-                        FAULT_EVICT_INODE      0x000000200
-                        FAULT_TRUNCATE         0x000000400
-                        FAULT_READ_IO          0x000000800
-                        FAULT_CHECKPOINT               0x000001000
-                        FAULT_DISCARD          0x000002000
-                        FAULT_WRITE_IO         0x000004000
-                        ===================    ===========
- mode=%s                Control block allocation mode which supports "adaptive"
-                        and "lfs". In "lfs" mode, there should be no random
-                        writes towards main area.
- io_bits=%u             Set the bit size of write IO requests. It should be set
-                        with "mode=lfs".
- usrquota               Enable plain user disk quota accounting.
- grpquota               Enable plain group disk quota accounting.
- prjquota               Enable plain project quota accounting.
- usrjquota=<file>       Appoint specified file and type during mount, so that 
quota
- grpjquota=<file>       information can be properly updated during recovery 
flow,
- prjjquota=<file>       <quota file>: must be in root directory;
- jqfmt=<quota type>     <quota type>: [vfsold,vfsv0,vfsv1].
- offusrjquota           Turn off user journelled quota.
- offgrpjquota           Turn off group journelled quota.
- offprjjquota           Turn off project journelled quota.
- quota                  Enable plain user disk quota accounting.
- noquota                Disable all plain disk quota option.
- whint_mode=%s          Control which write hints are passed down to block
-                        layer. This supports "off", "user-based", and
-                        "fs-based".  In "off" mode (default), f2fs does not 
pass
-                        down hints. In "user-based" mode, f2fs tries to pass
-                        down hints given by users. And in "fs-based" mode, f2fs
-                        passes down hints with its policy.
- alloc_mode=%s          Adjust block allocation policy, which supports "reuse"
-                        and "default".
- fsync_mode=%s          Control the policy of fsync. Currently supports 
"posix",
-                        "strict", and "nobarrier". In "posix" mode, which is
-                        default, fsync will follow POSIX semantics and does a
-                        light operation to improve the filesystem performance.
-                        In "strict" mode, fsync will be heavy and behaves in 
line
-                        with xfs, ext4 and btrfs, where xfstest generic/342 
will
-                        pass, but the performance will regress. "nobarrier" is
-                        based on "posix", but doesn't issue flush command for
-                        non-atomic files likewise "nobarrier" mount option.
+                        ===================      ===========
+                        Type_Name                Type_Value
+                        ===================      ===========
+                        FAULT_KMALLOC            0x000000001
+                        FAULT_KVMALLOC           0x000000002
+                        FAULT_PAGE_ALLOC         0x000000004
+                        FAULT_PAGE_GET           0x000000008
+                        FAULT_ALLOC_BIO          0x000000010
+                        FAULT_ALLOC_NID          0x000000020
+                        FAULT_ORPHAN             0x000000040
+                        FAULT_BLOCK              0x000000080
+                        FAULT_DIR_DEPTH          0x000000100
+                        FAULT_EVICT_INODE        0x000000200
+                        FAULT_TRUNCATE           0x000000400
+                        FAULT_READ_IO            0x000000800
+                        FAULT_CHECKPOINT         0x000001000
+                        FAULT_DISCARD            0x000002000
+                        FAULT_WRITE_IO           0x000004000
+                        ===================      ===========
+ mode=%s                        Control block allocation mode which supports 
"adaptive"
+                        and "lfs". In "lfs" mode, there should be no random
+                        writes towards main area.
+ io_bits=%u             Set the bit size of write IO requests. It should be set
+                        with "mode=lfs".
+ usrquota               Enable plain user disk quota accounting.
+ grpquota               Enable plain group disk quota accounting.
+ prjquota               Enable plain project quota accounting.
+ usrjquota=<file>       Appoint specified file and type during mount, so that 
quota
+ grpjquota=<file>       information can be properly updated during recovery 
flow,
+ prjjquota=<file>       <quota file>: must be in root directory;
+ jqfmt=<quota type>     <quota type>: [vfsold,vfsv0,vfsv1].
+ offusrjquota           Turn off user journelled quota.
+ offgrpjquota           Turn off group journelled quota.
+ offprjjquota           Turn off project journelled quota.
+ quota                  Enable plain user disk quota accounting.
+ noquota                        Disable all plain disk quota option.
+ whint_mode=%s          Control which write hints are passed down to block
+                        layer. This supports "off", "user-based", and
+                        "fs-based".  In "off" mode (default), f2fs does not 
pass
+                        down hints. In "user-based" mode, f2fs tries to pass
+                        down hints given by users. And in "fs-based" mode, f2fs
+                        passes down hints with its policy.
+ alloc_mode=%s          Adjust block allocation policy, which supports "reuse"
+                        and "default".
+ fsync_mode=%s          Control the policy of fsync. Currently supports 
"posix",
+                        "strict", and "nobarrier". In "posix" mode, which is
+                        default, fsync will follow POSIX semantics and does a
+                        light operation to improve the filesystem performance.
+                        In "strict" mode, fsync will be heavy and behaves in 
line
+                        with xfs, ext4 and btrfs, where xfstest generic/342 
will
+                        pass, but the performance will regress. "nobarrier" is
+                        based on "posix", but doesn't issue flush command for
+                        non-atomic files likewise "nobarrier" mount option.
  test_dummy_encryption
  test_dummy_encryption=%s
-                        Enable dummy encryption, which provides a fake fscrypt
-                        context. The fake fscrypt context is used by xfstests.
-                        The argument may be either "v1" or "v2", in order to
-                        select the corresponding fscrypt policy version.
- checkpoint=%s[:%u[%]]  Set to "disable" to turn off checkpointing. Set to 
"enable"
-                        to reenable checkpointing. Is enabled by default. While
-                        disabled, any unmounting or unexpected shutdowns will 
cause
-                        the filesystem contents to appear as they did when the
-                        filesystem was mounted with that option.
-                        While mounting with checkpoint=disabled, the 
filesystem must
-                        run garbage collection to ensure that all available 
space can
-                        be used. If this takes too much time, the mount may 
return
-                        EAGAIN. You may optionally add a value to indicate how 
much
-                        of the disk you would be willing to temporarily give 
up to
-                        avoid additional garbage collection. This can be given 
as a
-                        number of blocks, or as a percent. For instance, 
mounting
-                        with checkpoint=disable:100% would always succeed, but 
it may
-                        hide up to all remaining free space. The actual space 
that
-                        would be unusable can be viewed at 
/sys/fs/f2fs/<disk>/unusable
-                        This space is reclaimed once checkpoint=enable.
- compress_algorithm=%s  Control compress algorithm, currently f2fs supports 
"lzo",
-                        "lz4", "zstd" and "lzo-rle" algorithm.
- compress_log_size=%u   Support configuring compress cluster size, the size 
will
-                        be 4KB * (1 << %u), 16KB is minimum size, also it's
-                        default size.
- compress_extension=%s  Support adding specified extension, so that f2fs can 
enable
-                        compression on those corresponding files, e.g. if all 
files
-                        with '.ext' has high compression rate, we can set the 
'.ext'
-                        on compression extension list and enable compression on
-                        these file by default rather than to enable it via 
ioctl.
-                        For other files, we can still enable compression via 
ioctl.
-                        Note that, there is one reserved special extension 
'*', it
-                        can be set to enable compression for all files.
+                        Enable dummy encryption, which provides a fake fscrypt
+                        context. The fake fscrypt context is used by xfstests.
+                        The argument may be either "v1" or "v2", in order to
+                        select the corresponding fscrypt policy version.
+ checkpoint=%s[:%u[%]]  Set to "disable" to turn off checkpointing. Set to 
"enable"
+                        to reenable checkpointing. Is enabled by default. While
+                        disabled, any unmounting or unexpected shutdowns will 
cause
+                        the filesystem contents to appear as they did when the
+                        filesystem was mounted with that option.
+                        While mounting with checkpoint=disabled, the 
filesystem must
+                        run garbage collection to ensure that all available 
space can
+                        be used. If this takes too much time, the mount may 
return
+                        EAGAIN. You may optionally add a value to indicate how 
much
+                        of the disk you would be willing to temporarily give 
up to
+                        avoid additional garbage collection. This can be given 
as a
+                        number of blocks, or as a percent. For instance, 
mounting
+                        with checkpoint=disable:100% would always succeed, but 
it may
+                        hide up to all remaining free space. The actual space 
that
+                        would be unusable can be viewed at 
/sys/fs/f2fs/<disk>/unusable
+                        This space is reclaimed once checkpoint=enable.
+ compress_algorithm=%s  Control compress algorithm, currently f2fs supports 
"lzo",
+                        "lz4", "zstd" and "lzo-rle" algorithm.
+ compress_log_size=%u   Support configuring compress cluster size, the size 
will
+                        be 4KB * (1 << %u), 16KB is minimum size, also it's
+                        default size.
+ compress_extension=%s  Support adding specified extension, so that f2fs can 
enable
+                        compression on those corresponding files, e.g. if all 
files
+                        with '.ext' has high compression rate, we can set the 
'.ext'
+                        on compression extension list and enable compression on
+                        these file by default rather than to enable it via 
ioctl.
+                        For other files, we can still enable compression via 
ioctl.
++                       Note that, there is one reserved special extension 
'*', it
++                       can be set to enable compression for all files.
 +inlinecrypt
-                        When possible, encrypt/decrypt the contents of 
encrypted
-                        files using the blk-crypto framework rather than
-                        filesystem-layer encryption. This allows the use of
-                        inline encryption hardware. The on-disk format is
-                        unaffected. For more details, see
-                        Documentation/block/inline-encryption.rst.
- ====================== 
============================================================
++                       When possible, encrypt/decrypt the contents of 
encrypted
++                       files using the blk-crypto framework rather than
++                       filesystem-layer encryption. This allows the use of
++                       inline encryption hardware. The on-disk format is
++                       unaffected. For more details, see
++                       Documentation/block/inline-encryption.rst.
+ ======================== 
============================================================
  
  Debugfs Entries
  ===============

Attachment: pgp58WhXZH3KO.pgp
Description: OpenPGP digital signature

Reply via email to