From owner-dev-commits-doc-all@freebsd.org Sun Feb 7 18:37:42 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 4A8FC533B59 for ; Sun, 7 Feb 2021 18:37:42 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4DYdF21fBLz3Cbf; Sun, 7 Feb 2021 18:37:42 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 2B4D8F57; Sun, 7 Feb 2021 18:37:42 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 117IbgMp037909; Sun, 7 Feb 2021 18:37:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 117IbghI037908; Sun, 7 Feb 2021 18:37:42 GMT (envelope-from git) Date: Sun, 7 Feb 2021 18:37:42 GMT Message-Id: <202102071837.117IbghI037908@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Fernando Apesteguía Subject: git: 5d0182eabb - main - [handbook]: Document how to mount NTFS disks MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5d0182eabb0093075b114ffead5db19da6a2cbcb Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Feb 2021 18:37:42 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=5d0182eabb0093075b114ffead5db19da6a2cbcb commit 5d0182eabb0093075b114ffead5db19da6a2cbcb Author: Fernando Apesteguía AuthorDate: 2021-01-27 14:49:48 +0000 Commit: Fernando Apesteguía CommitDate: 2021-02-07 18:31:53 +0000 [handbook]: Document how to mount NTFS disks How to mount NTFS disks is a FAQ in our chats and forums. Add a section in handbook/disks under "18. Storage" with straightforward information on how to mount NTFS disks. PR: 251109 Submitted by: Reported by: 0mp@ Reviewed by: Approved by: 0mp@ (mentor) Obtained from: MFC after: MFH: Relnotes: Security: Sponsored by: Differential Revision: https://reviews.freebsd.org/D28131 --- .../content/en/books/handbook/disks/_index.adoc | 86 ++++++++++++++++++++++ 1 file changed, 86 insertions(+) diff --git a/documentation/content/en/books/handbook/disks/_index.adoc b/documentation/content/en/books/handbook/disks/_index.adoc index 4d2d6f99d3..955e7f713a 100644 --- a/documentation/content/en/books/handbook/disks/_index.adoc +++ b/documentation/content/en/books/handbook/disks/_index.adoc @@ -1006,6 +1006,92 @@ To format the floppy with FAT, issue: The disk is now ready for use. To use the floppy, mount it with man:mount_msdosfs[8]. One can also install and use package:emulators/mtools[] from the Ports Collection. +[[using-ntfs]] +== Using NTFS Disks + +This section explains how to mount NTFS disks in FreeBSD. + +NTFS (New Technology File System) is a proprietary journaling file system +developed by Microsoft(R). It has been the default file system in Microsoft +Windows(R) for many years. FreeBSD can mount NTFS volumes using a FUSE file +system. These file systems are implemented as user space programs which +interact with the man:fusefs[5] kernel module via a well defined interface. + +[.procedure] +==== +*Procedure: Steps to Mount a NTFS Disk* + +. Before using a FUSE file system we need to load the man:fusefs[5] kernel +module: ++ +[source,bash] +.... +# kldload fusefs +.... ++ +Use man:sysrc[8] to load the module at startup: ++ +[source,bash] +.... +# sysrc kld_list+=fusefs +.... + +. Install the actual NTFS file system from packages as in the example (see +crossref:ports[pkgng-intro,Using pkg for Binary Package Management]) or from +ports (see crossref:ports[ports-using,Using the Ports Collection]): ++ +[source,bash] +.... +# pkg install fusefs-ntfs +.... + +. Last we need to create a directory where the file system will be mounted: ++ +[source,bash] +.... +# mkdir /mnt/usb +.... + +. Suppose a USB disk is plugged in. The disk partition information can be +viewed with man:gpart[8]: ++ +[source,bash] +.... +# gpart show da0 +=> 63 1953525105 da0 MBR (932G) + 63 1953525105 1 ntfs (932G) +.... + +. We can mount the disk using the following command: ++ +[source,bash] +.... +# ntfs-3g /dev/da0s1 /mnt/usb/ +.... +The disk is now ready to use. ++ +. Additionally, an entry can be added to /etc/fstab: ++ +[.programlisting] +.... +/dev/da0s1 /mnt/usb ntfs mountprog=/usr/local/bin/ntfs-3g,noauto,rw 0 0 +.... ++ +Now the disk can be now mounted with: ++ +[source,bash] +.... +# mount /mnt/usb +.... + +. The disk can be unmounted with: ++ +[source,bash] +.... +# umount /mnt/usb/ +.... +==== + [[backup-basics]] == Backup Basics