On 8/21/20 9:25 AM, Konstantin Komarov wrote:
> This adds fs/ntfs3 Kconfig, Makefile and Documentation file
>
> Signed-off-by: Konstantin Komarov <almaz.alexandrovich@xxxxxxxxxxxxxxxxxxxx>
> ---
> Documentation/filesystems/ntfs3.rst | 93 +++++++++++++++++++++++++++++
> fs/ntfs3/Kconfig | 23 +++++++
> fs/ntfs3/Makefile | 11 ++++
> 3 files changed, 127 insertions(+)
> create mode 100644 Documentation/filesystems/ntfs3.rst
> create mode 100644 fs/ntfs3/Kconfig
> create mode 100644 fs/ntfs3/Makefile
>
> diff --git a/Documentation/filesystems/ntfs3.rst b/Documentation/filesystems/ntfs3.rst
> new file mode 100644
> index 000000000000..4a510a6cdaee
> --- /dev/null
> +++ b/Documentation/filesystems/ntfs3.rst
> @@ -0,0 +1,93 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +=====
> +NTFS3
> +=====
> +
> +
> +Summary and Features
> +====================
> +
> +NTFS3 is fully functional NTFS Read-Write driver. The driver works with
> +NTFS versions up to 3.1, normal/compressed/sparse files
> +and journal replaying. File system type to use on mount is 'ntfs3'.
> +
> +- This driver implements NTFS read/write support for normal, sparsed and
sparse
> + compressed files.
> + NOTE: Operations with compressed files require increased memory consumption;
> +- Supports native journal replaying;
> +- Supports extended attributes;
> +- Supports NFS export of mounted NTFS volumes.
> +
> +Mount Options
> +=============
> +
> +The list below describes mount options supported by NTFS3 driver in addtion to
addition
> +generic ones.
> +
> +===============================================================================
> +
> +nls=name These options inform the driver how to interpret path
> + strings and translate them to Unicode and back. In case
> + none of these options are set, or if specified codepage
> + doesn't exist on the system, the default codepage will be
> + used (CONFIG_NLS_DEFAULT).
> + Examples:
> + 'nls=utf8'
> +
> +uid=
> +gid=
> +umask= Controls the default permissions for files/directories created
> + after the NTFS volume is mounted.
> +
> +fmask=
> +dmask= Instead of specifying umask which applies both to
> + files and directories, fmask applies only to files and
> + dmask only to directories.
> +
> +nohidden Files with the Windows-specific HIDDEN (FILE_ATTRIBUTE_HIDDEN)
> + attribute will not be shown under Linux.
Without this mount option, will HIDDEN files be shown by default?
> +
> +sys_immutable Files with the Windows-specific SYSTEM
> + (FILE_ATTRIBUTE_SYSTEM) attribute will be marked as system
> + immutable files.
> +
> +discard Enable support of the TRIM command for improved performance
> + on delete operations, which is recommended for use with the
> + solid-state drives (SSD).
> +
> +force Forces the driver to mount partitions even if 'dirty' flag
> + (volume dirty) is set. Not recommended for use.
> +
> +sparse Create new files as "sparse".
> +
> +showmeta Use this parameter to show all meta-files (System Files) on
> + a mounted NTFS partition.
> + By default, all meta-files are hidden.
> +
> +no_acs_rules "No access rules" mount option sets access rights for
> + files/folders to 777 and owner/group to root. This mount
> + option absorbs all other permissions:
> + - permissions change for files/folders will be reported
> + as successful, but they will remain 777;
> + - owner/group change will be reported as successful, but
> + they will stay as root
> +
> +===============================================================================
> +
> +
> +ToDo list
> +=========
> +
> +- Full journaling support (currently journal replaying is supported) over JBD.
journalling
seems to be preferred.
> +
> +
> +References
> +==========
> +https://www.paragon-software.com/home/ntfs-linux-professional/
> + - Commercial version of the NTFS driver for Linux.
> +
> +almaz.alexandrovich@xxxxxxxxxxxxxxxxxxxx
> + - Direct e-mail address for feedback and requests on the NTFS3 implementation.
> +
> +
thanks.
--
~Randy
