rc.suspend: execute rc-scripts with suspend keyword

[jo_bruelltuete.com]

Summary

For symmetry with rc.resume, give rc.suspend the ability to execute rc-scripts.
Use the suspend keyword for that.

Use-case is for setting a wake-up time, e.g. via efiwake.

Test Plan

I've tried this on my NAS box, works as intended:

Dummy test script /etc/rc.d/try_resume:

#!/bin/sh -

# KEYWORD: resume
# KEYWORD: suspend
# REQUIRE: jail

logger "try resume: ${1}"

Press the sleep button, optionally wait a minute or so, press wake button:
/var/log/messages

May  4 18:54:46 fred root[53062]: try resume: suspend
May  4 18:54:46 fred acpi[53067]: suspend at 20230504 18:54:46
...noise...
May  4 18:57:53 fred acpi[53080]: resumed at 20230504 18:57:53
...noise...
May  4 18:58:09 fred root[53159]: try resume: resume

[jo_bruelltuete.com]

i've pretty much copy-pasted the added bits from rc.resume and adjusted the keyword. that's it.

[christos]

It'd better to rename the commit title to: rc.suspend: execute rc-scripts with suspend keyword, otherwise LGTM.

[jo_bruelltuete.com]

thanks for looking!

[jo_bruelltuete.com]

feel free to commit if good to go

[markj]

Seems ok to me. Looks like rc.suspend should be documented to some extent in rc.8, if anyone would like to take that on. rc.resume is at least mentioned there.

Approved.

libexec/rc/rc.suspend

45–46

Unrelated, but I think we can safely delete this comment. :)

[jo_bruelltuete.com]

In D39965#916031, @markj wrote:

Looks like rc.suspend should be documented to some extent in rc.8, if anyone would like to take that on. rc.resume is at least mentioned there.

See D40484.