From nobody Wed Mar 02 00:00:34 2022 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 133BA19E767B; Wed, 2 Mar 2022 00:00:35 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4K7Z4y6xQ7z4RSR; Wed, 2 Mar 2022 00:00:34 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1646179235; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=nOS0BBl4l1+66WI7Qg/wdkaasQJBql7DtWHrG2RkQEk=; b=Rgx5N8MHgRmcR4Y6Bfjdqj8/CbAaN9YrMMgYtfN6hHaciWw1gC5ejVEZjPUSlAPOKRcHBx rHq4/0xcEQgVwRat1CW0tneJE9PLsV/UmGzoKYdNcITpuI2QN/xF8hZYOt1oLajkKSXPBU fqwLn78K4/BStfAn3yxV0k5tUg8OvTxdqM7erKV9P7xkDPsEeF//tKaAk37w/8XJqD5s2b Nvj6ZxGgL2Kh9zkL5n0qzss4vS/dsuEs4fB6sG/BpgU+mPVAwrCjA+nL/DpeFt/GPk25cf UL2cjOwg7H++0doWMCTc99oLOs8lCOmuToKo5B92cxyrrllxqpB2HaHxZ6mv5w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id CF34F190AF; Wed, 2 Mar 2022 00:00:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 22200YGc000978; Wed, 2 Mar 2022 00:00:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22200YRL000977; Wed, 2 Mar 2022 00:00:34 GMT (envelope-from git) Date: Wed, 2 Mar 2022 00:00:34 GMT Message-Id: <202203020000.22200YRL000977@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: d0e3860f706e - main - heir: Document SYSROOT conventions List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: d0e3860f706e389417c8b56b1d423104b830f4ad Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1646179235; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=nOS0BBl4l1+66WI7Qg/wdkaasQJBql7DtWHrG2RkQEk=; b=Qvot7VF1sH/50BRkJMXTRQhrUeZQB0sqGxwzl7mYx63eo42oSeHPZv8/JTBzjz2zi5fI9d E+bmy0aOGZyQgX1YMJ4dw7oResT5VYGhIM+JDp6AVU7rCQdi72eQpqxdCssJpqe/cyRpmY xiL2FayLHgbKhpUQIhApe1T1Jy5dMdqU5vhyhDCEq/+NDAzJdnnWUY4lxt/A7NIwyb5ld3 0jsrj1SBOUiCUDx1PZeDPoGHpPtVlrBA6ScHe7lY5rSIUYtbystVHtSn4S2SI6QlIAG71f qEy6EqeFBqlD0VZi+wmLDDxvgn7kNtSBreU47CFlNWW/O+Irt2kgulWNoJmL2g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1646179235; a=rsa-sha256; cv=none; b=Lg10JE1K2N+vid0pFDphheAu/hlcPKsRq3Rhet4PMlJE+ZMdo8n25/9sQjKzb+pFQV+JYW MskCPNw/0CGQ04wZamsjCwM9sGH116YLvyVKvpsUVSIZsyS4ckn+hOxVo4shIQUmJQui9Q wrlx6vAfxlK6jgML3TlMLqXT/54SuiySJK/2vjfGfidgOR5EnxS/C7czqpbv4kyD1ZaHBm M7JFNuIJgSydTQb9cj3A0bBGQDBmHIWxh9RAP7iEBpzthtzfqWGX3xzOKgDS2094Q2ddei uUIZOmMdCpkknokZPm+DogGDuE+MGhTtM/3eaDTnDYpn+wN/w67/du1PsjeSlQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=d0e3860f706e389417c8b56b1d423104b830f4ad commit d0e3860f706e389417c8b56b1d423104b830f4ad Author: Warner Losh AuthorDate: 2022-03-01 23:58:28 +0000 Commit: Warner Losh CommitDate: 2022-03-02 00:00:40 +0000 heir: Document SYSROOT conventions 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. Sponsored by: Netflix Reviewed by: brooks Differential Revision: https://reviews.freebsd.org/D33754 --- share/man/man7/hier.7 | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7 index 2826050c3307..150ba4c4b719 100644 --- a/share/man/man7/hier.7 +++ b/share/man/man7/hier.7 @@ -28,7 +28,7 @@ .\" @(#)hier.7 8.1 (Berkeley) 6/5/93 .\" $FreeBSD$ .\" -.Dd December 11, 2021 +.Dd March 1, 2022 .Dt HIER 7 .Os .Sh NAME @@ -566,6 +566,32 @@ and .It Pa scrnmaps/ console screen maps .El +.It Pa sysroot/ +files necessary for the -sysroot compiler/linker argument to build non-native +binaries. +.Bl -tag -width Fl -compact +.It Pa VERSION/ +files for +.Fx +release VERSION. +By convention, +.Dq VERSION +matches +.Xr uname 1 +.Fl r . +.Bl -tag -width Fl -compact +.It Pa MACHINE.MACHINE_ARCH/ +represent the binary ABI for these files. +.Dq MACHINE +matches +.Xr uname 1 +.Fl m . +.Dq MACHINE_ARCH +matches +.Xr uname 1 +.Fl p . +.El +.El .It Pa tabset/ tab description files for a variety of terminals; used in the termcap file;