hash(9): introduce hashalloc()/hashfree() KPI

This is a more extendable version than traditional hashinit(9). It allows
different kinds of slot headers with optional locks.

Implement traditional h

hash(9): introduce hashalloc()/hashfree() KPI

This is a more extendable version than traditional hashinit(9). It allows
different kinds of slot headers with optional locks.

Implement traditional hashinit()/hashdestroy() on top of it.

Reviewed by: pouria, gallatin
Differential Revision: https://reviews.freebsd.org/D55904

show more ...

ecn.9: Add ecn(9) manual

Add ecn manual for ip_ecn tunneling functions.

Reviewed by: pauamma_gundo.com, tuexen
Differential Revision: https://reviews.freebsd.org/D53517

pfind(9): follow-up fixes and improvements

(Found on a branch from a year ago.)

- Adjust NAMEs
- MLINKS: add pfind_any.9, pfind_any_locked.9; remove old zpfind.9
- Reword the description of pfind_a

pfind(9): follow-up fixes and improvements

(Found on a branch from a year ago.)

- Adjust NAMEs
- MLINKS: add pfind_any.9, pfind_any_locked.9; remove old zpfind.9
- Reword the description of pfind_any() so that it doesn't imply only
zombie processes are returned
- Fix a comma
- Use .Dv for the macro PRS_ZOMBIE
- Move the (logically separate) final statement to a new paragraph
- .Xr to pget(9)

Reviewed by: 0mp
Fixes: 07d78399eb79 ("pfind(9): Update to recent behavior")
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D53548

show more ...

bus: Add device_has_children predicate

Add a device_has_children() function which can be used to check if a
device has children without allocating a list of them which we aren't
going to use, or eve

bus: Add device_has_children predicate

Add a device_has_children() function which can be used to check if a
device has children without allocating a list of them which we aren't
going to use, or even counting them.

Also modify device_get_children() so it can be used to query the count
without allocating a list.

MFC after: 1 week
Sponsored by: Klara, Inc.
Sponsored by: NetApp, Inc.
Reviewed by: imp, markj
Differential Revision: https://reviews.freebsd.org/D53918

show more ...

exterror.9 man page

With help from: mckusick
Reviewed by: emaste, pauamma_gundo.com
Sponsored by: The FreeBSD Foundation
MFC after: 1 week
Differential revision: https://reviews.freebsd.org/D53589

packages: Install development manpages in the -dev package

Add a new per-group SUBPACKAGE option to bsd.man.mk. When MANSPLITPKG
is enabled, this is forced to "-man", otherwise it defaults to empty

packages: Install development manpages in the -dev package

Add a new per-group SUBPACKAGE option to bsd.man.mk. When MANSPLITPKG
is enabled, this is forced to "-man", otherwise it defaults to empty
but can be overridden by the caller.

Use this in bsd.lib.mk to install library manpages in the -dev package
instead of the base package. This is nearly always preferable, since
library manpages are usually in section 2 or 3 and are only relevant
to people with development packages installed.

For manpages which should be installed in the base package even for
libraries, add a new MANNODEV group in bsd.lib.mk. Update existing
Makefiles to use this where appropriate.

MFC after: 3 days
Discussed with: olce
Reviewed by: olce
Sponsored by: https://www.patreon.com/bsdivy
Differential Revision: https://reviews.freebsd.org/D52832

show more ...

deadfs.9: Document

Reviewed by: kib
MFC after: 2 weeks
Differential Revision: https://reviews.freebsd.org/D53334

man9: Provide SYSCTL_BOOL & SYSCTL_ADD_BOOL man pages

Updates: 84e717c4c & 9a593520

share/man/man9: Fix compilation

I goofed in the previous commit.

Fixes: 05e5de00b9ea ("vn_fullpath.9: Add missing links for described functions")
MFC after: 3 days
Event: Eur

share/man/man9: Fix compilation

I goofed in the previous commit.

Fixes: 05e5de00b9ea ("vn_fullpath.9: Add missing links for described functions")
MFC after: 3 days
Event: EuroBSDCon 2025
Sponsored by: The FreeBSD Foundation

show more ...

vn_fullpath.9: Add missing links for described functions

To reflect all the functions that are now described in the manual page.

Fixes: 9f269a0a771a ("MAC/do: Check executable path ...")
M

vn_fullpath.9: Add missing links for described functions

To reflect all the functions that are now described in the manual page.

Fixes: 9f269a0a771a ("MAC/do: Check executable path ...")
MFC after: 3 days
Event: EuroBSDCon 2025
Sponsored by: The FreeBSD Foundation

show more ...

vfs cache: Add vn_fullpath_jail(), factor out common code

Introduce vn_fullpath_jail(), which returns a path to the passed vnode
relative to the current jail's root. It will be used by mac_do(4) in

vfs cache: Add vn_fullpath_jail(), factor out common code

Introduce vn_fullpath_jail(), which returns a path to the passed vnode
relative to the current jail's root. It will be used by mac_do(4) in
a subsequent commit.

Factor out common code between the new variant and vn_fullpath(). While
here, rework the comments a bit.

Add vn_fullpath_jail() to the vn_fullpath.9 manual page. While here,
document all the existing public vn_fullpath*() functions.

Reviewed by: kib (except latest manual page changes)
MFC after: 3 days
Event: EuroBSDCon 2025
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D52757

show more ...

vfs: retire the VREF macro

It is defined as a plain use of vref.

Churn generated with coccinelle:
@@
expression vp;
@@

- VREF(vp)
+ vref(vp)

vnet.9: Rename vnet.9/vimage.9 to VNET.9/VIMAGE.9

Fix crossreferences to VNET(9) by correcting it's capitalization.

MFC after: 3 days
Reviewed by: enji, ziaee
Closes: https://github.com/freebsd/fr

vnet.9: Rename vnet.9/vimage.9 to VNET.9/VIMAGE.9

Fix crossreferences to VNET(9) by correcting it's capitalization.

MFC after: 3 days
Reviewed by: enji, ziaee
Closes: https://github.com/freebsd/freebsd-src/pull/1848

show more ...

share/man/man[49]: Set PACKAGE=kernel-man

When MANSPLITPKG is disabled (which is now the default), the kernel
manpages in sections 4 and 9 are installed in the -kernel package
instead of the -kernel

share/man/man[49]: Set PACKAGE=kernel-man

When MANSPLITPKG is disabled (which is now the default), the kernel
manpages in sections 4 and 9 are installed in the -kernel package
instead of the -kernel-man package, because bsd.man.mk doesn't add
the -man suffix.

Since we already have handling for kernel-man in generate-ucl.lua,
set PACKAGE=kernel-man to make sure they're always in the right
package.

To avoid creating -kernel-man-man when WITH_MANSPLITPKG is enabled,
add some logic to bsd.man.mk (suggested by kevans) to avoid adding
the -man suffix if the package already has a -man suffix, and while
here, ensure ${__group}PACKAGE is always defined.

MFC after: 3 seconds
Reviewed by: des, bapt
Differential Revision: https://reviews.freebsd.org/D52525

show more ...

kern: abstract away the vnode coredumper to allow pluggable dumpers

The default and only stock coredumper will continue to be the
traditional vnode dumper, which will dump to a vnode and issue a dev

kern: abstract away the vnode coredumper to allow pluggable dumpers

The default and only stock coredumper will continue to be the
traditional vnode dumper, which will dump to a vnode and issue a devctl
notification. With this change, one can write a kmod that injects custom
handling of user coredumps that offers richer behavior, particularly in
case one wants to add more metadata than we can tap out via devd.

The main motivation here is to pave the way for my usercore daemon to be
able to reroute coredumps before they ever touch the disk. In some
cases they may be discarded and we can avoid the overhead of writing
anything, in others they allow us to capture coredumps that would be
written into an area that's transient in nature (e.g., kyua test work
directories) without having to do more tricks to keep those alive. My
WIP kmod writes the coredump into a shmfd instead of a vnode, then
installs that into ucored(8) with every read(2) of /dev/ucore. This
also allows me to capture more metadata reliably before the process and
jail disappear.

Reviewed by: kib (earlier version), markj
Differential Revision: https://reviews.freebsd.org/D51338

show more ...

share/man: Move many manpages to more correct packages

At the moment, all the manpages in share/man are in the utilities-man
package. Move some of them to the package they should actually be in,
us

share/man: Move many manpages to more correct packages

At the moment, all the manpages in share/man are in the utilities-man
package. Move some of them to the package they should actually be in,
using the new MANGROUPS feature.

Move all of section 3 to clibs-man. Although some of these are from
/usr/include/sys rather than libc, you can't practically use them
without libc, and clibs-man is where the libc manpages live already.

Move all of sections 4 and 9 to a new kernel-man package, except for
atf-test-case.4 which goes to tests-man. atf-test-case.4 is in the
wrong section, but this needs to be fixed upstream.

kernel-man requires special handling in generate-ucl.lua since it's
got a -man suffix but doesn't want the ' (manual pages)' automatic
suffix. For now, fix this by adding a list of packages that don't
get automatic suffixes.

Reviewed by: ifreund_freebsdfoundation.org, manu, emaste
Differential Revision: https://reviews.freebsd.org/D51504

show more ...

inotify: Add man pages for the new syscalls and for VOP_INOTIFY

Reviewed by: kib
MFC after: 3 months
Sponsored by: Klara, Inc.
Differential Revision: https://reviews.freebsd.org/D50315

vm_map: drop vm_map_simplify_entry.9

A change in 2019 removed the function vm_map_simplify_entry(), but failed
to remove the manual page that documents it. As that was an internal
function not mean

vm_map: drop vm_map_simplify_entry.9

A change in 2019 removed the function vm_map_simplify_entry(), but failed
to remove the manual page that documents it. As that was an internal
function not meant to be used outside the kernel, the manual page is
dropped, and a new manual page for the function that replaced it is
not added.

Reported by: pfg
Reviewed by: alc
Fixes: 83ea714f4fca ("vm_map_simplify_entry considers merging")
Differential Revision: https://reviews.freebsd.org/D50861

show more ...

namei: Update documentation.

This should have been done 2+ years ago when the td argument was dropped
from NDINIT() and the NDFREE() macro and the SAVENAME and SAVESTART
flags were retired.

MFC aft

namei: Update documentation.

This should have been done 2+ years ago when the td argument was dropped
from NDINIT() and the NDFREE() macro and the SAVENAME and SAVESTART
flags were retired.

MFC after: 3 days
Fixes: 7e1d3eefd410 ("vfs: remove the unused thread argument from NDINIT*")
Fixes: 269c564b90d3 ("vfs: retire NDFREE")
Sponsored by: NetApp, Inc.
Reviewed by: markj
Differential Revision: https://reviews.freebsd.org/D50375

show more ...

pci: Add helper routines to manage PME in device drivers

pci_has_pm is a quick check that returns true if a PCI device supports
the power management capability.

pci_enable_pme can be used in DEVICE

pci: Add helper routines to manage PME in device drivers

pci_has_pm is a quick check that returns true if a PCI device supports
the power management capability.

pci_enable_pme can be used in DEVICE_SUSPEND driver methods to enable
PME# during suspend.

Reviewed by: Krzysztof Galazka <krzysztof.galazka@intel.com>x
Differential Revision: https://reviews.freebsd.org/D49250

show more ...

pci: Clear active PME# and disable PME# generation

The PCI power management specification requires that the OS clear any
pending PME# interrupt and generation of PME# interrupts during
"initial oper

pci: Clear active PME# and disable PME# generation

The PCI power management specification requires that the OS clear any
pending PME# interrupt and generation of PME# interrupts during
"initial operating system load". Note that clearing a pending PME#
interrupt requires writing a 1 to the Read/Write-Clear PME bit in the
power management status register. To handle the boot time case, clear
PME# state in pci_read_cap() when scanning new PCI devices. This
should also cover hotplug devices.

In addition, clear this state on every PCI device after resume from
sleep in pci_resume_child before invoking the driver's DEVICE_RESUME
method.

Reviewed by: imp
Differential Revision: https://reviews.freebsd.org/D49222

show more ...

IfAPI: Update ifnet(9) man page

Add starting documentation of the IfAPI to the ifnet(9) page. This
replaces the existing struct ifnet documentation, since it's to be
treated as opaque now.

Reviewe

IfAPI: Update ifnet(9) man page

Add starting documentation of the IfAPI to the ifnet(9) page. This
replaces the existing struct ifnet documentation, since it's to be
treated as opaque now.

Reviewed by: #manpages, adrian, ziaee
Differential Revision: https://reviews.freebsd.org/D47931

show more ...

man9: Delete standalone bus_delayed_attach_children.9

The description in bus_attach_children.9 has more details as well as
additional context.

This reverts commit 8770f17a959f2af303213989c0323204bb

man9: Delete standalone bus_delayed_attach_children.9

The description in bus_attach_children.9 has more details as well as
additional context.

This reverts commit 8770f17a959f2af303213989c0323204bb47c129.

show more ...

man9: Remove bus_delayed_attach_children MLINK

bus_delayed_attach_children already existed as a standalone page,
causing pkgbase errors due to duplicate METALOG entries. Delete the
MLINK for now to

man9: Remove bus_delayed_attach_children MLINK

bus_delayed_attach_children already existed as a standalone page,
causing pkgbase errors due to duplicate METALOG entries. Delete the
MLINK for now to fix the build.

Fixes: 192d326bcff5 ("bus_attach_children.9: New manpage for functions operating on children")
Sponsored by: The FreeBSD Foundation

show more ...

bus_generic_print_child.9: Document bus_print_domain

While here, cross-reference BUS_PRINT_CHILD (and fix a stale reference
to DEVICE_PRINT_CHILD which doesn't exist) and expand the text
describing

bus_generic_print_child.9: Document bus_print_domain

While here, cross-reference BUS_PRINT_CHILD (and fix a stale reference
to DEVICE_PRINT_CHILD which doesn't exist) and expand the text
describing the role of the helper functions.

Differential Revision: https://reviews.freebsd.org/D48373

show more ...