freebsd-dev/lib/libufs
Kirk McKusick fb14e73cb4 Normally when an attempt is made to mount a UFS/FFS filesystem whose
superblock has a check-hash error, an error message noting the
superblock check-hash failure is printed and the mount fails. The
administrator then runs fsck to repair the filesystem and when
successful, the filesystem can once again be mounted.

This approach fails if the filesystem in question is a root filesystem
from which you are trying to boot. Here, the loader fails when trying
to access the filesystem to get the kernel to boot. So it is necessary
to allow the loader to ignore the superblock check-hash error and make
a best effort to read the kernel. The filesystem may be suffiently
corrupted that the read attempt fails, but there is no harm in trying
since the loader makes no attempt to write to the filesystem.

Once the kernel is loaded and starts to run, it attempts to mount its
root filesystem. Once again, failure means that it breaks to its prompt
to ask where to get its root filesystem. Unless you have an alternate
root filesystem, you are stuck.

Since the root filesystem is initially mounted read-only, it is
safe to make an attempt to mount the root filesystem with the failed
superblock check-hash. Thus, when asked to mount a root filesystem
with a failed superblock check-hash, the kernel prints a warning
message that the root filesystem superblock check-hash needs repair,
but notes that it is ignoring the error and proceeding. It does
mark the filesystem as needing an fsck which prevents it from being
enabled for writing until fsck has been run on it. The net effect
is that the reboot fails to single user, but at least at that point
the administrator has the tools at hand to fix the problem.

Reported by:    Rick Macklem (rmacklem@)
Discussed with: Warner Losh (imp@)
Sponsored by:   Netflix
2018-12-06 00:09:39 +00:00
..
block.c lib: further adoption of SPDX licensing ID tags. 2017-11-26 02:00:33 +00:00
bread.3
cgread.3 Fix punctuation. 2018-02-02 00:01:50 +00:00
cgroup.c Correct fsck journal-recovery code to update a cylinder-group 2018-01-17 17:58:24 +00:00
getinode.3 In preparation for adding inode check-hashes, clean up and 2018-11-13 21:40:56 +00:00
inode.c In preparation for adding inode check-hashes, clean up and 2018-11-13 21:40:56 +00:00
libufs.3 Bring up to date with recently added functions berase(3), getinode(3), 2018-11-26 23:09:45 +00:00
libufs.h Normally when an attempt is made to mount a UFS/FFS filesystem whose 2018-12-06 00:09:39 +00:00
Makefile In preparation for adding inode check-hashes, clean up and 2018-11-13 21:40:56 +00:00
Makefile.depend DIRDEPS_BUILD: Update dependencies. 2017-10-31 00:07:04 +00:00
sblock.c Normally when an attempt is made to mount a UFS/FFS filesystem whose 2018-12-06 00:09:39 +00:00
sbread.3 Refactoring of reading and writing of the UFS/FFS superblock. 2018-01-26 00:58:32 +00:00
type.c The ufs_disk_write() function is used to upgrade a read-only descriptor 2018-04-08 06:59:42 +00:00
ufs_disk_close.3 Don't put multiple names on a single .Nm line. This fixes apropos(1) 2018-04-17 09:05:46 +00:00