On Fri, Jan 03, 2014 at 05:14:56PM -0700, Chris Murphy wrote:
>
> On Jan 3, 2014, at 5:33 AM, Marc MERLIN <m...@merlins.org> wrote:
> >
> > Would it be possible for whoever maintains btrfs-tools to change both
> > the man page and the help included in the tool to clearly state that
> > running the fsck tool is unlikely to be the right course of action
> > and talk about btrfs-zero-log as well as mount -o recovery?
>
> The problem FAQ doesn't even mention btrfsck so I think people are just
> getting around that page or making assumptions.
> https://btrfs.wiki.kernel.org/index.php/Problem_FAQ
It's easy to find btrfsck without the wiki, whether it's with dpkg -l,
rpm -ql, or command line completion.
My point is that as you said, it's most often not the command to use, it
can even do more damage than good, but neither its command line help,
nor the man page warn of anything dangerous or bad in using it.
Telling people they should have read a wiki instead of the canonical man
page isn't the right way to go longer term, nor how things are done on
linux usually.
> Should btrfs check (btrfsck without --repair) work similar to xfs_repair when
> the file system is not cleanly unmounted? If an XFS volume is not cleanly
> unmounted, running xfs_repair will instruct the user to first mount the
> volume so that the journal is replayed, then umount the volume, then run
> xfs_repair.
I don't know about what the actual tool does when it works, I've never
had it do anything useful for me, so I can't comment, except about the
fact that it should warn users about "I'm not the fsck you're used to or
are likely looking for"
> A possible variant of this for btrfs check: inform the user the first step in
> repairing a problem Btrfs volume is to use -o recovery, for more information
> see Btrfs FAQ <url> for additional problem solving recommendations.
Yes, along with tweaking the man page to say the same.
Thanks,
Marc
--
"A mouse is a device used to point at the xterm you want to type in" - A.S.R.
Microsoft is to operating systems ....
.... what McDonalds is to gourmet cooking
Home page: http://marc.merlins.org/ | PGP 1024R/763BE901
--
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
