git: f496cd95cf9e - main - iflibdd(9): Clarify resume during suspend rollback

The branch main has been updated by kbowling:

URL: https://cgit.FreeBSD.org/src/commit/?id=f496cd95cf9e1ed68b0df3ae2f7a24fc0f66aa6b

commit f496cd95cf9e1ed68b0df3ae2f7a24fc0f66aa6b
Author:     Kevin Bowling <kbowling@FreeBSD.org>
AuthorDate: 2026-09-11 20:16:45 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2026-09-11 20:16:45 +0000

    iflibdd(9): Clarify resume during suspend rollback
    
    The resume callback also runs when suspend fails, without an intervening
    PCI power-state transition or configuration-space restore.  Document
    that drivers must not assume either has occurred.
    
    MFC after:      2 weeks
    Sponsored by:   BBOX.io
---
 share/man/man9/iflibdd.9 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/share/man/man9/iflibdd.9 b/share/man/man9/iflibdd.9
index 54551c9c7053..23c293a604bf 100644
--- a/share/man/man9/iflibdd.9
+++ b/share/man/man9/iflibdd.9
@@ -272,6 +272,10 @@ Shutdown errors are returned without attempting rollback.
 .It Fn ifdi_resume
 Optional function that restores suspend-specific device state while the
 datapath remains stopped.
+This function is also called to roll back a failed suspend.
+It must not assume that a PCI power-state transition or configuration-space
+restore has occurred since
+.Fn ifdi_suspend .
 After it succeeds, iflib initializes the datapath exactly once when the
 interface is administratively up and leaves an administratively-down interface
 stopped.