Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 828541 - New NTFS3 driver documentation needs details to be usable
Summary: New NTFS3 driver documentation needs details to be usable
Status: RESOLVED WONTFIX
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal
Assignee: Gentoo Wiki Team
URL: https://wiki.gentoo.org/wiki/NTFS
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-12-08 04:42 UTC by Peter Sasi
Modified: 2022-06-26 10:35 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Peter Sasi 2021-12-08 04:42:05 UTC
1. Need to at least reference how to *install* the necessary 5.15 kernel:
1/a. at least reference https://wiki.gentoo.org/wiki/Handbook:AMD64/Portage/Branches#Mixing_stable_with_testing or add here explicitly to edit /etc/portage/package.accept_keywords and add:
sys-kernel/gentoo-sources
1/b. either here explicitly or adding to https://wiki.gentoo.org/wiki/Kernel how to install a *specific* kernel version (verbose to include te URL where the user can read up on the gentoo kernel patches)
emerge --ask --verbose sys-kernel/gentoo-sources-5.15
2. need to add a note, that trying to mount can give a uselessly generic error:
sudo mount -t ntfs3 /dev/sdb1 /mnt/Data
_mount: /mnt/Data: wrong fs type, bad option, bad superblock on /dev/sdb1, missing codepage or helper program, or other error._
2/a. Search for the possible problems with and correct the problematic parameters if any, e.g.:
dmesg|grep ntfs3
ntfs3: Unknown parameter 'notime'
ntfs3: sdc2: volume is dirty and "force" flag is not set!
2/b. the new ntfs3 driver will not mount a volume by default with the dirty flag set, so either have to add the force mount option or better:
2/c: need to check the volume and clear the flag. 
sudo ntfsfix /dev/sdb1
Problem: ntfsfix is not installed by default, so in fact you need to emerge the FUSE based NTFS-3G even if you are not planning to use it to have ntfsfix for ntfs3:
emerge --ask sys-fs/ntfs3g
2/d: Problem: ntfsfix without any arguments will actively set the dirty bit, so that a chkdsk from Windows can do a real check/analysis. If you don't have that handy and want to clear the dirty bit despite ntfsfix not being entirely a good checking tool you can pass the -d argument to ntfsfix.
sudo ntfsfix -d /dev/sdb1
sudo mount -t ntfs3 /dev/sdb1 /mnt/Data
PROFIT! :-)

Reproducible: Always

Steps to Reproduce:
1. try to mount an NTFS volume as ntfs3 
2. try to install the 5.15 version of gentoo-sources
3. try to mount an NTFS volume as ntfs3 using the 5.15 kernel but not having cleared the dirty flag
4. checking the volume using ntfsfix: unless you add the -d flag.
Actual Results:  
With all above steps the new ntfs3 will not mount the NTFS volume.

Expected Results:  
We need a proper walk-through to include the above details for the successful usage of the new ntfs3.

I am happy to actively help extend the documentation instead of just submitting bugs, if possible!
Comment 1 Jonas Stein gentoo-dev 2021-12-08 22:54:22 UTC
Thank you for the important comment. You do not need a bug ticket for this.
You can edit the wiki directly. Use the talk page for suggestions/discussions and/or the IRC channel of the wiki project to chat.

https://wiki.gentoo.org/wiki/Project:Wiki

Please move the content at least to the talk page and close this ticket, when it is done.
Comment 2 Matthew Marchese Gentoo Infrastructure gentoo-dev 2022-06-26 10:35:17 UTC
These steps are not something for the wiki team to write for you, since our primary role is administration of the wiki, not writing technical guide documents (although I do write some from time to time... The wiki is editable by all, therefore you should follow Jonah's advice and open a discussion with your concerns on the NTFS wiki discussion page.

We'll close this bug since it doesn't need to stay open at this point. Come visit us on IRC if you would like to discuss in real time. Thank you!