UPDATING: Add entry for boot-time error message caused by removal of vfs.zfs.min_auto_ashift tunable
ClosedPublic
Actions

Authored by emaste on Sep 21 2025, 5:52 PM.

Details

Reviewers

mm
yasu

Commits

rG7f42fc03d2a7: UPDATING: Belatedly note OpenZFS sysctls moving
rG9f85cf09d48b: UPDATING: Belatedly note OpenZFS sysctls moving

Summary

Document error message caused by removal of vfs.zfs.min_auto_ashift tunable and how to fix it.

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

yasu created this revision.Sep 21 2025, 5:52 PM

Herald added a subscriber: imp. · View Herald TranscriptSep 21 2025, 5:52 PM

yasu requested review of this revision.Sep 21 2025, 5:52 PM

Harbormaster completed remote builds in B67228: Diff 162542.Sep 21 2025, 5:52 PM

I would phrase this slightly differently -- bsdinstall now uses the updated name, and with the revert I just committed the "unknown oid" will go away. We should mention that the sysctl OIDs changed with the switch to OpenZFS in FreeBSD 13 and backwards compatibility will be removed. It's a little tricky because this should have been an UPDATING entry many years ago.

Maybe something like this:

With the migration to OpenZFS, vdev sysctls moved from vfs.zfs to vfs.zfs.vdev.
Backwards compatibility aliases will be removed in the near future.  Please 
update /etc/sysctl.conf to reference the new OIDs.
 
For example,
 
        vfs.zfs.min_auto_ashift=12
 
needs to be changed to
 
        vfs.zfs.vdev.min_auto_ashift=12