Date: Sun, 7 Feb 2021 18:37:42 GMT From: Fernando Apesteguía <fernape@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: 5d0182eabb - main - [handbook]: Document how to mount NTFS disks Message-ID: <202102071837.117IbghI037908@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=5d0182eabb0093075b114ffead5db19da6a2cbcb commit 5d0182eabb0093075b114ffead5db19da6a2cbcb Author: Fernando Apesteguía <fernape@FreeBSD.org> AuthorDate: 2021-01-27 14:49:48 +0000 Commit: Fernando Apesteguía <fernape@FreeBSD.org> 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 Basicshelp
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202102071837.117IbghI037908>