FreeBSD/src 2abf4ceusr.sbin/iostat iostat.8

iostat.8: Expand -w description

PR:             194781
MFC after:      3 days
Reviewed by:    ziaee
Event:          Halifax Hackathon 202606

(cherry picked from commit 4d299a767acce2841ded288e789a9c36620b57d7)
DeltaFile
+6-1usr.sbin/iostat/iostat.8
+6-11 files

FreeBSD/src 0312eb4share/man/man4 tcp.4, sys/netinet tcp_fastopen.c

tcp.fastopen.client_enable: Fix documented default

The default value has been 1 since June 2018, but the docs were not
updated to reflect the change.

MFC after:      3 days
Reviewed by:    ziaee
Fixes:          af4da5865557 (Enable TCP_FASTOPEN by default)
Signed-off-by:  Matteo Riondato <matteo at FreeBSD.org>
Closes:         https://github.com/freebsd/freebsd-src/pull/2285

(cherry picked from commit 0bc852cc62afcd79fc776f784623c3f2b7691d27)
DeltaFile
+2-2share/man/man4/tcp.4
+1-1sys/netinet/tcp_fastopen.c
+3-32 files

FreeBSD/src dcffbdfstand/man loader.efi.8

loader.efi.8: hw.uart.console is explained in uart

PR:             295944
MFC to:         15
MFC after:      3 days

(cherry picked from commit a641aa1c80f80e44cd9212b95e6584db9533712c)
DeltaFile
+2-3stand/man/loader.efi.8
+2-31 files

FreeBSD/src ca5648cbin/ln symlink.7

symlink.7: Clean up markup and tag SPDX

Also unwind some parentheticals.

MFC after:      3 days

(cherry picked from commit e821152cc71dbd09f5bd28be86499165c553f3ae)
DeltaFile
+49-43bin/ln/symlink.7
+49-431 files

FreeBSD/src e2b376fsbin/mount_udf mount_udf.8

mount_udf.8: Alphabetize and align options

While here, remove "The following UDF specific options are available:".
It is unused and does not appear to have ever been used.

MFC after:      3 days

(cherry picked from commit 05f132adc530cd53203b9cd09d7e1b211d2babc4)
DeltaFile
+5-6sbin/mount_udf/mount_udf.8
+5-61 files

FreeBSD/src 4f36622contrib/mandoc mdoc.7

mdoc.7: Revert upstream changes to Lb/LIBRARY

Since this manual describes the mdoc syntax throughout the ecosystem,
I had to blend what we had before with what upstream is doing now.

Thanks:         adrian
MFC after:      3 days (we shipped this doc in 15.0/14.4)
Reviewed by:    ivy, mhorne, des, adrian
Discussed with: arch@
Differential Revision:  https://reviews.freebsd.org/D56153

(cherry picked from commit 4e2bf6e90a65bee317e4dd379e098ba2eb5d8c0d)
DeltaFile
+33-4contrib/mandoc/mdoc.7
+33-41 files

FreeBSD/src de72f76share/man/man5 style.mdoc.5

style.mdoc: Explain why not to abuse Nm

MFC after:              3 days
Reviewed by:            0mp
Differential Revision:  https://reviews.freebsd.org/D55299

(cherry picked from commit bcd50fe5c3c6e70c710e13378999814e9df43d3c)
DeltaFile
+6-0share/man/man5/style.mdoc.5
+6-01 files

FreeBSD/src 96f9f95share/man/man4 ocs_fc.4

ocs_fc.4: Cleanup

+ more consistent document description
+ enumerate available options in synopsis in vt.4 style
+ tag spdx
+ tweak list rendering
+ cleanup HARDWARE
+ reflow excessively long lines silencing linter warnings
+ fix link macros

MFC after:              3 days
Reported by:            michaelo (hardware notes)
Differential Revision:  https://reviews.freebsd.org/D56753

(cherry picked from commit dd97c3d83f9a92bbeb9740ceff4c1c74c451293e)
DeltaFile
+55-38share/man/man4/ocs_fc.4
+55-381 files

FreeBSD/src 91be228usr.sbin/nvram nvram.8

nvram.8: Align option list and tag SPDX

MFC after:      3 days

(cherry picked from commit 33fbfceeb4d9daf1145089a10ce7b25110d8840f)
DeltaFile
+4-2usr.sbin/nvram/nvram.8
+4-21 files

FreeBSD/src 5e14432share/man/man7 ports.7

ports.7/FILES: Expand and refactor into 3 tables

Add make.conf, CHANGES, CONTRIBUTING.Md, UPDATING, and Tools/scripts.
Refactor the FILES section of the ports reference manual into a bigger
table with three sections separated by root directory. Remove preceeding
article from all but "the big Kahuna", and root dirs where reasonable.

MFC after:              3 days
Relnotes:               yes
Reported by:            adamw, arrowd, linimon
Differential Revision:  https://reviews.freebsd.org/D55441

(cherry picked from commit 28deec9b7e2b08b00160eb39de84ade6f27eb125)
DeltaFile
+29-18share/man/man7/ports.7
+29-181 files

FreeBSD/src b2e845cusr.sbin/bsdinstall/scripts auto

bsdinstall: Improve auto-partition message

Manually tuning ZFS for systems with <8GB ram hasn't been necessary at
least since the switch to OpenZFS. We have users reporting using 1GB RAM
with no manual tuning/issues. Further, the page this links to is a stale
wiki page, which is causing complaints. Remove this misleading note and
replace it with a similar message for UFS. While here, reword that note
to be a bit clearer.

PR:                     287719
MFC after:              3 days
Differential Revision:  https://reviews.freebsd.org/D50971

(cherry picked from commit 5ed26c21e4ff1d478d4611abbf3dc14cc1b77244)
DeltaFile
+2-2usr.sbin/bsdinstall/scripts/auto
+2-21 files

FreeBSD/src 30c821alib/geom/cache gcache.8, lib/geom/eli geli.8

geom manuals: Clarify units

The gpart manual says that sizes are specified in blocks, unless an SI
unit suffix is provided. This confuses new operators because GEOM uses
binary bytes, a large difference at modern storage pool sizes. Rewrite
suffixes in all GEOM manuals to consistently clarify this, matching what
we and the rest of the industry have been doing in other documentation.
While here, use non-breaking spaces between numbers and units, unless
they are already written with a hyphen.

MFC after:              3 days
Reviewed by:            fuz
Reported by:            bbaovanc <bbaovanc at bbaovanc.com>
Differential Revision:  https://reviews.freebsd.org/D56534

(cherry picked from commit 975e3605ebb15cbaf5a25c1c9d1f51aed41291d0)
DeltaFile
+29-23lib/geom/part/gpart.8
+4-4sbin/ggate/ggatec/ggatec.8
+4-4lib/geom/eli/geli.8
+2-2sbin/ggate/ggated/ggated.8
+2-2lib/geom/cache/gcache.8
+41-355 files

FreeBSD/src 0b35f51sys/cddl/compat/opensolaris/kern opensolaris_cmn_err.c

dtrace: Improve dmesg kernel message prefix

Provide intuitive log search keywords and increased system consistency.

MFC after:              2 weeks
Reported by:            mav
Reviewed by:            0mp, dteske
OpenZFS change:         d45c8d648 (Improve dmesg kernel message prefix)
Differential Revision:  https://reviews.freebsd.org/D55765

(cherry picked from commit 49e9b3061df036a73e8bc424c026158f3f57b183)
DeltaFile
+7-7sys/cddl/compat/opensolaris/kern/opensolaris_cmn_err.c
+7-71 files

FreeBSD/src b75965elib/libc/sys ntp_adjtime.2

ntp_adjtime.2: Increase visibility

+ s/ntp/ntpd/ for correctness + apropos results in document description
+ silence a linter warning by escaping a period with a zero-width space

MFC after:      3 days

(cherry picked from commit b49b3ccd40bda02f530c679f23f42ba9e0e4b2e2)
DeltaFile
+3-3lib/libc/sys/ntp_adjtime.2
+3-31 files

FreeBSD/src 21783b3share/skel dot.profile, usr.bin/apply apply.1

Bourne shell -> POSIX shell

The FreeBSD shell is a POSIX compatible shell. It evolved over several
decades from the Almquist shell, which was preceeded a decade before
that by the Bourne shell. Most readers today have never seen a Bourne
shell. If someone wants to learn to use our shell, they need to look for
tutorials on the POSIX shell. Align descriptions through out the tree
with this reality, consistent with it's manual and common parlance.

We made a similar change to the doc tree in b4d6eb01540fe.

MFC after:              3 days
Reviewed by:            carlavilla
Differential Revision:  https://reviews.freebsd.org/D56382

(cherry picked from commit dc140a9fc151f3717bce2157f49070daafa13ec0)
DeltaFile
+2-2usr.bin/script/script.1
+2-2usr.bin/fortune/datfiles/freebsd-tips
+1-1usr.sbin/adduser/adduser.8
+1-1usr.bin/chpass/chpass.1
+1-1usr.bin/apply/apply.1
+1-1share/skel/dot.profile
+8-86 files

FreeBSD/src 9bc3d8ebin/sh histedit.c

sh: Increase default history size to POSIX mandated minimum of 128

The default history size in bin/sh is currently 100 however POSIX.1-2024
mandates that a default greater than or equal to 128 shall be used,
therefore this increases the default history size in /bin/sh to 128.

POSIX standards reference:
https://pubs.opengroup.org/onlinepubs/9799919799/utilities/sh.html#tag_20_110_08

MFC after:      3 days
Reviewed by:    emaste, jilles, jlduran, ziaee
Signed-off-by:  Kristofer Peterson <kris at tranception.com>
Closes:         https://github.com/freebsd/freebsd-src/pull/2093

(cherry picked from commit 81b2055c49dec8884d7bb23503f1dfeac37ac95d)
DeltaFile
+1-1bin/sh/histedit.c
+1-11 files

FreeBSD/src 4bcf748usr.sbin/diskinfo diskinfo.c diskinfo.8

diskinfo: Align and alphabetize options

MFC after:      3 days

(cherry picked from commit afe57c12e97d5c8773d829c2914f35462a7cdd0c)
DeltaFile
+6-6usr.sbin/diskinfo/diskinfo.8
+5-5usr.sbin/diskinfo/diskinfo.c
+11-112 files

FreeBSD/src a716cf6bin/timeout timeout.1

timeout.1: Document non-POSIX options

MFC after:              3 days
Reviewed by:            Aaron Li <aly at aaronly.me>, ziaee
Differential Revision:  https://reviews.freebsd.org/D56090

(cherry picked from commit b1bc748430b5ee79ae103c464dbf5ebc8802f782)
DeltaFile
+5-1bin/timeout/timeout.1
+5-11 files

FreeBSD/src 6758b7fshare/man/man4 arcmsr.4

arcmsr.4: Improve HARDWARE introductory sentence

MFC after:      3 days

(cherry picked from commit ff32dbb1d14f05bf77e356ae68c82c048c88888f)
DeltaFile
+3-2share/man/man4/arcmsr.4
+3-21 files

FreeBSD/src 6e79044usr.sbin/mfiutil mfiutil.8

mfiutil.8: Fix typo - missing macro for dev node

MFC after: 3 days

(cherry picked from commit 2bcdab574598e729273f7ddc7d898ffdb43b63b9)
DeltaFile
+2-1usr.sbin/mfiutil/mfiutil.8
+2-11 files

FreeBSD/src 37bd9f1share/man/man4 Makefile vmgenc.4

vmgenc.4: Add VM Generation ID Counter manual

Document the vmgenc(4) ACPI driver which detects virtual machine
cloning and snapshot restoration via the VM Generation ID
specification. The driver reseeds the kernel entropy pool when
a generation change is detected.

MFC after:              3 days
Reviewed by:            cem (previous), ziaee
Signed-off-by:          Christos Longros <chris.longros at gmail.com>
Differential Revision:  https://reviews.freebsd.org/D56011

(cherry picked from commit 59cb18f35617d3a53f7d7e142b4f91ad7951f5e0)
DeltaFile
+62-0share/man/man4/vmgenc.4
+1-0share/man/man4/Makefile
+63-02 files

FreeBSD/src 3c0afd5sys/x86/x86 tsc.c cpu_machdep.c

x86: Handle when MPERF/APERF MSRs aren't writable

For performance and/or correct reasons some hypervisors allow
MPERF/APERF MSRs to be read but not written to. This change
modifies the handling of these MSRs to not rely on writes.
This patch is part of Google Cloud Engine (GCE) C4-LSSD turnup.

Sponsored by:           Google
Tested by:              NetApp (previous)
PR:                     292808
MFC after:              3 days
Co-authored-by:         Jim Mattson <jmattson at google.com>
Reviewed by:            jrtc27, imp, kib, markj, olce, obiwac
Differential Revision:  https://reviews.freebsd.org/D55996

(cherry picked from commit 7e7d4e711ff94d114c93fd522d4125aa9bd9f5cd)
DeltaFile
+7-7sys/x86/x86/cpu_machdep.c
+6-3sys/x86/x86/tsc.c
+13-102 files

FreeBSD/src 7a06810sys/x86/x86 cpu_machdep.c

x86: Guard clock frequency against a divide by 0

We may be running in a Virtual Machine which may not fully support
hardware performance counters. If the MPERF counter somehow ends up
at zero, return an error and fail gracefully instead of panicking.
This patch is part of Google Cloud Engine (GCE) C4-LSSD turnup.

Sponsored by:           Google
Tested by:              NetApp (previous)
PR:                     292808
MFC after:              3 days
Co-authored-by:         Aymeric Wibo <obiwac at google.com>
Co-authored-by:         Jim Mattson <jmattson at google.com>
Suggested by:           jrtc27 (split out this part)
Reviewed by:            imp, obiwac, olce
Differential Revision:  https://reviews.freebsd.org/D56056

(cherry picked from commit c505fc1468849150f48484b225b6476d8316de57)
DeltaFile
+8-1sys/x86/x86/cpu_machdep.c
+8-11 files

FreeBSD/src a1479a3share/man/man4/man4.arm Makefile dwcotg.4

dwcotg.4: Initial manual page

Create visibility in apropos and the Hardware Release Notes.

MFC after:              3 days
Relnotes:               yes
Reviewed by:            pauamma, ray
Differential Revision:  https://reviews.freebsd.org/D53287

(cherry picked from commit 8475cd93fb6db65a02afe435f16306bc18e96ec9)
DeltaFile
+29-0share/man/man4/man4.arm/dwcotg.4
+1-0share/man/man4/man4.arm/Makefile
+30-02 files

FreeBSD/src b8d1a7eshare/man/man4 igc.4

igc.4: Describe better

MFC after:      3 days

(cherry picked from commit 6560ee97e8f51d5147521319dfd9d1e7afe74d34)
DeltaFile
+4-4share/man/man4/igc.4
+4-41 files

FreeBSD/src f31df65share/man/man7 ports.7

ports.7: Document DEFAULT_VERSIONS

MFC after:              3 days
Co-authored-by:         Adam Weinberger <adamw at FreeBSD.org>
Differential Revision:  https://reviews.freebsd.org/D55443

(cherry picked from commit 74aec9f02d9d8fbde250da1ecc881729c8baf489)
DeltaFile
+4-0share/man/man7/ports.7
+4-01 files

FreeBSD/src e7cdcb5share/man/man5 style.mdoc.5

style.mdoc: Left angle bracket is not less-than

MFC after:              3 days
Differential Revision:  https://reviews.freebsd.org/D55300

(cherry picked from commit 06ac71cffba4a0f86334844453d0a6fb3c46aa12)
DeltaFile
+1-1share/man/man5/style.mdoc.5
+1-11 files

FreeBSD/src e5c5e7dshare/man/man5 style.mdoc.5

style.mdoc: Remove synopsis formatting advice

Remove incorrect advice. The first rule was no spaces padding pipes
when showing alternates. Almost universally we not do this, and third
party manuals do not either. The second was using Cm to mark up symbols.
This advice is in conflict with mdoc(7), and the extended documentation
on mdoc linked below, which is also linked at the bottom of mdoc(7).

Conflicting information in our docs is a natural result of documentation
proliferation. The most important thing we can do to reduce technical
debt in the documentation is reduce the amount of doc overlap. Excessive
technical debt and conflicting rules is a barrier to new contributors.
This type of work requires thorough expertise, is not glamorous at all,
and to add insult to injury, is socially unsafe. To get new contributors
to the docs project, we must deduplicate documentation.

We have the mdoc manual, examples/mdoc, style.mdoc, and the fdp chapter
on manual pages. With this many, they will inevitably come to contain
conflicting information, and people will learn not to read them or work

    [7 lines not shown]
DeltaFile
+0-67share/man/man5/style.mdoc.5
+0-671 files

FreeBSD/src 612a0fdshare/man/man5 style.mdoc.5

style.mdoc: Li macro is undeprecated for some time

Previously, the mdoc linter warned against using Li as it was deprecated
upstream. However, upstream undeprecated it since last year. As usual
when it comes to style, the best thing to do is to follow the existing
style of the page. We have many manuals which prefer double quotes.

MFC after:              3 days
Citation:               https://cvsweb.bsd.lv/mandoc/mdoc.7?rev=1.297
Differential Revision:  https://reviews.freebsd.org/D55297

(cherry picked from commit fae551b76785d2357b09e2c022a92f410d871b9b)
DeltaFile
+1-9share/man/man5/style.mdoc.5
+1-91 files

FreeBSD/src b8f4265share/man/man5 style.mdoc.5

style.mdoc: Add example manuals to FILES

This is the OG meat and potatoes.

MFC after:              3 days
Reviewed by:            0mp, carlavilla
Differential Revision:  https://reviews.freebsd.org/D55301

(cherry picked from commit 2abdbe9d796419e8149705ffb4c81f0c0cdea05f)
DeltaFile
+5-0share/man/man5/style.mdoc.5
+5-01 files