Changeset View
Changeset View
Standalone View
Standalone View
sysutils/fusefs-ntfs/files/README.FreeBSD
| Show All 23 Lines | |||||
| ============================================================================== | ============================================================================== | ||||
| 2. Port specific notes | 2. Port specific notes | ||||
| ============================================================================== | ============================================================================== | ||||
| The port has a patch to align read/write operations to the media block size | The port has a patch to align read/write operations to the media block size | ||||
| (required on FreeBSD). | (required on FreeBSD). | ||||
| The port has 2 options: LOCK (to prevent access to the device by external | The port has 2 options: LOCK, which prevents access to the device by external | ||||
| programs than NTFS-3G once mounted, default on Linux), and UBLIO (use a user | programs than NTFS-3G once mounted, the default on Linux, and UBLIO, which | ||||
| space cache library, see devel/libublio, not required on Linux). | enabled a user space cache library, see devel/libublio, not required on Linux. | ||||
| The reason for using UBLIO is that FreeBSD removed support for block devices, | The reason for using UBLIO is that FreeBSD removed support for block devices, | ||||
| being them now character devices. The former ones had a cache, and NTFS-3G was | being them now character devices. The former ones had a cache, and NTFS-3G was | ||||
| optimized for it (Linux still uses them). The same happens on Mac OS X (based | optimized for it (Linux still uses them). The same happens on Mac OS X (based | ||||
| on FreeBSD 5). So using UBLIO both improves performance (~10 times faster), | on FreeBSD 5). So using UBLIO both improves performance (~10 times faster), | ||||
| and reduces disk load. | and reduces disk load. | ||||
| Note: The UBLIO port option has been removed from OPTIONS_DEFINE, as there | |||||
| have been bug reports including data corruption when using it. However, the | |||||
| bits to enable and patch NTFS-3g to use UBLIO have been left in place to enable | |||||
| interested persons to test and potentially bring it back to a maintained and | |||||
| stable state. To enable UBLIO, add UBLIO to the ports OPTIONS_DEFINE line. | |||||
tobik: This seems weird to me. The option should be discoverable not hidden. Putting up an… | |||||
| ============================================================================== | ============================================================================== | ||||
| 3. Mounting at startup with /etc/fstab | 3. Mounting at startup with /etc/fstab | ||||
| ============================================================================== | ============================================================================== | ||||
| To mount at startup you need to have the following line in /boot/loader.conf: | To mount at startup you need to have the following line in /boot/loader.conf: | ||||
| fuse_load="YES" | fuse_load="YES" | ||||
| ▲ Show 20 Lines • Show All 101 Lines • Show Last 20 Lines | |||||
This seems weird to me. The option should be discoverable not hidden. Putting up an additional barrier for interested users by hiding it in long documents (README.FreeBSD and the Makefile) that few people will read is artificial and unnecessary. Please just rename the option to something more sensible like UBLIO_EXPERIMENTAL or UBLIO_UNSTABLE and add it back to OPTIONS_DEFINE. The likelihood of users turning it on by accident or due to stale OPTIONS_SET should be minimal to nonexistent. The option could be further warned about by an improved option description and pkg-help.