From nobody Fri Mar 01 22:22:52 2024 X-Original-To: dev-commits-src-all@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 Subject: git: f19875b66bf4 - main - hier.7: various improvements usr/src and /var List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@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 AuthorDate: 2024-02-28 05:16:35 +0000 Commit: Warner Losh 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 .