Page MenuHomeFreeBSD

kern_reboot(9): describe event handlers
ClosedPublic

Authored by mhorne on Mar 16 2023, 7:36 PM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, Nov 26, 9:16 AM
Unknown Object (File)
Fri, Nov 22, 4:44 PM
Unknown Object (File)
Tue, Nov 19, 11:08 PM
Unknown Object (File)
Tue, Nov 19, 2:39 AM
Unknown Object (File)
Tue, Nov 19, 2:00 AM
Unknown Object (File)
Fri, Nov 15, 12:41 PM
Unknown Object (File)
Fri, Nov 15, 11:34 AM
Unknown Object (File)
Fri, Nov 15, 9:53 AM

Details

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

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

Very minor, fixable on commit.

share/man/man9/kern_reboot.9
190

Clarity for EFL readers

213
244
mhorne marked 5 inline comments as done.

Fix nits.

This revision now requires review to proceed.Mar 20 2023, 2:35 PM
This revision is now accepted and ready to land.Mar 20 2023, 4:26 PM
share/man/man9/kern_reboot.9
277
In this example, the

This one's my fault, I botched it in the example I provided. <facepalm>

This revision was automatically updated to reflect the committed changes.