kern_reboot(9): describe event handlers
ClosedPublic
Actions

Authored by mhorne on Mar 16 2023, 7:36 PM.

Details

Reviewers

markj
imp

Group Reviewers

manpages

Commits

rGf6f8cbda8efc: kern_reboot(9): describe event handlers

Summary

Add more details about the execution and purpose of these shutdown
handlers. Make a point to mention the requirement that they can be run
in a normal or panic context. Add a simple example of a shutdown_final
handler.

Add a brief comment to the declaration in sys/eventhandler.h.

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

mhorne created this revision.Mar 16 2023, 7:36 PM

Herald added a subscriber: imp. · View Herald TranscriptMar 16 2023, 7:36 PM

mhorne requested review of this revision.Mar 16 2023, 7:36 PM

Harbormaster completed remote builds in B50428: Diff 118950.Mar 16 2023, 7:36 PM

mhorne added a parent revision: D39134: kern_reboot(9): document shutdown_nice().Mar 16 2023, 7:36 PM

mhorne added a child revision: D39136: callout(9): adopt old references to timeout(9).

mhorne added reviewers: markj, imp.Mar 16 2023, 7:41 PM

markj accepted this revision.Mar 16 2023, 7:49 PM

markj added inline comments.

share/man/man9/kern_reboot.9
223

This revision is now accepted and ready to land.Mar 16 2023, 7:49 PM

rpokala added a subscriber: rpokala.Mar 16 2023, 8:39 PM

rpokala added inline comments.

share/man/man9/kern_reboot.9
277	This example .Vt shutdown_final handler uses the .Dv RB_NOSYNC flag to detect that a panic or other unusual condition has occurred, and returns early.