From nobody Mon Aug 25 01:52:42 2025 X-Original-To: dev-commits-doc-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 4c9DMG5l14z66Mwg for ; Mon, 25 Aug 2025 01:52:42 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4c9DMG54zQz3wt3; Mon, 25 Aug 2025 01:52:42 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756086762; 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=Eq2+1CNf/zQlbYV3CEstuM/0K7sKzQYlL2yhcbKMCMY=; b=qSHpUZKD2W4v4G+m35Ahsa2/5J1nCpl9Nd2It4KVk/kgXqhyGMlblCqEWmIVekJsGVLPRV lpkbUt+FamTXMN4MJIJAmUq/HGLytXRzjjrYTWZifef5ysKtuXOr8T6FdumeCosIpZYEK5 4t/3bdtbodRKqq/6NlGby9C+TyX+/M6MdPZu9SF+zvFHK+0HY0mHtDcce2rTd0/x49zhXk I7t59YbWntEPsPrc+8s5pgYHey6EE8Q2oSKZdtWgx5WIfJPIy5l//IyVG5EMLLc4nKR5+X qX4zjYL2fI7eQ6Rz+ek07l9OVVGc+z6muVK0PxIbMJaMqDSXjw3N84bkpC7sIg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756086762; 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=Eq2+1CNf/zQlbYV3CEstuM/0K7sKzQYlL2yhcbKMCMY=; b=x8l3KTDPTy/P0c5ITcN6u1fQ4uSccHA8NazwMfXYug12GiMoiJoBd/GmZcFhhYY0VwAOWC FkvTDwj5vBb+3dcbCGUxZBcQIrEGl9YBGRpRx6fHSz+b+Kf32hOhx+FqPa9CzOObrKA6ly 3Xmi0LcgoH1Nbw2CB3b0EP6x1V7k3u+tWZmAzJkuwHBFJV5PMmcNSQTmzE7MheNw57/uuw G7yFNOXUr5DhjyHW8zEW49CSMXIVz+3acfYfc1/3124Dnee/8MzKn6c09+F5m8+7Hp2HJs Dhy8N6NQrwvLa9iCXavGk+s6l1v4QB1gdWO8esK+SBngUtW7xguFLRDWQInJ5Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756086762; a=rsa-sha256; cv=none; b=r6ktWDHhEFwv733loXo08AtZVRLvLIxijlHcCIWiszolbNHPLj11qnipkrzZajpMBuS+oq NMD6Th+mQ8upR6erU9MXj504y6YTDsQUBNlLl7u6vb/3tb5M5bxJsv05helYkWoRjuZ7WJ bcNofGERh33/6Y2ho3nF3tWqx2ArFDlQ/VdaDq4T/MxAo7OJSHJkvcm+pNsOZL9sTzt1ck tuFHOgCpjirRQ0yhvJWQSFUnVljsne+5+2dJYO99+gJqyLQ9dQYIb0K4Up7krelhPZ1HA9 YXJdcQLLex30utmkL1fvGD9tpZlLnvLn7ebYVr24U7ivpXXqKL6yH6K02wVlBg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4c9DMG4YKTzDL3; Mon, 25 Aug 2025 01:52:42 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57P1qgqS021477; Mon, 25 Aug 2025 01:52:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57P1qg5Y021474; Mon, 25 Aug 2025 01:52:42 GMT (envelope-from git) Date: Mon, 25 Aug 2025 01:52:42 GMT Message-Id: <202508250152.57P1qg5Y021474@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ed Maste Subject: git: 8c8f735e52 - main - pgpkeys: Add new emaste@ key List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8c8f735e5240be4ea862d506abc1aabc1ec8372a Auto-Submitted: auto-generated The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/doc/commit/?id=8c8f735e5240be4ea862d506abc1aabc1ec8372a commit 8c8f735e5240be4ea862d506abc1aabc1ec8372a Author: Ed Maste AuthorDate: 2025-08-25 01:49:33 +0000 Commit: Ed Maste CommitDate: 2025-08-25 01:52:23 +0000 pgpkeys: Add new emaste@ key --- .../content/en/articles/pgpkeys/_index.adoc | 3 +++ documentation/static/pgpkeys/emaste.key | 27 ++++++++++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/documentation/content/en/articles/pgpkeys/_index.adoc b/documentation/content/en/articles/pgpkeys/_index.adoc index 51baa8be03..c082f7feba 100644 --- a/documentation/content/en/articles/pgpkeys/_index.adoc +++ b/documentation/content/en/articles/pgpkeys/_index.adoc @@ -879,6 +879,9 @@ include::{include-path}christos.key[] === `{marino}` include::{include-path}marino.key[] +=== `{emaste}` +include::{include-path}emaste.key[] + === `{cherry}` include::{include-path}cherry.key[] diff --git a/documentation/static/pgpkeys/emaste.key b/documentation/static/pgpkeys/emaste.key new file mode 100644 index 0000000000..7e79583675 --- /dev/null +++ b/documentation/static/pgpkeys/emaste.key @@ -0,0 +1,27 @@ +// sh addkey.sh emaste 7B9B8FC081B863CF ; + +[.literal-block-margin] +.... +pub ed25519/7B9B8FC081B863CF 2025-08-25 [SC] [expires: 2028-08-24] + Key fingerprint = D2D8 87C3 2C65 C322 914A DDCE 7B9B 8FC0 81B8 63CF +uid Ed Maste +sub cv25519/09BA94A9879D4F9D 2025-08-25 [E] [expires: 2028-08-24] + +.... + +[.literal-block-margin] +.... +-----BEGIN PGP PUBLIC KEY BLOCK----- + +mDMEaKu6uRYJKwYBBAHaRw8BAQdAvfAZBOCW42PeTuzMgCiICNQa1AI/UuvRg/G/ +Kx1qDvW0HUVkIE1hc3RlIDxlbWFzdGVARnJlZUJTRC5vcmc+iJkEExYKAEEWIQTS +2IfDLGXDIpFK3c57m4/AgbhjzwUCaKu6uQIbAwUJBaOagAULCQgHAgIiAgYVCgkI +CwIEFgIDAQIeBwIXgAAKCRB7m4/Agbhjz4C2AQCaJ0Jb60luV+jXeUNcen3uXSnM +siOpaKfgoYLSnfxOugEAoCe0FBOxkQTlw9RwIPABWOqmApXOeT12PXm+UiLhsA64 +OARoq7q5EgorBgEEAZdVAQUBAQdA5z9Oa9410sNK15TO9rRlxwX+BHPFsWRV51/2 +H985cBcDAQgHiH4EGBYKACYWIQTS2IfDLGXDIpFK3c57m4/AgbhjzwUCaKu6uQIb +DAUJBaOagAAKCRB7m4/Agbhjz+kUAQDpfG08VrCtCzCE9L/GiHwQsVua0eIIdxHR +nEQtpvvEPwD8CSc8pijyf/mjGKosha+vJBK3MI4dYc0M8X8a3RJ6Ggc= +=zvzt +-----END PGP PUBLIC KEY BLOCK----- +.... From nobody Mon Aug 25 15:58:15 2025 X-Original-To: dev-commits-doc-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 4c9b6v3fqHz65yF8 for ; Mon, 25 Aug 2025 15:58:15 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4c9b6v2xZQz3gFQ; Mon, 25 Aug 2025 15:58:15 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756137495; 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=sdCZCFP/7L97VO7CKislmRPEuYOYvu+IcttNq8fXEls=; b=gbaukynJnz03OiV5ts0EyPtt+fCyoL5DFk6gexp306/GzydBLYohaZdtLaqh+75j2rRTnf gvsin96oLLmzKli4iRk3+VLG/YJP5Q5vn9EgoIFqy9sHRnG2JiKc0KOyt7PXgyll2lSxFz NKAKYd5I3cUqTudSBOo5nZoz63f0lEpu0Mw3dWe399IwRJYaEOP8Fzmqss+yJFTPDMd5MU SZsZPSBE68VXO7pZngY7Id9IcjducXSUP4MfcHlvQ1YuxWv0/KJJdS5dAyS2Ty6/3oVmJP Hak+pzAY3FT2Ti0juGemGs7aAOAZami+fyv+nxb+LVMi9+TmqUKcIwuLzjnKdQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756137495; 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=sdCZCFP/7L97VO7CKislmRPEuYOYvu+IcttNq8fXEls=; b=NVHZ5wXdnl4DnNKMhNBymIVjlXDN3akD4VNahIL2q2Q0PRitNCB7BEe3waUe0B96tkXvSH XEnu2JgQNnIyQvqMlSPwCj6HTlu/WkGqxAacGttoNcdHuXXbr7qZNtlzMIAvMap4yE8xtA uacmKlN9n2C7dlKd4J24QxRume2EbBTZimWDIJ2SH0S9/fFTLHifpM5IpIDFW41UhZJAUg NVrs3fdNnqCCUQ0uvIBaz+lMlc2H+GwUCPyAEoMQ58EcT73zkhBzSf3yo27gMxYf5x0gXY YsHYiupocDk5AQdJgPVDWcskia/T5HGTPuWKpynJRjg0BNyw+UNJ+nvIUb/rcA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756137495; a=rsa-sha256; cv=none; b=pmuHbH0o+hmpUPYWzfNpy0ZOngkNwzN2KL2wzyhW3wwFqcxQmgeg4kC+35BE9pcmldLygk RHms7hc3JgUDfr7G/+wR2IhhJWzgoVVHundSwhHu6ekTVIafEUkAgUIbROPuA7hjy4ygFA pPj4c1Y+SWCOdv/spUqkQGgdAy2YdnMmrTl9UrnuChNb6+8si2218YtLh48c8IZ04m6abV K8BnUILusEkxBXtSHGR0vSdL4fBNFGfsK+bYsc++nn8LcopuNrS/2R5ouK7vQiAGuVbGZd lrC2vccxw8xTK0MQrVJ8aUkcB1tj05NqSjE8e8eefz3cGDnXrykqrcovMBlQVQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4c9b6v2Sg9zwXL; Mon, 25 Aug 2025 15:58:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57PFwF2M012399; Mon, 25 Aug 2025 15:58:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57PFwFcD012396; Mon, 25 Aug 2025 15:58:15 GMT (envelope-from git) Date: Mon, 25 Aug 2025 15:58:15 GMT Message-Id: <202508251558.57PFwFcD012396@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Aymeric Wibo Subject: git: 231939c628 - main - Status/2025Q2/kw-hackathon.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: obiwac X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 231939c628f2a0a6823008c0a4d2a36b7de5146b Auto-Submitted: auto-generated The branch main has been updated by obiwac: URL: https://cgit.FreeBSD.org/doc/commit/?id=231939c628f2a0a6823008c0a4d2a36b7de5146b commit 231939c628f2a0a6823008c0a4d2a36b7de5146b Author: Aymeric Wibo AuthorDate: 2025-08-21 21:42:36 +0000 Commit: Aymeric Wibo CommitDate: 2025-08-25 15:57:06 +0000 Status/2025Q2/kw-hackathon.adoc: Add report Final report of the KW hackathon. Reviewed by: lwhsu, salvadore, aokblast, olce, gbe, jrm (mentor) Approved by: lwhsu, salvadore, aokblast, olce, jrm (mentor) --- .../report-2025-04-2025-06/kw-hackathon.adoc | 87 ++++++++++++++++++++++ 1 file changed, 87 insertions(+) diff --git a/website/content/en/status/report-2025-04-2025-06/kw-hackathon.adoc b/website/content/en/status/report-2025-04-2025-06/kw-hackathon.adoc new file mode 100644 index 0000000000..5b8aba58ee --- /dev/null +++ b/website/content/en/status/report-2025-04-2025-06/kw-hackathon.adoc @@ -0,0 +1,87 @@ +=== Hackathon 202506 Kitchener-Waterloo, Canada + +Links: + +link:https://wiki.freebsd.org/Hackathon/202506[Hackathon/202506 Wiki Page] URL: link:https://wiki.freebsd.org/Hackathon/202506[] +link:https://wiki.freebsd.org/Hackathon[FreeBSD Hackathon Wiki Page] URL: link:https://wiki.freebsd.org/Hackathon[] + +In the week following link:https://www.bsdcan.org/2025/[BSDCan 2025], a hackathon took place in the Kitchener-Waterloo area. + +Thanks to Ed Maste for hosting this event at the Communitech Hub in Kitchener. + +==== Pictures of the hackathon + +Pictures of the hackathon are collected link:https://people.freebsd.org/~emaste/hackathon202506/[here]. + +National FreeBSD day landed sometime during the hackathon, so Charlie Li treated us to a great DJ set to celebrate, mixing entirely on FreeBSD at an arcade bar in Waterloo :) + +==== The work done during the hackathon + +===== WiFi Testbed (Li-Wen Hsu) + +- The hardware of a proof-of-concept wireless has been set up in Foundation's Kitchener office. +- The current setup is simple: + - One baremetal machine has multiple wireless interface and, + - One access point is also connected to the machine via a serial console and a private testing network +- Currently we have following hardware to be passthru to bhyve VM provisioned with the image from link:https//artifact.ci.freebsd.org[Artifact server of FreeBSD CI] + - Intel AX210 + - Realtek RTL8812AU +- The work continues on connecting it to link:https//ci.freebsd.org[FreeBSD CI cluster] as a downstream job after standard tests finishes. + +===== Installer (Joseph Mingrone, Ed Maste, Aymeric Wibo) + +- Go through installer step-by-step and create the link:https://wiki.freebsd.org/ImproveInstaller[Improving the Installer] wiki page with the notes we collected. +- lualoader: Add distinct brand for installer (Make it obvious to users that the system is booting into the installer.) + Patch: link:https://reviews.freebsd.org/D51001[] + +===== pkgbase (Ed Maste) + +- man:bsdinstall[8]: Default to pkgbase if media contains base packages + Patch: link:https://reviews.freebsd.org/D50467[] +- man:release[7]: Add set -e to abort upon failure + Patch: link:https://reviews.freebsd.org/D50383[] + +===== Landing scheduler run queue patches (Olivier Certner) + +- Land all scheduler runqueue patches. +* link:https://reviews.freebsd.org/D45387[D45387] +* link:https://reviews.freebsd.org/D45388[D45388] +* link:https://reviews.freebsd.org/D45389[D45389] +* link:https://reviews.freebsd.org/D45390[D45390] +* link:https://reviews.freebsd.org/D45391[D45391] +* link:https://reviews.freebsd.org/D45392[D45392] +* link:https://reviews.freebsd.org/D46566[D46566] +* link:https://reviews.freebsd.org/D46567[D46567] +* link:https://reviews.freebsd.org/D50880[D50880] + + +===== Capsicum (Ed Maste) + +- Improvements to the man:capsicum[4] manpage. + Patches: link:https://reviews.freebsd.org/D50855[], gitref:ce65ff203a4f7ce59c8782f87d90a657f7ccbc46[repository=src] +- Capsicumize man:beep[1] to serve as an easy example of Capsicum. + Patches: link:https://reviews.freebsd.org/D50709[] + +===== s2idle/S0ix/USB4 (Aymeric Wibo, Sheng-Yi Hung) + +- Fix some more USB4 driver panics. +- Discuss how s2idle should work w.r.t. the scheduler with Olivier & Mark, and temporarily implement "idle" state for the scheduler (where it just always chooses the idle thread). +- Extend amdgpio driver to service all GPIO interrupts (requirement for S0i3 on AMD). + We were also looking into how we can consume GPIO interrupts in device drivers on x86 for stuff like reducing the latency of the Framework trackpad with Sheng-Yi. +- Implement some more S0i3 debugging features for AMD to help us debug why we would not be entering S0i3. + +===== Ports (Joseph Mingrone) + +- [.filename]#Mk/Scripts/qa.sh#: Fix false positives in LIB_DEPENDS warnings + Patch: https://reviews.freebsd.org/D50860[] +- package:editors/emacs-devel[]: Update to 2025-06-17 snapshot + Patch: gitref:4170f65753805c08842bd6b200efd8d5ae20d464[repository=ports] + +===== Miscellaneous (Ed Maste, Olivier Certner, Sheng-Yi Hung, Li-Wen Hsu) + +- Enable sccache support as an alternative to ccache when building (through `WITH_CCACHE_BUILD` environment variable). + Commit: gitref:10cb3979a9bde6c8e441e3ba4aa5fd09963c484f[repository=src] +- Discussion on the CPPC implementation (Sheng-Yi, Olivier), see in particular https://reviews.freebsd.org/D49587[D49587]. +- Other various fixes. + Patches: https://reviews.freebsd.org/D50876[D50876], gitref:956100d60fa86daebc1bd46ea62f207f6b54d93d[repository=src], gitref:fc77abfd1e62751b0c76cd5d8ef3299b8ca398c6[repository=src], https://reviews.freebsd.org/D50938[D50938], gitref:6d8cfd29d477c64376b3e286946cddb93c7373c5[repository=src], gitref:4f33d073003ccd91390709e14e5c1bf1f0c1c85c[repository=src] + +Sponsor: The FreeBSD Foundation From nobody Mon Aug 25 16:03:49 2025 X-Original-To: dev-commits-doc-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 4c9bFM1Hvqz65FJb for ; Mon, 25 Aug 2025 16:03:51 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4c9bFM0dWcz3gxV; Mon, 25 Aug 2025 16:03:51 +0000 (UTC) (envelope-from jhb@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756137831; 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: in-reply-to:in-reply-to:references:references; bh=XtmZBheE13oa1ngn1sjWvO6utJBPolki9O9aPSCjBVI=; b=ZdQpMfxunRiTVVv+euo8yrsn1oaMv6XPJbsPkK6UkSRYLAln+2C3fmGILo0TwIDmkwPFN9 fwCqIJHRmbP/NAA8Q/Anaau3q35beOD4qOkLVKA2kAGDXRvhVL1qSy0qmsQOhY8o5V3GmA Cz/HOrJ8FoTFes9PSv32mFPtwrdDc1UTUGIL5e2fR0fqEOY83NhoVwte8ri9iPAqacWnCU BGm4AqqP1J/fit0XWRAGsMY7KqeC3eCDVe8xH9Wbo5boU09uxODOYxNNTuMKw1kJjTuhgJ 8x4OFvnMQBwiodiuQ9F2RY6TNkrRPU4RAsuUJ1hGjxSqAs7EOZL71wHCw0b2OA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756137831; 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: in-reply-to:in-reply-to:references:references; bh=XtmZBheE13oa1ngn1sjWvO6utJBPolki9O9aPSCjBVI=; b=eGiShhf75fOpONtSf/ou3HkgvGaqZE9Btg1vL86bgYmBUPZkZdlM+m6bFJ1bExx6K88Ut2 H4R0dE+ssNVkaXjm49gdOjplGOOxBUT7DZBh1J+QR1UzK06dFYWTAOI3YvdPoVHzGlOsq9 xi0U2TjxS2XvWBM4HlWAGziwCIiws6iI2wY+x3CcSRl7k+EOotCaURkRk5C37JkwsJB7cI 9K+c29552jflVoLoiTBTiMwOpuQxKFC/mvna49g/CjLz3w+AtBllLgGNTacOb39zhI75WL vBmIQYm8K82jZ8UB7BXcwOaXYYxUsxZuf5WptXR+pPeLxX5lrGlzao/RPD3H9w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756137831; a=rsa-sha256; cv=none; b=Ipdics5RyYIxGZY7R8nQVW4tKev8IHjAAA7amPcCCZISMrdzXX+choDrwSa2HbVbEY4ooH uPWaVNh0p6Otmm/ut83LMxQ7sIA531T2qtVlwhQdlFPWF6fSvDoYAVF1YIWIqbRqgqB/B6 1qksxI6ArHHpWYWx6to57ApG5jbzz7n1u87qPD34x0yMtR6N7p52lv6EFk080LrPmqJyN4 c9RSaGItxeCR2Sp0R6oaWXCZ2PN7II5YA2N3zdAUmT7OKjXBDGiJeKAgIVttBBG3h4sVVm AxraRXRp4Y+WRpLOPSk+qSXhMHgnTo4x1qtCFaOlGPKET9KXr9Vo+G2K4tUoAw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from [IPV6:2601:5c0:4202:5670:dcd8:8b69:c90b:430f] (unknown [IPv6:2601:5c0:4202:5670:dcd8:8b69:c90b:430f]) (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: jhb) by smtp.freebsd.org (Postfix) with ESMTPSA id 4c9bFL5xLBz3pr; Mon, 25 Aug 2025 16:03:50 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Message-ID: <5a04b360-9692-43dc-b13b-052587b7cbb4@FreeBSD.org> Date: Mon, 25 Aug 2025 12:03:49 -0400 List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: git: 6fe66094cd - main - HW Relnotes: Remove aic.i386 from template Content-Language: en-US To: Alexander Ziaee , doc-committers , dev-commits-doc-all References: From: John Baldwin In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 8/22/25 12:53, Alexander Ziaee wrote: > On 2025-08-22 10:03 -04:00 EDT, "John Baldwin" wrote: >> On 8/21/25 16:43, Alexander Ziaee wrote: >>> The branch main has been updated by ziaee: >>>> URL: https://cgit.FreeBSD.org/doc/commit/?id=6fe66094cd90c50d1b7ce7a994d86ff1f95ac0ba >>>> commit 6fe66094cd90c50d1b7ce7a994d86ff1f95ac0ba >>> Author: Alexander Ziaee >>> AuthorDate: 2025-08-21 20:35:29 +0000 >>> Commit: Alexander Ziaee >>> CommitDate: 2025-08-21 20:35:29 +0000 >>>> HW Relnotes: Remove aic.i386 from template >>> > Ref: src:c24bd33d41b6d (Remove aic(4) driver) >> >> Hmm, for 15.0, we aren't shipping kernels for i386 or 32-bit powerpc, so >> that means drivers for those platforms aren't relevant either and should be >> removed. If a driver is for both amd64 and i386, we probably want to only list >> amd64 in the release notes. >> >> For any powerpc drivers, you might want to ensure it is not used for powerpc64 >> before removing an entry in the harware notes. powerpc64 is kind of special >> compared to i386 vs amd64 in that both powerpc and powerpc64* share the same >> sys/powerpc directory and sys/conf/files.powerpc, etc. >> >> i386 should be a straightforward cleanup at least (I hope). > > Thanks jhb! I didn't even think of that! > > 1. What's the best way to verify that they're i386 and not also amd64? I thought i386 drivers will always work on amd64. There are a few drivers that are i386 only. My best guess was to just look at the rendered release notes and check for "i386" annotations and use that as a guide. > 2. Should I remove the manuals also, or just remove the entries from the hardware release notes? For now I think just the latter. I think we should wait to remove the actual manuals until we remove i386 kernel support from the tree. -- John Baldwin From nobody Mon Aug 25 16:08:38 2025 X-Original-To: dev-commits-doc-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 4c9bMD3yFkz65FLQ for ; Mon, 25 Aug 2025 16:08:56 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Received: from mail-pf1-x42e.google.com (mail-pf1-x42e.google.com [IPv6:2607:f8b0:4864:20::42e]) (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-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "WR4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4c9bMC6Qcnz3hhw for ; Mon, 25 Aug 2025 16:08:50 +0000 (UTC) (envelope-from wlosh@bsdimp.com) Authentication-Results: mx1.freebsd.org; none Received: by mail-pf1-x42e.google.com with SMTP id d2e1a72fcca58-76e2e88c6a6so3967921b3a.1 for ; Mon, 25 Aug 2025 09:08:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bsdimp-com.20230601.gappssmtp.com; s=20230601; t=1756138129; x=1756742929; darn=freebsd.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=0NtHycifo5RmIbdrv9bxM7C6OHbw/v30/IYo6rRhys0=; b=GmoOOC91llY7+436knMW7FHMfhxrmVWhXe+MuqQcRiZUFQBOja63MDE5+FZgfI28sz eilRD2Vp3ICSuc5E3X7b/zNgO4TUEQI0h2PpbWyngW+Mk8El+hSqkHLuhoLAWpK8bn+5 4TJ4aA9KEV5IkwTnWfRYvy/lZxJViTVYJyOjXB/n8tvxOoXhiGAk4IB8WR6BNGRkePgu JfMtzUI//v1Z9rbCNpN0FpnzImeo5oOpuUHPweuHH9j9xk4P+sDij4FgzAzD2j33CUd7 LLPejGvHwvsY2uBNajhA2cnZX3aFgyV/bXXySo8ZpQ1VWs94yDjusT++E/9Sjb8yPO+k zpDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756138129; x=1756742929; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=0NtHycifo5RmIbdrv9bxM7C6OHbw/v30/IYo6rRhys0=; b=QnPjcTUemaWBFnLSvpInh+f6eHFjkYZs3dnR9JgrU7gF/prXUaNR1sgLYj67drCiLO vV3esSGHCQslk/kOjgksOWL6NhUMIeGeS5LCWpBJODuf88W5pggecN6zCt4PWI9Vr+OK YAtDMo3uU38gFNUWtFcDG9sfLkc1Dicb90/EEHaUjYkMwG5u4dJT0btLHrz/BZC4uFyH MyxIf2JW5P18IRpLXj5ks47Oe92SFbfq/96q8EgrLg7dHATezN7WyPPvF81a5wLlxjY1 fAAkNyEiFadu4k3876doGc4mmi2pG9qlEQ2ycZ1CE20GQtRNptenOau2myKWDq+lezdq pH9A== X-Forwarded-Encrypted: i=1; AJvYcCWFBCEscWVdDlaQohXzwxP14ngnH5OyH9r+lgQcDHyDQ2vD3Dn50EL9Ue0Bd5+5X9NcmLUvlhVioJQvRQc94L/g9lfy@freebsd.org X-Gm-Message-State: AOJu0Yw2UkLJ1jAsNkpoLWGPFwlDgnHLCKc9rR/VNuv0l4Z0Yi01lEcF 8zNPP20H7Im6StDrd2WAI/X0KlWzd/+lnIBtOf7SzL3yQUNLPz0OfcHB7IrSNJrUbSZqpULb0Gt t8bviVg3PmYi1FaOWTUZ8Nhv5ZjCDY6L5kT9u5lJxpQ== X-Gm-Gg: ASbGncszXVLT3Hsunliv26dY1gqphGj44ST+w0H7K4W2llq7tq2k2cp0iN5IRE6QsA4 kOpAXycS4mZvFuKkldo8e00K+8ezNDu8/v5972p2840M6znhlijUJmwViknJUrdUMbDzowNzZRu GKD5feMu4IrHlE2fFEz5PQO5XBP6jKOyjhjnCIpdSg08RpTDpD1h7KgumYsW/aKWrz8xwqXK+Yu c+dLQRbiWcTae0FSFkkKQ6RCEYIkcuHtw4PNVo= X-Google-Smtp-Source: AGHT+IEh7Yxckg17ht5iTK24EXMKhxuRn/BgHtv9XV8vFgZsM9vr/mTMq/vA7LeStCLib9953XFy+HxENmx+y0rwvtM= X-Received: by 2002:a17:903:38cf:b0:240:9dd8:219b with SMTP id d9443c01a7336-2462ef99b9amr167164025ad.49.1756138129036; Mon, 25 Aug 2025 09:08:49 -0700 (PDT) List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 References: <5a04b360-9692-43dc-b13b-052587b7cbb4@FreeBSD.org> In-Reply-To: <5a04b360-9692-43dc-b13b-052587b7cbb4@FreeBSD.org> From: Warner Losh Date: Mon, 25 Aug 2025 10:08:38 -0600 X-Gm-Features: Ac12FXxq-q1iF9kKl8pRRtf3UH4RE4WpbAOD7Kb8bAb6754kJOs8U9tvUzHdHug Message-ID: Subject: Re: git: 6fe66094cd - main - HW Relnotes: Remove aic.i386 from template To: John Baldwin Cc: Alexander Ziaee , doc-committers , dev-commits-doc-all Content-Type: multipart/alternative; boundary="0000000000005baaee063d32c582" X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:15169, ipnet:2607:f8b0::/32, country:US] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Rspamd-Queue-Id: 4c9bMC6Qcnz3hhw --0000000000005baaee063d32c582 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Mon, Aug 25, 2025 at 10:03=E2=80=AFAM John Baldwin wro= te: > > 2. Should I remove the manuals also, or just remove the entries from > the hardware release notes? > > For now I think just the latter. I think we should wait to remove the > actual manuals until > we remove i386 kernel support from the tree. > In the past, we've removed the driver and the manual at the same time (usually, not perfectly). It's better to not leave dangling things, but the i386 kernel removal is going to be brutal since not everything i386 is i386 specific, and not all the i386 specific stuff is under sys/i386. Let's not create confusion by going 'oh, is there a man page for this?' on top of it. Warner --0000000000005baaee063d32c582 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable


On Mon, Aug 25,= 2025 at 10:03=E2=80=AFAM John Baldwin <jhb@freebsd.org> wrote:
> 2.=C2=A0 Should I remove the manuals also, or just remove the entries = from the hardware release notes?

For now I think just the latter.=C2=A0 I think we should wait to remove the= actual manuals until
we remove i386 kernel support from the tree.

In the past, we've removed the driver and the manual at the same = time (usually, not perfectly). It's better to not leave dangling things= , but the i386 kernel removal is going to be brutal since not everything i3= 86 is i386 specific, and not all the i386 specific stuff is under sys/i386.= Let's not create confusion by going 'oh, is there a man page for t= his?' on top of it.

Warner
--0000000000005baaee063d32c582-- From nobody Tue Aug 26 13:50:34 2025 X-Original-To: dev-commits-doc-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 4cB8F71tRkz65bR0 for ; Tue, 26 Aug 2025 13:50: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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cB8F71H2Vz3MFn; Tue, 26 Aug 2025 13:50:35 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756216235; 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=l07d17/Sp+y0F7h+QrtSs2+2X+g4GNeFVN+/xuIiksE=; b=jgIznFdBwJcPDZD66O12Jtvzx4IEjczZ5pmD23tgJYWfmJ9w18gpkVgZnsYjjwknh0ae8A fyRT/fut+34ZN810BYCu/urNcdaXdlpUKhlCMXwm16PvW8/gVpSbcIJZkuUSmvXqnjnWT9 Tqn9AMUalqAAvtG6bSJgBfEIho/B8mKT3IqDrUZsaeOvyLq2ZZu53gjG0RYWGiAMWtT0HH kQ1zAkOlITzPcIrjRMArrvv/pD3boje2mP2NMRwzjjKq3eepIFxLhHxpysRKIhnnAlU4/I CYj+uom6xjY8xUGUKpd9y8jxCPJW9ab4OyqmCkNap+KQui4KxkTOp75JnKx2UQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756216235; 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=l07d17/Sp+y0F7h+QrtSs2+2X+g4GNeFVN+/xuIiksE=; b=tWlq215Z+JDgfPSpr5AMwjdSfUZTH55qv8HtB/BTk9ko5pSc4QNZKsuAh6ef5B6WVFmuyY WBLF5zyAuv5bSYXJxACneWm6loGEimg8BGsSSbRqofBGVIawlb8RRPUG2reDf57hVLNG47 ugLwfUGJ0aPuuyX/qCl+dCywQNJKhQmlBe8fEJPJJHVf+fn1Bk/Y/4zbN2zjVXZQv6Cwxc qGKO+RwQzoiNNkrBiWgBYTBkTJfhpn+3b42tYB1E92VyF48l+/QXhzmd4fPaTngMaIiZXG 767UEo0gWDfdUvW+VORveKf8vDKlMSn15TJNB2zyfTaOb8Lup6Oz/93pdfYuAQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756216235; a=rsa-sha256; cv=none; b=Npwe9UGVGlY3mNDkB9VCG43eCxCIyh9gVzU0BLYafe2CHOrVfrNolDTFCTyHGXn+3LjYyH 9X94Qt035dCCkZQZ3frJBS2eYTASBS4UnVsK92rBxnufsT4F0MznCEt8zc0YrGkLaWBKtJ XCL+lPH+3TUEPk3YPxsRaOLb8snkPebntPdXh0851yvwSixvG9aduVljr2s2lF8Y++AEAT WSesUwvEFVIJihR6E0azt+7KnR7i7YKjaTXvteAF5RkudOlYEhDEYf3eFqZCmA+IZBZ0bp NxfOH+eRVgBn853MuPOEMl3rf9aDQeITaM2Oog90wrQGNooHf+J0CBsQHguq9A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cB8F705Jqzfrn; Tue, 26 Aug 2025 13:50:35 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57QDoY2W092160; Tue, 26 Aug 2025 13:50:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57QDoYjS092157; Tue, 26 Aug 2025 13:50:34 GMT (envelope-from git) Date: Tue, 26 Aug 2025 13:50:34 GMT Message-Id: <202508261350.57QDoYjS092157@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 387f30ecec - main - Status/2025Q2/groupe-changes.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 387f30ecec1fa147d9cf41bd1facbc4c369da472 Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=387f30ecec1fa147d9cf41bd1facbc4c369da472 commit 387f30ecec1fa147d9cf41bd1facbc4c369da472 Author: Kyle Evans AuthorDate: 2025-08-19 04:19:41 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-26 13:50:00 +0000 Status/2025Q2/groupe-changes.adoc: Add report Pull Request: https://github.com/freebsd/freebsd-doc/pull/539 --- .../report-2025-04-2025-06/group-changes.adoc | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/website/content/en/status/report-2025-04-2025-06/group-changes.adoc b/website/content/en/status/report-2025-04-2025-06/group-changes.adoc new file mode 100644 index 0000000000..01dc8f2a13 --- /dev/null +++ b/website/content/en/status/report-2025-04-2025-06/group-changes.adoc @@ -0,0 +1,27 @@ +=== ucred / group changes in FreeBSD 15.0 + +Links: + +link:https://lists.freebsd.org/archives/freebsd-hackers/2025-August/004825.html[freebsd-arch@ discussion] URL: https://lists.freebsd.org/archives/freebsd-hackers/2025-August/004825.html[] + +link:https://cgit.freebsd.org/src/commit/sys/sys/ucred.h?id=be1f7435ef218b1df35aebf3b90dd65ffd8bbe51[Primary kernel change] URL: https://cgit.freebsd.org/src/commit/sys/sys/ucred.h?id=be1f7435ef218b1df35aebf3b90dd65ffd8bbe51[] + +link:https://cgit.freebsd.org/src/commit/sys/kern/kern_prot.c?id=9da2fe96ff2ea227e4d5f03ef92b55aabeabb7fc[Primary userspace change] URL: https://cgit.freebsd.org/src/commit/sys/kern/kern_prot.c?id=9da2fe96ff2ea227e4d5f03ef92b55aabeabb7fc + +Contact: Kyle Evans + +Contact: Olivier Certner + +FreeBSD 15.0 will change how supplementary groups are handled in both userspace and the kernel in FreeBSD 15.0 in a way that warrants additional attention and feedback. + +For some background: FreeBSD has historically tracked the effective group-ID of a process in the man:ucred[9] cr_groups array as the first element, with the rest of the array describing its supplementary groups. +The natural consequence of this decision is that the arrays used in man:setgroups[2] and man:getgroups[2] follow the same format, and man:setgroups[2] has the documented side effect of setting the effective group-ID. +The vast majority of other platforms do not exhibit this behavior anymore, including NetBSD and OpenBSD. +macOS appears to be the only exception found in testing. + +The problem is that the vast majority of software in the FreeBSD Ports Collection comes from other platforms, where man:setgroups[2] and man:setgroups[2] operate purely on the supplementary groups. +This kind of a behavior difference is very subtle and would need to be audited more carefully to be sure that we have not introduced a potential security issue in ported software. + +In FreeBSD 15.0, the primary user-facing change is that man:setgroups[2], man:getgroups[2], and man:initgroups[3] behavior will change to match other platforms, and users are requested to be extra vigilant in areas that may be affected as we proceed through the release cycle. +In general, the expectation is that this change may: + +* Fix some small number of bugs where we would have lost either our expected effective group membership or one of the supplementary groups we should have been in +* (Less likely) Introduce some even smaller number of bugs where something expected man:setgroups[2] to change our effective group membership but now it is just a supplementary group and our effective group-ID is unchanged + +Software included in the base system is largely unaffected or improved by this change, with OpenSSH being a notable example of a link:https://cgit.freebsd.org/src/commit/?id=239e8c98636a7578cc67a6f9d54d14c71b095e36[strange bug] caused by the historical implementation. From nobody Wed Aug 27 10:55:00 2025 X-Original-To: dev-commits-doc-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 4cBhJ462xwz666LK for ; Wed, 27 Aug 2025 10:55:00 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cBhJ44wHQz3VZT; Wed, 27 Aug 2025 10:55:00 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756292100; 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=O2rszatWyStMeu8YfKyD5iViIfew7QJC3JG2pngI3CQ=; b=jceJTBpTUGjhPVdI/kb4F5w1c18QqstCawU0Ut4FX9bviY7ZWabBdrC9RpW1RJVtuZ9I5f WNAW9I2H4OaPMfrKhKUU24yrF4ABn+gzy1jIK2d/Hr5sl57WMd6GXjjJdFe4+tCPNMPDCT r9x15mpWeEk3IJAxd3bxhpd6ewI/haatHclEd6QtUWI2Wp+LTW4mgmgYi0uYU6BuPWkbiV NFxA7x+1JXr9OCyXSW2AQqnTU/XR42qqfxojvf3xrew+NBRizDKTj9ukc2PhfUu9Vqh9Wh zmsmgXhDzUHRKtfz1G04KfDumg9VKiVejlYIkSIibPz5Xjt6aSR/115MTVgDDA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756292100; 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=O2rszatWyStMeu8YfKyD5iViIfew7QJC3JG2pngI3CQ=; b=h5vHHREIXuGL9SHG9Pk8Aw3WYRaHI+8IYUrP+xHzaY5W9VSNNDVzWYQF3+mDBWigp+hJ/h vtAn/QIyHDEqJOmJ+HlPdFZhBh0WVAOTfTT94bKYQRyqRfiEUe2c6ws4MNypDSRMTR9srA KFwB1wpYlE1Pezw4mX5vyyD5yV6KOSjEh9gueYCWTK7EGzJIpL17dPYc5uJRYgS0KVBYkP z7NKaed831UGVSwK57hDSmobqSq2bXYFg7dkm+KzQTdfAOuq56ladzrqY1+XeNlFRlXDft sXsTcVM+J/iom6yjSNL0O0p5CSOMI9Po0AGEVxz0GOdnpWuqt8allpxfi2sp2Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756292100; a=rsa-sha256; cv=none; b=l5Nvrt05HxrGGK9RDjEpxpcXrAu4vKFfFhrFEgkXff+dxYkt2izE5TWYpy8kGJggZ6WCME KGUp+TrNbkvkSt7qxsYmQM92BaqAjxrR3VdbfIyfWAlM/WDb++DHqYx15BKPVjp6J68OOG pfTZUnDmPIVuuMVlWsdBCbxGq7QWBx8qIuiE6xBqKzT4rn8uKRQrl12XLJu8VtmUtqqa7d rEAFTzawIAjoDZinrG9Ph3eu7nUQLRg0QYYS5V1YDoMCAesbVELhJsnwOSieNjoyCl73ru uNFNesnkO+n5mtREJekuMvchD4VkQ8WuqzjksEivoFjssFtKQ8FDJ5jU0XMrwg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cBhJ44THnz4WF; Wed, 27 Aug 2025 10:55:00 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57RAt0Dt078650; Wed, 27 Aug 2025 10:55:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57RAt0AM078647; Wed, 27 Aug 2025 10:55:00 GMT (envelope-from git) Date: Wed, 27 Aug 2025 10:55:00 GMT Message-Id: <202508271055.57RAt0AM078647@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 92dfc0643a - main - Replace vestiges of nonexistent /cdrom to /media List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 92dfc0643a55ccd9e5221967de9c125382c3c86b Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=92dfc0643a55ccd9e5221967de9c125382c3c86b commit 92dfc0643a55ccd9e5221967de9c125382c3c86b Author: Benedict Reuschling AuthorDate: 2025-08-27 10:53:26 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-27 10:53:26 +0000 Replace vestiges of nonexistent /cdrom to /media PR: 282681 Event: Oslo Hackathon 2025 --- documentation/content/en/books/handbook/basics/_index.adoc | 2 +- documentation/content/en/books/handbook/cutting-edge/_index.adoc | 4 ++-- documentation/content/en/books/handbook/network-servers/_index.adoc | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc index 0abb750dab..df093f4e5e 100644 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -1076,7 +1076,7 @@ The root directory also contains mount points for other file systems that are mo A mount point is a directory where additional file systems can be grafted onto a parent file system (usually the root file system). This is further described in crossref:basics[disk-organization, Disk Organization]. -Standard mount points include `/usr/`, `/var/`, `/tmp/`, `/mnt/`, and `/cdrom/`. +Standard mount points include `/usr/`, `/var/`, `/tmp/`, `/mnt/`, and `/media/`. These directories are usually referenced to entries in `/etc/fstab`. This file is a table of various file systems and mount points and is read by the system. Most of the file systems in `/etc/fstab` are mounted automatically at boot time from the script man:rc[8] unless their entry includes `noauto`. diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc index e1390faa52..59e38e2bc9 100644 --- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc @@ -415,8 +415,8 @@ If physical access to the system is available, a copy of the `GENERIC` kernel ca [source,shell] .... -# mount /cdrom -# cd /cdrom/usr/freebsd-dist +# mount /media +# cd /media/usr/freebsd-dist # tar -C/ -xvf kernel.txz boot/kernel/kernel .... diff --git a/documentation/content/en/books/handbook/network-servers/_index.adoc b/documentation/content/en/books/handbook/network-servers/_index.adoc index dba07a8e2c..37109cb947 100644 --- a/documentation/content/en/books/handbook/network-servers/_index.adoc +++ b/documentation/content/en/books/handbook/network-servers/_index.adoc @@ -319,11 +319,11 @@ The examples can be modified to match the file systems and client names on the r There are many options that can be used in this file, but only a few will be mentioned here. See man:exports[5] for the full list of options. -This example shows how to export [.filename]#/cdrom# to three hosts named _alpha_, _bravo_, and _charlie_: +This example shows how to export [.filename]#/media# to three hosts named _alpha_, _bravo_, and _charlie_: [.programlisting] .... -/cdrom -ro alpha bravo charlie +/media -ro alpha bravo charlie .... The `-ro` flag makes the file system read-only, preventing clients from making any changes to the exported file system. From nobody Wed Aug 27 11:39:20 2025 X-Original-To: dev-commits-doc-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 4cBjHD6VCbz6685c for ; Wed, 27 Aug 2025 11:39:20 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cBjHD5vxNz3YKw; Wed, 27 Aug 2025 11:39:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756294760; 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=V6XuKUqCRqCbMluTVyoP5gBR+YRAMLMc/tebVbITR7U=; b=A4ivW74GP0vTzfdt5rezQnUB0zVcRJqFPSdFV51SL1OYpYkLKsS8JoVY0sJ3UjpbS4uigN HGE7QUOwUmJreyAXryTGj0aHigxVLcos3vdedwVpvevHCRumdJASapKT7K0VlA+vfpxgj1 PNgFy5//LzqineBmCj6wwjE+FbjeXl47032ADG+Z3AnKL/OzxQq/hmnaTwK+Cs/PKGWvvp xiR661vIEHB0Ajt6pyXT2hYGYlLSX57FI4QZonRuDtfNaJowFo2aZJkQSh3r45Ab+XwhZN IL+uQABWXArLHUsGIoSDh4QuenIArajtd4JlL94vLivsiRmU8aOnsc7W82YmeA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756294760; 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=V6XuKUqCRqCbMluTVyoP5gBR+YRAMLMc/tebVbITR7U=; b=yJ5OVlOOnU6eiVwRGQ7U8nJjsq+S8zmu+SMeZUZk+oiaPlXYF95vOQS21LJFYDI7Cs1X6W TttFWvl0uXgsKBkl/y8nffc51oa6MsFyGSc8ZbZ4KbAoL1TL4wsIUn0d1JxCEXMmhMBZe8 7SSEOh+lS5jPrffhPJaWK3iNYReum6G7LhC9a6eN9nQNkgySDM03kMOGJ3fLnZIgGfHoyh It0244LFEz7KSXuNHKPPo9kOi+YUrdKjTzP9QHKndynDIE/Eoul5DQEf0fnJUzkGAwT4w8 wuClfjTDOF2/c9rVGbp0tYBeGh3mM5wKwmXWyhksEGPKFhM8TkirI07TEFIQEg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756294760; a=rsa-sha256; cv=none; b=VE8bohjNvyY6BLvb+l0gmy7Oo9b/Mkc6/6rOQwl/wRQOU4r7DrdCbm3ums9fQxZmQWhd+p 7fB9atO7atpdKqc1au1WEc2Qrf0FqBi8DnZ22vlrCdTA57N6m5JzWBjXrIoMOCdKURhOXp G8VcyR3GCzWD8BRpcYYReS69R9aIze9rr0mbjtBDMAgSmQO7ha/oS9oG/CvxTAa8LZwtmE VwLJn+DpmFsVQMSZ0cPYz+9orf5aUv++D8rjuUZ/8k6dPMBbD67CIFesGbN2CPHPfoa30D 0WxQgw5a1ZNw0BunAkAJw/tYvLHKGNFSOzZCNDgoLhAIdR0ZlWELaz0st2U57Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cBjHD5KxBz4nM; Wed, 27 Aug 2025 11:39:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57RBdK5r055878; Wed, 27 Aug 2025 11:39:20 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57RBdKsT055875; Wed, 27 Aug 2025 11:39:20 GMT (envelope-from git) Date: Wed, 27 Aug 2025 11:39:20 GMT Message-Id: <202508271139.57RBdKsT055875@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 25f1ff3ed7 - main - Add HUGO_CMD variable for running on mac OS List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 25f1ff3ed7598a22ad7a9a11fb9e67bb4329d86e Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=25f1ff3ed7598a22ad7a9a11fb9e67bb4329d86e commit 25f1ff3ed7598a22ad7a9a11fb9e67bb4329d86e Author: Andrés Jaimes AuthorDate: 2025-08-27 11:36:52 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-27 11:38:47 +0000 Add HUGO_CMD variable for running on mac OS PR: 288591 Event: Oslo Hackathon 2025 --- documentation/content/en/books/fdp-primer/overview/_index.adoc | 2 +- documentation/content/pt-br/books/fdp-primer/overview/_index.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/fdp-primer/overview/_index.adoc b/documentation/content/en/books/fdp-primer/overview/_index.adoc index 2b72b0c23e..c316176b05 100644 --- a/documentation/content/en/books/fdp-primer/overview/_index.adoc +++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc @@ -290,7 +290,7 @@ Repeat until all of the errors are resolved. + [source,shell] .... -$ bmake run USE_RUBYGEMS=YES RUBY_CMD=$(brew --prefix ruby)/bin/ruby +$ bmake run USE_RUBYGEMS=YES RUBY_CMD="$(brew --prefix ruby)/bin/ruby" HUGO_CMD="$(brew --prefix hugo)/bin/hugo" .... . Add all the files with `git add .`, then review the diff with `git diff`. For example: + diff --git a/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc b/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc index 3cfbb5b603..605491e080 100644 --- a/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc @@ -276,7 +276,7 @@ Revise a saída e edite os arquivos para corrigir os problemas informados e, em + [source, shell] .... -$ bmake run USE_RUBYGEMS=YES RUBY_CMD=$(brew --prefix ruby)/bin/ruby +$ bmake run USE_RUBYGEMS=YES RUBY_CMD="$(brew --prefix ruby)/bin/ruby" HUGO_CMD="$(brew --prefix hugo)/bin/hugo" .... . Adicione todos os arquivos com `git add .`, então revise o diff com `git diff`. Por exemplo: + From nobody Wed Aug 27 12:06:55 2025 X-Original-To: dev-commits-doc-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 4cBjv35Wxbz66Bgf for ; Wed, 27 Aug 2025 12:06:55 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cBjv34zPTz3d1W; Wed, 27 Aug 2025 12:06:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756296415; 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=IVTB7gNTidlOYs1llnJlpRdtDc3jDdTYuRlAA10AYmI=; b=P2E/JjXpKEL1peN6jPLJwOQVsXeKyxYPHoGYrQVmE+tcC5b/i4IK7ZBeyVj6doCCQWJDkp 0fP1zOiUOOLKv6lP55ekzgJkuX1yeImiMO0M8dXUaH8Qcl3CYZmdel201BxvT1CYT2yhbF i6tNrW56Tdx7crVf4ekgR+UPBTI6AfUYcd4mRen/sfCCoRDuJI4Dzp40rS7K4C064X62r1 aq06GCeC55GebX9EMXIb6+XYSPi4Itjf20gX9IIEX3GmAsTS9BnNx/bzW9132g19RZONQf wx/SrRpPlXqaD2uubEP0tIEU/nmVE8Ct2A9c6oJrzcZxgmn9X4nHavqkNO6MvQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756296415; 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=IVTB7gNTidlOYs1llnJlpRdtDc3jDdTYuRlAA10AYmI=; b=r34FvMsHxZf+5z5idBN1Cnhc4J2FsGSXtcOCp4TvRhrBgcFfPQDt5DtOYBVN2DUkM9VmM9 7ZxU/oDWN4AzXuH8NNJKW1kwyzYFjugabHfbEBDYh1blLxEmyaa6MWaEH1j52rutaG4B8U ++qY/I2mS5BOmTFw4qnPNv+PaMkXqAH3FlzEp/pyXZsq5VN3xLlP9SYuUX5vfVnfxXBfw8 EQVhi2Y0l1k1Fud+qJPIG9kIOQalT37/uevjbq5HnOXuZBnErpphH3r1CtHBvwcYQm2t8n LOF0B4MfYZqYLfgngYieztLdBkBhpPErSb4x+usfVL9BNMPVprdA0m85Y1Bk5g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756296415; a=rsa-sha256; cv=none; b=IXPKzmllQnFp5mHaIC7CwPqIryT61Vn5lBJKi+ZoOk1MjqkPvg17B7zuvUL2gWfJfb0HZI IMnUXNmzDKzL4QVx+UC/4DoGYxH6L90C6tZw7OvOx5EktgY6YjAcERyErzhhzdmT0y36iy hdu7jJLebffT/TEJ64T3GS+DfFrZQa9MdutRSZXXooeWu3/FpN4CQHY7pUKzKic15Rss93 Ud0uR2umnvKTjLURgMd6MTJjhtAO/DU1/xKI1/Qa8YvT6rfLCC7nvh4YFywJER7Mz7qQqn U9YbxD7dTbxBitvL0KORL1RO9cehyuTGkxBISBmpsfOh99v5rChBFORmUpyFkQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cBjv34DQ4z5cS; Wed, 27 Aug 2025 12:06:55 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57RC6tgP012182; Wed, 27 Aug 2025 12:06:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57RC6tIV012179; Wed, 27 Aug 2025 12:06:55 GMT (envelope-from git) Date: Wed, 27 Aug 2025 12:06:55 GMT Message-Id: <202508271206.57RC6tIV012179@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 4de0473841 - main - Status/2025Q2/intro.adoc: Add introduction List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4de047384107ff7002c192749c8b8639fa1af1a5 Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=4de047384107ff7002c192749c8b8639fa1af1a5 commit 4de047384107ff7002c192749c8b8639fa1af1a5 Author: Lorenzo Salvadore AuthorDate: 2025-08-26 15:36:12 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-27 12:06:47 +0000 Status/2025Q2/intro.adoc: Add introduction Reviewed by: status (Graham Perrin ) Pull Request: https://github.com/freebsd/freebsd-doc/pull/543 --- .../content/en/status/report-2025-04-2025-06/intro.adoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/website/content/en/status/report-2025-04-2025-06/intro.adoc b/website/content/en/status/report-2025-04-2025-06/intro.adoc new file mode 100644 index 0000000000..3dcc419a3e --- /dev/null +++ b/website/content/en/status/report-2025-04-2025-06/intro.adoc @@ -0,0 +1,17 @@ +Here is the second 2025 status report, with 32 entries. + +As for the preceding quarters, this report is published just a few days before calls for 2025Q3 report submissions are sent. +Indeed, although according to our link:https://docs.freebsd.org/en/articles/freebsd-status-report-process/#_timeline[timeline] we should have published this report in July (general rule is publication should happen within the month just after the calls for reports are sent), we kept receiving important reports until the end of August. +This is both a positive and a negative thing. +On a hand, it means that our FreeBSD community is busy fixing existing issues and implementing new features, making the OS we love better and better every day; it means that the community works so intensely that very little time remains for reporting. +On the other hand, it means that news in these reports is always two months old when published. +Two months is not bad, especially if we consider that FreeBSD communication happens on many other channels too, but it would be nice if we could improve it. + +If you are a late submitter, please take some time to evaluate if there is anything you can do to improve your report submission punctuality. +The Status team is always glad to ease the submission process: if there is something we can do for you, just ask. +If you are a contributor or just a FreeBSD user, please consider contributing more if you can. +Even working on a single small simple task only is useful, it can help to lower the pressure on other developers, for whom it might thus become easier to find the time to document their work. + +Have a nice reading! + +Lorenzo Salvadore, on behalf of the Status Team. From nobody Wed Aug 27 12:37:12 2025 X-Original-To: dev-commits-doc-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 4cBkZ04154z66D9w for ; Wed, 27 Aug 2025 12:37:12 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cBkZ03BXgz3hCB; Wed, 27 Aug 2025 12:37:12 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756298232; 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=onEIrVjjbqXlEqwpNDWEgGWcSZNaKu3ro+pQyexs4fE=; b=DMgn5v8sbnP8wnOqNRdlA4k/KQvcKfL6yrqPRoxi+eg7K66ypbLodBJU2FL32MxnOTmKMi aU6l3tVfpOQ6nZeNAkO1XeCViDCc32DL7s8W+YLKORFC2Cytyis/emneh+KOU9dvseb5Lg j6jIzOgoMY3WDGPs5qJpg2K6eDPtD9hIoDzm0i7uJoTflHMC4kEp6coUAscyUIBni7KZNh /jIPA+I5mcSu5dNrw1xFnNN5MWRO3o3AuPWuH5+KrrH71i3R8FI26cTbviLN3jJ9oqmVtJ Xc2CS/qCBFC6OaiA82rhDFyDUrxHkGiztU0gh1G00WZfUFGTzpaLErRelG4Jnw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756298232; 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=onEIrVjjbqXlEqwpNDWEgGWcSZNaKu3ro+pQyexs4fE=; b=GFEFyc0wIRRfEGXPMtv87o5FPN//P4hSHtukafEUl0oa7VdVDRHgIqUGlFKc3rOb5ZO5ol qa0fW+2Uixm+vN1MHVP3kXH2SjfozzEXWZWgJcviEkU4PJAU5qv5ZVJSI8ARfZBsxeGePZ nTTVwqEqQCT0i0zWyqd71mP0t3xiD2XcirF9WFmtsAsdYXU/7HPZ+Mn6DcYEubk72sKR/7 x6DQTLkLHcnWZ8roe0xHKNHpkLsWVgndDHSUOWZU11QiCaQu3yW+uFLc3nElhND/XPQCR8 EX0wNS1G2ncvQtdFkXcqI3L/vHyyyoHD++rXru1L3VrmMptb5E+1Nt4VdGd4nQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756298232; a=rsa-sha256; cv=none; b=KC1ZuPUAvHMhB7Q9wUm2w8Iyj9GmJVglB0S3tWi2cSLXeTurceSFQyIgyJzS10YIQZn++O RbtH6jvflE0+CuHzsehcc5gWF3C1N9oJd72GR7OCCB+7mJlOHooGrnm8M5u0VcluKB3YRr Oiyi+KgmsC75HTAFR+bGvuxWZXvPbzupJPZ5vzrcSwJldHpLXT9us4/XZql8XUqXF7cWvv Qnuc/nkb8BqKrZwPsWD9sJcWXC9TqEV+rU6qUyBd8HaIV5aXLykjAt4EuRD9jGHc8BsBMF JOrn0xhZuj1BW+dipUTKmGHV05rZTXOJrume4A169V1L8spv+4ahNv3EVgVIOw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cBkZ02mCJz5rq; Wed, 27 Aug 2025 12:37:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57RCbCox068819; Wed, 27 Aug 2025 12:37:12 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57RCbC1k068816; Wed, 27 Aug 2025 12:37:12 GMT (envelope-from git) Date: Wed, 27 Aug 2025 12:37:12 GMT Message-Id: <202508271237.57RCbC1k068816@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 710b10d89c - main - Switch Debian version from focal to jammy in the Linuxulator List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 710b10d89ca580400310c01e485493bf815b2d5f Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=710b10d89ca580400310c01e485493bf815b2d5f commit 710b10d89ca580400310c01e485493bf815b2d5f Author: Benedict Reuschling AuthorDate: 2025-08-27 12:33:26 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-27 12:36:51 +0000 Switch Debian version from focal to jammy in the Linuxulator Debian Focal went EoL in May 2025. Replace references to the current jammy version in examples and sources.list, including the uname output. PR: 288523 Event: Oslo Hackathon 2025 --- .../content/en/books/handbook/linuxemu/_index.adoc | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/content/en/books/handbook/linuxemu/_index.adoc b/documentation/content/en/books/handbook/linuxemu/_index.adoc index df1034c1e7..1f0c07c540 100644 --- a/documentation/content/en/books/handbook/linuxemu/_index.adoc +++ b/documentation/content/en/books/handbook/linuxemu/_index.adoc @@ -119,7 +119,7 @@ In order to run Linux software a Linux userland must be installed first. If all that is wanted is to run some software already included in the Ports tree, it can be installed via package manager and man:pkg[8] will automatically setup the required Linux userland. For example, to install Sublime Text 4, along with all the Linux libraries it depends on, run this command: - + [source,shell] .... # pkg install linux-sublime-text4 @@ -231,7 +231,7 @@ Once enabled, execute the following command to install Ubuntu or Debian in [.fil [source,shell] .... -# debootstrap focal /compat/ubuntu +# debootstrap jammy /compat/ubuntu .... [NOTE] @@ -244,11 +244,11 @@ The output should be similar to the following: [.programlisting] .... -I: Retrieving InRelease +I: Retrieving InRelease I: Checking Release signature I: Valid Release signature (key id F6ECB3762474EDA9D21B7022871920D1991BC93C) -I: Retrieving Packages -I: Validating Packages +I: Retrieving Packages +I: Validating Packages I: Resolving dependencies of required packages... I: Resolving dependencies of base packages... I: Checking component main on http://archive.ubuntu.com/ubuntu... @@ -307,7 +307,7 @@ The output should be similar to the following: [.programlisting] .... -Linux 3.17.0 x86_64 +Linux 5.15.0 x86_64 .... Once inside the chroot, the system behaves as in a normal Ubuntu installation. @@ -321,10 +321,10 @@ For amd64 the following example can be used: [.programlisting] .... -deb http://archive.ubuntu.com/ubuntu focal main universe restricted multiverse -deb http://security.ubuntu.com/ubuntu/ focal-security universe multiverse restricted main -deb http://archive.ubuntu.com/ubuntu focal-backports universe multiverse restricted main -deb http://archive.ubuntu.com/ubuntu focal-updates universe multiverse restricted main +deb http://archive.ubuntu.com/ubuntu jammy main universe restricted multiverse +deb http://security.ubuntu.com/ubuntu/ jammy-security universe multiverse restricted main +deb http://archive.ubuntu.com/ubuntu jammy-backports universe multiverse restricted main +deb http://archive.ubuntu.com/ubuntu jammy-updates universe multiverse restricted main .... For arm64 this other example can be used: From nobody Wed Aug 27 14:58:41 2025 X-Original-To: dev-commits-doc-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 4cBnjF3xNVz66PJW for ; Wed, 27 Aug 2025 14:58:41 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cBnjF31Gqz3J3v; Wed, 27 Aug 2025 14:58:41 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756306721; 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=OmzWLYzAL0yMoubhVFtmjVPBSydEBYURFXXo5cSkkhA=; b=m6+ONv42sYSZCdPQluTx+qkjO8as++zxCi1ZU3jFUYPbmIbkK1488KxgfEnCeObaYf8JVy ano4+evoHtMojIO4TJAZRLKmni6jTTuH0GuG+KwG58s/Hdijm/hslG+HYnVy4Bbmw5y1zw KGNolonpt3NaGEU4mBm15nboJ5ywyNgbGhGEqOMg8kbjygbMwp+mUaYUE2WgjBkG1dqL1j 04RAlxEjiZq1ct/qPeiQmiK4l3hSUbiYC/xS5kyzhxYMSnKllJeu7KP7Ii4VlRVS+wtNmM qgKjJr0y16wLZM9STNuMdh6wpoEn/Unjh5zPGcMH1sO5DyzDmGMn/L42JlAzkA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756306721; 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=OmzWLYzAL0yMoubhVFtmjVPBSydEBYURFXXo5cSkkhA=; b=xzolqA/ISukQcqAQh2HDDK/W3ruFDskM4NtUmo+RVzIKRN+hP/LH7tQdYxULSIt1+Z+uFt N3YT1R/lg6ELy8RY3/Jz+XcLAll8BdnDoYhLrW5cXM5FuMDh2Hb5+LGbQvT8+3kBbqX4I9 xbBxNbeWvfRrjzYXTmVlkqs6jHpMOl1JBizkRJXLwEpeb24bC7JJrzsl+YZCyBgHRRnPeX jCcXT1q/atF85gyG1vcgILIW8oBZlrrQeJSm5bVnE41il/S1JxDwZUgP5p0evI7R8uqBOp AelUIvutPpHQLJPBaFAZV4DwWagBvCw3dOwBbXBqcfO/t9eo0bbImkuXQ+36vQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756306721; a=rsa-sha256; cv=none; b=U59JFVvRqFvStpDZMIckYrD+sPKYVWSHI1v1g146rmXTtAfaCExbkQBZ9hsov/QWItiald K2NfA+ttpdNtoHIlArKoWzbxtrSVVRPESYrRBiAnlJ59VPYo7HNbBzxkljmlzbKV5w9U16 hsAptWIj3GKAVkwPH/JYahPq23k7QOCSPAAsqr4ebo1N/qwlEO/rgOf1PiNmCNNmadE65S 1FudUXsMk/zZMKImhgkmavTHJ4v99mLag2Y+GrnG4pkIWmkMSlJsshzb2Q3BAVvAOHQutn FYQMB/zbMciLxjwUSh19JAPCP7QOhHBZGoXmjTgUT0AE//5pL0OJFOHOUbW3Dw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cBnjF2XBLzBRv; Wed, 27 Aug 2025 14:58:41 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57REwfxv032389; Wed, 27 Aug 2025 14:58:41 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57REwfuh032386; Wed, 27 Aug 2025 14:58:41 GMT (envelope-from git) Date: Wed, 27 Aug 2025 14:58:41 GMT Message-Id: <202508271458.57REwfuh032386@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Muhammad Moinur Rahman Subject: git: 6587a1d1d8 - main - release/15.0R/relnotes: Update release notes List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bofh X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6587a1d1d8bb1b998f241b7e5f868f3e30fa731d Auto-Submitted: auto-generated The branch main has been updated by bofh: URL: https://cgit.FreeBSD.org/doc/commit/?id=6587a1d1d8bb1b998f241b7e5f868f3e30fa731d commit 6587a1d1d8bb1b998f241b7e5f868f3e30fa731d Author: Muhammad Moinur Rahman AuthorDate: 2025-08-27 14:57:55 +0000 Commit: Muhammad Moinur Rahman CommitDate: 2025-08-27 14:58:34 +0000 release/15.0R/relnotes: Update release notes Approved by: re (implicit) Sponsored by: The FreeBSD Foundation Event: Oslo Hackathon 202508 --- website/content/en/releases/15.0R/relnotes.adoc | 113 +++++++++++++++--------- 1 file changed, 73 insertions(+), 40 deletions(-) diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc index d91e1fae8e..29f78cc9d7 100644 --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -175,25 +175,33 @@ This section lists the various Security Advisories and Errata Notices since {rel |29 October 2024 |Certificate revocation list man:fetch[1] option fails -| https://www.freebsd.org/security/advisories/FreeBSD-SA-25:01.openssh.asc[FreeBSD-SA-25:01.openssh] -| 2025-01-29 -| OpenSSH Keystroke Obfuscation Bypass +|https://www.freebsd.org/security/advisories/FreeBSD-SA-25:01.openssh.asc[FreeBSD-SA-25:01.openssh] +|29 January 2025 +|OpenSSH Keystroke Obfuscation Bypass -| https://www.freebsd.org/security/advisories/FreeBSD-SA-25:02.fs.asc[FreeBSD-SA-25:02.fs] -| 2025-01-29 -| Buffer overflow in some filesystems via NFS +|https://www.freebsd.org/security/advisories/FreeBSD-SA-25:02.fs.asc[FreeBSD-SA-25:02.fs] +|29 January 2025 +|Buffer overflow in some filesystems via NFS -| https://www.freebsd.org/security/advisories/FreeBSD-SA-25:03.etcupdate.asc[FreeBSD-SA-25:03.etcupdate] -| 2025-01-29 -| Unprivileged access to system files +|https://www.freebsd.org/security/advisories/FreeBSD-SA-25:03.etcupdate.asc[FreeBSD-SA-25:03.etcupdate] +|29 January 2025 +|Unprivileged access to system files -| https://www.freebsd.org/security/advisories/FreeBSD-SA-25:04.ktrace.asc[FreeBSD-SA-25:04.ktrace] -| 2025-01-29 -| Uninitialized kernel memory disclosure via man:ktrace[2] +|https://www.freebsd.org/security/advisories/FreeBSD-SA-25:04.ktrace.asc[FreeBSD-SA-25:04.ktrace] +|29 January 2025 +|Uninitialized kernel memory disclosure via man:ktrace[2] -| https://www.freebsd.org/security/advisories/FreeBSD-SA-25:05.openssh.asc[FreeBSD-SA-25:05.openssh] -| 2025-02-21 -| Multiple vulnerabilities in OpenSSH +|https://www.freebsd.org/security/advisories/FreeBSD-SA-25:05.openssh.asc[FreeBSD-SA-25:05.openssh] +|21 February 2025 +|Multiple vulnerabilities in OpenSSH + +|https://www.freebsd.org/security/advisories/FreeBSD-SA-25:06.xz.asc[FreeBSD-SA-25:06.xz] +|02 July 2025 +|Use-after-free in multi-threaded xz decoder + +|https://www.freebsd.org/security/advisories/FreeBSD-SA-25:07.libarchive.asc[FreeBSD-SA-25:07.libarchive] +|08 August 2025 +|Integer overflow in libarchive leading to double free |=== [[errata]] @@ -286,7 +294,7 @@ This section lists the various Security Advisories and Errata Notices since {rel |19 June 2024 |Lock order reversal in killpg causing livelock -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:13.libc++.asc[FreeBSDS-EN-24:13:libc++] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:13.libc\+\+.asc[FreeBSDS-EN-24:13:libc++] |19 June 2024 |Incorrect size passed to heap allocated std::string delete @@ -306,37 +314,61 @@ This section lists the various Security Advisories and Errata Notices since {rel |20 October 2024 |XDG runtime directory's file descriptor leak at login -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:01.rpc.asc[FreeBSD-EN-25:01.rpc] -| 2025-01-29 +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:01.rpc.asc[FreeBSD-EN-25:01.rpc] +|29 January 2025 | NULL pointer dereference in the NFSv4 client -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:02.audit.asc[FreeBSD-EN-25:02.audit] -| 2025-01-29 -| System call auditing disabled by DTrace +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:02.audit.asc[FreeBSD-EN-25:02.audit] +|29 January 2025 +|System call auditing disabled by DTrace + +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:03.tzdata.asc[FreeBSD-EN-25:03.tzdata] +|29 January 2025 +|Timezone database information update + +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:04.tzdata.asc[FreeBSD-EN-25:04.tzdata] +|10 April 2025 +|Timezone database information update + +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:05.expat.asc[FreeBSD-EN-25:05.expat] +|10 April 2025 +|Update expat to 2.7.1 + +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:06.daemon.asc[FreeBSD-EN-25:06.daemon] +|10 April 2025 +|man:daemon[8] missing signals + +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:07.openssl.asc[FreeBSD-EN-25:07.openssl] +|10 April 2025 +|Update OpenSSL to 3.0.16 + +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:08.caroot.asc[FreeBSD-EN-25:08.caroot] +|10 April 2025 +|Root certificate bundle update -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:03.tzdata.asc[FreeBSD-EN-25:03.tzdata] -| 2025-01-29 -| Timezone database information update +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:09.libc.asc[FreeBSD-EN-25:09:libc] +|02 July 2025 +|Dynamically-loaded C++ libraries crashing at exit -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:04.tzdata.asc[FreeBSD-EN-25:04.tzdata] -| 2025-04-10 -| Timezone database information update +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:10.zfs.asc[FreeBSD-EN-25:10:zfs] +|02 July 2025 +|Corruption in ZFS replication streams from encrypted datasets -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:05.expat.asc[FreeBSD-EN-25:05.expat] -| 2025-04-10 -| Update expat to 2.7.1 +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:11.ena.asc[FreeBSD-EN-25:11:ena] +|02 July 2025 +|ena resets and kernel panic on Nitro v4 or newer instances -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:06.daemon.asc[FreeBSD-EN-25:06.daemon] -| 2025-04-10 -| man:daemon[8] missing signals +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:12.efi.asc[FreeBSD-EN-25:12:efi] +|08 August 2025 +|man:bsdinstall[8] not copying the correct loader on systems with IA32 UEFI firmware. -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:07.openssl.asc[FreeBSD-EN-25:07.openssl] -| 2025-04-10 -| Update OpenSSL to 3.0.16 +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:13.wlan_tkip.asc[FreeBSD-EN-25:13:wlan_tkip] +|08 August 2025 +|net80211 TKIP crypto support fails for some drivers -| https://www.freebsd.org/security/advisories/FreeBSD-EN-25:08.caroot.asc[FreeBSD-EN-25:08.caroot] -| 2025-04-10 -| Root certificate bundle update +|https://www.freebsd.org/security/advisories/FreeBSD-EN-25:14.route.asc[FreeBSD-EN-25:14:route] +|08 August 2025 +|man:route[8] monitor buffers too much when redirected to a file |=== [[userland]] @@ -414,7 +446,8 @@ gitref:3a2ec5957ea9[repository=src] === Contributed Software One True Awk (man:awk[1]) has been updated to 2nd Edition, with new -csv support and UTF-8 support. -gitref:daf917daba9c[repository=src] +The snapshot used is 20250804. +gitref:b45a181a74c8[repository=src] The man:sendmail[8] suite has been upgraded to version 8.18.1, addressing CVE-2023-51765. gitref:58ae50f31e95[repository=src] From nobody Wed Aug 27 18:35:21 2025 X-Original-To: dev-commits-doc-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 4cBtWG1055z65S0C for ; Wed, 27 Aug 2025 18:35:22 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cBtWF5d5pz3vk3; Wed, 27 Aug 2025 18:35:21 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756319721; 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=mTnFglP7Jf0pESpzj3c19AqOSaaGPh5yTayICWj/QxM=; b=pbPKtQPTaq49Vlk6+RZBwESM/BNSofHgySNrqhQFIIhFVVA0xjazlcqAQ78H2fBz0SYB9H d0NN4kltblkxtFpDLidGxMtwSs56G4PaMs4Xyn2ljfMtx29x/4ZEqOyC4o1wxmCIGUGCyt x8nbzrglyZ0GViQNg8sNM23RfM19WKADuTbUUNSEzk1cGx+7iBLmz0Q7grMSAM5KBuXV5X PXfchzesYts679mMtPeAJAIfgS3mt7RwF12MxjlJDnhDYO36djx3DbEjIw7iNz0oLjb7Zm uywO+DsQ4g5HCa87+M5d4xDwDtWKfqIowqmY6nAox1Qv0fIqj/NmztK35HVmqw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756319721; 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=mTnFglP7Jf0pESpzj3c19AqOSaaGPh5yTayICWj/QxM=; b=tCvCpo2dscCiH2k0EclRVM5zO2qkJfXotMNQtzKqBMcXioc/Rp0jn2aSXohB4MvlQH32ua tFcq1cOumziI+vq95B/y5Y8Dv0GB0OkgL0wQHAPmEjw9uNpG3Ygs3E4/+uyvO0xotJ56HY b21GHXVpkInzU4rzTiMbIIA2ax/uvAauTtsdQUM8Ewk2MSNKoqf9UM/1EcRCHSDuBQRuWc oHDYNshZNhJrl1aTda3kupJnN1CMKBJHl4x/f/FrRW/8lXLiTAxlS7LZHTNOp5NCfmnlYW rvlnJO0RA6cjlkdfookyKYisQFOyOtm078Sz4wiUddekrKUq8sCDAn2FqLaGIQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756319721; a=rsa-sha256; cv=none; b=cOtlNRb6DYgqS2aPeWuY6UzB8R6vBNzYY5zqQlnDnmUatoyOeqqem+zGkFw9JzaOSocyj6 mX1naN7IFySS1zZF/hHXIXjcXWMOYiWa6hiNjNRjhk9OpvoWZflELrul3NoRsdr3DvIFJx cVtfq4kQPaF6eTjag5ZUD3JrmRuKv6zGPxep5ASDwggTh1KXPOPe8k3tAF4ttFLRSqGrBN JzAUh3gQL9ohWZEnhWvNR8tk53M87SQlHEsTHbLmk/Pq4+URODMJF80fgnIdNx2QjoHHrS e/4mVoZLfwIQx9sYQ4iyU3pJ/CEPGlWCOQwJx1ixO6L7V3DjZvltseeGEl+sFg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cBtWF57YBzbBT; Wed, 27 Aug 2025 18:35:21 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57RIZLDP048100; Wed, 27 Aug 2025 18:35:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57RIZLHm048097; Wed, 27 Aug 2025 18:35:21 GMT (envelope-from git) Date: Wed, 27 Aug 2025 18:35:21 GMT Message-Id: <202508271835.57RIZLHm048097@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Muhammad Moinur Rahman Subject: git: 7d1dfd9ba8 - main - releases/15.0R/relnotes: Add important pkg repo entry List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bofh X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7d1dfd9ba86600c91c3e2ef03b110d8dad4c684c Auto-Submitted: auto-generated The branch main has been updated by bofh: URL: https://cgit.FreeBSD.org/doc/commit/?id=7d1dfd9ba86600c91c3e2ef03b110d8dad4c684c commit 7d1dfd9ba86600c91c3e2ef03b110d8dad4c684c Author: Muhammad Moinur Rahman AuthorDate: 2025-08-27 18:34:18 +0000 Commit: Muhammad Moinur Rahman CommitDate: 2025-08-27 18:34:18 +0000 releases/15.0R/relnotes: Add important pkg repo entry Approved by: re (implicit) Sponsored by: The FreeBSD Foundation --- website/content/en/releases/15.0R/relnotes.adoc | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc index 29f78cc9d7..cb3f44316f 100644 --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -294,7 +294,7 @@ This section lists the various Security Advisories and Errata Notices since {rel |19 June 2024 |Lock order reversal in killpg causing livelock -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:13.libc\+\+.asc[FreeBSDS-EN-24:13:libc++] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:13.libc%2B%2B.asc[FreeBSDS-EN-24:13:libc++] |19 June 2024 |Incorrect size passed to heap allocated std::string delete @@ -1003,11 +1003,13 @@ The man:intro[5] to the File Formats manual has been revised, incorporating impr This section covers changes to the FreeBSD Ports Collection, package infrastructure, and package maintenance and installation tools. - A new `FreeBSD-kmods` repository is included in the default `/etc/pkg/FreeBSD.conf` man:pkg[8] configuration file. This repository contains kernel modules compiled specifically for {releaseCurrent} rather than for the {releaseBranch} branch. Installing kernel modules from this repository allows drivers with unstable kernel interfaces, in particular graphics drivers, to work even when the main {releaseBranch} repository has packages build on a previous release. (gitref:a47542f71511[repository=src]). +The `FreeBSD` and `FreeBSD-kmods` repositories defined in `/etc/pkg/FreeBSD.conf` have been renamed to `FreeBSD-ports` and `FreeBSD-ports-kmods` respectively. +Users who override these in `/usr/local/etc/pkg/repos` will need to adjust their configuration to match the new names. + [[Installer]] === Installer From nobody Thu Aug 28 11:53:48 2025 X-Original-To: dev-commits-doc-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 4cCKYT2sq3z65ssC for ; Thu, 28 Aug 2025 11:53:49 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCKYT0NhBz3kBC; Thu, 28 Aug 2025 11:53:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756382029; 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=oDwG4MaKTEUHgZUc1dmcJ6gIeXcKLI5nuFEqPuPz3EE=; b=bQY7XimBdd5AKCe6IXK/Yo4UeRbUIGp3FBVRaDSZPAHJ3JeOfY6dSuQPYWwrb6XV5Zx11B F2PnnKWzPqUZMOpQ/SN3G1ZofJbDMdvXv12a7hgNYTxrh3dRw7CG7KKZXo2TZVq5US2WMa uCTKRTdCX64hk2NPaQTGCfhwAuR9YSvz+/4An+ij8mmFSbk2oAXcOzDBxAh0UyUXjSnL0I pTaMPQo8cNct81aY98OlqH8q3F1Ua0sH2hEnK9gH5DLqGsSnORZA2Nxraln2Xh56G3htLq P25uEeo8gi/0GXIgpmfFAfizNMT77yX7JPQiwLYgScA03TF7mxQFSw2keXuanA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756382029; 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=oDwG4MaKTEUHgZUc1dmcJ6gIeXcKLI5nuFEqPuPz3EE=; b=i/gdY3r0cSfcd7zALeO7UzX+AJefJU7oAdlui+KtksWKvRCCjH73AY3k9qFhUE4bUa1cUV bkoNOxVhUiG9pBkCLHVGP1HaygkLtvWTLNOFG1Y9tKTqN1Es3WWXB4q2xxCIzaRxCfznxW nHfP55+HfS2jNzHL7LpgcA+getoKIgMhe+9ytjdjmi6LDPp5Z3ViyxOOUTY+e0wJmdhNEE comIU5L8TQUxRODL5vcMkkeOuqnY6F4mMwJd5SEeK5jxELS4B3JtBOZGuoH8PyvQOVO+YE HjMckuCnpoTyUI5RI0iSrxTGH/Q3sb5yfJYMry0L6WBdG8JAML6sI9kgEoMt8A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756382029; a=rsa-sha256; cv=none; b=PLijaNrOB/uSe5CQJVdqm3iQZihy2MAEWC+yGa3llu4689o8y9916/CZ3kjED4RmK4jK+J myY/kCPT+pvRN/gGwPoLzLh0p+kue3EEndJkH8+tpXlSt6z5diMsoO3S5nT4DGdNjw19sy je9EMVAzJNWC73hdnq+ztsFr4ukmqsOvqTkdEe3nRdN8++SXb+VMxlNRt2bIxfrOEUBzA6 BGyK6TH+mNcKiMlU/yH9Y0xCtQ6+vs5PkIBsYxeoj8dIJ98JxExBwTYc2Zbns+EurjUcuI ibnqRdsjWKxfOt//uA3mWfUhrMRDqW7tteetG/Y+C3YeGdbz4CBjx2LCv85PiQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCKYS70D7z1795; Thu, 28 Aug 2025 11:53:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SBrmZY013408; Thu, 28 Aug 2025 11:53:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SBrmYE013405; Thu, 28 Aug 2025 11:53:48 GMT (envelope-from git) Date: Thu, 28 Aug 2025 11:53:48 GMT Message-Id: <202508281153.57SBrmYE013405@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Muhammad Moinur Rahman Subject: git: b47c27e587 - main - releases/15.0R/relnotes: Fix typos List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bofh X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b47c27e587bc0171f9363e1ec213d1b02cb99eea Auto-Submitted: auto-generated The branch main has been updated by bofh: URL: https://cgit.FreeBSD.org/doc/commit/?id=b47c27e587bc0171f9363e1ec213d1b02cb99eea commit b47c27e587bc0171f9363e1ec213d1b02cb99eea Author: Muhammad Moinur Rahman AuthorDate: 2025-08-28 11:53:05 +0000 Commit: Muhammad Moinur Rahman CommitDate: 2025-08-28 11:53:05 +0000 releases/15.0R/relnotes: Fix typos Reported by: pauamma@gundo.com --- website/content/en/releases/15.0R/relnotes.adoc | 50 ++++++++++++------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc index cb3f44316f..1235446c19 100644 --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -214,103 +214,103 @@ This section lists the various Security Advisories and Errata Notices since {rel | Date | Topic -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:15.sanitizer.asc[FreeBSDS-EN-23:15:sanitizer] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:15.sanitizer.asc[FreeBSD-EN-23:15:sanitizer] |01 December 2023 |Clang sanitizer failure with ASLR enabled -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:16.openzfs.asc[FreeBSDS-EN-23:16:openzfs] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:16.openzfs.asc[FreeBSD-EN-23:16:openzfs] |01 December 2023 |OpenZFS data corruption -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:17.ossl.asc[FreeBSDS-EN-23:17:ossl] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:17.ossl.asc[FreeBSD-EN-23:17:ossl] |05 December 2023 |man:ossl[4]'s AES-GCM implementation may give incorrect results -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:18.openzfs.asc[FreeBSDS-EN-23:18:openzfs] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:18.openzfs.asc[FreeBSD-EN-23:18:openzfs] |05 December 2023 |High CPU usage by ZFS kernel threads -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:19.pkgbase.asc[FreeBSDS-EN-23:19:pkgbase] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:19.pkgbase.asc[FreeBSD-EN-23:19:pkgbase] |05 December 2023 |Incorrect pkgbase version number for FreeBSD {releasePrev}. -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:20.vm.asc[FreeBSDS-EN-23:20:vm] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:20.vm.asc[FreeBSD-EN-23:20:vm] |05 December 2023 |Incorrect results from the kernel physical memory allocator -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:21.tty.asc[FreeBSDS-EN-23:21:tty] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:21.tty.asc[FreeBSD-EN-23:21:tty] |24 November 2023 |man:tty[4] IUTF8 causes a kernel panic -|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:22.vfs.asc[FreeBSDS-EN-23:22:vfs] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-23:22.vfs.asc[FreeBSD-EN-23:22:vfs] |05 December 2023 |ZFS snapshot directories not accessible over NFS -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:01.tzdata.asc[FreeBSDS-EN-24:01:tzdata] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:01.tzdata.asc[FreeBSD-EN-24:01:tzdata] |14 February 2024 |Timezone database information update -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:02.libutil.asc[FreeBSDS-EN-24:02:libutil] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:02.libutil.asc[FreeBSD-EN-24:02:libutil] |14 February 2024 |Login class resource limits and CPU mask bypass -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:03.kqueue.asc[FreeBSDS-EN-24:03:kqueue] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:03.kqueue.asc[FreeBSD-EN-24:03:kqueue] |14 February 2024 |man:kqueue_close[2] page fault on exit using man:rfork[2] -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:04.ip.asc[FreeBSDS-EN-24:04:ip] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:04.ip.asc[FreeBSD-EN-24:04:ip] |14 February 2024 |Kernel panic triggered by man:bind[2] -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:05.tty.asc[FreeBSDS-EN-24:05:tty] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:05.tty.asc[FreeBSD-EN-24:05:tty] |28 March 2024 |TTY Kernel Panic -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:06.wireguard.asc[FreeBSDS-EN-24:06:wireguard] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:06.wireguard.asc[FreeBSD-EN-24:06:wireguard] |28 March 2024 |Insufficient barriers in WireGuard man:if_wg[4] -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:07.clang.asc[FreeBSDS-EN-24:07:clang] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:07.clang.asc[FreeBSD-EN-24:07:clang] |28 March 2024 |Clang crash when certain optimization is enabled -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:08.kerberos.asc[FreeBSDS-EN-24:08:kerberos] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:08.kerberos.asc[FreeBSD-EN-24:08:kerberos] |28 March 2024 |Kerberos segfaults when using weak crypto -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:09.zfs.asc[FreeBSDS-EN-24:09:zfs] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:09.zfs.asc[FreeBSD-EN-24:09:zfs] |24 April 2024 |High CPU usage by kernel threads related to ZFS -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:10.zfs.asc[FreeBSDS-EN-24:10:zfs] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:10.zfs.asc[FreeBSD-EN-24:10:zfs] |19 June 2024 |Kernel memory leak in ZFS -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:11.ldns.asc[FreeBSDS-EN-24:11:ldns] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:11.ldns.asc[FreeBSD-EN-24:11:ldns] |19 June 2024 |LDNS uses nameserver commented out in resolv.conf -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:12.killpg.asc[FreeBSDS-EN-24:12:killpg] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:12.killpg.asc[FreeBSD-EN-24:12:killpg] |19 June 2024 |Lock order reversal in killpg causing livelock -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:13.libc%2B%2B.asc[FreeBSDS-EN-24:13:libc++] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:13.libc%2B%2B.asc[FreeBSD-EN-24:13:libc++] |19 June 2024 |Incorrect size passed to heap allocated std::string delete -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:14.ifconfig.asc[FreeBSDS-EN-24:14:ifconfig] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:14.ifconfig.asc[FreeBSD-EN-24:14:ifconfig] |07 August 2024 |Incorrect ifconfig netmask assignment -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:15.calendar.asc[FreeBSDS-EN-24:15:calendar] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:15.calendar.asc[FreeBSD-EN-24:15:calendar] |04 September 2024 |man:cron[8] / man:periodic[8] session login -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:16.pf.asc[FreeBSDS-EN-24:16:pf] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:16.pf.asc[FreeBSD-EN-24:16:pf] |19 September 2024 |Incorrect ICMPv6 state handling in pf -|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:17.pam_xdg.asc[FreeBSDS-EN-24:17:pam_xdg] +|https://www.freebsd.org/security/advisories/FreeBSD-EN-24:17.pam_xdg.asc[FreeBSD-EN-24:17:pam_xdg] |20 October 2024 |XDG runtime directory's file descriptor leak at login From nobody Thu Aug 28 16:13:36 2025 X-Original-To: dev-commits-doc-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 4cCRKF0XVqz66FfR for ; Thu, 28 Aug 2025 16:13:37 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCRKD6sBTz3GNx; Thu, 28 Aug 2025 16:13:36 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756397617; 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=JvGEl8T5mw44Wk9s/7zTPJ4Cv7/cPUoyohdoDNhFTPQ=; b=wuTvc47vsVD2CvdkxZQ1sq8MBfsYXFwCSGNe4GIQix7FtECDJ6jv2VBKKH34JhB3MdNNFE fwHYU2WNUnQQ9HBepNb+7+2U+ofteIJhHdphUYjrVP3LHb/ISns2W3UKpzzoFBC7nOEx2j II3Uk99r+8CKoj6HeWtd2c7JAMJOdeAB0PkDNHCkwmuQhizGDLwRCLOIWHpUhtD5/CceDM Suky2+UjTK1NPaG21hFY5lL6st4BXimW+eG1mWB5qpm6m6bIHdvvWyqvEIfK1YNSbKF8Hy cvC7N8YQZC0FM2Mtl5jUQCggR1gBpFWqPm7HX0r18FVoZkZUEBxnc3TOfAOz6w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756397617; 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=JvGEl8T5mw44Wk9s/7zTPJ4Cv7/cPUoyohdoDNhFTPQ=; b=I5L4Fy8gXkire2dCzpvzYAXwjgHnrz2WViQTL+Sa3/xVCSDBqfnGLbGKy/vxQa68f6RJCg G+R+hdqCnJJY0CncIusQdJuDZ6qOs0Ti3mMSwsAuwZlSY4sMuw2gIiV9bfoUvaI3h/Lyn4 uTr7kx7kcVzoguEJ8XCbKPLBQ0TvzsjhtlKow4rwXBdIFoBeo/StVVXb0DgQPmfbRNrBDt mzUBeiy0Vrwc3JtpCvP72pTAQWm+4vkF6d3RNGwY9Zg2bwW1UtPvY7/gbXlHOmbdA5hhho AIedzUHqe/l1l0XA6TDQYJXMTGqMEIotsfYscJ+WYs27nm3MjKQgx2/3+HZU+g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756397617; a=rsa-sha256; cv=none; b=n3pbTGdF9BuQhMKc4uMiUuCSwZBTf4HqEox6bo0SvDCUT29ewEz86dRC8Z529uvzs526tq 5devu6l6xamEXzbC9YnJeBk/5/Zzg1eDt6INdZiu4iaX5UNOX2ghr5ChMxJB8pLAy+JJdt e2/3swTTC8GnTETjKMMcoZVK5BB8/Vvi95ECM0MS7e7QPhEh0Xw9mnZrdMv+6fvEdJDBDt BIOK7QVjvXvi4GzWcXI3dKJyC/IVNyO353nsMpVuvBbf+pIWa+3IzgCXb6eLWamnPh46jJ 2uWJqOD5M6+fL+J2MIx4Ns9FZhnjoJJR8oJEjvZthUtsy+NKsR7jMIkzYiNpLw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCRKD6Fncz1FV5; Thu, 28 Aug 2025 16:13:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SGDamu006058; Thu, 28 Aug 2025 16:13:36 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SGDad8006055; Thu, 28 Aug 2025 16:13:36 GMT (envelope-from git) Date: Thu, 28 Aug 2025 16:13:36 GMT Message-Id: <202508281613.57SGDad8006055@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: fbceac26b3 - main - Avoid the use of "you" in the ports chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fbceac26b352f276045e220804377bd1cce30ca1 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=fbceac26b352f276045e220804377bd1cce30ca1 commit fbceac26b352f276045e220804377bd1cce30ca1 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:40:54 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 16:13:30 +0000 Avoid the use of "you" in the ports chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52214 --- .../content/en/books/handbook/ports/_index.adoc | 24 +++++++++++----------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index fe7001ab82..725e00331c 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -57,7 +57,7 @@ In addition, FreeBSD provides two complementary technologies for installing thir for installing from source, and packages, for installing from pre-built binaries. Either method may be used to install software from local media or from the network. -After reading this chapter, you will know: +Read this chapter to learn: * The difference between binary packages and ports. * How to find third-party software that has been ported to FreeBSD. @@ -86,7 +86,7 @@ A FreeBSD package contains pre-compiled copies of all the commands for an applic A package can be manipulated with the man:pkg[8] commands, such as `pkg install`. While the two technologies are similar, packages and ports each have their own strengths. -Select the technology that meets your requirements for installing a particular application. +Select the technology that meets the needs for installing a particular application. .Package Benefits * A compressed package tarball is typically smaller than the compressed tarball containing the source code for the application. @@ -99,7 +99,7 @@ Select the technology that meets your requirements for installing a particular a + In some cases, multiple packages will exist for the same application with different settings. For example, NGINX(R) is available as a `nginx` package and a `nginx-lite` package, the former has many more options enabled, but this in turn requires many things to be installed as dependencies for it to work, thus increasing space consumption and attack surface. + -The transitive dependencies can grow quite large, for example the full `nginx` package will pull in several X libraries which can be quite surprising, so building from ports allow you to choose only the options you need without a "kitchen sink" approach. In some cases, multiple packages will exist for the same application to specify certain settings. +The transitive dependencies can grow quite large, for example the full `nginx` package will pull in several X libraries which can be quite surprising, so building from ports allows to choose only the options needed without a "kitchen sink" approach. In some cases, multiple packages will exist for the same application to specify certain settings. * The licensing conditions of some software forbid binary distribution. Such software must be distributed as source code which must be compiled by the end-user. * Some people do not trust binary distributions or prefer to read through source code in order to look for potential problems. * Source code is needed in order to apply custom patches. @@ -165,7 +165,7 @@ The package management tool is not yet installed on your system. Do you want to fetch and install it now? [y/N] .... -man:pkg[7] will intercept the command, and if you confirm that is your intention, download the man:pkg[8] tarball, install man:pkg[8] from it, bootstrap the local package database and then proceed to run the command you originally requested. +man:pkg[7] will intercept the command, and when confirmed, downloads the man:pkg[8] tarball, installs man:pkg[8] from it, bootstraps the local package database and then proceeds to run the command originally requested. More recent versions of man:pkg[7] understand `pkg -N` as a test to see if man:pkg[8] is installed without triggering the installation, and conversely, pkg bootstrap[-f] to install man:pkg[8] (or force it to be reinstalled) without performing any other actions. @@ -695,7 +695,7 @@ By default, the Ports Collection itself is stored as a subdirectory of `/usr/por Before installing and using the Ports Collection, please be aware that it is generally ill-advised to use the Ports Collection in conjunction with the binary packages provided via pkg to install software. pkg, by default, tracks quarterly branch-releases of the ports tree and not HEAD. Dependencies could be different for a port in HEAD compared to its counterpart in a quarterly branch release and this could result in conflicts between dependencies installed by pkg and those from the Ports Collection. -If the Ports Collection and pkg must be used in conjunction, then be sure that your Ports Collection and pkg are on the same branch release of the ports tree. +If the Ports Collection and pkg must be used in conjunction, then be sure that the Ports Collection and pkg are on the same branch release of the ports tree. ==== The Ports Collection contains directories for software categories. @@ -730,8 +730,8 @@ If more control over the ports tree is needed or if local changes need to be mai Git can be used to obtain the Ports Collection. Refer to extref:{committers-guide}[the Git Primer, git-primer] for a detailed description of Git. -We add --depth 1 to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. -If you have your own changes to the ports tree, or need the history for any reason, omit the --depth 1 argument below. +We add --depth 1 to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. +When maintaining custom changes to the ports tree, or need the history for any reason, omit the --depth 1 argument below. . Git must be installed before it can be used to check out the ports tree. If a copy of the ports tree is already present, install Git like this: + @@ -875,7 +875,7 @@ and ports options screens no longer appear, to be certain that all dependency op There are several ways to revisit a port's build options menu in order to add, remove, or change these options after a port has been built. One method is to `cd` into the directory containing the port and type `make config`. Another option is to use `make showconfig`. -Another option is to execute `make rmconfig` which will remove all selected options and allow you to start over. +Another option is to execute `make rmconfig` which will remove all selected options and allows to start over. All of these options, and others, are explained in great detail in man:ports[7]. The ports system uses man:fetch[1] to download the source files, which supports various environment variables. @@ -921,7 +921,7 @@ will compile the port in `/usr/ports` and install it in `/usr/home/example/local will combine the two. These can also be set as environmental variables. -Refer to the manual page for your shell for instructions on how to set an environmental variable. +Refer to the manual page for the shell for instructions on how to set an environmental variable. [[ports-removing]] === Removing Installed Ports @@ -983,7 +983,7 @@ Synth is a newer alternative. [NOTE] ==== The choice of which tool is best for a particular system is up to the system administrator. -It is recommended practice to back up your data before using any of these tools. +It is recommended practice to back up data before using any of these tools. ==== [[portmaster]] @@ -1361,5 +1361,5 @@ Instead, any fixes and support come from the general community who subscribe to ==== + If there is no response to the email, use Bugzilla to submit a bug report using the instructions in extref:{problem-reports}[Writing FreeBSD Problem Reports]. -. Fix it! The extref:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure so that you can fix the occasional broken port or even submit your own! -. Install the package instead of the port using the instructions in crossref:ports[pkgng-intro, Using pkg for Binary Package Management]. + +. Fix it! The extref:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure, enabling the fixing of occasional broken ports or the submission of new ones. Install the package instead of the port using the instructions in crossref:ports[pkgng-intro, Using pkg for Binary Package Management]. From nobody Thu Aug 28 16:41:16 2025 X-Original-To: dev-commits-doc-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 4cCRx84vKmz66HXy for ; Thu, 28 Aug 2025 16:41:16 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCRx84Grdz3Jx5; Thu, 28 Aug 2025 16:41:16 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756399276; 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=BMulBhQoEVPkdhEupzVmkJBlGjeF+9I+Sa24VGiT5Jg=; b=Llnm31zgQEttksVUHXQFjxBfXBUiPcUeGMp3Mg7lv3kWrlAAdGR/4lN+eh/Eypw+ZQMDlx MHRk8fUz8ATqvVvo+qCU/5VZw4f1W47HrcfZodQVwbNBva1B4I5n42H3lKGvOa3S+GyaBR 40dvHnkplP2hs+ggGOqUxMO/WJy1Zi6/GHwyTwst++UMICvtLcEBUEKXv4FyNQFn/aXaq4 aq5A/hqR6Tp4E4Ltcca9Gww4/1RBIf4eYVSUfNKS5eNViNeC64QEtBw+weAJxE5xfgV6Pw 9maXLE2PUeVnGgNmYk0g5AMchTT4HxDgf6FRUPziQE8+G4BGmKiZvtnuRTcDJw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756399276; 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=BMulBhQoEVPkdhEupzVmkJBlGjeF+9I+Sa24VGiT5Jg=; b=LDPx+SIdQ7IXkeU+8nVw7OBrErAERsHatvrK6wYVj6Qzl5SA09/Km05Cs3Ayv/vVBdV1eF 8/tEGhynkh/ly+DLoyCT3Yu/jSg1vM50eZZkfrycLgOK6qib2UVMIvuOUYQpmyyOnGYG0r aC3eBcQNZ9s42tlqJtTq+S+jJIVdjqLWlDh78A8QLySrUQcZ1kndvxpoN70KY5jGHp/5pY HtxbN/WaGTo2q4h+aOLsRG2DWBHTz4o7NIYS2lB+qLHz/94KtZ2Ond0Q6kYbRCrvI5Du/D TWDSl7ldPWs7/zXzSuPwRU4HymZ1nuQj3HEB3FmcGBKleXSkn9gimoEUHowARw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756399276; a=rsa-sha256; cv=none; b=MoUXCeBSKNK227Lqcbx+3ClbPwnUiaq3iUJ4i4JpQuCobG+65ywWTU4NaeAQVEwQQiqfdR yeVUL8qVOU5/pyLWsi/Atmu+adOTb15br/aEM9p5EoYpNLzBcN5/j5Uv8oWcoPLsRH+v7+ B733gDF2FPDhKsR05pTG6hqpdm6g9CpSJ90rpMniu7amd4N4AdS9sfD+bpMi32op2/tLJa TZvBCJsl3dJml4R6QnXnTiADz3fwoiJbXUcS6N0b573PzEo8z1DJJx3KS44/uu5Fxty4+x 6Tpz6qz8f+/qdeoy4343PrYu18lyjSLUHI1mnpS6KjQPJlkwZR23Aq2RSIpBTQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCRx83lzyz1GJw; Thu, 28 Aug 2025 16:41:16 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SGfGX8056258; Thu, 28 Aug 2025 16:41:16 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SGfGk1056255; Thu, 28 Aug 2025 16:41:16 GMT (envelope-from git) Date: Thu, 28 Aug 2025 16:41:16 GMT Message-Id: <202508281641.57SGfGk1056255@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 1f0e82bfa3 - main - Avoid the use of "you" in the Advanced Networking chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1f0e82bfa35e52e747765a17472a305b50bb3112 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=1f0e82bfa35e52e747765a17472a305b50bb3112 commit 1f0e82bfa35e52e747765a17472a305b50bb3112 Author: Benedict Reuschling AuthorDate: 2025-08-28 14:21:29 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 16:39:30 +0000 Avoid the use of "you" in the Advanced Networking chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52204 --- .../en/books/handbook/advanced-networking/_index.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc index 57ddfe3d75..33da0682cf 100644 --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc @@ -54,7 +54,7 @@ endif::[] This chapter covers a number of advanced networking topics. -After reading this chapter, you will know: +Read this chapter to learn: * The basics of gateways and routes. * How to set up USB tethering. @@ -63,9 +63,9 @@ After reading this chapter, you will know: * How to set up network PXE booting. * How to enable and utilize the features of the Common Address Redundancy Protocol (CARP) in FreeBSD. * How to configure multiple VLANs on FreeBSD. -* Configure bluetooth headset. +* How to configure a bluetooth headset. -Before reading this chapter, you should: +Before reading this chapter: * Understand the basics of the [.filename]#/etc/rc# scripts. * Be familiar with basic network terminology. @@ -1859,13 +1859,13 @@ We therefore recommend overriding the Ethernet MAC address for this purpose. [NOTE] **** If the driver for the wireless interface is not loaded in the `GENERIC` or custom kernel, and the computer is running FreeBSD {rel121-current}, load the corresponding [.filename]#.ko# in [.filename]#/boot/loader.conf# by adding `*driver_load="YES"*` to that file and rebooting. -Another, better way is to load the driver in [.filename]#/etc/rc.conf# by adding it to `kld_list` (see man:rc.conf[5] for details) in that file and rebooting. +Another, better way is to load the driver in [.filename]#/etc/rc.conf# by adding it to `kld_list` (see man:rc.conf[5] for details) in that file and rebooting. This is needed because otherwise the driver is not loaded yet at the time the man:lagg[4] interface is set up. **** In this example, the Ethernet interface, _re0_, is the master and the wireless interface, _wlan0_, is the failover. The _wlan0_ interface was created from the _ath0_ physical wireless interface, and the Ethernet interface will be configured with the MAC address of the wireless interface. -First, bring the wireless interface up (replacing _FR_ with your own 2-letter country code), but do not set an IP address. +First, bring the wireless interface up (replacing _FR_ with the local 2-letter country code), but do not set an IP address. Replace _wlan0_ to match the system's wireless interface name: [source,shell] @@ -1873,7 +1873,7 @@ Replace _wlan0_ to match the system's wireless interface name: # ifconfig wlan0 create wlandev ath0 country FR ssid my_router up .... -Now you can determine the MAC address of the wireless interface: +Determine the MAC address of the wireless interface like this: [source,shell] .... @@ -2095,7 +2095,7 @@ In this case, [.filename]#/etc# and [.filename]#/var# need to be memory backed f When the system boots, memory file systems for [.filename]#/etc# and [.filename]#/var# will be created and mounted and the contents of the [.filename]#cpio.gz# files will be copied into them. By default, these file systems have a maximum capacity of 5 megabytes. -If your archives do not fit, which is usually the case for [.filename]#/var# when binary packages have been installed, request a larger size by putting the number of 512 byte sectors needed (e.g., 5 megabytes is 10240 sectors) in [.filename]#${NFSROOTDIR}/conf/base/etc/md_size# and [.filename]#${NFSROOTDIR}/conf/base/var/md_size# files for [.filename]#/etc# and [.filename]#/var# file systems respectively. +If the archives do not fit, which is usually the case for [.filename]#/var# when binary packages have been installed, request a larger size by putting the number of 512 byte sectors needed (e.g., 5 megabytes is 10240 sectors) in [.filename]#${NFSROOTDIR}/conf/base/etc/md_size# and [.filename]#${NFSROOTDIR}/conf/base/var/md_size# files for [.filename]#/etc# and [.filename]#/var# file systems respectively. [[network-pxe-setting-up-dhcp]] === Configuring the DHCP Server From nobody Thu Aug 28 16:54:32 2025 X-Original-To: dev-commits-doc-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 4cCSDS6fvqz66JwR for ; Thu, 28 Aug 2025 16:54:32 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSDS694hz3MPQ; Thu, 28 Aug 2025 16:54:32 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400072; 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=e1VMnwEzR6lJxHfFxD0EHSamwxL8vWp6bFtOpwOWdKM=; b=ZY3g0umj0qGWOZoUW551xUGKTvinBR6amiUSXY7R5rrosxKw6woYAX5qW1mIyIiOo1mqsb oIGPUz0rZ5lXzUujfO9L6K8IJ+b3Zhvv/LKMjUzmOC3xfQNF4AmfiJSFqbtR1SQj4KmXkY A5+nwOO94vL+jhe6d2XkBR0fgWtP8WnW6dFnGG0HM7PWZFCEaFB8LX/Yhk1sjSke3S1IY0 IdAeNO/dGibeNuw0XYh+O+aAThqUazJBty6a3d1J6E0hPJ6EqCuMYpOgOVGcDcJ7FiqfCK bAv8ziIiNHTx1c3jx4IbI7iXuQmiCPjjXzUsytgHmwsOhliDPjH6HO7jVAfziQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400072; 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=e1VMnwEzR6lJxHfFxD0EHSamwxL8vWp6bFtOpwOWdKM=; b=By0ag7WmFGlnmc4vH7MaZCwaNBZVE2RUhEhBzFvqalZPWW30dIu/ykYpCHUO4nWX1d4Rgc kJCzPY9FoBfbEnNe21ZXaWuqJ76BfFIffKUxbQ9+ZqFlDSt5gDDxsiai5xSjTTanFLrFXe AYi3xsn+4g2Y1M3mFLqnfQ+RwmzTFpTeeHlBgxOe59Qp4ja6lraINrRPoGeVvA1PT2SH5Y AONyhCglrRGXuMHqle2zaGE1HGFAJlyP7qObikNze2DJQ8WZCyDsyik3nt5E0e6oi3DecX bGSz6PnSz/eoxXXpxlsWZAwZfmNw/Opuphrc5ERYUZJTtUmEb7oYF5rbNaHiBA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400072; a=rsa-sha256; cv=none; b=RST8y7PtKthNuc3baWUll4kc0mZXehgnmhkpixKiAw8wjNQ5rQsX8KzYQeBe+Y7BnjR39H 82x5KkfEtbdd8mVRFFqcte5WXTYljxG+JtYge0Mu1L2jSyHWtOhZuV0WKJ9Kj6BrAv9ZHA Ci0AMJKh7tbybSSfo2cGF57/2y9ZVS7y9bH9Ml3U/UiT5rMVxfePjadr5DwGOh4gegkryP gBbJPfj4yse32hp89G/pjXa7tmYka0FbES9pkEnxhxxK64rjb03lTYfmek7jQi6nzkBR+s ygPfu1qbYyT+YnFQNFJU3sQdisVEF8+xWFy2dBU/tdseMKJ5rAZyF33p/4XCXA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCSDS5H3yz1H4s; Thu, 28 Aug 2025 16:54:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SGsWlQ081708; Thu, 28 Aug 2025 16:54:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SGsWIN081705; Thu, 28 Aug 2025 16:54:32 GMT (envelope-from git) Date: Thu, 28 Aug 2025 16:54:32 GMT Message-Id: <202508281654.57SGsWIN081705@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: c8ce9da342 - main - Avoid the use of "you" in the Basics chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c8ce9da342741711d263b2b5f0866962e71f3dfe Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=c8ce9da342741711d263b2b5f0866962e71f3dfe commit c8ce9da342741711d263b2b5f0866962e71f3dfe Author: Benedict Reuschling AuthorDate: 2025-08-28 14:36:17 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 16:53:45 +0000 Avoid the use of "you" in the Basics chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52205 --- documentation/content/en/books/handbook/basics/_index.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc index df093f4e5e..ad0cdb7a9c 100644 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -56,7 +56,7 @@ This chapter covers the basic commands and functionality of the FreeBSD operatin Much of this material is relevant for any UNIX(R)-like operating system. New FreeBSD users are encouraged to read through this chapter carefully. -After reading this chapter, you will know: +Read this chapter to learn: * How to use and configure virtual consoles. * How to create and manage users and groups on FreeBSD. @@ -559,7 +559,7 @@ How to configure NIS is covered in crossref:network-servers[network-servers,Netw Any user can easily change their password using man:passwd[1]. To prevent accidental or unauthorized changes, this command will prompt for the user's original password before a new password can be set: -.Changing Your Password +.Changing The Password [example] ==== [source,shell] @@ -1257,7 +1257,7 @@ There are some drawbacks to this approach, and one advantage. * FreeBSD's file systems are robust if power is lost. However, a power loss at a critical point could still damage the structure of the file system. By splitting data over multiple file systems it is more likely that the system will still come up, making it easier to restore from backup as necessary. .Benefit of a Single File System -* File systems are a fixed size. If you create a file system when you install FreeBSD and give it a specific size, you may later discover that you need to make the partition bigger. This is not easily accomplished without backing up, recreating the file system with the new size, and then restoring the backed up data. +* File systems are a fixed size. When creating a file system during the FreeBSD installation and giving it a specific size, it may be that one wants to make the partition bigger. This is not easily accomplished without backing up, recreating the file system with the new size, and then restoring the backed up data. + [IMPORTANT] ==== @@ -1291,7 +1291,7 @@ These devices are used by file systems that expect to occupy a slice. Each GPT or BSD partition can contain only one file system, which means that file systems are often described by either their typical mount point in the file system hierarchy, or the name of the partition they are contained in. FreeBSD also uses disk space for _swap space_ to provide _virtual memory_. -This allows your computer to behave as though it has much more memory than it actually does. +This allows the computer to behave as though it has much more memory than it actually does. When FreeBSD runs out of memory, it moves some of the data that is not currently being used to the swap space, and moves it back in (moving something else out) when it needs it. This is called _paging_. @@ -1772,7 +1772,7 @@ For example, to change the shell to `bash`: % chsh -s /usr/local/bin/bash .... -Enter your password at the prompt and press kbd:[Return] to change your shell. +Enter the password at the prompt and press kbd:[Return] to change the shell. Log off and log in again to start using the new shell. [NOTE] From nobody Thu Aug 28 16:58:51 2025 X-Original-To: dev-commits-doc-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 4cCSKR3XlYz66JsG for ; Thu, 28 Aug 2025 16:58:51 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSKR2Sl6z3MgJ; Thu, 28 Aug 2025 16:58:51 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400331; 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=vnBAsMY/jBwtHeufxh/EUyqTa9PwzHl9TkiwJihb38A=; b=XAmy8HSGACJBw8nmc3FVZuuxySJJ0ywxWBfonxLkBkh3X68SEVB+bT0qA/5CFqxF//2g9H YI0+KN5SKUDHC8pGobqGjP7YTbszQxwk4gQEBZ3B7QuO8iVLKCvo+343Rcoerabk+Rh+dv cPNCqhx7UGeFWF8aluNBaB+2gEDlmWXBRFPlabicerNp3Hw/BJZggUni/sdhWLFKG+gmw7 gK7VI77CrbP/j308ZLOI7R22hyMHZHhhTLwvDvifnV/nEYcacmd9m0nSJgNixABjc5hg+e 0MxBbdMPyrAmPG5l9JThFCHMHjXBUWwk0tVw7vH5g1vvw0RBzbmE24tZitnVwA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400331; 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=vnBAsMY/jBwtHeufxh/EUyqTa9PwzHl9TkiwJihb38A=; b=Bl/Vyf1EgyTRUhGNp2dH3te9/AOCWPTc0Wic3VmfJDDOZ/aGrZaMh1y9YB3A2X5o41WyZb dIAWh+pNdHMQHgtBTgI/SC6AVOphTUvpFDiSKyL2pIUNoX18xivn4im4B4TjI784qdEWeY x0VBawFv3dcOQz9jaE/0cILsne+BKCXzvB3R8/W9RngNBEQ5S5QLZKflKO97vu/iA9/Nf3 g6XPPuQdhbgGYJyYsjjlOo9eOGZCODP8Vj50+PKznk2yCVAXVGLpzY3Do9gGx1cm3i3ylQ NCCjVfV4T8Hf1XaB/9o/dHi9nc58VkRnNL2AXvJ4ybv2QvyOjXBRCqNWKtENSQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400331; a=rsa-sha256; cv=none; b=PQtuzEXhT8Sdc7XrIubvVta561XBhjGowzsQi5/p1CNBZnbI+58+pISKj+W5Sht32ssMa6 Pdxo+WDpoDq5z/kL2Yy7Nt2sAd5EmuglObpf5kBp0V7s+RU5mnojyNQ7RRFXNxHyDsVFat 35QcoVbQEMyiguGePejrRhZ6QDWQ5teg9DieZCOvcRhs+58Yh9IOFQsPuxGN0Puc3dZlzP oQM0Sw2QDwd57fv/Ydzl1BjTN8YspAyaB0DAPcYeKWw+vrn0qSyqK02FzPsMuEOYi9wTDk aWeM0PyFA43ZqyfjiP/kLpvPXPBX38Yv1O87DHmpf4GU26LgeKObSrbXfbYdNg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCSKR1p0Sz1GN7; Thu, 28 Aug 2025 16:58:51 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SGwpuB083102; Thu, 28 Aug 2025 16:58:51 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SGwpo4083099; Thu, 28 Aug 2025 16:58:51 GMT (envelope-from git) Date: Thu, 28 Aug 2025 16:58:51 GMT Message-Id: <202508281658.57SGwpo4083099@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 338b72447e - main - Avoid the use of "you" in the install chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 338b72447eb0e04ffab8890047f99fb4c88fd012 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=338b72447eb0e04ffab8890047f99fb4c88fd012 commit 338b72447eb0e04ffab8890047f99fb4c88fd012 Author: Benedict Reuschling AuthorDate: 2025-08-28 14:48:52 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 16:58:03 +0000 Avoid the use of "you" in the install chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52206 --- .../content/en/books/handbook/bsdinstall/_index.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc index 83acfe30e7..79234d2dc6 100644 --- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc +++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc @@ -64,7 +64,7 @@ The image types are: The rest of this chapter describes the third case, explaining how to install FreeBSD using the text-based installation program named bsdinstall. There may be minor differences between the installer and what is shown here, so use this chapter as a general guide rather than as a set of literal instructions. -After reading this chapter, you will know: +Read this chapter to learn: * How to obtain FreeBSD images and create FreeBSD installation media. * How to start bsdinstall. @@ -86,7 +86,7 @@ Once it has been determined that the system meets the minimum hardware requireme [TIP] ==== -Consider using crossref:virtualization[virtualization,virtualization] if you want to use FreeBSD on a system that already has another operating system installed. +Consider using crossref:virtualization[virtualization,virtualization] when wanting to use FreeBSD on a system that already has another operating system installed. ==== Before moving on to the installation, check that the system is ready by verifying the items in this checklist: @@ -185,7 +185,7 @@ There are two _checksum_ files available, named after the release number and the For example: `CHECKSUM.SHA256-FreeBSD-13.1-RELEASE-amd64` and `CHECKSUM.SHA512-FreeBSD-13.1-RELEASE-amd64`. After downloading one of the files (or both), calculate the _checksum_ for the image file and compare it with the one shown in the _checksum_ file. -Note that you need to compare the calculated _checksum_ against the correct file, as they correspond to two different algorithms: SHA256 and SHA512. +Note that comparing the calculated _checksum_ against the correct file is needed, as they correspond to two different algorithms: SHA256 and SHA512. FreeBSD provides man:sha256[1] and man:sha512[1] that can be used for calculating the _checksum_. Other operating systems have similar programs. @@ -468,7 +468,7 @@ It then demonstrates how to use the different partitioning methods. === Designing the Partition Layout The default partition layout for file systems includes one file system for the entire system. -When using `UFS` it may be worth considering the use of multiple file systems if you have sufficient disk space or multiple disks. +When using `UFS` it may be worth considering the use of multiple file systems with sufficient disk space or multiple disks available. When laying out file systems, remember that hard drives transfer data faster from the outer tracks to the inner. Thus, smaller and heavier-accessed file systems should be closer to the outside of the drive, while larger partitions like `/usr` should be placed toward the inner parts of the disk. It is a good idea to create partitions in an order similar to: `/`, swap, `/var`, and `/usr`. @@ -1045,7 +1045,7 @@ Here is a summary of the services that can be enabled in this menu: * `sshd` - The Secure Shell (SSH) daemon is used to remotely access a system over an encrypted connection. Only enable this service if the system should be available for remote logins. * `moused` - Enable this service if the mouse will be used from the command-line system console. * `ntpdate` - Enable automatic clock synchronization at boot time. Note that the functionality of this program is now available in the man:ntpd[8] daemon and the man:ntpdate[8] utility will soon be retired. -* `ntpd` - The Network Time Protocol (NTP) daemon for automatic clock synchronization. Enable this service if you wish to synchronise your system clock with a remote time server or pool. +* `ntpd` - The Network Time Protocol (NTP) daemon for automatic clock synchronization. Enable this service when wanting to synchronise the system clock with a remote time server or pool. * `powerd` - System power control utility for power control and energy saving. * `dumpdev` - Crash dumps are useful when debugging issues with the system, so users are encouraged to enable them. @@ -1151,7 +1151,7 @@ Once configuration is complete, select btn:[Exit]. [[bsdinstall-final-modification-shell]] .Manual Configuration -image::bsdinstall-final-modification-shell.png[Menu showing that the installation has finished. And asking if you want to open a shell to make manual changes.] +image::bsdinstall-final-modification-shell.png[Menu showing that the installation has finished. And asking if a shell to make manual changes should open.] bsdinstall will prompt for any additional configuration that needs to be done before rebooting into the new system. Select btn:[Yes] to exit to a shell within the new system or btn:[No] to proceed to the last step of the installation. From nobody Thu Aug 28 17:01:56 2025 X-Original-To: dev-commits-doc-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 4cCSP031Q6z66K7G for ; Thu, 28 Aug 2025 17:01:56 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSP02HlMz3MqX; Thu, 28 Aug 2025 17:01:56 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400516; 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=a6gR54M0X3rxsVUZ57eEtdoEQlt9xLcvYNDEsS3KGHc=; b=Jc/3TWH0Ifk2qu9F8cHbcy1hOhJUxY+C2LgWRn3PpB80GwEhtz0jL2b3q74Xasq6DVbXcf j7eRbdQIl4Ee6H1G1kmQ77w3+3TzRWenED+y8tWR6DR9jWdr5xvW9zOSv3amKjFkQyVOuL GgWqxaiR+S3ezcmMIhDcsf4ADcfJ+ryaBKB5GujCEk7RVrPFmRHIiowlHlaWc2CsPIox80 8OAG3C6MgtjPb8rPdiK0bR9GS/b5vMVNCEAj8ddQ8fnQGw0E3fube3k0CClKzQF1JyDGdp 09Xg0iNJZ0WewI9ODfM/PUGqobc9eSSlTy/fA/+XJi5bPrkmhuW2NC5D+V98DQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400516; 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=a6gR54M0X3rxsVUZ57eEtdoEQlt9xLcvYNDEsS3KGHc=; b=UNJ8kUQ5+RdFh4dDoUdrZbxjz2+fNW1IPTxC++arz8dLpBMSAtG1orfRmFReiK/BMlNuSM O9ZkQNrZaNYGQ5HvH6aqyaW7EEEQLBlxF8VghQQBw8nhXRkZexys6yQgTACiBHoJmYcww4 kjZ+6C928UXO36EK19EFG+bBNYLDqVvwsVZ3Axj6JjyaSYlNqZ8QqoiWFNmt4npQCV1EHp hGNgOve0ghu4q4CqcceWxj5Uy0OTbBBx8jS3yOh/4kSMU051WZSaVETkp6FgU6cR4Mtps4 iS5zkg7zZXzHKfKJGDQdUfZUiUmqrSkQI8dWEOxtk5jLl7Pe5Go8YdgFzkWN7g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400516; a=rsa-sha256; cv=none; b=htgXF4grt+UcZ01TouZWBFULtFBsuJJOPd0eEdYBhTvEV2LORvXMbnk57VTM5Yv8xkQE+P Ha8LpfTJNpehFX+Tfz+wN/W894rS3mLVKs6eANxVRoLRWekJd55XHJ5ln222D1BaZTPQ/g eME0F2232kmg0m5pfLO6UTP7A5J0OYi98A5/9VZi/fQgu4DM1aIOM/JZDMAVQUYebM6++i J6LXet29+aogCXCCHgj6S4R1ST4U3ZTCXcaeljJWGvLrfjWdwYCD/l+KIT7j3PjjVtuCdX LdchN7ophzymqv6D0Jh6EiwREnqY8rakgl+smzxPlWBtXRSDtKJRVWU63XdpBQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCSP01t63z1GSk; Thu, 28 Aug 2025 17:01:56 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SH1u6g099655; Thu, 28 Aug 2025 17:01:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SH1uCs099652; Thu, 28 Aug 2025 17:01:56 GMT (envelope-from git) Date: Thu, 28 Aug 2025 17:01:56 GMT Message-Id: <202508281701.57SH1uCs099652@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 38cc9fe26c - main - Avoid the use of "you" in the disks chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 38cc9fe26cff0230dbc76eb27014c04f0933f71f Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=38cc9fe26cff0230dbc76eb27014c04f0933f71f commit 38cc9fe26cff0230dbc76eb27014c04f0933f71f Author: Benedict Reuschling AuthorDate: 2025-08-28 14:59:14 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 17:01:17 +0000 Avoid the use of "you" in the disks chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52207 --- documentation/content/en/books/handbook/disks/_index.adoc | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/documentation/content/en/books/handbook/disks/_index.adoc b/documentation/content/en/books/handbook/disks/_index.adoc index 599952fecd..b86395f9e4 100644 --- a/documentation/content/en/books/handbook/disks/_index.adoc +++ b/documentation/content/en/books/handbook/disks/_index.adoc @@ -55,7 +55,7 @@ endif::[] This chapter covers the use of disks and storage media in FreeBSD. This includes SCSI and IDE disks, CD and DVD media, memory-backed disks, and USB storage devices. -After reading this chapter, you will know: +Read this chapter to learn: * How to add additional hard disks to a FreeBSD system. * How to grow the size of a disk's partition on FreeBSD. @@ -68,7 +68,7 @@ After reading this chapter, you will know: * How to encrypt disks and swap to secure them against attackers. * How to configure a highly available storage network. -Before reading this chapter, you should: +Before reading this chapter: * Know how to crossref:kernelconfig[kernelconfig,configure and install a new FreeBSD kernel]. @@ -1487,7 +1487,8 @@ For more details about `mdmfs`, refer to man:mdmfs[8]. FreeBSD offers a feature in conjunction with crossref:config[soft-updates,Soft Updates]: file system snapshots. -UFS snapshots allow a user to create images of specified file systems, and treat them as a file. If you are using the crossref:zfs[,Z file system (ZFS)], refer to crossref:zfs[zfs-zfs-snapshot,"Managing Snapshots"] on how to use snapshots. +UFS snapshots allow a user to create images of specified file systems, and treat them as a file. +When using the crossref:zfs[,Z file system (ZFS)], refer to crossref:zfs[zfs-zfs-snapshot,"Managing Snapshots"] on how to use snapshots. Snapshot files must be created in the file system that the action is performed on, and a user may create no more than 20 snapshots per file system. Active snapshots are recorded in the superblock so they are persistent across unmount and remount operations along with system reboots. @@ -2148,13 +2149,13 @@ The following are the main features of HAST: * Can be used in an already deployed environment to add additional redundancy. * Together with CARP, Heartbeat, or other tools, it can be used to build a robust and durable storage system. -After reading this section, you will know: +Read this chapter to learn: * What HAST is, how it works, and which features it provides. * How to set up and use HAST on FreeBSD. * How to integrate CARP and man:devd[8] to build a robust storage system. -Before reading this section, you should: +Before reading this section: * Understand UNIX(R) and FreeBSD basics (crossref:basics[basics,FreeBSD Basics]). * Know how to configure network interfaces and other core FreeBSD subsystems (crossref:config[config-tuning,Configuration and Tuning]). From nobody Thu Aug 28 17:04:12 2025 X-Original-To: dev-commits-doc-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 4cCSRc3tc7z66Kc4 for ; Thu, 28 Aug 2025 17:04:12 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSRc3LQpz3NSZ; Thu, 28 Aug 2025 17:04:12 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400652; 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=HVgdveNxLib3i2uXW/BWAhGVo0lt7qnb5uPp0enaMOE=; b=YQYTUowjsoUmKF/y4Z+ghpOLxW60WUALvOR4/1V0O885xVQM/M7IpdzK4mw0YajA/aPAdF 3JpeXXklOO08z9PShcig8Zh2Nt7a24d6iKSoT1QK6clTS7DN9SMCVxqFj2jxZR8FXRQZjT PlTrv9K+GeUkeanlM9GChsi7cUDVRI1tkwhMkC1+529NnAy/WQ8UVK/5vzR5CpmykPTdQ2 5lZoh6nKhVkWr9rlooY3nKFGkQ92stV+HBH6WoHwINsucJ90DLJi0XWY1EwiiBUNmEkfw5 Irz40OwQrtG3vk1n5cNxjylR/s+69jJYGiDocq5rRcLORVacZxW4ERAF6xMNcg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400652; 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=HVgdveNxLib3i2uXW/BWAhGVo0lt7qnb5uPp0enaMOE=; b=u0nqENVEceScWdmOyV/0bpJPCm8eEt1UvtSIU3mMPzj6V10h1C9o40kxw8M/MxcGaDLwrS 0A1MJZVBiCLrWm4QLU+z4CGzFQUnhNSnc81NofqIX1m9X5DyLb0giO7xft+dP40ZJSbkop GhYRyGax7LPtE/TBd6sab4EBEi/AhduM13xB1a0shqRiqpH+eG6dEQWw4Hh4sf79R1h+Gm 7kY2j2/PaPVoPyZ31Cwqz4eL7733ZlXeJN6lxduzUKzgLS7jEoaN+xFuy9+QotqIPbtYpC HGoCxqkr5Mt5YzQ6ZZ8uCvfLcE4SSU5kZEGsNzY0T5PAXG5ycaIi151kI2TK3g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400652; a=rsa-sha256; cv=none; b=Z1ENnnhc61sThFpp8WnbbZ6zVBfH7DU3hMoruoHR+VYjZwEJF97sF4GFeObz7jrLbxesMK oQdJGZS5Pto8q53OO4rEipBkI64NpCQwuMyVAQQxcMejfievhNaKxjAY159GGoRXmOs4EI HfGQakhLdDEQ8hHfiw5DMYl/qj/9WzJgQZPFXJk6HpFUMdT9ldWEjlYH7kbD/uGY2d35yp hANKoeAyKmrRPkqDy1FivwGdsINIjI+hC9qLqy011AjweAbpCksY0I8CPH7FQMtClk7MGJ XiJtTczjqgzA6iesvCIaDmg4eKYQln4CyHoEkVWkj+yl2KkOabr281Ww/+f8hw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCSRc2nhRz1GsF; Thu, 28 Aug 2025 17:04:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SH4CtL001406; Thu, 28 Aug 2025 17:04:12 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SH4Chx001403; Thu, 28 Aug 2025 17:04:12 GMT (envelope-from git) Date: Thu, 28 Aug 2025 17:04:12 GMT Message-Id: <202508281704.57SH4Chx001403@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 545816b1a4 - main - Avoid the use of "you" in the introduction chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 545816b1a4b2823810359786635649a514d697c8 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=545816b1a4b2823810359786635649a514d697c8 commit 545816b1a4b2823810359786635649a514d697c8 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:12:15 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 17:03:40 +0000 Avoid the use of "you" in the introduction chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52209 --- .../en/books/handbook/introduction/_index.adoc | 26 +++++++++++----------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/documentation/content/en/books/handbook/introduction/_index.adoc b/documentation/content/en/books/handbook/introduction/_index.adoc index 6b59ec791f..4e84e37165 100644 --- a/documentation/content/en/books/handbook/introduction/_index.adoc +++ b/documentation/content/en/books/handbook/introduction/_index.adoc @@ -54,13 +54,13 @@ endif::[] Thank you for your interest in FreeBSD! The following chapter covers various aspects of the FreeBSD Project, such as its history, goals, development model, and so on. -After reading this chapter you will know: +Read this chapter to learn: * How FreeBSD relates to other computer operating systems. * The history of the FreeBSD Project. * The goals of the FreeBSD Project. * The basics of the FreeBSD open-source development model. -* And of course: where the name "FreeBSD" comes from. +* Where the name "FreeBSD" comes from. [[nutshell]] == Welcome to FreeBSD! @@ -69,13 +69,13 @@ FreeBSD is an Open Source, standards-compliant Unix-like operating system for x8 It provides all the features that are nowadays taken for granted, such as preemptive multitasking, memory protection, virtual memory, multi-user facilities, SMP support, all the Open Source development tools for different languages and frameworks, and desktop features centered around X Window System, KDE, or GNOME. Its particular strengths are: -* _Liberal Open Source license_, which grants you rights to freely modify and extend its source code and incorporate it in both Open Source projects and closed products without imposing restrictions typical to copyleft licenses, as well as avoiding potential license incompatibility problems. +* _Liberal Open Source license_, which grants the rights to freely modify and extend its source code and incorporate it in both Open Source projects and closed products without imposing restrictions typical to copyleft licenses, as well as avoiding potential license incompatibility problems. * _Strong TCP/IP networking_ - FreeBSD implements industry standard protocols with ever increasing performance and scalability. This makes it a good match in both server, and routing/firewalling roles - and indeed many companies and vendors use it precisely for that purpose. * _Fully integrated OpenZFS support_, including root-on-ZFS, ZFS Boot Environments, fault management, administrative delegation, support for jails, FreeBSD specific documentation, and system installer support. * _Extensive security features_, from the Mandatory Access Control framework to Capsicum capability and sandbox mechanisms. -* _Over 30 thousand prebuilt packages_ for all supported architectures, and the Ports Collection which makes it easy to build your own, customized ones. +* _Over 30 thousand prebuilt packages_ for all supported architectures, and the Ports Collection which makes it easy to build customized ones. * _Documentation_ - in addition to the Handbook and books from different authors that cover topics ranging from system administration to kernel internals, there are also the man:man[1] pages, not only for userspace daemons, utilities, and configuration files, but also for kernel driver APIs (section 9) and individual drivers (section 4). -* _Simple and consistent repository structure and build system_ - FreeBSD uses a single repository for all of its components, both kernel and userspace. This, along with a unified and easy to customize build system and a well thought-out development process makes it easy to integrate FreeBSD with build infrastructure for your own product. +* _Simple and consistent repository structure and build system_ - FreeBSD uses a single repository for all of its components, both kernel and userspace. This, along with a unified and easy to customize build system and a well thought-out development process makes it easy to integrate FreeBSD with build infrastructure for own product. * _Staying true to Unix philosophy_, preferring composability instead of monolithic "all in one" daemons with hardcoded behavior. * _Binary compatibility_ with Linux, which makes it possible to run many Linux binaries without the need for virtualisation. @@ -86,8 +86,8 @@ FreeBSD offers performance and reliability on par with other Open Source and com [[os-overview]] === What Can FreeBSD Do? -The applications to which FreeBSD can be put are truly limited only by your own imagination. -From software development to factory automation, inventory control to azimuth correction of remote satellite antenna; if it can be done with a commercial UNIX(R) product then it is more than likely that you can do it with FreeBSD too! FreeBSD also benefits significantly from literally thousands of high quality applications developed by research centers and universities around the world, often available at little to no cost. +The applications to which FreeBSD can be put are truly limited only by ones own imagination. +From software development to factory automation, inventory control to azimuth correction of remote satellite antenna; if it can be done with a commercial UNIX(R) product then it is more than likely that FreeBSD can do it, too! FreeBSD also benefits significantly from literally thousands of high quality applications developed by research centers and universities around the world, often available at little to no cost. Because the source code for FreeBSD itself is freely available, the system can also be customized to an almost unheard-of degree for special applications or projects, and in ways not generally possible with operating systems from most major commercial vendors. Here is just a sampling of some of the applications in which people are currently using FreeBSD: @@ -103,9 +103,9 @@ Here is just a sampling of some of the applications in which people are currentl ** Virtualization servers ** And more... -* _Education:_ Are you a student of computer science or a related engineering field? There is no better way of learning about operating systems, computer architecture and networking than the hands-on, under-the-hood experience that FreeBSD can provide. A number of freely available CAD, mathematical and graphic design packages also make it highly useful to those whose primary interest in a computer is to get _other_ work done! +* _Education:_ Computer science students, as well as those in related engineering fields, will benefit from FreeBSD. There is no better way of learning about operating systems, computer architecture and networking than the hands-on, under-the-hood experience that FreeBSD can provide. A number of freely available CAD, mathematical and graphic design packages also make it highly useful to those whose primary interest in a computer is to get _other_ work done! * _Research:_ With source code for the entire system available, FreeBSD is an excellent platform for research in operating systems as well as other branches of computer science. FreeBSD's freely available nature also makes it possible for remote groups to collaborate on ideas or shared development without having to worry about special licensing agreements or limitations on what may be discussed in open forums. -* _Networking:_ Need a new router? A name server (DNS)? A firewall to keep people out of your internal network? FreeBSD can easily turn that unused PC sitting in the corner into an advanced router with sophisticated packet-filtering capabilities. +* _Networking:_ Need a new router? A name server (DNS)? A firewall to keep people out of the internal network? FreeBSD can easily turn that unused PC sitting in the corner into an advanced router with sophisticated packet-filtering capabilities. * _Embedded:_ FreeBSD makes an excellent platform to build embedded systems upon. With support for the ARM, AArch64 and PowerPC platforms, coupled with a robust network stack, cutting edge features, and the permissive extref:{faq}[BSD license, bsd-license-restrictions], FreeBSD makes an excellent foundation for building embedded routers, firewalls, and other devices. * _Desktop:_ FreeBSD makes a fine choice for an inexpensive desktop solution using the freely available X11 server and Wayland display server. FreeBSD offers a choice from many open-source desktop environments, including the standard GNOME and KDE graphical user interfaces. FreeBSD can even boot "diskless" from a central server, making individual workstations even cheaper and easier to administer. * _Software Development:_ The basic FreeBSD system comes with a full suite of development tools including a full C/C++ compiler and debugger suite. Support for many other languages are also available through the ports and packages collection. @@ -237,8 +237,8 @@ All we ask of those who would join us as FreeBSD developers is some of the same In addition to the base distributions, FreeBSD offers a ported software collection with thousands of commonly sought-after programs. The list of ports ranges from HTTP servers to games, languages, editors, and almost everything in between. There are about {numports} ports; the entire Ports Collection requires approximately {ports-size}. -To compile a port, you simply change to the directory of the program you wish to install, type `make install`, and let the system do the rest. -The full original distribution for each port you build is retrieved dynamically so you need only enough disk space to build the ports you want. +To compile a port, simply change to the directory of the program needed to install, type `make install`, and let the system do the rest. +The full original distribution for each port that is build is retrieved dynamically so only enough disk space to build the ports is needed. Almost every port is also provided as a pre-compiled "package", which can be installed with a simple command (`pkg install`) by those who do not wish to compile their own ports from source. More information on packages and ports can be found in crossref:ports[ports,Installing Applications: Packages and Ports]. @@ -255,7 +255,7 @@ Documentation may also be installed later using packages: For localized versions replace the "en" with the language prefix of choice. Be aware that some of the localised versions might be out of date and might contain information that is no longer correct or relevant. -You may view the locally installed manuals with a web browser using the following URLs: +Read the locally installed manuals with a web browser using the following URLs: The FreeBSD Handbook:: `/usr/local/share/doc/freebsd/en/books/handbook/handbook_en.pdf` @@ -263,6 +263,6 @@ The FreeBSD Handbook:: The FreeBSD FAQ:: `/usr/local/share/doc/freebsd/en/books/faq/faq_en.pdf` -You can always find up to date documentation at link:https://docs.FreeBSD.org/[The Documentation Portal]. +Find up to date documentation at link:https://docs.FreeBSD.org/[The Documentation Portal]. All trademarks are the property of their respective owners. From nobody Thu Aug 28 17:05:58 2025 X-Original-To: dev-commits-doc-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 4cCSTf4pygz66KYn for ; Thu, 28 Aug 2025 17:05:58 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSTf48m8z3NQQ; Thu, 28 Aug 2025 17:05:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400758; 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=tHXoJv+T+R+Sv/GfExzEuEoiL+/+Z7rsgyastBXF088=; b=t9Lzm7XY1/kBLtJh5jW+rtqYKIwtDN8GlriRgq+dxc/fUHU8K4HXWPlwMV6vzKrffynbDI hIJ9vMYSgjLe+NHvEMSIVwUmScpm7M0vT6nC22WJWBMhvuvZXoiQ4eSnWTqtzW8+uv3wJt Vof8+hMcyJibK8EXEMIWLzyKU28cu/3CsUTen/zVqIYYBuu3aLfXnaUAnoWWuKQwZtkvp+ sPEL1J6SKZvCpmP2TEbqKrtxC+JLCI1/7oxTA3WlGONN5NEe+VGx72R9A2Aqrt7ebhMQ8r 8FvmnxwBrgIjPXybee3f/SbMPbbBtjGO8e4IxCIkTNlZM7RjmH1Gyp2m7I9RXw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400758; 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=tHXoJv+T+R+Sv/GfExzEuEoiL+/+Z7rsgyastBXF088=; b=xTk/M3B8JA73T7peNntCcRgiJkBa1qxf0UbR1k/MbU4e528IyxAYZCzGkgWk5jqom5ToGm 1GYui3Cw9/9fRJfVcuovSTaJlutpiGrNE2wzH73NwWjJH1pFr+8zNIynC2it9QfPGy/mga MdnDTBsFT7JpsmUKe3SoVNPjVzX6Jx6jJWR2NbekKY81yeXA66ypYndEzzD4Uu8MAB8zyH ybLsD+Bwz4iIoQ1AGSEUixMqmJ8ziVJpe6BraeKwCx/IrDEtbrWjXSj2DpvI1DvCG8GiA6 pDR13Ri78BBwUMX3VCIEbmXALk+og+8EkW/y+Gj2MWeTbREWvUb3lkxwyeA7xA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400758; a=rsa-sha256; cv=none; b=VDM/700WFT/vYmnfPulMuVv0G/AD6KU3rxbQls/8k5jxy5yMjPaYABystTK1LJcDTGmQaE xwO0gFcvJf++nZvq60ps5sIBmTYV2Rlk7OUlkZPmv45hZqkxr+gMByp2yr57I2BjD39iG1 cn8hmOqYeqxrqSt/3mtbTnTi4Kbqr0Au9PHdFLcLVL8vTM+w2DaFZui3Tj/O2AG/Ll4sDX wD7ajF5PDuUKVR8DpUTL9JasYpBJHrSZIbUGmgP6kQbG2ler20h4y/XKuWitTLLFbrOlCQ /P2gOug5bPKqQbYVMq+gveBOWEZEb26/UEI+J+lnO/0rY6kKUpmrOnbNueGR9Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCSTf3llpz1Gvg; Thu, 28 Aug 2025 17:05:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SH5wHP002079; Thu, 28 Aug 2025 17:05:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SH5wq5002076; Thu, 28 Aug 2025 17:05:58 GMT (envelope-from git) Date: Thu, 28 Aug 2025 17:05:58 GMT Message-Id: <202508281705.57SH5wq5002076@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 050c08320a - main - Avoid the use of "you" in the mail chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 050c08320aa7826f8e6250cd4d93cbf9b38d4c57 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=050c08320aa7826f8e6250cd4d93cbf9b38d4c57 commit 050c08320aa7826f8e6250cd4d93cbf9b38d4c57 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:19:12 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 17:05:30 +0000 Avoid the use of "you" in the mail chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52211 --- documentation/content/en/books/handbook/mail/_index.adoc | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc index c8c3cb076a..003b5a429c 100644 --- a/documentation/content/en/books/handbook/mail/_index.adoc +++ b/documentation/content/en/books/handbook/mail/_index.adoc @@ -141,10 +141,8 @@ username@gmail.com|smtp.gmail.com:password [NOTE] ==== -If you have 2-factor authentication enabled, you will need to generate an -application-specific password as your normal login password will be -rejected. See Google documentation for more information on -https://myaccount.google.com/apppasswords[app-specific passwords]. +With enabled 2-factor authentication a generated application-specific password as the normal login password will be rejected. +See Google documentation for more information on https://myaccount.google.com/apppasswords[app-specific passwords]. ==== Execute the following command to test the configuration: @@ -384,7 +382,7 @@ daily_submit_queuerun="NO" The next step is to install another MTA, man:dma[8] will be used in this example. As pointed above, man:dma[8] is the default MTA in FreeBSD starting with version 14.0. -Therefore, it is only necessary to install it from the ports if you are using a previous version. +Therefore, it is only necessary to install it from the ports when using a previous version. To install it execute the following command: @@ -767,7 +765,7 @@ example.FreeBSD.org has address 204.216.27.XX example.FreeBSD.org mail is handled (pri=10) by nevdull.FreeBSD.org .... -All mail sent to `example.FreeBSD.org` will be collected on `nevdull` under the same username instead of being sent directly to your host. +All mail sent to `example.FreeBSD.org` will be collected on `nevdull` under the same username instead of being sent directly to the local host. The above information is handled by the DNS server. The DNS record that carries mail routing information is the link:https://en.wikipedia.org/wiki/MX_record[mail exchanger record (MX record)]. @@ -788,7 +786,7 @@ The lowest MX number is the host that receives mail directly, if available. If it is not accessible for some reason, the next lower-numbered host will accept messages temporarily, and pass it along when a lower-numbered host becomes available. Alternate MX sites should have separate Internet connections in order to be most useful. -Your ISP can provide this service. +The ISP can provide this service. [[mail-domain]] === Mail for a Domain From nobody Thu Aug 28 17:07:34 2025 X-Original-To: dev-commits-doc-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 4cCSWV4Sqcz66KcH for ; Thu, 28 Aug 2025 17:07:34 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSWV3Ttrz3Nbq; Thu, 28 Aug 2025 17:07:34 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400854; 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=ORU1Ulk7CeEAMU3t2hGzA8wiHNp4lnpNPr7oFWAbROI=; b=SEKlVhvSFhZjgL0BZ+26Y6bLxvbFGFyJDcR2eGDM6kGXtApprEZD17CD9Yu2rCuSnTpc0i 0oE4H77l4vHGGyZsfQUWvleDAsK/M4PAjPY5tDqkS7k8O09GYTj7aCdsfZoU3xv5cnnCiK JcpU+oQyVy5HQD9hb+YsD6wcTnwSXviVzo7ks7bN1HxL/CTMGX9QonU97jrKUCWH2S8yTu K1A5eAdS3vVrSeb5X10mkLzZNjC4AhmoicaiveEnNP1Dhwqa+ccBxJoEuQidSMs0pUnbPT cvdDFeJ4Gzv1zCCastD6ztnUhBQ1JNYtYETGnI5YhplNYZXiqcmSqsKmTelw8w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400854; 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=ORU1Ulk7CeEAMU3t2hGzA8wiHNp4lnpNPr7oFWAbROI=; b=aT7WC9upm6TpgGA590pXUdUNs7dxmgEgBsw97pI4XxzRnmyyl7d7L29gVh1VZ2hleuqxc+ Iq5RmG/vXImqVC4CWf7+0ZUDL5mEAaFhxYRE3JYa3V7OEGKNa5U12GI4oQeI2avypkvWeH uJf3Z2KEB5KFg7oV6PJ2wsr0IffFUkWu11TYVMrWPtgAFpdiIcd1n8zss1XXGS4w3SU//0 yvdXOuyBLPss4zumRTjd6lCcEX1LSGgncL36/i8tZbTwYMry8tCaQZyVfnlJkWr3ZijKhh FvnIXPAR19HppB5NC81B0u4FKyU0XA8Hh4TW32jFoMV3zSzWQbYuTOvmDIpn5g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400854; a=rsa-sha256; cv=none; b=OSMXQ1n2c9POLbT8lA1KpYD2bfB/JszuQmRy+rLTfyx+vtx651R1Haf0vL8qC2hIuWZMli 0GumYmNlOfsDBWOUdCtobEKyOiB+0AQ2dEwmEV71AopL2PnSly49Wlg2OwAKIsDFbAZkdb Ar6bhL/zlbZJpgtFGM3/w8W3zEx2HogFQzDhh3OkYTFb5UsWTBfAuzEG0dIJ+ucmFRv/6O 4ZUVlgWBeoRyAokW/b7FR1P4YeGnK7BvXvmcfoJrFslQQbHRGXQHlSwkX5R5pZpBYeCZTX TqTeElNuIv94CzO51ZFj8GGS0ENCYKHO3o2N77vb/BLbCoc8JeETgPWLMQ4ZJA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCSWV2tpJz1Gpl; Thu, 28 Aug 2025 17:07:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SH7YZg002644; Thu, 28 Aug 2025 17:07:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SH7YDh002641; Thu, 28 Aug 2025 17:07:34 GMT (envelope-from git) Date: Thu, 28 Aug 2025 17:07:34 GMT Message-Id: <202508281707.57SH7YDh002641@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 6bac0268b5 - main - Avoid the use of "you" in the Multimedia chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6bac0268b5b3e9a55da774660644ad63a468da38 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=6bac0268b5b3e9a55da774660644ad63a468da38 commit 6bac0268b5b3e9a55da774660644ad63a468da38 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:24:25 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 17:07:18 +0000 Avoid the use of "you" in the Multimedia chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52212 --- documentation/content/en/books/handbook/multimedia/_index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc index 17cb077290..0950c9d5c1 100644 --- a/documentation/content/en/books/handbook/multimedia/_index.adoc +++ b/documentation/content/en/books/handbook/multimedia/_index.adoc @@ -57,7 +57,7 @@ Multimedia applications and technologies have become an integral part of modern This chapter covers various multimedia components such as audio, video, and image processing. It also discusses various media formats and codecs, as well as tools and applications for multimedia creation and playback. Additionally, the chapter covers multimedia system configuration, troubleshooting, and optimization. -Whether you are a multimedia enthusiast or a professional content creator, FreeBSD offers a robust platform for multimedia work. +FreeBSD provides a robust platform for multimedia work, suitable for both multimedia enthusiasts and professional content creators. This chapter aims to help get the most out of FreeBSD's multimedia capabilities, providing useful information and practical examples to help get started. [[sound-setup]] @@ -343,7 +343,7 @@ To install GNOME Music, execute: === Audacious Audacious is an open source audio player. -A descendant of XMMS, it plays your music how you want it, without stealing away your computer's resources from other tasks. +As a descendant of XMMS, it provides music playback while maintaining efficient use of system resources. To install Audacious, execute: From nobody Thu Aug 28 17:09:45 2025 X-Original-To: dev-commits-doc-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 4cCSZ13Jclz66KXm for ; Thu, 28 Aug 2025 17:09:45 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCSZ11CTXz3Nv9; Thu, 28 Aug 2025 17:09:45 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400985; 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=tZXQDqBWE4qVgfMnhMyX3E7ftD2/mAPCcp3iTfjyEb8=; b=MKcaciKXqhUuQk6TT1AvVPHepI4GhXrO3CypGuVkx9AMbuVuLI0ZnnsKGUYeYDCWLfAIBY MsKgM5bvg57SDPdmLjxUADP4fA58FVlbM6wQFr008XEBFSLI0V/pUpQUARmYoxx7tnKncB 8f7VplwK+xFwU0FpdlFK0hPesOWdzO7AMh21MNFNMrp03HsRgvyfgJTioSAJyIzRvI5yh1 gj8UG1j3TeQfJOzmVi3P6RDYWVwQoSetvHqhsk6uBJaxxC8adY930dgPT38XbRm5Zhgohc DHYGBGRd8k5OWdzCbd1Y9Q/BidhWVn4rQTYZ2LH1CSlxphC03N5pVVojPAGmBg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756400985; 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=tZXQDqBWE4qVgfMnhMyX3E7ftD2/mAPCcp3iTfjyEb8=; b=gPlvZZ1T/gWC2UtJEBpnd9OwEm8TEKNUUoj+VIIcedsSKoARpO7h331JWbJe4OMz++lkKq +q9JvobCdKN3dl0JzYeIOMmEckQpDnbyYNTirUP8QB0m+F8cJCNYYyhmKBNUunEOonVi4g lLZXoB9NA0GIOc/Pag1mfea5YDCnexBABKLal5hLFp1V1s1oEcV4zTsaQ1pEd6xe19317Y PcKwG0G+4kSya/xy1M+VsqXj5hQXL8Jhn6TLX4HiZfR7oCIju5YDbCvh46iNdJwDdXCSH8 RCYKfc1596yzNG7KyvBTXdEiXVhrrNPCXd6mnML8CQ5R4VwxKIW5LzWEZQgDNw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756400985; a=rsa-sha256; cv=none; b=Mc1dNJzx9AqDf1Ss0InL9fSQltZHtlQ8BgRiX1JQY/SlN4qXcC67q4BfAwwRaCCfVnNAE9 +D+uI/A2P/IS7KpYdJGoZcuqR3JVSvVhEUL/hEK0sPa574zP0WZX/8B2Kj+YxDs+2IIrvl VQyHLPbqRJboa4zFN/J4u4WOzQGaamTFcDnBaZH/Oz3midVd1Mh/Wd9csXClgNnZXjuhRb fqz4v6wgikn605VPi+pWIwHcbgtRodJrRa5lXbdAT6CvHOzoaB+X3mNLT7MdZLU4w3mpl+ nPP/07aTQbMnbCqLaPcfbAom3rKn9FBAUbXt1jBU3D3XCYkkAaNDlP+BD6zg1g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCSZ10q1hz1HMk; Thu, 28 Aug 2025 17:09:45 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57SH9jnV003425; Thu, 28 Aug 2025 17:09:45 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SH9jr5003422; Thu, 28 Aug 2025 17:09:45 GMT (envelope-from git) Date: Thu, 28 Aug 2025 17:09:45 GMT Message-Id: <202508281709.57SH9jr5003422@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: b65c5744af - main - Avoid the use of "you" in the network-servers chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b65c5744af0dc93c547c59bf7ec56ba6b198ec77 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=b65c5744af0dc93c547c59bf7ec56ba6b198ec77 commit b65c5744af0dc93c547c59bf7ec56ba6b198ec77 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:28:39 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 17:09:14 +0000 Avoid the use of "you" in the network-servers chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Approved by: carlavilla Differential Revision: https://reviews.freebsd.org/D52213 --- .../content/en/books/handbook/network-servers/_index.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/content/en/books/handbook/network-servers/_index.adoc b/documentation/content/en/books/handbook/network-servers/_index.adoc index 37109cb947..d7ac579d4f 100644 --- a/documentation/content/en/books/handbook/network-servers/_index.adoc +++ b/documentation/content/en/books/handbook/network-servers/_index.adoc @@ -96,14 +96,14 @@ Each line of this configuration file represents an application which can be star By default, every line starts with a comment (`+#+`), meaning that inetd is not listening for any applications. To configure inetd to listen for an application's connections, remove the `+#+` at the beginning of the line for that application. -After saving your edits, configure inetd to start at system boot by editing [.filename]#/etc/rc.conf#: +After saving the edits, configure inetd to start at system boot by editing [.filename]#/etc/rc.conf#: [.programlisting] .... inetd_enable="YES" .... -To start inetd now, so that it listens for the service you configured, type: +To start inetd now, so that it listens for the configured service, type: [source,shell] .... @@ -1249,7 +1249,7 @@ default:\ In this example, the system is using the DES format for password hashing. Other possible values include `blf` for Blowfish, `md5` for MD5, `sha256` and `sha512` for SHA-256 and SHA-512 respectively. -For more information and the up to date list of what is available on your system, consult the man:crypt[3] manpage. +For more information and the up to date list of what is available on the system, consult the man:crypt[3] manpage. If the format on a host needs to be edited to match the one being used in the NIS domain, the login capability database must be rebuilt after saving the change: @@ -2618,7 +2618,7 @@ On FreeBSD, the built-in ntpd can be used to synchronize a system's clock. ntpd is configured using man:rc.conf[5] variables and [.filename]#/etc/ntp.conf#, as detailed in the following sections. ntpd communicates with its network peers using UDP packets. -Any firewalls between your machine and its NTP peers must be configured to allow UDP packets in and out on port 123. +Any firewalls between the machine and its NTP peers must be configured to allow UDP packets in and out on port 123. ==== The [.filename]#/etc/ntp.conf# file @@ -2732,7 +2732,7 @@ The presence of any of the following keywords in [.filename]#ntp.conf# requires * logdir * statsdir -To manually configure ntpd to run as user `ntpd` you must: +To manually configure ntpd to run as user `ntpd`: * Ensure that the `ntpd` user has access to all the files and directories specified in the configuration. * Arrange for the `mac_ntpd` module to be loaded or compiled into the kernel. See man:mac_ntpd[4] for details. From nobody Fri Aug 29 08:22:51 2025 X-Original-To: dev-commits-doc-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 4cCrqc1Cwqz66Khd for ; Fri, 29 Aug 2025 08:22:52 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCrqc0Wmwz45VZ; Fri, 29 Aug 2025 08: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=1756455772; 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=pKo6RrWTWExX9tApOvCiM9QHi/vQvfyjo8A+gOm3wSE=; b=LDKDfBNKGriBaQJyU8oj+/kmH2nGgyR8Fmoenvt1bmikrGuTCzAE5Qpqea31pohzzSjc9e W5zILWoOiTpZXJfVuuaxFlDOeiIeB9waa7Ipnh/ojIpUWpGJd2JMZMloXbaGL8mSvd9E8R rPb7kDcLc4bUEnbvarklWJ/FOsp842feWGVCpZ+d+r9B7gttiZ7nIkr79+VPoM0wOO4ikT bQDoxPz9IS/a7txGTthnpxbWaLTYnTNdUqRE8f2tYyFqevyKVvoK74GqPjLHKHWmfG8+Hp 04wK/+h4fpcRoSP+6DQTqYTe16mAPza5lXFsNCPotFQGcPZaK63elDb/q2letQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756455772; 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=pKo6RrWTWExX9tApOvCiM9QHi/vQvfyjo8A+gOm3wSE=; b=hpYendYPDfuUxxE/nYGyEwcqc2On6r6QN+S81ICL2OJSt1EQI8sHixbudU5I8H+8Y1rHeH k/vJAIrCkc0pbrt6obkYOX5lAIHfDcdfB82IOyDUOk8xdqrcUsD5Zchsu5tbnXr0fzf3jW bqOpvVN36Kb4lShz/pLQ5jtbOz/wzNMKSj1s70rhk0iUGBJKE+u7Z+iaut4JF6gY6VW0/0 EuG6xQhHAs04EKOIDUcMPnrIRW1vtF/K6D4aJ7LZsDV8lLX6Rue5SGp7xSS+v1F+CzfFk7 mXK8zdFPRxQC+6uGGKnR6kTkLoUBx0rPzU9HmEIbU8X4zcV/HpQ+X8XuR88DxA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756455772; a=rsa-sha256; cv=none; b=ZD4Cz1XCCljs7qxeJMOSi81lmJlQeZc9yBbmwe5OGRhAL9j0ZRerBGM5qHQPEb7Tcxpp0Y bAdm/SA0CLILyB2SmTglarjE871ruZGMVQmEg1KoLVcJVWwXDfnq8US++n+yMgzcuhDT8u LdqPLHAayl2Do6hPt3lKFWhnIoEdZFjvnOFrF/kvbNPvqCrPTmZKjH1ml5hFBUISg8Vqdw TklPG+2Cyk4kgu+2XV1b4B7QwinfulhTw76T13HDKwbptjEk593252uIscu2tj88vhAbVA mUFszLMEmrTqqieLFStvqMxGBEMOWvGEMTc3zAw5DYlCSqGwRq7xk/Id/SiM7Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCrqb6yPtzY1w; Fri, 29 Aug 2025 08:22:51 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T8MpwH027124; Fri, 29 Aug 2025 08:22:51 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8MpA0027121; Fri, 29 Aug 2025 08:22:51 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:22:51 GMT Message-Id: <202508290822.57T8MpA0027121@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: a7ce6dddfb - main - Avoid the use of "you" in the PPP chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a7ce6dddfbc3149c26038944211be0302357b270 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=a7ce6dddfbc3149c26038944211be0302357b270 commit a7ce6dddfbc3149c26038944211be0302357b270 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:45:01 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 17:10:48 +0000 Avoid the use of "you" in the PPP chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52215 --- .../en/books/handbook/ppp-and-slip/_index.adoc | 28 +++++++++++----------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc index a267fdc7ea..3d7ec970d3 100644 --- a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc +++ b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc @@ -55,13 +55,13 @@ endif::[] FreeBSD supports the Point-to-Point (PPP) protocol which can be used to establish a network or Internet connection using a dial-up modem. This chapter describes how to configure modem-based communication services in FreeBSD. -After reading this chapter, you will know: +Read this chapter to learn: * How to configure, use, and troubleshoot a PPP connection. * How to set up PPP over Ethernet (PPPoE). * How to set up PPP over ATM (PPPoA). -Before reading this chapter, you should: +Before reading this chapter: * Be familiar with basic network terminology. * Understand the basics and purpose of a dial-up connection and PPP. @@ -289,7 +289,7 @@ This line specifies the PAP/CHAP user name.Insert the correct value for _MyUserN Line 14::: This line specifies the PAP/CHAP password. Insert the correct value for _MyPassword_. -You may want to add an additional line, such as: +An additional line may be added, such as: + [.programlisting] .... @@ -384,8 +384,8 @@ router_enable="NO" It is important that the `routed` daemon is not started, as `routed` tends to delete the default routing table entries created by `ppp`. -It is probably a good idea to ensure that the `sendmail_flags` line does not include the `-q` option, otherwise `sendmail` will attempt to do a network lookup every now and then, possibly causing your machine to dial out. -You may try: +It is probably a good idea to ensure that the `sendmail_flags` line does not include the `-q` option, otherwise `sendmail` will attempt to do a network lookup every now and then, possibly causing the machine to dial out. +Try this: [.programlisting] .... @@ -709,13 +709,13 @@ Here is an example of a working [.filename]#ppp.conf#: [.programlisting] .... default: - set log Phase tun command # you can add more detailed logging if you wish + set log Phase tun command # add more detailed logging when needed set ifaddr 10.0.0.1/0 10.0.0.2/0 name_of_service_provider: - set device PPPoE:xl1 # replace xl1 with your Ethernet device - set authname YOURLOGINNAME - set authkey YOURPASSWORD + set device PPPoE:xl1 # replace xl1 with the Ethernet device + set authname THELOGINNAME + set authkey THEPASSWORD set dial set login add default HISADDR @@ -734,7 +734,7 @@ Add the following to [.filename]#/etc/rc.conf#: .... ppp_enable="YES" ppp_mode="ddial" -ppp_nat="YES" # if you want to enable nat for your local network, otherwise NO +ppp_nat="YES" # when needing to enable nat for the local network, otherwise NO ppp_profile="name_of_service_provider" .... @@ -746,7 +746,7 @@ Service tags are used to distinguish between different PPPoE servers attached to Any required service tag information should be in the documentation provided by the ISP. As a last resort, one could try installing the package:net/rr-pppoe[] package or port. -Bear in mind however, this may de-program your modem and render it useless, so think twice before doing it. +Bear in mind however, this may de-program the modem and render it useless, so think twice before doing it. Simply install the program shipped with the modem. Then, access the menu:System[] menu from the program. The name of the profile should be listed there. @@ -838,8 +838,8 @@ adsl: open .... -<.> The username used to authenticate with your ISP. -<.> The password used to authenticate with your ISP. +<.> The username used to authenticate with the ISP. +<.> The password used to authenticate with the ISP. Information about the link, or links, to establish is found in [.filename]#mpd.links#. An example [.filename]#mpd.links# to accompany the above example is given beneath: @@ -896,7 +896,7 @@ adsl: .... <.> The username for the DSL provider. -<.> The password for your account. +<.> The password for the account. [WARNING] ==== From nobody Fri Aug 29 08:28:14 2025 X-Original-To: dev-commits-doc-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 4cCrxp4WG1z66LM3 for ; Fri, 29 Aug 2025 08:28:14 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCrxp3rXxz469s; Fri, 29 Aug 2025 08:28:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456094; 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=WVSZryUVMXwAoZK+qW1BYe163oZyP60cD0qX9choTmQ=; b=mwnGTC+RQOzQ3C5Eea0Syp0JxRlD75pBBk5O/pMFUJpp1xGIF/tr8ZGBj8FuDo9reImICx YNdiGITaUsVORVRWYsAU6w8sHdeuiJPcfW2EobR4S9ft0DFegyDIFqioiOrbDONVwjfHhH J/8EbT4XlGObAeQf+LH/yfPX1yfjcqMsQ87hQMCKqH77NLD3zjBSnCcZ491RU30cW8KwTz QceUeh9n/kcsW1JiSTXXEuUkSZewwkGEgnCDtHSWzhJc/g+bflDd8B7d8JbxYBgITLIQHa FlKColH/6wL0GBhOl2QD7rZfb6EOGyv/unZkOgVuQVC8NILmsXzP+6UNbI+4kQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456094; 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=WVSZryUVMXwAoZK+qW1BYe163oZyP60cD0qX9choTmQ=; b=EEGw7+ut837kJkqeO9Wy81vKFw71YvILYHSJ5vTLCH1JDGIrqc7VaOFd3oLdzXTxzuvTSx lmp5I/UDhOGzC9EzYzC4N/B404wLGzESYiQPVD+WFeUrVCvPvo62A2E8TRsgpMV9dL50p6 3MVj/on4yDDiGhngpu5faUrZAfbqMW2m7gNJeMw6llKLbG6vGtkQwQf+xRKRNlHdrXwFik MyAg27cwTWPvajFpi6uBNnclxY8i6yhMIu90l3kTfvK3jFCmkDjiDJNUolykyYNROLTy6W 3D/FQBiJPE1wapsnsgkorrWd1zYdqL/8y+U854uD/RrKvemW+7ChxTztBuze1A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756456094; a=rsa-sha256; cv=none; b=KZjc8JdsblSOligY3wDbWplEo2Ahm4iX0+f5pKWt35lETf3u3cr+mM4jl5hoAl3KeqqPzf WNPpGOd1AIOdBqWqLDoONwK3cvNeAeZ2C0aizX/KCznKJp5mPl9oc3kD82O7Uf9l4zb8oI KkbyDX+aZxEZh6qVGBInZDmgyGNuXmuOtqaHDWQkPo3pXrd68xZ0ZkWwVHZUIxoteDwpo4 hhbUeItlEBPHN8yqQlMDu0Oe025FgdiK5vsaZM9qYciVfsJtJvD5nTnX12VNpKkgiPK7LP PERc9bhvMmgOe/IQUD4h8UGYbmwlQOstAgg0jZP6NAm7HHHu6aABxycNpGBBWA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCrxp38HTzXRw; Fri, 29 Aug 2025 08:28:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T8SExP028776; Fri, 29 Aug 2025 08:28:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8SEbT028772; Fri, 29 Aug 2025 08:28:14 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:28:14 GMT Message-Id: <202508290828.57T8SEbT028772@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: ddec620a4f - main - Avoid the use of "you" in the Preface chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ddec620a4f26057a86e335ff8273bba2ca247299 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=ddec620a4f26057a86e335ff8273bba2ca247299 commit ddec620a4f26057a86e335ff8273bba2ca247299 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:49:17 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 08:27:04 +0000 Avoid the use of "you" in the Preface chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52216 --- .../content/en/books/handbook/preface/_index.adoc | 24 +++++++++++----------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/documentation/content/en/books/handbook/preface/_index.adoc b/documentation/content/en/books/handbook/preface/_index.adoc index b25f3960d8..dfed27ebd1 100644 --- a/documentation/content/en/books/handbook/preface/_index.adoc +++ b/documentation/content/en/books/handbook/preface/_index.adoc @@ -51,8 +51,8 @@ endif::[] The FreeBSD newcomer will find that the first section of this book guides the user through the FreeBSD installation process and gently introduces the concepts and conventions that underpin UNIX(R). Working through this section requires little more than the desire to explore, and the ability to take on board new concepts as they are introduced. -Once you have traveled this far, the second, far larger, section of the Handbook is a comprehensive reference to all manner of topics of interest to FreeBSD system administrators. -Some of these chapters may recommend that you do some prior reading, and this is noted in the synopsis at the beginning of each chapter. +Once reaching this far, the second, far larger, section of the Handbook is a comprehensive reference to all manner of topics of interest to FreeBSD system administrators. +Some of these chapters may recommend to do some prior reading, and this is noted in the synopsis at the beginning of each chapter. For a list of additional sources of information, please see crossref:bibliography[bibliography,Bibliography]. @@ -157,7 +157,7 @@ _crossref:bsdinstall[bsdinstall,Installing FreeBSD]_:: Walks a user through the entire installation process of FreeBSD 9._x_ and later using bsdinstall. _crossref:basics[basics,FreeBSD Basics]_:: -Covers the basic commands and functionality of the FreeBSD operating system. If you are familiar with Linux(R) or another flavor of UNIX(R) then you can probably skip this chapter. +Covers the basic commands and functionality of the FreeBSD operating system. When familiar with Linux(R) or another flavor of UNIX(R) then this chapter can probably be skipped. _crossref:ports[ports,Installing Applications: Packages and Ports]_:: Covers the installation of third-party software with both FreeBSD's innovative "Ports Collection" and standard binary packages. @@ -172,10 +172,10 @@ _crossref:desktop[desktop,Desktop Applications]_:: Lists some common desktop applications, such as web browsers and productivity suites, and describes how to install them on FreeBSD. _crossref:multimedia[multimedia,Multimedia]_:: -Shows how to set up sound and video playback support for your system. Also describes some sample audio and video applications. +Shows how to set up sound and video playback support for the system. Also describes some sample audio and video applications. _crossref:kernelconfig[kernelconfig,Configuring the FreeBSD Kernel]_:: -Explains why you might need to configure a new kernel and provides detailed instructions for configuring, building, and installing a custom kernel. +Explains the need to configure a new kernel and provides detailed instructions for configuring, building, and installing a custom kernel. _crossref:printing[printing,Printing]_:: Describes managing printers on FreeBSD, including information about banner pages, printer accounting, and initial setup. @@ -193,7 +193,7 @@ _crossref:boot[boot,The FreeBSD Booting Process]_:: Describes the FreeBSD boot process and explains how to control this process with configuration options. _crossref:security[security,Security]_:: -Describes many different tools available to help keep your FreeBSD system secure, including Kerberos, IPsec and OpenSSH. +Describes many different tools available to help keep the FreeBSD system secure, including Kerberos, IPsec and OpenSSH. _crossref:jails[jails,Jails]_:: Describes the jails framework, and the improvements of jails over the traditional chroot support of FreeBSD. @@ -238,19 +238,19 @@ _crossref:mail[mail,Electronic Mail]_:: Explains the different components of an email server and dives into simple configuration topics for the most popular mail server software: sendmail. _crossref:network-servers[network-servers,Network Servers]_:: -Provides detailed instructions and example configuration files to set up your FreeBSD machine as a network filesystem server, domain name server, network information system server, or time synchronization server. +Provides detailed instructions and example configuration files to set up the FreeBSD machine as a network filesystem server, domain name server, network information system server, or time synchronization server. _crossref:firewalls[firewalls,Firewalls]_:: Explains the philosophy behind software-based firewalls and provides detailed information about the configuration of the different firewalls available for FreeBSD. _crossref:advanced-networking[advanced-networking,Advanced Networking]_:: -Describes many networking topics, including sharing an Internet connection with other computers on your LAN, advanced routing topics, wireless networking, Bluetooth(R), ATM, IPv6, and much more. +Describes many networking topics, including sharing an Internet connection with other computers on the LAN, advanced routing topics, wireless networking, Bluetooth(R), ATM, IPv6, and much more. _crossref:mirrors[mirrors,Obtaining FreeBSD]_:: -Lists different sources for obtaining FreeBSD media on CDROM or DVD as well as different sites on the Internet that allow you to download and install FreeBSD. +Lists different sources for obtaining FreeBSD media on CDROM or DVD as well as different sites on the Internet that allows to download and install FreeBSD. _crossref:bibliography[bibliography,Bibliography]_:: -This book touches on many different subjects that may leave you hungry for a more detailed explanation. The bibliography lists many excellent books that are referenced in the text. +This book touches on many different subjects that may leave readers hungry for a more detailed explanation. The bibliography lists many excellent books that are referenced in the text. _crossref:eresources[eresources,Resources on the Internet]_:: Describes the many forums available for FreeBSD users to post questions and engage in technical conversations about FreeBSD. @@ -303,7 +303,7 @@ C:\> tools\fdimage floppies\kern.flp A: .... Examples starting with # indicate a command that must be invoked as the superuser in FreeBSD. -You can login as `root` to type the command, or login as your normal account and use man:su[1] to gain superuser privileges. +Login as `root` to type the command, or login as the normal account and use man:su[1] to gain superuser privileges. [source,shell] .... @@ -321,7 +321,7 @@ Unless otherwise noted, C-shell syntax is used for setting environment variables [[preface-acknowledgements]] == Acknowledgments -The book you are holding represents the efforts of many hundreds of people around the world. +This book represents the efforts of many hundreds of people around the world. Whether they sent in fixes for typos, or submitted complete chapters, all the contributions have been useful. Several companies have supported the development of this document by paying authors to work on it full-time, paying for publication, etc. From nobody Fri Aug 29 08:30:32 2025 X-Original-To: dev-commits-doc-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 4cCs0S6pwbz66LVL for ; Fri, 29 Aug 2025 08:30:32 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCs0S5y9yz46Bj; Fri, 29 Aug 2025 08:30:32 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456232; 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=Z6HeqbMsSJaxWpLpUQGPsLu20w6DlsGU8r1+0Lau+m0=; b=Y3++GI+GyJHsKV9V0duIvagY7VFrCvE0hJuNHe2AmJ74GL43bh/h/EDyaHDvi8+2cEud7O Vx7mlTXDSYaHZAJLkphpGHNmD6/PuukteoHlyUtuiEqBAHLVW6CnchHlx/+JTvXfU/hAt+ Sv++n+lmJ6XU+iosuizhhDpqtF5JxMhZu1kRKLHH11nwYO275WTlxYTLNSFic3+SuDdaAj y9AiRWCO8B9tEZDcSWlkfM5oQ4XDjl+wmkLLoI0jiVT/wbwjjUTZZZFjaXvoTCA7MMFgPH YMAq6o3TnNcjaDlPpzlFtr6qb5NDmmQbFtQn8aQHrrisahGzICmEIBIcjByAsg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456232; 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=Z6HeqbMsSJaxWpLpUQGPsLu20w6DlsGU8r1+0Lau+m0=; b=aXNdLHifHnueRACRTeCl4RrCb+qDzx43WySKrK4Qz3DZ+eBa6eqvTZ1Akb1zP0bKbG3bp3 dHMO752FeCkmq41CZ66iLJfBcTRp7xbuDbYh9Of/HFpJOyt0HgUS9HkW9kDMrL5RBYUYhH HfPoeUHO44RiIGTtj59kmZjoJ+rnNSCNRplgymiQ1yHyoeIag1ezbYFEoM0XoOlOhBLxVw x9t4vZqIlsJY2MRolccgmtcKy7xEYAQbC1SigHSwGfGk/Ae7dupus+fBPja0EWEdmxmt+W 0OOAJzXwHq0RuIx0Pluly3QsucUWQcL9htTixy76xMl4hHl7cZ2wzDvjs6UBOg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756456232; a=rsa-sha256; cv=none; b=DFYM0wnkib9L8iCB99Gs17bYSzU7fKubiDN05zq+neMdy1V/d5I24QYeQd57wtaQKZx0bi 8Yo/nhDDeJXuzmHkw/ZhNaDfrVH9+wxKNZ+3B5v4QZLvGJQQQYHytKjDa38p0Wn4abL4wF LuQ2aCj7AXa+c9LVfSwpAKXVyCigp2NxWASy3WGCoB7Eeoe/tiD1t7P47wH11lWBioaYwn Nbn3BZG+IzqG5zwLYGAVpR41jiyzdXtrBJa8ytIUAsYCDQGl5XO9POkEbcAhxYyTx+rfhG MZ7tS2VV96bdCYaIUdgC+sthiBnoKRXJ4rhdANBFPDz5RB7imxJOaNLYmxtW+w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCs0S5WPmzY4L; Fri, 29 Aug 2025 08:30:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T8UWYJ038171; Fri, 29 Aug 2025 08:30:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8UWgf038168; Fri, 29 Aug 2025 08:30:32 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:30:32 GMT Message-Id: <202508290830.57T8UWgf038168@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 63d63c114e - main - Avoid the use of "you" in the security chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 63d63c114e8992e455b8f2390f95bdc8c6a92282 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=63d63c114e8992e455b8f2390f95bdc8c6a92282 commit 63d63c114e8992e455b8f2390f95bdc8c6a92282 Author: Benedict Reuschling AuthorDate: 2025-08-28 15:51:38 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 08:30:14 +0000 Avoid the use of "you" in the security chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52217 --- documentation/content/en/books/handbook/security/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/security/_index.adoc b/documentation/content/en/books/handbook/security/_index.adoc index 53be6040d1..f2dc051b6a 100644 --- a/documentation/content/en/books/handbook/security/_index.adoc +++ b/documentation/content/en/books/handbook/security/_index.adoc @@ -256,7 +256,7 @@ Enter new password: If a password that does not match the policy is entered, it will be rejected with a warning and the user will have an opportunity to try again, up to the configured number of retries. -If your organization's policy requires passwords to expire, FreeBSD supports the `passwordtime` in the user's login class in [.filename]#/etc/login.conf# +If the organization's policy requires passwords to expire, FreeBSD supports the `passwordtime` in the user's login class in [.filename]#/etc/login.conf# The `default` login class contains an example: @@ -580,7 +580,7 @@ All devices may be read or written subject to their permissions. 1:: *Secure mode* - the system immutable and system append-only flags may not be turned off; disks for mounted file systems, [.filename]#/dev/mem# and [.filename]#/dev/kmem# may not be opened for writing; -[.filename]#/dev/io# (if your platform has it) may not be opened at all; kernel modules (see man:kld[4]) may not be loaded or unloaded. +[.filename]#/dev/io# (if the platform has it) may not be opened at all; kernel modules (see man:kld[4]) may not be loaded or unloaded. The kernel debugger may not be entered using the debug.kdb.enter sysctl. A panic or trap cannot be forced using the debug.kdb.panic, debug.kdb.panic_str and other sysctl's. @@ -1888,7 +1888,7 @@ Additionally, always exercise caution when editing system configuration files, e === Enabling and Configuring Resource Limits The man:rctl[8] system provides a more fine-grained way to set and manage resource limits for individual processes and users. -It allows you to dynamically assign resource limits to specific processes or users, regardless of their user class. +It allows dynamically assigning resource limits to specific processes or users, regardless of their user class. The first step to use man:rctl[8] will be to enable it adding the following line to [.filename]#/boot/loader.conf# and reboot the system: From nobody Fri Aug 29 08:31:50 2025 X-Original-To: dev-commits-doc-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 4cCs1y3zg6z66LDv for ; Fri, 29 Aug 2025 08:31:50 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCs1y3Cnsz46FZ; Fri, 29 Aug 2025 08:31:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456310; 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=tjOzm+IqFaQK1FWaZmsePTxpCBWhjTgEb9iE09ePXls=; b=xMiZrbOKIzX10/yNrh7Bj9WgSWiUV8NwDduf5RXHgzHobCvgQknLBToakzH+z2xVD6Cqf/ VxJD7zUEWM3s6sLXTpl2R5nyVvGJ6uXT73u75WsDpk72tT8zX72/yOne5AGExni+3Xy1ZJ B1zowVlHw+9h5smdloRhZphdE5aEY6NS7IgK097lnWVgNIaM9EbsSEKVJRTY92XnqjKxeq D8vEVf8fIO7WMs1ttBpS+LZ9nPHcENhwK90e/OPAUjX92S42GhkAaYBV6y1NBTInNMQBUW VcNntDna2WHugWd6DgJHzVJvP4LvuEJBEIXlJSvEVi0qfxGI6xM4g1f4tylOUg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456310; 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=tjOzm+IqFaQK1FWaZmsePTxpCBWhjTgEb9iE09ePXls=; b=VM5iDJRIr/T0+S4a0zZb+iZCzwgcVN4POFrJjpIRBmJdefP08tvcNjISfjJws6Uhzo6EvA MDOIIgck8YD3R7PR574EwOS7GolKkZv3IxSl5AHwY2XCBTVibZ4v3JxKZidDn6Yh/bhkvy L61D2eAeEyOMT167gH4pcnBAWXE2363urQlisEQEWj5sh4dCUr1uczbc8mPNowgUvVYAa+ 4B141tuq4me0Gl1zpYZKauZYt3WNDGdjUxeq4Dgi5Lxtd8EPjIS0LZPfUGABz5mNiCaHoW 15d6fhdpoHpkJCMEqzCFrszNnO/skfL9GtF9T0XYzEjuptTDNSsz2z9q/KK4EQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756456310; a=rsa-sha256; cv=none; b=DmvMypTiYEdppjIPu+Hqc2SmyO6OJQx9cjZaZO0nkrk+lT5hn5bXPPCB5SsQLpQ91QdNt9 8BgP9Z6lFICHdi65AHzFuHJxL1nbxJXOxksoKPjvFFLOggkLZ7EDn2Ay92zWunh04VXKR4 qEZxCkc8ZB570jjQ9reQT3siZIKGFxXgx1+0jSxa98HzogBHfMsyvJLbqK3zR8A3rUeBOD pTj/Oru2PP4sNSPa23btM+KXqseIXZKU9lFV3+fMF6djnH5dfyzlqDusJAI6mOEbHhAO0+ /Wvjz/fB7WEGlX7LV5JTbYfP6/1HsdKtMI+b4Mbs6KYjZr26deMTbtV+kHobmw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCs1y2nJhzY2P; Fri, 29 Aug 2025 08:31:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T8VoOj041834; Fri, 29 Aug 2025 08:31:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8Voci041831; Fri, 29 Aug 2025 08:31:50 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:31:50 GMT Message-Id: <202508290831.57T8Voci041831@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: fd089bceb3 - main - Avoid the use of "you" in the serialcomms chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e commit fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e Author: Benedict Reuschling AuthorDate: 2025-08-28 15:53:35 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 08:31:32 +0000 Avoid the use of "you" in the serialcomms chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52218 --- documentation/content/en/books/handbook/serialcomms/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/serialcomms/_index.adoc b/documentation/content/en/books/handbook/serialcomms/_index.adoc index 18637f7d1c..e275e26ae6 100644 --- a/documentation/content/en/books/handbook/serialcomms/_index.adoc +++ b/documentation/content/en/books/handbook/serialcomms/_index.adoc @@ -56,14 +56,14 @@ UNIX(R) has always had support for serial communications as the very first UNIX( Things have changed a lot from the days when the average terminal consisted of a 10-character-per-second serial printer and a keyboard. This chapter covers some of the ways serial communications can be used on FreeBSD. -After reading this chapter, you will know: +Read this chapter to learn: * How to connect terminals to a FreeBSD system. * How to use a modem to dial out to remote hosts. * How to allow remote users to login to a FreeBSD system with a modem. * How to boot a FreeBSD system from a serial console. -Before reading this chapter, you should: +Before reading this chapter: * Know how to crossref:kernelconfig[kernelconfig, configure and install a custom kernel]. * Understand crossref:basics[basics, FreeBSD permissions and processes]. @@ -880,7 +880,7 @@ Put in an entry for `tip1200` or `cu1200`, but go ahead and use whatever bps rat === Accessing a Number of Hosts Through a Terminal Server Rather than waiting until connected and typing `CONNECT _host_` each time, use ``tip``'s `cm` capability. -For example, these entries in [.filename]#/etc/remote# will let you type `tip pain` or `tip muffin` to connect to the hosts `pain` or `muffin`, and `tip deep13` to connect to the terminal server. +For example, these entries in [.filename]#/etc/remote# allow typing `tip pain` or `tip muffin` to connect to the hosts `pain` or `muffin`, and `tip deep13` to connect to the terminal server. [.programlisting] .... From nobody Fri Aug 29 08:33:37 2025 X-Original-To: dev-commits-doc-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 4cCs415MGCz66LHc for ; Fri, 29 Aug 2025 08:33:37 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCs414Y17z46VQ; Fri, 29 Aug 2025 08:33:37 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456417; 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=Ws/VqRx/ni+sKh0jn4IQvuxfNX+2ppHoac+ZsQScPP4=; b=M0u+csVVOAk9oR/FA4KRulyYfzCrIBUSgYp5UMyeR9TEdcj6LeT8+Uwofu4WX5TTSE8DcM yJUX575DySyptr4oUkjbHuq1SEVK/A8uLjrJhHA4AO6HnSMsdWqspwosP4YrarKZOW0j8q 14VN3YsmGmV6qvlKO37eDfySyQaQ5aZxxS7v+nJ6OGTo8PXv1q4eixtVGV+QfVHcbxOw7j NPoiGVx8PTIkLdsAHqa3zrBBC+lNMtYgP7xYcIojZCikGFor7rwBt+mNfdJhrP5tvYt9kz gGEFhNTW1zLg5OyjBvmeSdRl5nct3iJMwHvjvbWUY1f2wN2kHG4Hj6R/67Tzxg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456417; 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=Ws/VqRx/ni+sKh0jn4IQvuxfNX+2ppHoac+ZsQScPP4=; b=xNAQszfigF8j2EqFCR1weWXRwHXR9Vt3Qy1Emlx2lDeEaZAVnYyiR9Viln+C/mfnjOZ1Ov s+e9kzInJ3jBCL1W1tgbvrHEc/PXfoRLRHFEEM+svU/sekPv2joO9oGEOBnlnZ++6kHT2Q 3lI/fPeUEXQ5qjO6LlC1hq9jxhWkWRnG7MZeUcIvxY3u9jL6XunMyIcg16ZmjD+3r7Qeg6 Rh8R0FRPtpa/MYqbX8ZW4pe5eJxc6O1Lsv2P0w51ERjrNnISGe+IOnX/eDf20vAXLxrA50 CskmMZccDyX4t6uPRgB6p9mT3V9xgR8ft91wBZpXmlu6HwHbNDdV/JpwZ5p3hQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756456417; a=rsa-sha256; cv=none; b=CEcvZsUBnucJ/VkPtchnIKx72zrs959R0/ea6LD2ExpCj24C0sjyioM7XJzxwTDmjgYRNr x5H81oAWBJyczDzP/LJnrp+sXDL/oEnt7SFBgIm14Co+gYEczkYLWKY0MEq45B83y+MJKt TwR1s2XEajo5oPnByy5cE982p+WFEwQuIODYBmoOYI5Hog/8HKjUgDOPrx4z2ubbT3g8Jd 6aJt9+bceK8ihqPHahXj+D3HL32u6ri6ZVRr3GqQF7IL76rVnKBJYXSkwFBeXiZWyJ042k ELwl1zip2iaoTtovUNzZBT07M7m3BWLClzc845njk7Y7pGgruVq0EarBxVQnvg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCs413wtvzY9W; Fri, 29 Aug 2025 08:33:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T8XbQs047122; Fri, 29 Aug 2025 08:33:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8Xbeb047119; Fri, 29 Aug 2025 08:33:37 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:33:37 GMT Message-Id: <202508290833.57T8Xbeb047119@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 9785a09c52 - main - Avoid the use of "you" in the USB device mode chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9785a09c52236fdf3772a23f7b9079b166a8c69a Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=9785a09c52236fdf3772a23f7b9079b166a8c69a commit 9785a09c52236fdf3772a23f7b9079b166a8c69a Author: Benedict Reuschling AuthorDate: 2025-08-28 15:56:46 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 08:33:13 +0000 Avoid the use of "you" in the USB device mode chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52219 --- .../content/en/books/handbook/usb-device-mode/_index.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc index 224412d35f..1ca78d5dfd 100644 --- a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc +++ b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc @@ -75,7 +75,7 @@ Note that in some cases, depending on the hardware and the hosts operating syste When FreeBSD is running on the host, man:usbconfig[8] `reset` can be used. This also must be done after loading [.filename]#usb_template.ko# if the USB host was already connected to the USBOTG socket. -After reading this chapter, you will know: +Read this chapter to learn: * How to set up USB Device Mode functionality on FreeBSD. * How to configure the virtual serial port on FreeBSD. @@ -141,7 +141,7 @@ To load the module and set the template without rebooting use: To connect to a board configured to provide USB device mode serial ports, connect the USB host, such as a laptop, to the boards USB OTG or USB client port. Use `pstat -t` on the host to list the terminal lines. -Near the end of the list you should see a USB serial port, e.g. "ttyU0". +Near the end of the list a USB serial port is shown, e.g. "ttyU0". To open the connection, use: [source,shell] @@ -149,7 +149,7 @@ To open the connection, use: # cu -l /dev/ttyU0 .... -After pressing the kbd:[Enter] key a few times you will see a login prompt. +After pressing the kbd:[Enter] key a few times a login prompt appears. === Connecting to USB Device Mode Serial Ports from macOS @@ -174,10 +174,10 @@ To open the connection, use: === Connecting to USB Device Mode Serial Ports from Microsoft Windows 10 To connect to a board configured to provide USB device mode serial ports, connect the USB host, such as a laptop, to the boards USB OTG or USB client port. -To open a connection you will need a serial terminal program, such as PuTTY. +To open a connection a serial terminal program is needed, such as PuTTY. To check the COM port name used by Windows, run Device Manager, expand "Ports (COM & LPT)". -You will see a name similar to "USB Serial Device (COM4)". -Run serial terminal program of your choice, for example PuTTY. +A name similar to "USB Serial Device (COM4)" appears. +Run the serial terminal program of choice, for example PuTTY. In the PuTTY dialog set "Connection type" to "Serial", type the COMx obtained from Device Manager in the "Serial line" dialog box and click Open. [[usb-device-mode-network]] From nobody Fri Aug 29 08:35:20 2025 X-Original-To: dev-commits-doc-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 4cCs6106Bgz66LmJ for ; Fri, 29 Aug 2025 08:35:21 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCs606xtPz471B; Fri, 29 Aug 2025 08:35:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456520; 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=0We4E+0x0fbn4+g9BsrPJl5AX5onemzlFb7feOnNHFI=; b=xg34hiYbiflC/71SgCcxx3wsWp8m/zKOjAmqC+o6BjHax/xnKVCyYtDOm93pA5YIeB+PR6 p+9181spx6G0sqY5MM9U0tFg5I+wnQ9/Ksgqtx5aGf7Cve2SsBo195+QynZcqanH5adpL0 NSzY+8nrpUf3N4PHo//WP7OPhrRrFaGaROJ05Hmrbe4BJHe/n+2208a2b+NcG6DNUy3OS2 uEjTPiHkID5W35Bxksyp9hCmwaL1fPeQ0Az27DifDeIrgz8A/ZqAzPeswWofvSPydZzOMI Hk4pECNgPx41mzcIwPKp4sM3Mgk1/b6FU0hmomze7/s/Al6Aame7yd8sCaC9sg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456520; 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=0We4E+0x0fbn4+g9BsrPJl5AX5onemzlFb7feOnNHFI=; b=IixR/me3WRklKl4OBWJOo73wCsXQUkcF0RrV/H42WK5GmiVfUN8+RtXBm35ECvwoVtnrf+ MVsQpN26htlMUid1Zon6VEzK/ZnbpDdkvCsnrg58hFFrrMu+t7v/Ed/uHGJ6vb4b8lcRIf B5gxYiTucoXgxe21KKnlnL+HCkSyb8uucVYZZYlvcu6Z8TlqpQ96vvfat5603TOvhRknW4 UhCOkU9zJDR0lt+teHsK1W19n/vFmFabxi+pa+MDoeaXpkxZATCu/xvc6PkM1SVUT/nqgr cQhuF+hvIb3NBNdQV/DOpNbDw2FmiY5GtP9jw5PqlW7aPA3qDhaWKZ3zTJFSbw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756456520; a=rsa-sha256; cv=none; b=svqm7oQdfkCWQM2ovW2mcV84aQ9K+zsuATL4dItq8TcYpYTn5hXOliEKdymtFojFv4l+/g mRYOYdNA+cWwoVHDepLMvGirX5y/sKN3WcVPVIKALjSgHikzM01ErbRbUZRf/BDEsc+tEF 4pxmUGFtRvzCxx+ogCfUyivzcZqEQMjVL2wy1E7VA/JqhpcueAIq+oUwirlxMsgeCuKCdh iO5IyqNYNitgqnNlYzFqI8AJhVED5obT5WkKXZ0AagAbho9uMN9vLbEujWhh74H/9MLuad FiEri//9yloeAVot9BHNCE1GLW147bIUdVGxxxgMUIItHHS+E8OP0iCyOAgd3g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCs606LLrzXSp; Fri, 29 Aug 2025 08:35:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T8ZKEj047750; Fri, 29 Aug 2025 08:35:20 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8ZKv7047747; Fri, 29 Aug 2025 08:35:20 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:35:20 GMT Message-Id: <202508290835.57T8ZKv7047747@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 4fe400069b - main - Avoid the use of "you in the virtualization chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4fe400069b9473b1403bafdd04e1893bf2d898c3 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=4fe400069b9473b1403bafdd04e1893bf2d898c3 commit 4fe400069b9473b1403bafdd04e1893bf2d898c3 Author: Benedict Reuschling AuthorDate: 2025-08-28 16:00:39 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 08:34:57 +0000 Avoid the use of "you in the virtualization chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52220 --- .../en/books/handbook/virtualization/_index.adoc | 78 +++++++++++----------- 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc index aa264bc80d..bd9dc39007 100644 --- a/documentation/content/en/books/handbook/virtualization/_index.adoc +++ b/documentation/content/en/books/handbook/virtualization/_index.adoc @@ -55,7 +55,7 @@ endif::[] Virtualization software allows multiple operating systems to run simultaneously on the same computer. Such software systems for PCs often involve a host operating system which runs the virtualization software and supports any number of guest operating systems. -After reading this chapter, you will know: +Read this chapter to learn: * The difference between a host operating system and a guest operating system. * How to install FreeBSD on the following virtualization platforms: @@ -66,7 +66,7 @@ After reading this chapter, you will know: ** bhyve(FreeBSD) * How to tune a FreeBSD system for best performance under virtualization. -Before reading this chapter, you should: +Before reading this chapter: * Understand the crossref:basics[basics,basics of UNIX(R) and FreeBSD]. * Know how to crossref:bsdinstall[bsdinstall,install FreeBSD]. @@ -424,7 +424,7 @@ All users that need access to VirtualBox(TM) will have to be added as members of [source,shell] .... -# pw groupmod vboxusers -m yourusername +# pw groupmod vboxusers -m username .... The default permissions for [.filename]#/dev/vboxnetctl# are restrictive and need to be changed for bridged networking: @@ -463,7 +463,7 @@ For VirtualBox(TM) to be aware of USB devices attached to the machine, the user [source,shell] .... -# pw groupmod operator -m yourusername +# pw groupmod operator -m username .... Then, add the following to [.filename]#/etc/devfs.rules#, or create this file if it does not exist yet: @@ -747,7 +747,7 @@ After a successful installation, QEMU will boot the operating system installed o [NOTE] ==== QEMU supports a ```-runas``` option. -For added security, include the option "-runas your_user_name" in the script listing above. +For added security, include the option "-runas user_name" in the script listing above. See man:qemu[1] for details. ==== @@ -1170,7 +1170,7 @@ image::qemu-freebsd16.png[] Reboot the system, and before FreeBSD starts up, switch to the monitor and enter `stop`. The VM will stop. -Enter `loadvm` with the tag you used above (here `original_install`). +Enter `loadvm` with the tag used above (here `original_install`). [source, shell] .... @@ -1413,7 +1413,7 @@ Now the guest can be started from the virtual disk: [[virtualization-bhyve-linux]] === Creating a Linux(R) Guest -Linux guests can be booted either like any other regular crossref:virtualization[virtualization-bhyve-uefi,"UEFI-based guest"] virtual machine, or alternatively, you can make use of the package:sysutils/grub2-bhyve[] port. +Linux guests can be booted either like any other regular crossref:virtualization[virtualization-bhyve-uefi,"UEFI-based guest"] virtual machine, or alternatively, use the package:sysutils/grub2-bhyve[] port. To do this, first ensure that the port is installed, then create a file to use as the virtual disk for the guest machine: @@ -1503,9 +1503,9 @@ Boot the virtual machine: -s 3:0,virtio-blk,./linux.img -l com1,stdio -c 4 -m 1024M linuxguest .... -Linux(R) will now boot in the virtual machine and eventually present you with the login prompt. +Linux(R) will now boot in the virtual machine and eventually presents the login prompt. Login and use the virtual machine. -When you are finished, reboot the virtual machine to exit bhyve. +When finished, reboot the virtual machine to exit bhyve. Destroy the virtual machine instance: [source,shell] @@ -1522,7 +1522,7 @@ This option may support guest operating systems that are not supported by the ot To make use of the UEFI support in bhyve, first obtain the UEFI firmware images. This can be done by installing package:sysutils/bhyve-firmware[] port or package. -With the firmware in place, add the flags `-l bootrom,_/path/to/firmware_` to your bhyve command line. +With the firmware in place, add the flags `-l bootrom,_/path/to/firmware_` to the bhyve command line. The actual bhyve command may look like this: [source,shell] @@ -1534,7 +1534,7 @@ The actual bhyve command may look like this: guest .... -To allow a guest to store UEFI variables, you can use a variables file appended to the `-l` flag. +To allow a guest to store UEFI variables, use a variables file appended to the `-l` flag. Note that bhyve will write guest modifications to the given variables file. Therefore, be sure to first create a per-guest-copy of the variables template file: @@ -1543,7 +1543,7 @@ Therefore, be sure to first create a per-guest-copy of the variables template fi # cp /usr/local/share/uefi-firmware/BHYVE_UEFI_VARS.fd /path/to/vm-image/BHYVE_UEFI_VARS.fd .... -Then, add that variables file into your bhyve arguments: +Then, add that variables file to the bhyve arguments: [source,shell] .... @@ -1641,7 +1641,7 @@ A detailed description for this process can be found on the link:https://wiki.fr [WARNING] ==== Modifying Windows installation media and running Windows guests without a TPM module are unsupported by the manufacturer. -Consider your application and use case before implementing such approaches. +Consider the application and use case before implementing such approaches. ==== [[virtualization-bhyve-zfs]] @@ -1664,7 +1664,7 @@ When starting the VM, specify the ZFS volume as the disk drive: -l com1,stdio -c 4 -m 1024M linuxguest .... -If you are using ZFS for the host as well as inside a guest, keep in mind the competing memory pressure of both systems caching the virtual machine's contents. +When using ZFS for the host as well as inside a guest, keep in mind the competing memory pressure of both systems caching the virtual machine's contents. To alleviate this, consider setting the host's ZFS filesystems to use metadata-only cache. To do this, apply the following settings to ZFS filesystems on the host, replacing `` with the name of the specific zvol dataset name of the virtual machine. @@ -1762,7 +1762,7 @@ To verify successful activation of the snapshot feature, enter and check if the output lists a `--suspend` flag. If the flag is missing, the feature did not activate correctly. -Then, you can snapshot and suspend a running virtual machine of your choice: +Then, snapshot and suspend a running virtual machine of choice: [source,shell] .... @@ -1877,7 +1877,7 @@ add path 'tap10*' unhide [NOTE] ==== -If there's another devfs rule with the numeric ID 100 in your [.filename]#/etc/devfs.rules# file, replace the one in the listing with another yet unused ID number. +If there's another devfs rule with the numeric ID 100 in the [.filename]#/etc/devfs.rules# file, replace the one in the listing with another yet unused ID number. ==== [NOTE] @@ -1907,8 +1907,8 @@ Those rules can be expanded and varied with different guest and interface names [NOTE] ==== -If you intend to use bhyve on the host as well as in a one or more jails, remember that [.filename]#tap# and [.filename]#nmdm# interface names will operate in a shared environment. -For example, you can use [.filename]#/dev/nmdmbhyve0# only either for bhyve on the host or in a jail. +When intending to use bhyve on the host as well as in a one or more jails, remember that [.filename]#tap# and [.filename]#nmdm# interface names will operate in a shared environment. +For example, use [.filename]#/dev/nmdmbhyve0# only either for bhyve on the host or in a jail. ==== Restart devfs for the changes to be loaded: @@ -1918,8 +1918,8 @@ Restart devfs for the changes to be loaded: # service devfs restart .... -Then add a definition for your new jail into [.filename]#/etc/jail.conf# or [.filename]#/etc/jail.conf.d#. -Replace the interface number [.filename]#$if# and IP address with your personal variations. +Then add a definition for the new jail into [.filename]#/etc/jail.conf# or [.filename]#/etc/jail.conf.d#. +Replace the interface number [.filename]#$if# and IP address with personal variations. .Using NAT or routed traffic with a firewall [example] @@ -1937,7 +1937,7 @@ bhyve { exec.clean; - host.hostname = "your-hostname-here"; + host.hostname = "the-hostname-here"; vnet; vnet.interface = "jail${if}"; path = "/jails/${name}"; @@ -1955,7 +1955,7 @@ bhyve { } .... -This example assumes use of a firewall like `pf` or `ipfw` to NAT your jail traffic. +This example assumes use of a firewall like `pf` or `ipfw` to NAT the jail traffic. See the crossref:firewalls[,Firewalls] chapter for more details on the available options to implement this. ==== .Using a bridged network connection @@ -1974,7 +1974,7 @@ bhyve { exec.clean; - host.hostname = "your-hostname-here"; + host.hostname = "the-hostname-here"; vnet; vnet.interface = "jail${if}"; path = "/jails/${name}"; @@ -1995,7 +1995,7 @@ bhyve { [NOTE] ==== -If you previously replaced the devfs ruleset ID 100 in [.filename]#/etc/devfs.rules# with your own unique number, remember to replace the numeric ID also in your [.filename]#jails.conf# too. +Having previously replaced the devfs ruleset ID 100 in [.filename]#/etc/devfs.rules# with a custom unique number, remember to replace the numeric ID also in the [.filename]#jails.conf# too. ==== [[virtualization-bhyve-jailed-config]] @@ -2023,7 +2023,7 @@ Restart and enable the jail: # service jail restart bhyve .... -Afterwards, you can create a virtual machine within the jail. +Afterwards, create a virtual machine within the jail. For a FreeBSD guest, download an installation ISO first: [source,shell] @@ -2052,7 +2052,7 @@ Skipping this step may cause the following error message when starting `bhyve`: `vm_open: vm-name could not be opened. No such file or directory` ==== -Finally, use your preferred way of starting the guest. +Finally, use the preferred way of starting the guest. .Starting with `vmrun.sh` and ZFS [example] @@ -2083,7 +2083,7 @@ Using `vmrun.sh` on a UFS filesystem: .Starting bhyve for an UEFI guest with ZFS [example] ==== -If instead you want to use an UEFI guest, remember to first install the required firmware package package:sysutils/bhyve-firmware[] in the jail: +When wanting to use an UEFI guest, remember to first install the required firmware package package:sysutils/bhyve-firmware[] in the jail: [source,shell] .... @@ -2106,7 +2106,7 @@ Then use `bhyve` directly: bhyvevm0 .... -This will allow you to connect to your virtual machine `bhyvevm0` through VNC as well as a serial console at [.filename]#/dev/nmdbbhyve0B#. +This allows connecting to the virtual machine `bhyvevm0` through VNC as well as a serial console at [.filename]#/dev/nmdbbhyve0B#. ==== [[virtualization-bhyve-nmdm]] @@ -2139,7 +2139,7 @@ For security reasons, it's therefore recommended to logout before disconnecting. The number in the [.filename]#nmdm# device path must be unique for each virtual machine and must not be used by any other processes before bhyve starts. The number can be chosen arbitrarily and does not need to be taken from a consecutive sequence of numbers. The device node pair (i.e. [.filename]#/dev/nmdm0a# and [.filename]#/dev/nmdm0b#) are created dynamically when bhyve connects its console and destroyed when it shuts down. -Keep this in mind when creating scripts to start your virtual machines: you need to make sure that all virtual machines are assigned unique [.filename]#nmdm# devices. +Keep this in mind when creating scripts to start the virtual machines: make sure that all virtual machines are assigned unique [.filename]#nmdm# devices. [[virtualization-bhyve-managing]] === Managing Virtual Machines @@ -2225,7 +2225,7 @@ In order to configure the system to start bhyve guests at boot time, some config [.procedure] . [.filename]#/etc/sysctl.conf# + -When using [.filename]#tap# interfaces as network backend, you either need to manually set each used [.filename]#tap# interface to UP or simply set the following sysctl: +When using [.filename]#tap# interfaces as network backend, either manually set each used [.filename]#tap# interface to UP or simply set the following sysctl: + [.programlisting] .... @@ -2234,9 +2234,9 @@ net.link.tap.up_on_open=1 . [.filename]#/etc/rc.conf# + -To connect your virtual machine's [.filename]#tap# device to the network via a [.filename]#bridge#, you need to persist the device settings in [.filename]#/etc/rc.conf#. -Additionally, you can load the necessary kernel modules `vmm` for bhyve and `nmdm` for [.filename]#nmdm# devices through the `kld_list` configuration variable. -When configuring `ifconfig_bridge0`, make sure to replace `/` with the actual IP address of your physical interface ([.filename]#igb0# in this example) and remove IP settings from your physical device. +To connect the virtual machine's [.filename]#tap# device to the network via a [.filename]#bridge#, persisting the device settings in [.filename]#/etc/rc.conf# is needed. +Additionally, load the necessary kernel modules `vmm` for bhyve and `nmdm` for [.filename]#nmdm# devices through the `kld_list` configuration variable. +When configuring `ifconfig_bridge0`, make sure to replace `/` with the actual IP address of the physical interface ([.filename]#igb0# in this example) and remove IP settings from the physical device. + [source,shell] .... @@ -2250,7 +2250,7 @@ When configuring `ifconfig_bridge0`, make sure to replace `/` w .Setting the IP for a bridge device [example] ==== -For a host with an _igb0_ interface connected to the network with IP `10.10.10.1` and netmask `255.255.255.0`, you would use the following commands: +For a host with an _igb0_ interface connected to the network with IP `10.10.10.1` and netmask `255.255.255.0`, use the following commands: [source,shell] .... @@ -2263,7 +2263,7 @@ For a host with an _igb0_ interface connected to the network with IP `10.10.10.1 [WARNING] ==== -Modifying the IP address configuration of a system may lock you out if you are executing these commands while you are connected remotely (i.e. via SSH)! +Modifying the IP address configuration of a system may terminate the current remote connection (e.g., via SSH), causing a lock out. Take precautions to maintain system access or make those modifications while logged in on a local terminal session. ==== @@ -2509,9 +2509,9 @@ This section contains basic information in order to help troubleshoot issues fou ==== Host Boot Troubleshooting Please note that the following troubleshooting tips are intended for Xen(TM) 4.11 or newer. -If you are still using Xen(TM) 4.7 and having issues, consider migrating to a newer version of Xen(TM). +When still using Xen(TM) 4.7 and having issues, consider migrating to a newer version of Xen(TM). -In order to troubleshoot host boot issues, you will likely need a serial cable, or a debug USB cable. +In order to troubleshoot host boot issues, a serial cable or a debug USB cable is needed. Verbose Xen(TM) boot output can be obtained by adding options to the `xen_cmdline` option found in [.filename]#loader.conf#. A couple of relevant debug options are: @@ -2555,6 +2555,6 @@ libxl: debug: libxl_dom.c:988:libxl__load_hvm_firmware_module: Loading BIOS: /us .... If the verbose output does not help diagnose the issue, there are also QEMU and Xen(TM) toolstack logs in [.filename]#/var/log/xen#. -Note that the name of the domain is appended to the log name, so if the domain is named `freebsd` you should find a [.filename]#/var/log/xen/xl-freebsd.log# and likely a [.filename]#/var/log/xen/qemu-dm-freebsd.log#. +Note that the name of the domain is appended to the log name, so if the domain is named `freebsd` find a [.filename]#/var/log/xen/xl-freebsd.log# and likely a [.filename]#/var/log/xen/qemu-dm-freebsd.log#. Both log files can contain useful information for debugging. -If none of this helps solve the issue, please send the description of the issue you are facing and as much information as possible to mailto:freebsd-xen@FreeBSD.org[freebsd-xen@FreeBSD.org] and mailto:xen-devel@lists.xenproject.org[xen-devel@lists.xenproject.org] in order to get help. +If none of this helps solve the issue, please send the description of the issue and as much information as possible to mailto:freebsd-xen@FreeBSD.org[freebsd-xen@FreeBSD.org] and mailto:xen-devel@lists.xenproject.org[xen-devel@lists.xenproject.org] to get help. From nobody Fri Aug 29 09:26:48 2025 X-Original-To: dev-commits-doc-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 4cCtFN4L9pz66PwY for ; Fri, 29 Aug 2025 09:26:48 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCtFN3Nx7z4DlT; Fri, 29 Aug 2025 09:26:48 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756459608; 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=rbG1vyNn3qfHY9GBhp15NQw5IDp8Sx6pu6zm3U7Vugg=; b=Zi8HRtHnIlKy/F7yG/zQcZ6/xnraFUlptsc2bULLMQVg9erZEa6sPgyHkueeo89yCfKXU5 I78Y+uZzcitCx4YP+hCke0wUGiXbziQpwpy3yKahi9e4LRLcVtMBitHmWMIKM23+myg6mo LD5Iv5AyHYvfUQYy9T+YNAiv/Us3fbbYIl6+iLpQ2BWXJUFaQyNcsXUEm/ET8fWQGorIZl fRYw5orO1CAeFLIs/REVlm58ifnDVgisbJmpoJFH/fFySt5vXRmzNC9v/mgXcvo1KRR9rx Huk9pTs7zzdea9zowC68M1fDUfnOl9UO6hgBAWVXffGpZr0CJ9N1lzDCahCHZg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756459608; 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=rbG1vyNn3qfHY9GBhp15NQw5IDp8Sx6pu6zm3U7Vugg=; b=XUpZcNjxFOKYuorpVjKohZq3fdPU3J1fn0HhzH/E4e5I2JhtwDnvHyW8X4i5ZGDMrUg6nc 73jVkCKABVO8libt+Z7E7Coino68P0EgAgQWz+yfzewPUJsPJDGIHNcPyvapGsC+DZRm0S kMXSnIyXX0bsS2r4VP6dp5JPkttFnTObeXO8ua48IFO+agwEALR58P7XV0JSrE/kXuR+tf Fksntxn4O/p8XGzGEj5jneUgS6uTfK/bUe7N40ZjoY2l7eHNZhlNVDVncRpZgjn0Cp07p7 ri3sVB25hwnAWoevIAmOBtkouMljwx8kOojYWhyA2Hu9DWE4Luza1wKDr6XnqQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756459608; a=rsa-sha256; cv=none; b=uS+Qohya5feqi8bCXRQ3oJb36997BNV+XboU0lPGu6EmJNdzzkO+i4WhWm2tbX3c2YLVTR 1/e9/xGoMeUP4u0/3mv2W+nkrTTBZaHfrVuvkjl8b3b4h4C3lpFgUB5Mm9tixTabuuFGex JSjKHVkejvPsLW6QuzcQ5KiqmbguL3aHdQpMoXMtTy1LruWDVXlq+T7wBq1wu3ien7gYTm KO3gEZjTFCD8cSAcY5Az6lS+oF2XxMcFo7oftgO2YrhMDEUbylTJDcd/egv3DDYXuNpNgT Gbxxaf96E2VdzDxL6jARkzelPDGjtXqmL5vXy65kyiTNuBA90yjAtOaify5Q4w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCtFN2y8ZzZWt; Fri, 29 Aug 2025 09:26:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T9Qmfl041544; Fri, 29 Aug 2025 09:26:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T9QmPE041541; Fri, 29 Aug 2025 09:26:48 GMT (envelope-from git) Date: Fri, 29 Aug 2025 09:26:48 GMT Message-Id: <202508290926.57T9QmPE041541@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 02857856ac - main - Status/2025Q2/intro.adoc: Fixes List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 02857856ac329eba9f7c2e6c7c10d2e6def1e642 Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=02857856ac329eba9f7c2e6c7c10d2e6def1e642 commit 02857856ac329eba9f7c2e6c7c10d2e6def1e642 Author: Graham Perrin AuthorDate: 2025-08-29 09:24:43 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-29 09:26:29 +0000 Status/2025Q2/intro.adoc: Fixes Pull Request: https://github.com/freebsd/freebsd-doc/pull/544 --- website/content/en/status/report-2025-04-2025-06/intro.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/content/en/status/report-2025-04-2025-06/intro.adoc b/website/content/en/status/report-2025-04-2025-06/intro.adoc index 3dcc419a3e..f71ed66788 100644 --- a/website/content/en/status/report-2025-04-2025-06/intro.adoc +++ b/website/content/en/status/report-2025-04-2025-06/intro.adoc @@ -3,14 +3,14 @@ Here is the second 2025 status report, with 32 entries. As for the preceding quarters, this report is published just a few days before calls for 2025Q3 report submissions are sent. Indeed, although according to our link:https://docs.freebsd.org/en/articles/freebsd-status-report-process/#_timeline[timeline] we should have published this report in July (general rule is publication should happen within the month just after the calls for reports are sent), we kept receiving important reports until the end of August. This is both a positive and a negative thing. -On a hand, it means that our FreeBSD community is busy fixing existing issues and implementing new features, making the OS we love better and better every day; it means that the community works so intensely that very little time remains for reporting. +On one hand, it means that our FreeBSD community is busy fixing existing issues and implementing new features, making the OS we love better and better every day; it means that the community works so intensely that very little time remains for reporting. On the other hand, it means that news in these reports is always two months old when published. Two months is not bad, especially if we consider that FreeBSD communication happens on many other channels too, but it would be nice if we could improve it. If you are a late submitter, please take some time to evaluate if there is anything you can do to improve your report submission punctuality. -The Status team is always glad to ease the submission process: if there is something we can do for you, just ask. -If you are a contributor or just a FreeBSD user, please consider contributing more if you can. -Even working on a single small simple task only is useful, it can help to lower the pressure on other developers, for whom it might thus become easier to find the time to document their work. +The Status Team is always glad to ease the submission process: if there is something we can do for you, just ask. +If you are a contributor or just a FreeBSD user, please consider contributing, more if you can. +Even working on a single small simple task is useful, it can help to lower the pressure on other developers, for whom it might thus become easier to find the time to document their work. Have a nice reading! From nobody Fri Aug 29 09:57:34 2025 X-Original-To: dev-commits-doc-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 4cCtwt52y6z66S9w for ; Fri, 29 Aug 2025 09:57:34 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCtwt4Tjqz4Jhs; Fri, 29 Aug 2025 09:57:34 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756461454; 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=pVf7fS6/9JrHya3VyOpwv2GD4hJZw9TqL7e7yJ33rKQ=; b=G7ohi98ME4Lnh6Rm6Dlw3eHItmuPz8KbgUTmPKKgDlutVyeEXVFN4P6U6MZs8/MEP8NmBM XYZK9+FoikTO92KuFPqGAqSbVmPz+pNoeFykHt0M8hxN9nekMF6y5e0TvDSsdF66IevW8a usZnaJ5F9zbpZcnvqWITpLq6nyLUWagNz/zVtnY6n2GQH6dwx5cKpkcglMe98YSbsEGdkS ZIY+SnEgVZDY35rHu34sxPPlpyNW5g3VtBDUAcb2Vuurh92sv1xlzBgKLs5+XP3heA3BaL oMuRqit3C7pcL1R5IMYTIPNO40MF4V1EDZfC6h7ymbLt9EWAZ67Fb6PfdErbJg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756461454; 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=pVf7fS6/9JrHya3VyOpwv2GD4hJZw9TqL7e7yJ33rKQ=; b=pRECCFg9jnTmW4H3xNsxRXkapgDlF1LPXc+vrfGnxReW2hZFdTdcfuCbqReBdSNfZ+VpnJ 1iLdVudxWHaQAyaY7R8JNb60+LH7r1lr6Id0CSyGQDbyroDTLHFqnyaw5qSyPdkE8+b56H jjw43HBCfwZ8zmVOM6XuK77m1efRevBbeU56lsJeGd/Or2AiylQ9yiYteMZIm5mIk6d0qR R4oEta/UN4n2jmIXNho02Ip8GzNYTSrvD2SVDys7CcjyxPed1zmAPmzkhZmjfmo1MCHOR3 b6nvnCuCYQckmlZceayD0goxIApNTcvFTMRCiBdmJLigIvx+kwX/6AGm3I2Bhg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756461454; a=rsa-sha256; cv=none; b=Z4nwvUuoYrwvrID5WhcxuPe0HRVLUD8DubWciHKT2EKpE09QwYHsF5utFQoe7hOv5wdwyM 9wQr/bxIQ1TJRxYKugSlO6y4TUHfgwxeZ7IcSj6VzikN7zyENaaDM0g5Bnt3lHH+1NKNso 8lOVV7ddPd7ojZfJl2TglPQoo+kY8zLg8mdgmetYvAo1SkrMA7E9gKS/cr1amN1OKPGzIM 2GtEzgQvgSempJnUJpFPwSMCSXyVEpok7ZiiJs6p2aVTQ1yjbmFutkDHGMmk+BAq018WRr 7cEonwt7Y66WVWSyYjhstuXGv4Dhknac1xOPlCvMCdOSrCjfbrOSWZi3MJr/KA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCtwt40nlzbSg; Fri, 29 Aug 2025 09:57:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57T9vY0q097423; Fri, 29 Aug 2025 09:57:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T9vYic097420; Fri, 29 Aug 2025 09:57:34 GMT (envelope-from git) Date: Fri, 29 Aug 2025 09:57:34 GMT Message-Id: <202508290957.57T9vYic097420@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: f19e4a3dba - main - Remove whitespaces at end of lines List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f19e4a3dba75997d809c74f349247ad54e17176e Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=f19e4a3dba75997d809c74f349247ad54e17176e commit f19e4a3dba75997d809c74f349247ad54e17176e Author: Benedict Reuschling AuthorDate: 2025-08-29 09:50:53 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 09:57:22 +0000 Remove whitespaces at end of lines No content changes. --- .../en/books/handbook/advanced-networking/_index.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc index 33da0682cf..6bade200be 100644 --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc @@ -1325,7 +1325,7 @@ cu -l $PTS By default, when FreeBSD is accepting a new connection, it tries to perform a role switch and become master. Some older Bluetooth devices which do not support role switching will not be able to connect. -Since role switching is performed when a new connection is being established, it is not possible to ask the remote device if it supports role switching. +Since role switching is performed when a new connection is being established, it is not possible to ask the remote device if it supports role switching. However, there is a HCI option to disable role switching on the local side: [source,shell] @@ -1454,7 +1454,7 @@ The STP protocol detects loops and puts redundant links into a blocked state. Should one of the active links fail, STP calculates a different tree and enables one of the blocked paths to restore connectivity to all points in the network. The Rapid Spanning Tree Protocol (RSTP or 802.1w) provides backwards compatibility with legacy STP. -RSTP provides faster convergence and exchanges information with neighboring switches to quickly transition to forwarding mode without creating loops. +RSTP provides faster convergence and exchanges information with neighboring switches to quickly transition to forwarding mode without creating loops. FreeBSD supports RSTP and STP as operating modes, with RSTP being the default mode. STP can be enabled on member interfaces using man:ifconfig[8]. @@ -1527,7 +1527,7 @@ Sticky entries are never aged out of the cache or replaced, even if the address This gives the benefit of static address entries without the need to pre-populate the forwarding table. Clients learned on a particular segment of the bridge cannot roam to another segment. + -An example of using sticky addresses is to combine the bridge with VLANs in order to isolate customer networks without wasting IP address space. +An example of using sticky addresses is to combine the bridge with VLANs in order to isolate customer networks without wasting IP address space. Consider that `CustomerA` is on `vlan100`, `CustomerB` is on `vlan101`, and the bridge has the address `192.168.0.1`: + [source,shell] @@ -1558,7 +1558,7 @@ The following example sets the maximum number of Ethernet devices for `CustomerA # ifconfig bridge0 ifmaxaddr vlan100 10 .... -Bridge interfaces also support monitor mode, where the packets are discarded after man:bpf[4] processing and are not processed or forwarded further. +Bridge interfaces also support monitor mode, where the packets are discarded after man:bpf[4] processing and are not processed or forwarded further. This can be used to multiplex the input of two or more interfaces into a single man:bpf[4] stream. This is useful for reconstructing the traffic for network taps that transmit the RX/TX signals out through two separate interfaces. For example, to read the input from four network interfaces as one stream: @@ -1688,7 +1688,7 @@ Each LAG is composed of ports of the same speed, set to full-duplex operation, a Typically, there is only one LAG which contains all the ports. In the event of changes in physical connectivity, LACP will quickly converge to a new configuration. + -LACP balances outgoing traffic across the active ports based on hashed protocol header information and accepts incoming traffic from any active port. +LACP balances outgoing traffic across the active ports based on hashed protocol header information and accepts incoming traffic from any active port. The hash includes the Ethernet source and destination address and, if available, the VLAN tag, and the IPv4 or IPv6 source and destination address. roundrobin:: @@ -1844,7 +1844,7 @@ ifconfig_lagg0="laggproto failover laggport fxp0 laggport fxp1 10.0.0.15/24" [example] ==== -For laptop users, it is usually desirable to configure the wireless device as a secondary which is only used when the Ethernet connection is not available. +For laptop users, it is usually desirable to configure the wireless device as a secondary which is only used when the Ethernet connection is not available. With man:lagg[4], it is possible to configure a failover which prefers the Ethernet connection for both performance and security reasons, while maintaining the ability to transfer data over the wireless connection. This is achieved by overriding the Ethernet interface's MAC address with that of the wireless interface. From nobody Fri Aug 29 11:49:35 2025 X-Original-To: dev-commits-doc-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 4cCxQ80G7tz65NLd for ; Fri, 29 Aug 2025 11:49:36 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCxQ75CK0z3Flr; Fri, 29 Aug 2025 11:49:35 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756468175; 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=80eJtVK3NCRQekl2ZVyoRQYIDB90f1al1Y25iJZmPf4=; b=UslrmVjD2ohHaPdx++k0X6IjbZzqf43MBqWC2aUFkl8ZeX/9n32mAysWsXYjQfZeUS27UR HTJBOCotauBaUnQtaUWtimI5I4NpByEQ1cRd+GgBSPqQFT/uhO4hQXeVnIfIBBJRY5DwrR GZNy8MUUvXLNza3tYvY+vCwpeiKaiO4TkwN400npNEdqUoLeXHpDPD6lCOf41sHkGkSVME 0gRTqztMLuCcYf3beR6mrgAkTmSp/Vod4V3GMBpJdI7azvg1s5uIpTIicsN+9i1ZFf5hJs eROBgVzxlxM8o4+igzTz9bTv8NB6yZpqoMuf6GMU8ZQZTcw3bt4vKjuF2X5nNA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756468175; 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=80eJtVK3NCRQekl2ZVyoRQYIDB90f1al1Y25iJZmPf4=; b=Xx0zeW7TyeleqvAh3gloUrcznf0/j8ZgwDPbAdymxyhkrN4+EqDdozoxOjjZWzjxc9vosx n6kJtK2pU74sWbIzki8ema6nRZ5TqeVLnlfCjYhAGYdbFMtSMqyIs2C5f16KSXCInZrIFt 3oV8f9JU4RSu3ArBUh2dOY+HHe6HRpQU6p5ExvIPn0C/3KlTe+i343pXND/k0OE4ARg0hu ETjAP680iKr0uVnkedynDpKu4kuV766JLcVxZeLdqbQ0MXax1aS7dsI9s+Mfw/zACr/n39 +cilMw/aR7+tsZxg8HzsTxcytc+CgtAOWWQEPOVZN7DIAGM0MimZM2gMeQWaPA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756468175; a=rsa-sha256; cv=none; b=aUxxI+NIuGwGbxdq4gk2KMs7BL8X6x9vqLhd43UBsRXpLznFQdN4SOQkdZhFppnwnhLa7F JrhWV7mc3O7zErB6gNzbxUGKreeNf2+uH2U/fT+zF5p+i/gaLv1UYmOjwbvtdUJQIiN6F0 oev5wXUiCLoiMp9JuBWtDhtIaLdG6Yocw0SfWaIO2uZoLUV8H6qnP3ioFuWrg51tEZdg1Q OGDwgCDIw06DMgmB0qfR21hqYg5FDmsnyx3ejTJgzUYIID7qDOOySxuxV/5p4AUdRp3kM7 c8K0SJUYt8QwF6++Mjc99/m8ctSV4BVBP3CtQ0hITl4WILTQqprD1ACi2Dmn+Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCxQ74kYyzfGB; Fri, 29 Aug 2025 11:49:35 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57TBnZjJ001939; Fri, 29 Aug 2025 11:49:35 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57TBnZ53001936; Fri, 29 Aug 2025 11:49:35 GMT (envelope-from git) Date: Fri, 29 Aug 2025 11:49:35 GMT Message-Id: <202508291149.57TBnZ53001936@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: c886cdee08 - main - Status/2025Q2: Fixes List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c886cdee089683c0689955cc322520680959df11 Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=c886cdee089683c0689955cc322520680959df11 commit c886cdee089683c0689955cc322520680959df11 Author: Lorenzo Salvadore AuthorDate: 2025-08-29 09:50:20 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-29 11:49:18 +0000 Status/2025Q2: Fixes Various fixes, among which a comma that was added in the wrong place [1]. Reported by: Graham Perrin [1] Pull Request: https://github.com/freebsd/freebsd-doc/pull/544 [1] --- website/content/en/status/report-2025-04-2025-06/drm-drivers.adoc | 1 + .../en/status/report-2025-04-2025-06/freebsd-foundation.adoc | 2 +- website/content/en/status/report-2025-04-2025-06/gcc.adoc | 2 +- website/content/en/status/report-2025-04-2025-06/intro.adoc | 2 +- website/content/en/status/report-2025-04-2025-06/lkpi-wireless.adoc | 2 +- website/content/en/status/report-2025-04-2025-06/packrat.adoc | 2 +- .../content/en/status/report-2025-04-2025-06/ports-security.adoc | 6 +++--- website/content/en/status/report-2025-04-2025-06/usb-debugging.adoc | 2 +- 8 files changed, 10 insertions(+), 9 deletions(-) diff --git a/website/content/en/status/report-2025-04-2025-06/drm-drivers.adoc b/website/content/en/status/report-2025-04-2025-06/drm-drivers.adoc index 7ba18092d6..80b5451cbf 100644 --- a/website/content/en/status/report-2025-04-2025-06/drm-drivers.adoc +++ b/website/content/en/status/report-2025-04-2025-06/drm-drivers.adoc @@ -22,6 +22,7 @@ These updates target the FreeBSD 15-CURRENT development branch for now. Once kernel patches are accepted and the DRM drivers updates merged, we will evaluate if/how we can backport the kernel patches to earlier release branches (namely 14-STABLE). While waiting for review, we also started to work on two features which were unsupported on FreeBSD: + * https://github.com/freebsd/drm-kmod/pull/357[`DMA_BUF_IOCTL_EXPORT_SYNC_FILE` and `DMA_BUF_IOCTL_IMPORT_SYNC_FILE` ioctls] * https://github.com/freebsd/drm-kmod/pull/358[`DRM_IOCTL_SYNCOBJ_EVENTFD` ioctl] diff --git a/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc b/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc index cf92f014df..10dc68320f 100644 --- a/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc +++ b/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc @@ -83,7 +83,7 @@ link:https://wiki.freebsd.org/SummerOfCode2025Projects[Twelve projects] were acc ==== Continuous Integration and Workflow Improvement -As part of our continued support of the FreeBSD Project, the Foundation supports a full-time staff member dedicated to <<_continuous_integration,improving the Project's continuous integration system and test infrastructure>>. +As part of our continued support of the FreeBSD Project, the Foundation supports a full-time staff member dedicated to improving the Project's continuous integration system and test infrastructure. ==== Legal/FreeBSD IP diff --git a/website/content/en/status/report-2025-04-2025-06/gcc.adoc b/website/content/en/status/report-2025-04-2025-06/gcc.adoc index d3dcd0313c..63383daa3d 100644 --- a/website/content/en/status/report-2025-04-2025-06/gcc.adoc +++ b/website/content/en/status/report-2025-04-2025-06/gcc.adoc @@ -4,7 +4,7 @@ Links: + link:https://gcc.gnu.org/[GCC Project] URL: link:https://gcc.gnu.org/[] + link:https://gcc.gnu.org/gcc-12/[GCC 12 release series] URL: link:https://gcc.gnu.org/gcc-12/[] + link:https://gcc.gnu.org/gcc-13/[GCC 13 release series] URL: link:https://gcc.gnu.org/gcc-13/[] + -link:https://gcc.gnu.org/gcc-14/[GCC 14 release series] URL: link:https://gcc.gnu.org/gcc-14/[] +link:https://gcc.gnu.org/gcc-14/[GCC 14 release series] URL: link:https://gcc.gnu.org/gcc-14/[] + link:https://gcc.gnu.org/gcc-11/[GCC 15 release series] URL: link:https://gcc.gnu.org/gcc-15/[] + link:https://gcc.gnu.org/gcc-11/[GCC 16 release series] URL: link:https://gcc.gnu.org/gcc-16/[] + diff --git a/website/content/en/status/report-2025-04-2025-06/intro.adoc b/website/content/en/status/report-2025-04-2025-06/intro.adoc index f71ed66788..76a4956e75 100644 --- a/website/content/en/status/report-2025-04-2025-06/intro.adoc +++ b/website/content/en/status/report-2025-04-2025-06/intro.adoc @@ -9,7 +9,7 @@ Two months is not bad, especially if we consider that FreeBSD communication happ If you are a late submitter, please take some time to evaluate if there is anything you can do to improve your report submission punctuality. The Status Team is always glad to ease the submission process: if there is something we can do for you, just ask. -If you are a contributor or just a FreeBSD user, please consider contributing, more if you can. +If you are a contributor or just a FreeBSD user, please consider contributing more, if you can. Even working on a single small simple task is useful, it can help to lower the pressure on other developers, for whom it might thus become easier to find the time to document their work. Have a nice reading! diff --git a/website/content/en/status/report-2025-04-2025-06/lkpi-wireless.adoc b/website/content/en/status/report-2025-04-2025-06/lkpi-wireless.adoc index 85858bb08f..c36d29c290 100644 --- a/website/content/en/status/report-2025-04-2025-06/lkpi-wireless.adoc +++ b/website/content/en/status/report-2025-04-2025-06/lkpi-wireless.adoc @@ -7,7 +7,7 @@ link:https://github.com/FreeBSDFoundation/proj-laptop/issues/58[LinuxKPI wireles link:https://github.com/FreeBSDFoundation/proj-laptop/issues/66[MediaTek mt76 PCI driver support] URL:link:https://github.com/FreeBSDFoundation/proj-laptop/issues/66[] + link:https://github.com/FreeBSDFoundation/proj-laptop/issues/34[802.11ax support] URL:link:https://github.com/FreeBSDFoundation/proj-laptop/issues/34[] + link:https://github.com/FreeBSDFoundation/proj-laptop/issues/79[net80211 updates] URL:link:https://github.com/FreeBSDFoundation/proj-laptop/issues/79[] + -link:https://bugs.freebsd.org/bugzilla/showdependencytree.cgi?id=277512&hide_resolved=1[Tracked wireless PRs] URL:https://bugs.freebsd.org/bugzilla/showdependencytree.cgi?id=277512&hide_resolved=1[] +link:https://bugs.freebsd.org/bugzilla/showdependencytree.cgi?id=277512&hide_resolved=1[Tracked wireless PRs] URL:link:https://bugs.freebsd.org/bugzilla/showdependencytree.cgi?id=277512&hide_resolved=1[] Contact: Bjoern A. Zeeb + Contact: The FreeBSD wireless mailing list diff --git a/website/content/en/status/report-2025-04-2025-06/packrat.adoc b/website/content/en/status/report-2025-04-2025-06/packrat.adoc index f496bccc9c..fdace6f6e9 100644 --- a/website/content/en/status/report-2025-04-2025-06/packrat.adoc +++ b/website/content/en/status/report-2025-04-2025-06/packrat.adoc @@ -1,4 +1,4 @@ -=== Packrat - NFS client caching on non-volatile storage +=== Packrat -- NFS client caching on non-volatile storage Contact: Rick Macklem diff --git a/website/content/en/status/report-2025-04-2025-06/ports-security.adoc b/website/content/en/status/report-2025-04-2025-06/ports-security.adoc index 8fb04f26d6..eba18d298d 100644 --- a/website/content/en/status/report-2025-04-2025-06/ports-security.adoc +++ b/website/content/en/status/report-2025-04-2025-06/ports-security.adoc @@ -11,12 +11,12 @@ As not all ports are compatible with them, this is not enabled by default. The 3 new features which can be enabled for the Ports Collection in [.filename]#make.conf# are: -- WITH_FORTIFY=yes:: +- WITH_FORTIFY=yes: This enables mitigations of common memory safety issues, such as buffer overflows, by adding checks to functions like memcpy, strcpy, sprintf, and others when the compiler can determine the size of the destination buffer at compile time. This requires support from the FreeBSD base system and may only be available in FreeBSD 15 onwards. -WITH_STACK_AUTOINIT=yes:: +- WITH_STACK_AUTOINIT=yes: This enables a compiler specific option to automatically initialize local (automatic) variables to prevent the use of uninitialized memory. -WITH_ZEROREGS=yes:: +- WITH_ZEROREGS=yes: Zero call-used registers at function return to increase program security by either mitigating Return-Oriented Programming (ROP) attacks or preventing information leakage through registers. This depends upon support from the compiler for a given architecture. This is disabled for python ports; currently there are issues. diff --git a/website/content/en/status/report-2025-04-2025-06/usb-debugging.adoc b/website/content/en/status/report-2025-04-2025-06/usb-debugging.adoc index 12c3234e7b..a047cdbcce 100644 --- a/website/content/en/status/report-2025-04-2025-06/usb-debugging.adoc +++ b/website/content/en/status/report-2025-04-2025-06/usb-debugging.adoc @@ -4,7 +4,7 @@ Contact: Tom Jones XHCI USB controllers offer a mode which allows them to be used as a system debugging interface. XHCI debug uses a special USB 3 cable with VBUS, D+ and D- disconnected. -The feature can used to live debug the FreeBSD kernel, enabling investigation of issues which cause the system video console to lock up and there is not an alternative such as a serial console. +The feature can be used to live debug the FreeBSD kernel, enabling investigation of issues which cause the system video console to lock up and there is not an alternative such as a serial console. This can happen when debugging issues with graphics drivers. mailto:hrs@FreeBSD.org[Hiroki Sato] developed support for the XHCI debug interface and made it available as some in progress git branches. From nobody Fri Aug 29 11:49:36 2025 X-Original-To: dev-commits-doc-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 4cCxQ86zDbz65NJ6 for ; Fri, 29 Aug 2025 11:49:36 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCxQ868HHz3Fdk; Fri, 29 Aug 2025 11:49:36 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756468176; 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=b7eWoMHyCmASsLKbZi8u2LEhREj5yAaxCLqvUcSbIGI=; b=Xj6ICHrDJKrYCAX2aQY+XZ+Lcxowwd8PnFhqv2tk/36XLHEERmVRzxu0XMj6u/Y9OlSrQ5 pwzuImiU2jbZ7BwFRlax8CnmDAiXCb8kSSJmKyjAznamL5lMrB8FKNcXHzWqWFddD/jxlR L8b55lGk6qtqAYg4JKkiuIMMFtV262btZb+UoyfyWpWJw3U6lw1kzqHDqpTXBacRR17C/L FqOPnNzaNSKnyrVrjAnGjHRDnKqxVZVfw16eiF8FNztpH+rlCQoWaEyOUvSvyHnp5a5peL HXnMZfuPE7jbJAr5DiRL858VZqn3LmW8y4vU+ZN3QCKEsx4w1qSy3Nfmk7JptA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756468176; 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=b7eWoMHyCmASsLKbZi8u2LEhREj5yAaxCLqvUcSbIGI=; b=KdxHXp7MWHtidK88vuJWhxyL5V+lq85UeI1UJfn90MTtp2QB0u90XWfOhlv6bnrre01fv6 +9m0a21arJlGUYCwPLuMeyE/ZnZbO/gAW2PHB2n+0tozbshj7UohUTW+KOrVNZIT47cHfO +ykeuv+tg40oJsmN6Gch9pR9vhiAOxqi4dB1ZLDUv5UhLfBxaJNmTq/6YeZBUOrid5LMgQ IDOY9Viu2Ajj3E73PnOz/D7NC+88Sa26+bFa529c9QSIc1lGKlAOiQOWdR+8iB8OHk4p9z VQ0ueaExZXpZWSIU1lL7tv1IWTaFW31qkryPuiEihUOHXF5Qt8FMeAmxaP36QA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756468176; a=rsa-sha256; cv=none; b=jMLMnHSAmb1AMeREbrp1zfUYXJTP9MTgJNF7F47nHWRjHYh6R7QdYOUlNZ143rcgEg/knP uXrGEnsZuZMpcofTgeSSXUKTYPskLzs0S7grph0VQILf/dACsd5st8xYuaG8GpftOo6RMR m/eOEW/FSOwW/oq5FQc3VOybwBHZKaJTzBABgeevsU6iR0wDcISrFZl+hAjug3Pyz5HlkG A1UYflDwTCZ+9erwJCDvF8Djl4pRSgfXbSuA2ihLGCrnZk17rSMLCJ90B4jsF5FHTVFyeY i7V11ddsjChj6QY9++8dv9kXh8m1tBPtjaaDHVD+paDcLHMVsocyRxrpYXweFA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCxQ85fs5zfV2; Fri, 29 Aug 2025 11:49:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57TBnaQ0001977; Fri, 29 Aug 2025 11:49:36 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57TBnaTC001974; Fri, 29 Aug 2025 11:49:36 GMT (envelope-from git) Date: Fri, 29 Aug 2025 11:49:36 GMT Message-Id: <202508291149.57TBnaTC001974@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: e5ca986eec - main - Status/2025Q2: Sort reports List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e5ca986eec896f069631c02238321419d0cd01c2 Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=e5ca986eec896f069631c02238321419d0cd01c2 commit e5ca986eec896f069631c02238321419d0cd01c2 Author: Chris Moerz AuthorDate: 2025-08-29 11:39:52 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-29 11:49:18 +0000 Status/2025Q2: Sort reports Differential Revision: https://reviews.freebsd.org/D51288 Co-authored-by: Lorenzo Salvadore --- .../en/status/report-2025-04-2025-06/_index.adoc | 213 +++++++++++++++++++++ 1 file changed, 213 insertions(+) diff --git a/website/content/en/status/report-2025-04-2025-06/_index.adoc b/website/content/en/status/report-2025-04-2025-06/_index.adoc new file mode 100644 index 0000000000..957bdbca16 --- /dev/null +++ b/website/content/en/status/report-2025-04-2025-06/_index.adoc @@ -0,0 +1,213 @@ +--- +title: "FreeBSD Status Report Second Quarter 2025" +sidenav: about +--- + += Introduction +:doctype: article +:toc: macro +:toclevels: 2 +:icons: font +:!sectnums: +:source-highlighter: rouge +:experimental: +:reports-path: content/en/status/report-2025-04-2025-06 + +include::content/en/status/categories-desc.adoc[] + +include::{reports-path}/intro.adoc[] + +''' + +toc::[] + + +''' + +[[FreeBSD-Team-Reports]] +== FreeBSD Team Reports + +{FreeBSD-Team-Reports-desc} + +''' + +include::{reports-path}/core.adoc[] + +''' + +include::{reports-path}/freebsd-foundation.adoc[] + +''' + +include::{reports-path}/releng.adoc[] + +''' + +include::{reports-path}/portmgr.adoc[] + +''' + +include::{reports-path}/bugmeister.adoc[] + +''' + +include::{reports-path}/srcmgr.adoc[] + +''' + +[[projects]] +== Projects + +{projects-desc} + +''' + +include::{reports-path}/foundation-sta.adoc[] + +''' +include::{reports-path}/pkgbase-bsdinstall.adoc[] + +''' + +include::{reports-path}/qemu_l4b.adoc[] + +''' + +include::{reports-path}/sylve.adoc[] + +''' + +include::{reports-path}/kw-hackathon.adoc[] + +''' + +[[userland]] +== Userland + +{userland-desc} + +''' + +include::{reports-path}/group-changes.adoc[] + +''' + +include::{reports-path}/mit_krb5.adoc[] + +''' + +include::{reports-path}/sysctltui.adoc[] + +''' + +include::{reports-path}/geomman.adoc[] + +''' + +[[kernel]] +== Kernel + +{kernel-desc} + +''' + +include::{reports-path}/audio.adoc[] + +''' + +include::{reports-path}/drm-drivers.adoc[] + +''' + +include::{reports-path}/suspend.adoc[] + +''' + +include::{reports-path}/named-attributes.adoc[] + +''' + +include::{reports-path}/packrat.adoc[] + +''' + +include::{reports-path}/lkpi-wireless.adoc[] + +''' + +include::{reports-path}/usb-debugging.adoc[] + +''' + +include::{reports-path}/hfs.adoc[] + +''' + +[[architectures]] +== Architectures + +{architectures-desc} + +''' + +include::{reports-path}/pinephone.adoc[] + +''' + +[[cloud]] +== Cloud + +{cloud-desc} + +''' + +include::{reports-path}/ec2.adoc[] + +''' + +[[documentation]] +== Documentation + +{documentation-desc} + +''' + +include::{reports-path}/doceng.adoc[] + +''' + +include::{reports-path}/wiki.adoc[] + +''' + +include::{reports-path}/vision-accessibility.adoc[] + +''' + +[[ports]] +== Ports + +{ports-desc} + +''' + +include::{reports-path}/ports-security.adoc[] + +''' + +include::{reports-path}/openjdk.adoc[] + +''' + +include::{reports-path}/gcc.adoc[] + +''' + +[[third-Party-Projects]] +== Third Party Projects + +{third-Party-Projects-desc} + +''' + +include::{reports-path}/cfc.adoc[] From nobody Fri Aug 29 11:49:37 2025 X-Original-To: dev-commits-doc-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 4cCxQB0vqfz65N2X for ; Fri, 29 Aug 2025 11:49:38 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCxQB035cz3Fbg; Fri, 29 Aug 2025 11:49:38 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756468178; 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=jqgz5LsjsQP44lZ+0lj04VYN73OiDfBCkroyENAHJas=; b=PRITLPMxlcZakaflPGONONgoEiRlJ+IVr4HbfvOC6bOFw7fgSlhSfwbQ/AHdejZhj2PKDO IRM6S/NKWLQRWn3eBnaPi3AOWhM6gZ/m6TCZVEawlR+SVFrXt/3O4G/9qZC6ViXOyj6rd8 LHvhh2xIh7EBPXh2+3MrMTenXAtPTuXRD3l/mYYjGVztWiVoTRa3mmByc/7Khj+dbkCr41 CqS4+RW0y0rzNDdv4TtrKbsWeFwAt4g/hJJQuDwfM7rC+xBElw/NDQMyCAgHITr5SB+1Op NUVXZOSPxVxUMQBYblXLyoxbcCFqg4vWikVWiwmNM5gubvR29mzdfUVhmixZtw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756468178; 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=jqgz5LsjsQP44lZ+0lj04VYN73OiDfBCkroyENAHJas=; b=Zf+fxI1sMYTrRbaAETu1zbW9uCqTJIWcacZusRu2hsKAXoajGul1AzVT1PvvKq4i/489SO 81/SZsiwB5sraseTBmKo9FP37F8ECL2ZgcgBex7NAvVPWQLVU8cTYrzsmiTTbpsws0bGhQ ajsf+VjSxPOtBhmisfUjz40s/rezUYwR0X4DhaBNf+reJDI3SZstw9/6WRecThmNG3OyAT 22hwEjomGhYeqHF4XHd9xiGHGy2oFw+fuJsKiN0XeCanwG64T6vFCQFuffBD6XSj6gwvjI GAqncUcV5c4f+a/ayQX2E5Kp/yoe4M4mLP/J2vb+whxb8m0SVlJmnUhY+FW3lA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756468178; a=rsa-sha256; cv=none; b=CBymQiY+FG+L2FHtlDC6slhWNlI9djJy+ILmCuaQIW03AATrqcgDxo8P6vPne6UHn4+k6J CM0iZ67206aW6rjQpQFRFEHfq3VLABnNU22Yhh1skhiHKxb/23A59wL8ufY0Zwvc2oGjKC +d6kUJZ8AxBeUd/lUmP3I/anjH5LYDESJ72U7ezCY8WrlWyg74OmHYk78zApotEQhOusUD D1vcs73z9t2AoQpbOI6KqdEudixQddIoOrXrMg++36PHYjjNEc29BJI8HTgOhCg7gq1WhV PvapaJTOoGqQuhJtQcnt+1VSyapTeJmTF65YHKvXR+pK30+8gTEZABFFkm5IZA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCxQ96b8RzfDn; Fri, 29 Aug 2025 11:49:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57TBnbmi002017; Fri, 29 Aug 2025 11:49:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57TBnbNx002014; Fri, 29 Aug 2025 11:49:37 GMT (envelope-from git) Date: Fri, 29 Aug 2025 11:49:37 GMT Message-Id: <202508291149.57TBnbNx002014@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 697bc18fd4 - main - Status/2025Q2: Publish report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 697bc18fd4633954a68315c10d5f71fa6b688003 Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=697bc18fd4633954a68315c10d5f71fa6b688003 commit 697bc18fd4633954a68315c10d5f71fa6b688003 Author: Lorenzo Salvadore AuthorDate: 2025-08-29 11:48:39 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-29 11:49:18 +0000 Status/2025Q2: Publish report --- website/content/en/status/_index.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/website/content/en/status/_index.adoc b/website/content/en/status/_index.adoc index 604e0fd9a3..a41e5b64f9 100644 --- a/website/content/en/status/_index.adoc +++ b/website/content/en/status/_index.adoc @@ -7,7 +7,7 @@ include::shared/en/urls.adoc[] = FreeBSD Status Reports -== Next Quarterly Status Report submissions (April -- June) due: June 30th, 2025 +== Next Quarterly Status Report submissions (July -- September) due: September 30th, 2025 If you are interested in submitting status reports or you are curious about how the publication process works, please see our link:{freebsd-status-report-process}[status report process description]. @@ -23,6 +23,7 @@ These status reports may be reproduced in whole or in part, as long as the sourc == 2025 +* link:report-2025-04-2025-06/[April, 2025 - June, 2025] * link:report-2025-01-2025-03/[January, 2025 - March, 2025] == 2024 From nobody Fri Aug 29 12:10:59 2025 X-Original-To: dev-commits-doc-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 4cCxtq6mZQz65Q3t for ; Fri, 29 Aug 2025 12:10:59 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCxtq68cwz3J2Q; Fri, 29 Aug 2025 12:10:59 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756469459; 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=MtYUlqJvlNpQD+ifH42A6AN6qOcBZddhEAjgeVnQ24w=; b=kOynfSNG4Iix0BAeyTdwmxALmMeYzPUVYOQlGl7Wdpm+Gpo7t4FYMdUmrKUi7+WAaSddwu pIVJh4IOM4nlQhlepHqZWCxGCCAIhYhukFDviMLTjoPe6BI5aEOhja1lYIYx+4tZGtVxIA AIOnkWUHb7QGZZcBqt8XWcW4p6sXeylOjabCWEtNmP6VnZtmumz4tKwsB16zjYJm7EabuP /7HeGw9SRfzd6shVCMSOMN+tGIRJqmASC1hkBrBsqMhcnSnoJiwWKOfw3V8XpPFpyuZOG2 EC8x8wsfLz0o1fZpcQ+iV9sjfiWCOdtXysQRDLqHjrUaWR9on5fuUHNsF6E9Gg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756469459; 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=MtYUlqJvlNpQD+ifH42A6AN6qOcBZddhEAjgeVnQ24w=; b=qMsyd86lx5oCrk/RJ2141Ixw4OMqqDLSD7lSxZIRZLDPeiBGc18WuGuSujk7KDvYycmUPf gxS6ZTJptIi1MqVwJkT+4LCfMn5jUpeUZssqGp1cWextp1mqF23Sf9Uc/DBk0eCwJVOH0V H++ALCpqd7EpD4eWdCYyYckhFUbm4xRnNAtmzcdzsUigR10ICpRGkUnIgdfYGFlDGx5m38 HGz62sDgaLrp61AVsPl8kZYkKkpkEo2FAMB+e6PZvrlDXnwwg+tzgsWSW7VIIes4jiUSOe ArEB12s99ofTur/H4WEHDn4S+bOW98FYxLmIb1xtJSugIrrdYAQUbuTLWw7Ufw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756469459; a=rsa-sha256; cv=none; b=W9Eqto5pt84cwHjZlXMjaKyMWdd6d7owF3CFFYfF3a9rlkp1YMeLzqXulUZWw6rA4Xb741 gUZWLNwqcmLkF/pR1K+KDQlKBi8243KE2Wd3xuf9A5dR06h+9gGQ7Fb6A1BAI5r2ST6Ht1 dlb9P0BBQYTEdVHsSdvnI0DHwHY6RlfSLcdmCQQuwRwAGifPAXoTx3m8Z7dpdxh/EBbfmy xieN3mhm2fgF1INryqNLhUcunIv24wghcu0OqcLoKmSmN/O7IGNsyt/VLk0wYidBK9ODOw ysVzexuw1VZLiph/MoPkgzPHoZC5+UTar64qgOcSDUNivnoMJXkHyOUXTaK4VA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCxtq5fvqzfXq; Fri, 29 Aug 2025 12:10:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57TCAxjC051524; Fri, 29 Aug 2025 12:10:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57TCAx0e051521; Fri, 29 Aug 2025 12:10:59 GMT (envelope-from git) Date: Fri, 29 Aug 2025 12:10:59 GMT Message-Id: <202508291210.57TCAx0e051521@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 941a0e3f8b - main - Status/2025Q2/sylve.adoc: Fix List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 941a0e3f8bd4c87aaf9457513ca567333df32f30 Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=941a0e3f8bd4c87aaf9457513ca567333df32f30 commit 941a0e3f8bd4c87aaf9457513ca567333df32f30 Author: Lorenzo Salvadore AuthorDate: 2025-08-29 12:06:11 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-29 12:06:11 +0000 Status/2025Q2/sylve.adoc: Fix --- website/content/en/status/report-2025-04-2025-06/sylve.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/status/report-2025-04-2025-06/sylve.adoc b/website/content/en/status/report-2025-04-2025-06/sylve.adoc index 183129c829..51553bc833 100644 --- a/website/content/en/status/report-2025-04-2025-06/sylve.adoc +++ b/website/content/en/status/report-2025-04-2025-06/sylve.adoc @@ -1,4 +1,4 @@ -=== Sylve - A Unified System Management Platform for FreeBSD +=== Sylve -- A Unified System Management Platform for FreeBSD Links: + link:https://github.com/AlchemillaHQ/Sylve[GitHub] URL: link:https://github.com/AlchemillaHQ/Sylve[] + From nobody Fri Aug 29 12:11:00 2025 X-Original-To: dev-commits-doc-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 4cCxts0xbmz65PmS for ; Fri, 29 Aug 2025 12:11:01 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cCxts0JRzz3HrN; Fri, 29 Aug 2025 12:11:00 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756469461; 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=Hq+rkQ3Jzyc7tGZ/2s5Drai/m/qbAqN9CkAmowTOupg=; b=BuY7ydsfcC5/AQnDCP+8Xz4ieaLcpDpku1HdgBWln/4nkrdatIG2MOzjsy4kXcpRQNLfef j0wrCRNB7dXFo4RQxljMd2mS1fUZpXCivcjpe4qoBb+0JtQrP4M6POnXjTb+uagyyJmEll t9teZiLkfOJr0iDd9bRK1Y/C3VYijk6W2e0nlbY1Nutw4BpOQw/9i59NkG8EhXYnzIM5fc EsLv+TwAOf+DPu7ggU17Iuz7DWFMrs/ftN4biYXesyC6BTPN083ZcUJO1NOyIuhK8bs9RE PoQKyn8twVzLckhatJu3Op+iuirJ8mpWZvy+/0WLX7HO+x5cyWHIQLbQLbc+eA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756469461; 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=Hq+rkQ3Jzyc7tGZ/2s5Drai/m/qbAqN9CkAmowTOupg=; b=xNU6Hq87K/8V7ZWUAjK7KY3dxlHq+/gr+PxIn/czoV0qXttrfZqME+7GnRWbfMUTxDUx0V QJUAVWJCv3Q0lwuvzlD04GXOqSDMRRzUDDS/doi0PWBG0KCyBi7xIqeTgPkbtgch8NX/0N ijASEBBaKOAQ39trmrvT0FY6/RaTb/sI6u4we633R66BW9wwal12zcjf9M96CK4GfJ0eHw WeTMzctEOIGPFnvMcFd9BtC7beDZ0WICh0u9zgl0hm5deIdPhjJMxDxigVspOziVr1p+HP 3MccQvb3gHqs1B08qYGg2YpNOVxO18tbJyrOyd90tbUxLx82P7lBkN54WlfDCw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756469461; a=rsa-sha256; cv=none; b=u9vcwjIONsRJdg0piQpqf6V4ognKP2A667NfKX13rLigvqEXPxMdx0MgrH4J8g2TZ3k3jC U0pDV7NkCfYT+1Jce8U89lR7Xrrxh4cg39sLUuP86v9MZmPOLoGGaAeAHh0Bxuw/5TBozl MMzFmaiYRmFqQSESEya74Yv+uTzUaP3S5mwMk3CC/jTvQHZj7yOCpnBZcnfRgsD36d5ZS6 TRyU46EyjXuivW2JDLEhTzPKp9/fl2JVyyabkBHVF6K2cFASm6MhVjrRKxIsdVkKGHPCA3 n0J2un2+5+0qkR+Fnyu0bWIbspBinPh5j94I6PkDk7nzfaL41sY2OAvC+r8xOg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cCxtr6ZtZzfVy; Fri, 29 Aug 2025 12:11:00 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57TCB0JH051583; Fri, 29 Aug 2025 12:11:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57TCB0l1051580; Fri, 29 Aug 2025 12:11:00 GMT (envelope-from git) Date: Fri, 29 Aug 2025 12:11:00 GMT Message-Id: <202508291211.57TCB0l1051580@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 0bba1f8658 - main - News: Announce 2025Q2 status report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0bba1f8658ac61fb17b482421c5e961616675a5a Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=0bba1f8658ac61fb17b482421c5e961616675a5a commit 0bba1f8658ac61fb17b482421c5e961616675a5a Author: Lorenzo Salvadore AuthorDate: 2025-08-29 12:10:21 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-08-29 12:10:31 +0000 News: Announce 2025Q2 status report --- website/data/en/news/news.toml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/website/data/en/news/news.toml b/website/data/en/news/news.toml index c9337b8ce4..9283d4a312 100644 --- a/website/data/en/news/news.toml +++ b/website/data/en/news/news.toml @@ -1,5 +1,10 @@ # Sort news by year, month and day +[[news]] +date= "2025-08-29" +title = "April-June 2025 Status Report" +description = "The April to June Status Report is now available with 32 entries." + [[news]] date = "2025-07-15" description = "New committer: Aymeric Wibo (src)" From nobody Sat Aug 30 02:20:47 2025 X-Original-To: dev-commits-doc-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 4cDJlM3HCGz65gf2 for ; Sat, 30 Aug 2025 02:20:47 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cDJlM1knRz3LwW; Sat, 30 Aug 2025 02:20:47 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756520447; 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=swafF90dD22rt00LyPvH7Jnuhxt3e59woYtGwCWc5bw=; b=kHNpeMTvR0CVpY0U2l685yvqu/o0hJvgZbuYZ4A3RXHlOMjczYU/Z0vRriaWH+0auOrBBk ISfOz9sRYXck0E9GKvuNvcULpkldKI+i3HjQDt3g2IpYDGiO1wjUssU1ZVeC44QYHut93V NUaSVporfqRN8Q4e5GI+QNzFBA5mvzjpL4JpeWI5Ze55H9CVw5+mCnWGdCGBVLYo4gDxOL +xKXWlfj8WSauF4F80IG3J6JTXPrYe2JDvlbUeo7JTQfJ6oFsXs9QsXjiWjeBY7aXHE/36 t9TL78Vy+JJc4dQknj4pboOS/R8dC/s3S5OF4ed6q1FHmmhZ9Dc2oiBiA48YLA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756520447; 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=swafF90dD22rt00LyPvH7Jnuhxt3e59woYtGwCWc5bw=; b=MUqbFa4Hb4er5B7pAg5h7GcpEBbZQDqleg50W5YUiyrE9wBVY9EVXEpIrNDzbW52mzMPdn pRiuxsS2XzsYcnncOSGdJNg2aFf1nGF7gfW64pUQgEDZ3XSef3y+x5gdS475zQ+xrga3IM EbIXMdYRqsZ1b20MEREZYnxWX9/p0v4EP6R2NZyHt27K/Yf56RlB9gQYzIvBA1qrgvducP fYq0fyoJNSzFjRroXbGBcNDrlVnLyUpX0GUNe29aDhjaOweYClDFYZkcxACBPmWe2p6uH6 MGhV3pG2hJceVvYHM4SI3zGKtceAS0h+CqPX5YNHK4+a3Ox1pOiDDbMUzUZJ7w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756520447; a=rsa-sha256; cv=none; b=L3R2WPyaGZaftTMUNbDIzpGehVtuxmfBIFE4sJK3z/rTgCUBgCaC40SZlb1IHPdQANz7ei CQnRkNVnQX/bAhqHZDWlYA2k6V9rLkAkjDVuS6eB6+W2cST/8PE7UmL/Rn3GdDzzxi9tCM 3a34SMZjd+TOHQof1lR52g7tVeo5yox9sdFNfvRhRZTfXIwPvklp9Mnh5K2Ye/qg8DFH5g NA50DDnNKtg86fMs6aHlcsA64BvY+jxKO1DOhB6dQwMrkRE6SI+Nos0jSIUTfbxRJB58Oc XCpoyc1i+S7DjM6NRm/7fnLPqyNR7UjM3M7ZERYX8mQA7z3Fai+CF/3Sl4lyXg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cDJlM1467z15MB; Sat, 30 Aug 2025 02:20:47 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57U2Kl9H053063; Sat, 30 Aug 2025 02:20:47 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57U2KlV7053060; Sat, 30 Aug 2025 02:20:47 GMT (envelope-from git) Date: Sat, 30 Aug 2025 02:20:47 GMT Message-Id: <202508300220.57U2KlV7053060@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Konstantin Belousov Subject: git: 12fd818f81 - main - report 2025 04-06: fix description of EXTERROR List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: kib X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 12fd818f81f24cc8a01b5120aa03c4107722ee77 Auto-Submitted: auto-generated The branch main has been updated by kib: URL: https://cgit.FreeBSD.org/doc/commit/?id=12fd818f81f24cc8a01b5120aa03c4107722ee77 commit 12fd818f81f24cc8a01b5120aa03c4107722ee77 Author: Konstantin Belousov AuthorDate: 2025-08-30 00:24:36 +0000 Commit: Konstantin Belousov CommitDate: 2025-08-30 02:19:51 +0000 report 2025 04-06: fix description of EXTERROR Reviewed by: jrm Sponsored by: The FreeBSD Foundation Differential revision: https://reviews.freebsd.org/D52292 --- .../content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc b/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc index 10dc68320f..720712d543 100644 --- a/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc +++ b/website/content/en/status/report-2025-04-2025-06/freebsd-foundation.adoc @@ -61,7 +61,7 @@ Here is a sampling of that work and other sponsored efforts: * Enhanced ptrace usability by enabling transient PT_ATTACH behavior. This reduces friction for debugging tools and eliminates spurious EINTR errors that could interrupt or break tracing workflows. * kqueue introspection support by extending man:procstat[1] to report kqueue state, improving observability into how processes use kernel event notification mechanisms -* Design and implementation of EXTERROR, a kernel-level flag mechanism that signals when extended error information is available. +* Design and implementation of EXTERROR, a mechanism that reports extended error information to userspace, augmenting the usual errno value. This enables applications to retrieve more detailed diagnostics beyond standard error codes. Other sponsored efforts are covered in separate report entries: From nobody Sun Aug 31 18:54:55 2025 X-Original-To: dev-commits-doc-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 4cFLlz5tPfz66Mkb for ; Sun, 31 Aug 2025 18:54:55 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cFLlz55N7z3c21; Sun, 31 Aug 2025 18:54:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756666495; 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=Y1bhvgpJRtl36zBE+ultLjZLLKAg7CMoYqhuEWIooBc=; b=AcDPg6Jdq3P2KumA+E7VEtLzTHghHAzfeOGsExOv0fRproJnCBj9+YKmHPqdLwbe90ftWD zUEffnmfWcrQe4QBH6de15y9BXW9TWPB2bIP2PHY+ZuYxY6bGBK5vSI6jVqYXrgB1j1d5v cpPcAU9JIDROFMgnIxikDHsC9kqzMdqP8bO7BPBWmkgSkSm7Mp+ROQFNsBRyIof0T/C2kX 0kYwWOefGD+FZc8q2rruioFuY9L8PWOo7Fe9Yk7rwVvbVuVJwRomOcsuYsFXuvOkqYXIHJ H7b1m8PkP1MIEmJtZjVi/05GjRrmbaibgbHBIOLkoEoYhL0UXRQ/E4WifouIyA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756666495; 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=Y1bhvgpJRtl36zBE+ultLjZLLKAg7CMoYqhuEWIooBc=; b=osLrMpsj3+f6K6n2DTOE4PE19rv2KxFaX9JsxuDxSX3mEoWY4DvzA/jchy79S1lulax5xg xEYIQW9vgzdelhluMwhPQIy56CZ96uNYWLUGUtPLxotkoCt67HjpElS4lSdu1G0W3M4bLq yQlkSJN0o+IU2B/L+ePhGmSM0qwj6zJ9CS9nPLXjQJ/6Tluk/c2uk7ZArN4EZ2wDCMnB1B 4uVfU+s2HiTyxmU3ig0gfnOL4CYw4Q7ohTnXDkAv0PqLHoMCYXsRfsostVY/k3J0iocDWa ecOegbB47Juf90BXiBQ2JfOJwSaJFodx1vBkIieINWntaIBLJAu0ySM4BY4V+A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756666495; a=rsa-sha256; cv=none; b=Zbsng7JP9uvqDBF8mRKNEjzHRJG0tnpRYcosAKz7ikNxPjsatK8JUTriv1sV4HexZ4Bo7Q //QZP9REXm5hhvomeg0OMLAMIn6AZk5L1WS4IYP/JCNpL6DIHfEGmv0kaFjI/CG1MGx89q gctcnqWGeK+TQJy3fcycby2w4VCr/yKUzJN/IDdYQMphSDq6KU1b2QUcULSQ6u0wP0PCqd btLGZ/8X4PIG5F/o4L6Ndm0jtzo3O4v8+8S+6upvxdLYLkrGkjSdSfeMk27oHDh9Mr3eR/ 0/DLOUWWtjwIIsX2tyZGtLZ7dz65Yhb4oMMDKRXByzs7/d5UTfNDrOJRvVujTA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4cFLlz4Bwtz951; Sun, 31 Aug 2025 18:54:55 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57VIsth4040425; Sun, 31 Aug 2025 18:54:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57VIstbJ040422; Sun, 31 Aug 2025 18:54:55 GMT (envelope-from git) Date: Sun, 31 Aug 2025 18:54:55 GMT Message-Id: <202508311854.57VIstbJ040422@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: 50735390bd - main - handbook: Add git switch info for shallow clones List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-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: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 50735390bd3ed510a067085d617ba0e0d050b029 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=50735390bd3ed510a067085d617ba0e0d050b029 commit 50735390bd3ed510a067085d617ba0e0d050b029 Author: Sergei Zhmylev AuthorDate: 2025-01-19 14:10:40 +0000 Commit: Warner Losh CommitDate: 2025-08-31 18:54:28 +0000 handbook: Add git switch info for shallow clones Signed-off-by: Sergei Zhmylev Reviewed-by: Warner Losh --- documentation/content/en/books/handbook/ports/_index.adoc | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index 725e00331c..a6e68a7137 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -730,8 +730,8 @@ If more control over the ports tree is needed or if local changes need to be mai Git can be used to obtain the Ports Collection. Refer to extref:{committers-guide}[the Git Primer, git-primer] for a detailed description of Git. -We add --depth 1 to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. -When maintaining custom changes to the ports tree, or need the history for any reason, omit the --depth 1 argument below. +We add `--depth 1` to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. +When maintaining custom changes to the ports tree, or need the history for any reason, omit the `--depth 1` argument below. . Git must be installed before it can be used to check out the ports tree. If a copy of the ports tree is already present, install Git like this: + @@ -773,7 +773,8 @@ If the ports tree is not available, or pkg is being used to manage packages, Git + [source,shell] .... -# git -C /usr/ports switch 2023Q1 +# git -C /usr/ports fetch --depth 1 origin 2023Q2:2023Q2 +# git -C /usr/ports switch 2023Q2 .... ****