From nobody Fri Mar 1 22:22:52 2024
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 4TmjJs1pLHz5D9Xj;
Fri, 1 Mar 2024 22:22:53 +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 4TmjJr6QPSz4D7P;
Fri, 1 Mar 2024 22:22:52 +0000 (UTC)
(envelope-from git@FreeBSD.org)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim;
t=1709331772;
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=MAZ3NsAIL+2mb2YD/mHblv6loAGOg9DehA/N306fpsE=;
b=WCAXNuNy+CNW/7UhyCMfapTk6xNcrx9WL05J6mQkG+cw6xb/DqRiY7+qrIAtPNwD227YZH
BrGjocK4KtI/lV5kG/QCDn5/rgNRekUlUlr3Tbzj5K5/JRMNM1fanrS684G/Cs8cyXWjJ9
GuF41IKPz2v1mYw51jj+HcKuN7juyWKoob6qZpPDu6UdIqlHuNO2xrmICL3+hYX3Du2TqS
PdV5tEI6BNt9YmNE9ikO9TZXn/qMxnSsx3iUaRuDWnwhRcaOwpKZt9WgsEg9o9UzaaANR3
tcBtR9mBv+vU+lfS2Qbu1T6SCuopmndw2uhYiUFoleDJctC0UUHLxwsFZRQdLw==
ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1709331772; a=rsa-sha256; cv=none;
b=q9NOCBkGmIasDtjJqjsUbGI3bWdAsp4xywn2/pn5OlscyFNYXwMDZPB+sx4JaWaiJ8kkHl
CvconqD8lfDec7vvh0McAN6qyPYiEV2W+c8qQvYCpGg+6cMNKuFeq5dCfhBK8sLXz7Pi4J
v23pGrTxUvcP2c9fnc8EaaG7Kb/fgPaIZ9jp4VyjVAIgBRkioMjAvT/oK7EBAZEGC1Rm4V
HIrzQViXfdwxIzls3diqS/CZjTRVU8h0s35Igf01cUXGwsq6cTL1QLz1NO5cCXfPsXv3Pp
bhF1lVqkgyBR2D4pWwd1yG7Is4ukJ8fp3r4XzfUtv0czfb4eIXGGCGhHAdWBIQ==
ARC-Authentication-Results: i=1;
mx1.freebsd.org;
none
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org;
s=dkim; t=1709331772;
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=MAZ3NsAIL+2mb2YD/mHblv6loAGOg9DehA/N306fpsE=;
b=qcjyN+ql3VJodLti7iRoEf15QJ+U2Xxs/yrYSanNxjZhKqBRDmwb2XEUUTbYIzQj8iqqaI
qGz9d3RtYIGq/RlPpdIvjBTuuv3egkhjSttE6KRXZ83PvBeYGZd7ywMxQ/eRuNbpxwfROU
/eV2EgpBtzKY+pid4s8wvJUpJ3c7phUPhjS8hcFqPN77VtAmRkX4q/gOmAN0UUO0AaB+Qu
Ojemv8z4EMwH7HymqiDmt9l642tC2BeAiZ8glPSWUjRXhffN0MvY4Wfn2gE3Dh6guKJ57U
5wz9kNnEEjrI/xbSGI0ypcknIeAnNhmOl0YqM3acX8cANY04eNlssY7AZGsmKw==
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 4TmjJr5m92zkyZ;
Fri, 1 Mar 2024 22:22:52 +0000 (UTC)
(envelope-from git@FreeBSD.org)
Received: from gitrepo.freebsd.org ([127.0.1.44])
by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 421MMqsi071321;
Fri, 1 Mar 2024 22:22:52 GMT
(envelope-from git@gitrepo.freebsd.org)
Received: (from git@localhost)
by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 421MMqdK071318;
Fri, 1 Mar 2024 22:22:52 GMT
(envelope-from git)
Date: Fri, 1 Mar 2024 22:22:52 GMT
Message-Id: <202403012222.421MMqdK071318@gitrepo.freebsd.org>
To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org,
dev-commits-src-main@FreeBSD.org
From: Warner Losh <imp@FreeBSD.org>
Subject: git: f19875b66bf4 - main - hier.7: various improvements
usr/src and /var
List-Id: Commit messages for the main branch of the src repository <dev-commits-src-main.freebsd.org>
List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main
List-Help: <mailto:dev-commits-src-main+help@freebsd.org>
List-Post: <mailto:dev-commits-src-main@freebsd.org>
List-Subscribe: <mailto:dev-commits-src-main+subscribe@freebsd.org>
List-Unsubscribe: <mailto:dev-commits-src-main+unsubscribe@freebsd.org>
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: f19875b66bf403ed5c57f82bbe2a3f42475d0a06
Auto-Submitted: auto-generated
The branch main has been updated by imp:
URL: https://cgit.FreeBSD.org/src/commit/?id=f19875b66bf403ed5c57f82bbe2a3f42475d0a06
commit f19875b66bf403ed5c57f82bbe2a3f42475d0a06
Author: Alexander Ziaee <concussious@runbox.com>
AuthorDate: 2024-02-28 05:16:35 +0000
Commit: Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-03-01 22:22:37 +0000
hier.7: various improvements usr/src and /var
Forth batch of word smithing: /usr/src and /var: Improved wording and a
few missing files added.
Reviewed by: imp
Pull Request: https://github.com/freebsd/freebsd-src/pull/831
---
share/man/man7/hier.7 | 154 ++++++++++++++++++++++++++++++++++++++++++--------
1 file changed, 129 insertions(+), 25 deletions(-)
diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index f126f3e43996..10847993c0f5 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -666,10 +666,10 @@ timezone configuration information; see
.It Pa src/
.Fx
source code; see
-.Xr development 7 .
-The layout of the source tree is described by the top-level
+.Xr development 7 ;
+the layout of the source tree is described by the top-level
.Pa README.md
-file.
+file
.Pp
.It Pa tests/
the
@@ -684,7 +684,7 @@ log, temporary, transient, and spool files
.It Pa account/
system accounting files
.Pp
-.Bl -tag -width Fl -compact
+.Bl -tag -width Ds -compact
.It Pa acct
execution accounting file; see
.Xr acct 5
@@ -694,67 +694,155 @@ execution accounting file; see
timed command scheduling files; see
.Xr at 1
.Pp
-.Bl -tag -width Fl -compact
+.Bl -tag -width Ds -compact
.It Pa jobs/
job files
.It Pa spool/
output spool files
.El
.Pp
+.It Pa audit/
+security event audit trail files; see
+.Xr audit 8
+.It Pa authpf/
+user shell sessions for authenticating gateways; see
+.Xr authpf 8
.It Pa backups/
-miscellaneous backup files
+critical system configuration backups
.It Pa cache/
miscellaneous cache files
.Pp
-.Bl -tag -width Fl -compact
+.Bl -tag -width Ds -compact
.It Pa pkg/
cached packages for
.Xr pkg 8
+.It Pa cups/
+cached printers for the Common Unix Prinitng system; see
+.Xr cups 1
.El
.Pp
.It Pa crash/
-default directory for kernel crash dumps; see
+default directory to store kernel crash dumps; see
.Xr crash 8
and
.Xr savecore 8
.It Pa cron/
+files used by cron; see
.Xr cron 8
-files
.Pp
-.Bl -tag -width Fl -compact
+.Bl -tag -width Ds -compact
.It Pa tabs/
+crontab files; see
.Xr crontab 5
-files
.El
.Pp
.It Pa db/
miscellaneous automatically-generated system-specific database files
.Pp
.Bl -tag -width "freebsd-update/" -compact
+.It Pa etcupdate/
+temporary files and log for
+.Xr etcupdate 8
.It Pa freebsd-update/
-temporary files and downloads for
+downloads and temporary files for
.Xr freebsd-update 8
+.It Pa pkg/
+package database
.El
.Pp
.It Pa empty/
-for use by programs that require an empty directory.
-Uses include privilege separation by
+for use by programs that require an empty directory,
+used for instance by
.Xr sshd 8
+for privilege separation
.It Pa games/
-miscellaneous game status and score files
+miscellaneous game status and score files for
+.Bx
+heritage games
.It Pa heimdal/
Kerberos server databases; see
.Xr kdc 8
+.It Pa lib/
+holds state information for applications ported from linux
.It Pa log/
-miscellaneous system log files
-.Pp
-.Bl -tag -width "utx.lastlogin" -compact
+system log files
+.Pp
+.Bl -tag -width "bsdinstall_log" -compact
+.It Pa Xorg.0.log
+.Xr Xserver 1
+log, if
+.Xr X 7
+is installed
+rotates to
+.Pa Xorg.0.log.old
+.It Pa aculog
+serial line access log; see
+.Xr cu 1
+.It Pa auth.log
+system authentication log
+.It Pa bsdinstall_log
+system installation log
+.It Pa bsdisks.log
+FreeDesktop.org automounter log, if a desktop environment is using
+.Xr bsdisks 8 ,
+from
+.Xr ports 7
+.It Pa cron
+scheduled task log; see
+.Xr cron 8
+.It Pa cups/
+logs for
+.Xr cups 1
+.It Pa daemon.log
+default log for system daemons
+.It Pa devd.log
+default log for device state change daemon
+.It Pa dmesg.today
+system message buffer log
+Rotates to
+.Pa dmesg.yesterday
+.It Pa debug.log
+???
+.It Pa lpd-errs
+logs for the line printer daemon; see
+.Xr lpd 8
+.It Pa maillog
+.Xr sendmail 8
+log, rotates and compresses to maillog.0.bz2
+.It Pa messages
+general system log; see
+.Xr syslog 3
+.It Pa mount.today
+currently loaded
+.Xr fstab 5 ,
+rotates to
+.Pa mount.yesterday
+.It Pa pf.today
+packet filter firewall log; see
+.Xr pf 4
+.It Pa pflog
+saved packets caught by
+.Xr pflogd 8
+.It Pa ppp.log
+see
+.Xr ppp 8
+.It Pa security
+transcript of events marked with the security flag
+.It Pa setuid.today
+listing of executable files which run with elevated permissions, rotates
+to
+.Pa setuid.yesterday
+.It Pa userlog
+logs changes in users or groups
.It Pa utx.lastlogin
last login log; see
.Xr getutxent 3
.It Pa utx.log
login/logout log; see
.Xr getutxent 3
+.It Pa xferlog
+default log for
+.Xr ftpd 8
.El
.Pp
.It Pa mail/
@@ -765,11 +853,11 @@ system messages database; see
.It Pa preserve/
unused, present for historical reasons
.It Pa quotas/
-file system quota information files
+UFS quota information files
.It Pa run/
files containing information about the operating system since it was booted
.Pp
-.Bl -tag -width Fl -compact
+.Bl -tag -width "wpa_supplicant/" -compact
.It Pa bhyve/
.Xr bhyve 8
virtual machine
@@ -782,10 +870,12 @@ group for command connection sockets; see
.It Pa utx.active
database of current users; see
.Xr getutxent 3
+.It Pa wpa_supplicant/
+IEEE Std. 802.11 wifi run time files
.El
.Pp
.It Pa rwho/
-rwho data files; see
+information about other systems on the local network; see
.Xr rwhod 8 ,
.Xr rwho 1 ,
and
@@ -797,26 +887,40 @@ miscellaneous printer and mail system spooling directories
.It Pa clientmqueue/
undelivered submission mail queue; see
.Xr sendmail 8
+.It Pa cups/
+print jobs and temporary files for
+.Xr cups 1
+.It Pa dma/
+undelivered mail queue for
+.Dx
+Mail Agent; see
+.Xr dma 8
+.It Pa lock/
+???
.It Pa ftp/
ftp root directory; see
.Xr ftpd 8
.It Pa mqueue/
-undelivered mail queue; see
+undelivered mail queue for
.Xr sendmail 8
.It Pa output/
line printer spooling directories
.El
.Pp
.It Pa tmp/
-temporary files that are not removed by
+temporary files that are not removed between system reboots by
.Xr rc 8
.Pp
.Bl -tag -width "vi.recover/" -compact
.It Pa vi.recover/
+recovery files for the
.Xr vi 1
-recovery files
+editor
.El
.Pp
+.It Pa unbound/
+files and configuration for
+.Xr unbound 8
.It Pa yp/
the NIS maps; see
.Xr yp 8
@@ -840,5 +944,5 @@ this document.
.Sh HISTORY
A
.Nm
-manual page appeared in
+manual page first appeared in 1979 with
.At v7 .