From nobody Wed May 10 14:53:45 2023 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 4QGdMH3HHyz4B0wM; Wed, 10 May 2023 14:53:47 +0000 (UTC) (envelope-from mhorne@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QGdMH2mW9z3tc5; Wed, 10 May 2023 14:53:47 +0000 (UTC) (envelope-from mhorne@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683730427; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=Qr4N0O3fgT3YDQHOlfyDUBWpFD9Sicjb4tHsmbA81u4=; b=lkY0d9L3XWXTjICl01HTTyIBiDtxpemPNcIGUYLqO4nJjHmCkRamEXumdzSw0cNAAhfq9o CUqETCobfOTyMKMYiRD635RM7KwQ/AqMQfhbAUIJkmxUNN3p+djjczTSLs9q4BzhDLtv00 RxReZGCXsaJ0F9mw39qcbVEizE1j3CY7kPyDqCK2lmquY0I7SjbJU+ZVobaT8rJlAEvQqX J5PG1oUg0rTfcqvoOIf3Z0oVJdfx3Wni9yJZeLqXdFLXvNJ8mJNTNiKKf4BigXHlSkNgNX WNGjqV7B1gMm9Z9bj+SawK52e3+2un1LWQXFakRmWRV8v6mHQF1H0Io7KV4HTg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683730427; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=Qr4N0O3fgT3YDQHOlfyDUBWpFD9Sicjb4tHsmbA81u4=; b=srxsKqTLxItt93P1Rzt1m3hKTsyZXKKFJR6Kj03vsoR8bqTJvnJ8yhanmlfX3UiDUZ3Y6x 0ICJL7pBnloywD1PyRRyoAKkr/8ELWe0ufix4ZB6bSFatPDeSh9hrBFxugMYYcz/2oEPfr YgIjIuTlgN27UisV4pwCrEhAZIzucPP7khYBS2tMimYrlyt+S7mTbEaGQRW6N8xeZaSIGv NYJVjMVGI0TPsc7beuK1El8yJaSPJp5G+Sq9mJVr7sGTyvs7lRDL5m+RZiAsDcf0XI5YIF 0RhUcUW+/j3/WQP+tCO0cbLj+V9sEDVRu+l9W+4rbBcGNiFWVlzGI/0dmAC6jw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1683730427; a=rsa-sha256; cv=none; b=SAXCwZM0BN5tF8KfFxrqd4KvdlH3Q1DmD8jtotCVGYmCJW+F2V3wr7VZPCEgSg/yoOPHxM DsUnUbnTwlpqTL8y4zdTiR/Y/u4YmofT/4MXm8eTCuoRpdC1CSI9itwk99L74pATf7PHZ5 7fv5nVXVJGvUmbtVfBZnPEDuZs8srh+NeqILzR2AfN2SyLg0POY/qRBS+/iglvrYD/PBpe uxfFZ7f8pNVi7PrSdGxn4L3emNL7j96HVmWYRn1trcJZL9Kx2gx0XwVPSD85TGlhrC73db DJ2K91nhrn/OBjpZXMe5gaQvAAAbkAX6SA0h93u4ZKIzFeFYKOFgqKKptWWxbg== Received: from [192.168.1.151] (host-173-212-76-127.public.eastlink.ca [173.212.76.127]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) (Authenticated sender: mhorne) by smtp.freebsd.org (Postfix) with ESMTPSA id 4QGdMG70XdzsWZ; Wed, 10 May 2023 14:53:46 +0000 (UTC) (envelope-from mhorne@freebsd.org) Message-ID: Date: Wed, 10 May 2023 11:53:45 -0300 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 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0 Subject: Re: git: 36db6b04962a - main - hier(7): document /home/ and /usr/home/ Content-Language: en-CA To: rgrimes@freebsd.org Cc: src-committers@freebsd.org, dev-commits-src-all@freebsd.org, dev-commits-src-main@freebsd.org References: <202305101419.34AEJf1x054239@gndrsh.dnsmgr.net> From: Mitchell Horne In-Reply-To: <202305101419.34AEJf1x054239@gndrsh.dnsmgr.net> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ThisMailContainsUnwantedMimeParts: N On 5/10/23 11:19, Rodney W. Grimes wrote: >> The branch main has been updated by mhorne: >> >> URL: https://cgit.FreeBSD.org/src/commit/?id=36db6b04962a01ff7b21592def02d4c570dac939 >> >> commit 36db6b04962a01ff7b21592def02d4c570dac939 >> Author: Mitchell Horne >> AuthorDate: 2023-05-10 12:53:56 +0000 >> Commit: Mitchell Horne >> CommitDate: 2023-05-10 13:25:17 +0000 >> >> hier(7): document /home/ and /usr/home/ >> >> Reviewed by: imp >> MFC after: 1 week >> Sponsored by: The FreeBSD Foundation >> Differential Revision: https://reviews.freebsd.org/D40002 >> --- >> share/man/man7/hier.7 | 10 ++++++++++ >> 1 file changed, 10 insertions(+) >> >> diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7 >> index ff11289436a1..b6759dd6e65b 100644 >> --- a/share/man/man7/hier.7 >> +++ b/share/man/man7/hier.7 >> @@ -90,6 +90,10 @@ file descriptor files; >> see >> .Xr \&fd 4 >> .El >> +.It Pa /home/ >> +user HOME directories. >> +This is a symlink to >> +.Pa /usr/home/ > > /usr is "contains the majority of user utilities and applications" > it should not contain home directories. > > I do not know when this move to usr came about it was traditionally /home. > I do not know why /usr/home even exists, it is not needed by > anything I am aware of. If we have a compatible link it > should be, usr/home -> ../home and /home should be the > directory. > I agree that /usr/home is strange, and is unique (?) to FreeBSD. The oldest commit in the output of `git log --grep '/usr/home'` is: commit f2400d465896a8e4f6fdc57eba840cf49b25bbbd Author: David Nugent Date: Fri Jan 3 04:42:18 1997 +0000 Implemented /home -> /usr/home symlink kludge. If home basedir would be created in the root partition, create it under /usr instead, and symlink /basedir -> /usr/basedir. Notes: svn path=/head/; revision=21242 So it has been this way for 26 years at least. I do not know what to say about whether /usr "should" contain it, but it does. Cheers, Mitchell >> .It Pa /etc/ >> system configuration files and scripts >> .Pp >> @@ -214,6 +218,12 @@ and >> .Xr bsdinstall 8 >> .It Pa include/ >> standard C include files >> +.It Pa home/ >> +users' HOME directories; >> +the layout is not standardized, but a typical interactive user >> +.Dv beastie >> +might receive their own directory under >> +.Pa /usr/home/beastie >> .Pp >> .It Pa lib/ >> shared and archive >> >