aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFernando ApesteguĂ­a <fernape@FreeBSD.org>2021-01-27 14:49:48 +0000
committerFernando ApesteguĂ­a <fernape@FreeBSD.org>2021-02-07 18:31:53 +0000
commit5d0182eabb0093075b114ffead5db19da6a2cbcb (patch)
treec2a2757bb480843eaa61ebd1d2ab2fa35de19699
parent89407529ff8f561963d9064148d80ef2c52326d0 (diff)
downloaddoc-5d0182eabb0093075b114ffead5db19da6a2cbcb.tar.gz
doc-5d0182eabb0093075b114ffead5db19da6a2cbcb.zip
[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
-rw-r--r--documentation/content/en/books/handbook/disks/_index.adoc86
1 files changed, 86 insertions, 0 deletions
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