heir: Document SYSROOT conventions
ClosedPublic
Actions

Authored by imp on Jan 5 2022, 9:56 PM.

Details

Reviewers

emaste
jhb
brooks

Group Reviewers

manpages

Commits

rGd0e3860f706e: heir: Document SYSROOT conventions

Summary

Define a place for sysroot trees to live. This assumes they come from
the base in some way, though there's not yet a build/install/etc sysroot
target. Include the FreeBSD version so multiple verrsions can be
installed on one system (it also includes the whole uname version, so
one could, in theory, install variants like CheriBSD or whatever on the
same system as FreeBSD). Use MACHINE.MACHINE_ARCH to be consistent with
the release practices, /usr/obj and other naming conventions.

Diff Detail

Repository

rS FreeBSD src repository - subversion

Lint

Lint Passed

Unit

No Test Coverage

Build Status

Buildable 43738
Build 40626: arc lint + arc unit

Event Timeline

imp created this revision.Jan 5 2022, 9:56 PM

Herald added a reviewer: manpages. · View Herald TranscriptJan 5 2022, 9:56 PM

imp requested review of this revision.Jan 5 2022, 9:56 PM

Harbormaster completed remote builds in B43723: Diff 101015.Jan 5 2022, 9:56 PM

imp added reviewers: emaste, jhb, brooks.Jan 5 2022, 9:56 PM

This seems viable, but I wonder where we envision the sysroots coming from and if it impacts the location?

share/man/man7/hier.7
570

In D33754#763423, @brooks wrote:

This seems viable, but I wonder where we envision the sysroots coming from and if it impacts the location?

I'm unsure. I'm thinking that we'll eventually have a top-level make target to create them. That puts them
in /usr/share or /usr/lib somewhere. I'd expect this would be one of the optional packages to install once
we transition to pkgbase. I don't expect to have ports of them in the mean time, but if we did, they'd
land in the analogous /usr/local/share/sysroot/$VERSION/$MACHINE.$MACHINE_ARCH.

English LGTM. Can't attest to the rest.

share/man/man7/hier.7
570	Agree with that suggestion.

imp edited the summary of this revision. (Show Details)Jan 6 2022, 6:34 AM

address brooks and Pau's concerns...

Harbormaster completed remote builds in B43738: Diff 101034.Jan 6 2022, 6:35 AM

It seems like with pkgbase you want some sort of magic packages or re-rooted pkg repo support so you can get them from the specific target's pkg repo, but that's for another day.

This revision is now accepted and ready to land.Jan 7 2022, 4:37 PM

Closed by commit rGd0e3860f706e: heir: Document SYSROOT conventions (authored by imp). · Explain WhyMar 2 2022, 12:00 AM

This revision was automatically updated to reflect the committed changes.

imp added a commit: rGd0e3860f706e: heir: Document SYSROOT conventions.