Page MenuHomeFreeBSD

bectl.8: update /home
ClosedPublic

Authored by karels on May 22 2023, 2:16 PM.
Tags
None
Referenced Files
F102707649: D40206.id122391.diff
Sat, Nov 16, 3:55 AM
Unknown Object (File)
Wed, Nov 6, 8:32 AM
Unknown Object (File)
Sun, Nov 3, 11:15 AM
Unknown Object (File)
Fri, Nov 1, 9:41 PM
Unknown Object (File)
Oct 16 2024, 1:19 PM
Unknown Object (File)
Oct 16 2024, 1:19 PM
Unknown Object (File)
Oct 15 2024, 10:34 AM
Unknown Object (File)
Oct 13 2024, 6:04 PM
Subscribers

Details

Summary

The default location for home directories is moving from /usr/home
to /home, including the default zfs datasets. Update accordingly.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

yuripv added inline comments.
sbin/bectl/bectl.8
422

This is now incorrect example as it was previously showing how to include /usr in BE and skip the nested /usr/home. You could use something created by default by the installer here instead, e.g. /usr/ports or /usr/src.

sbin/bectl/bectl.8
422

zroot/home is created by default by the installer now. It is not nested under /usr. but is under /. However, I see what you mean about the nesting. Maybe /usr/ports should be added as an example too, and used in this description.

sbin/bectl/bectl.8
409–410

btw, zroot/var now has can mount off in the default setup, which seems correct, so this part of the example is out of date.

sbin/bectl/bectl.8
422

I have to go with Yuri on this one -- the example doesn't have the same meaning with zroot/home, it should be swapped out for zroot/usr/src instead (removing references to home entirely) if we're going to touch it. It doesn't quite make sense in this context to have both zroot/home and zroot/usr/src as examples.

One minor issue, but that's easily fixed pre-push. I agree that it's not acceptable as-is and needs to change.

This revision is now accepted and ready to land.May 25 2023, 1:40 AM
sbin/bectl/bectl.8
422

I'll use zroot/usr/src. But why do you say it doesn't make sense to include zroot/home as an example as well? It seems like the prototypical example of something that should not be in the boot environment. It isn't nested in the same way, but that's not all this example shows (e.g. /var).

sbin/bectl/bectl.8
422

Because this part is specifically about guiding one to navigate the intricacies of subordinate datasets, how to understand when a second-level dataset may or may not be included by tracing from the root of the pool out to it and examining canmount along the way. One should be able to extrapolate from that to any given scenario, since it's the moderately more complex scenario to work through.

sbin/bectl/bectl.8
422

Then why is zroot/var there? And should I change canmount for var to off? Or delete it?

sbin/bectl/bectl.8
422

I was trying to keep it simple while still realistically representing a theoretical whole system. You can keep zroot/home in that listing (sorted above zroot/usr, though), it's just this reference and the next that should be zroot/usr/src (and zroot/usr/src added in the listing above with canmount=on).

This revision now requires review to proceed.May 25 2023, 3:00 AM
This revision is now accepted and ready to land.May 25 2023, 3:07 AM
This revision was automatically updated to reflect the committed changes.