diff options
| author | Fernando ApesteguĂa <fernape@FreeBSD.org> | 2021-01-27 14:49:48 +0000 |
|---|---|---|
| committer | Fernando ApesteguĂa <fernape@FreeBSD.org> | 2021-02-07 18:31:53 +0000 |
| commit | 5d0182eabb0093075b114ffead5db19da6a2cbcb (patch) | |
| tree | c2a2757bb480843eaa61ebd1d2ab2fa35de19699 | |
| parent | 89407529ff8f561963d9064148d80ef2c52326d0 (diff) | |
| download | doc-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.adoc | 86 |
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 |
