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 ...

bus_generic_attach.9: Remove manpage for deprecated function

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

bus_attach_children.9: New manpage for functions operating on children

This documents bus_attach_children, bus_delayed_attach_children,
bus_detach_children, bus_enumerate_hinted_children, and
bus_id

bus_attach_children.9: New manpage for functions operating on children

This documents bus_attach_children, bus_delayed_attach_children,
bus_detach_children, bus_enumerate_hinted_children, and
bus_identify_children.

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

show more ...

device_probe_and_attach.9: Document more device functions

Split out separate descriptions of device_probe and device_attach and
include extra details (such as the effect of a disabled hint during
de

device_probe_and_attach.9: Document more device functions

Split out separate descriptions of device_probe and device_attach and
include extra details (such as the effect of a disabled hint during
device_attach). Reframe device_probe_and_attach as a recommended
wrapper function around device_probe and device_attach.

While here, add a description of device_detach.

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

show more ...

sys: Add cpu_update_pcb hook

This MD function is invoked before dumping register set notes when
writing out a core dump to ensure that the PCB for a given thread is
up to date. This provides a cent

sys: Add cpu_update_pcb hook

This MD function is invoked before dumping register set notes when
writing out a core dump to ensure that the PCB for a given thread is
up to date. This provides a centralized place to update the PCB with
values of the current thread for each arch rather than doing this work
in each register set's get method.

Discussed with: jrtc27
Reviewed by: kib, markj
Sponsored by: AFRL, DARPA
Differential Revision: https://reviews.freebsd.org/D44910

show more ...

BUS_CONFIG_INTR.9: Describe bus_config_intr() wrapper function

Reviewed by: ziaee
Differential Revision: https://reviews.freebsd.org/D48372

bus_generic_print_child.9: Add bus_print_child_{header,footer}

These functions are already described in the body, just add them in
the NAME and SYNOPSIS sections along with MLINKS.

Reviewed by: zia

bus_generic_print_child.9: Add bus_print_child_{header,footer}

These functions are already described in the body, just add them in
the NAME and SYNOPSIS sections along with MLINKS.

Reviewed by: ziaee
Differential Revision: https://reviews.freebsd.org/D48370

show more ...

BUS_HINTED_CHILD.9: New manpage to document this bus method

Reviewed by: ziaee, imp
Differential Revision: https://reviews.freebsd.org/D48366

mi_switch.9: Remove cpu_switch, cpu_throw

cpu_machdep.9 was added to document cpu_*, but cpu_switch and cpu_throw
were already documented in mi_switch.9, and MLINKed. cpu_machdep.9
seems like the c

mi_switch.9: Remove cpu_switch, cpu_throw

cpu_machdep.9 was added to document cpu_*, but cpu_switch and cpu_throw
were already documented in mi_switch.9, and MLINKed. cpu_machdep.9
seems like the correct place for this, so remove them from mi_switch.9.

Some of the removed text was stale, although there are few notes that
ought to be added to cpu_machdep.9 in a future commit.

Reported by: tools/pkgbase/metalog_reader.lua
Reviewed by: jhb
Sponsored by: The FreeBSD Foundation
Fixes: 9c87cbbcaaed ("cpu_machdep.9: New manpage describing the semantics of several cpu_*")
Differential Revision: https://reviews.freebsd.org/D48360

show more ...

cpu_machdep.9: New manpage describing the semantics of several cpu_*

This page is not exhaustive but covers all of the MD interface
functions currently declared in <sys/proc.h>.

Requested by: kib
R

cpu_machdep.9: New manpage describing the semantics of several cpu_*

This page is not exhaustive but covers all of the MD interface
functions currently declared in <sys/proc.h>.

Requested by: kib
Reviewed by: kib
Sponsored by: AFRL, DARPA
Differential Revision: https://reviews.freebsd.org/D48022

show more ...

man9: Really complete the removal of MD5.9

Fixes: 46b0db2dbe9f ("Remove unnecessary and now inaccurate kernel side manual page.")
Fixes: 36d68cb2ddd2 ("Complete the removal of the MD5 manual page fr

man9: Really complete the removal of MD5.9

Fixes: 46b0db2dbe9f ("Remove unnecessary and now inaccurate kernel side manual page.")
Fixes: 36d68cb2ddd2 ("Complete the removal of the MD5 manual page from section 9.")

show more ...

Complete the removal of the MD5 manual page from section 9.

ifnet(9): Remove mention of defunct ifaddr_byindex(9).

Fixes: 964b8f8b993d
MFC after: 3 days
Sponsored by: Klara, Inc.
Reviewed by: markj
Differential Revision: https://reviews.freebsd.org/D46174

Deprecate contigfree(9) in favour of free(9)

As of 9e6544dd6e02c46b805d11ab925c4f3b18ad7a4b contigfree(9) is no longer
needed and should not be used anymore. We leave a wrapper for 3rd party
code i

Deprecate contigfree(9) in favour of free(9)

As of 9e6544dd6e02c46b805d11ab925c4f3b18ad7a4b contigfree(9) is no longer
needed and should not be used anymore. We leave a wrapper for 3rd party
code in at least 15.x but remove (almost) all other cases from the tree.

This leaves one use of contigfree(9) untouched; that was the original
trigger for 9e6544dd6e02 and is handled in D45813 (to be committed
seperately later).

Sponsored by: The FreeBSD Foundation
Reviewed by: markj, kib
Tested by: pho (10h stress test run)
Differential Revision: https://reviews.freebsd.org/D46099

show more ...

vm: Retire vm_page_alloc_freelist{,_domain}()

Once upon a time, I created vm_page_alloc_freelist{,_domain}() to
support faster allocation of pages that were mapped by the partial
direct map on 32-bi

vm: Retire vm_page_alloc_freelist{,_domain}()

Once upon a time, I created vm_page_alloc_freelist{,_domain}() to
support faster allocation of pages that were mapped by the partial
direct map on 32-bit MIPS. At the time, I expected that these
functions might find other uses too, but those other uses never
materialized. So, these functions have not been used for some time
now. Instead, people use the more general vm_page_alloc_contig().

Reviewed by: kib, markj
Differential Revision: https://reviews.freebsd.org/D46063

show more ...