From nobody Thu Oct 29 04:59:23 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4jFX8J66Qcz6xmTc for ; Thu, 29 Oct 2026 04:59:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4jFX8J589Sz4cXL for ; Thu, 29 Oct 2026 04:59:28 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1793249968; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hP3qugqsfjX2CwaM5OaZnoNnlIFsq0Syyr1cUIdGqNs=; b=EyGi69zMB9ysChrAOpJDwdB09YK0g3Nb8P7rFBSSOUG4uB9mWxgJWSgcWdKCkmWUmnprrQ x1POK+dD+KHxGJYx27m39UdTBijpJB8rk5O5mXAWe/jxhd7xJj/sRHhxrpMf8f7XZd6cjd /XVaLjyfyL+q4rMR6PuTRDlvRtTvDQpdG1NWrAEF8VYP8wyZSxOLHFm4FAR7q6iU3seZoJ SPWd6erD2stW8jxcdCa+o2PHhSqWmY5/bH7sn/8uU9eW2xoThB7HJRkNj75C0BamFEqa8M 3BUI14j9vQaEbxFk3dHmPUuAjPWZ2gRvBRsjSw81rMN4RYAAU9Wow1rpZNzUpA== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1793249968; b=qAs5VRUziLV122SkNvv8HBaRaa1caCa6iiVn/B1Rs7LJotqEDOf9d01ffWh1oMn4/mkRWU yUwPPVuqD5BZfw2h4Rx/gqEZrJ9UecVyC3qDwt3ksqtV9GU5mKB1uc0UEczUJpEyiqT7ZA CXTkc4w/ik5dZcrPyC/8t+QfFNlUOUOONymAv6Ft2DF39xDfPzaAgPEHgMHLupUhrdpht7 YkQgcU46Xcp2r8CWXUEBbT3jGBuDXt5IffH1tvNe1OBnWBATEcAR7jWMOP08NAnayTa/Q4 RLuELCQeEe/vDGIsS/Mv4/rGD6xzCmDUMJvhpl3Jj1GOe/bvxKgkaxiRW4t/xg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1793249968; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hP3qugqsfjX2CwaM5OaZnoNnlIFsq0Syyr1cUIdGqNs=; b=XeT6gltHDOROjb4QQP7L5jEjg2QKZVHVaFGCtyJXl+z98D+OelgGcbnE3LMXDACwlGeq7n aFiIPs9rn6iB6HRyCu4IEmwJ3ViR9BCJyd85+q2s83iTAPOWY7Hntc877ubn5WkDpEv8yj YJ4VLAZUleIprDlHGEOO8ralS4Vwm4BCq/PLNz4aIUjE+lxKC2h3DSwOF20J5yUjyKsg78 kFLaGDdXfBzGXDt2z4+8hHTsN4qaYBmvwRlfxrFqQIuoeD+nQ6oZZsrQq1RdVClBtNQoAe lnQ4HBgwoI0tXi0Sru5Q/Yv2Q67iHB3rkMeLu5OeMnLVlP2KIn0jZkfH2/pw2g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4jFX8J4qrszPHx for ; Thu, 29 Oct 2026 04:59:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 31ace by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 29 Oct 2026 04:59:23 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Kevin Bowling Subject: git: 1e9d3ab6a356 - stable/15 - iflibdd(9): Clarify resume during suspend rollback List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: Commit messages for all branches of the src repository List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: kbowling X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 1e9d3ab6a3562ddad531200f7cd1b0876e6633a2 Auto-Submitted: auto-generated Date: Thu, 29 Oct 2026 04:59:23 +0000 Message-Id: <6ae2d2ab.31ace.7eb9597b@gitrepo.freebsd.org> The branch stable/15 has been updated by kbowling: URL: https://cgit.FreeBSD.org/src/commit/?id=1e9d3ab6a3562ddad531200f7cd1b0876e6633a2 commit 1e9d3ab6a3562ddad531200f7cd1b0876e6633a2 Author: Kevin Bowling AuthorDate: 2026-09-11 20:16:45 +0000 Commit: Kevin Bowling CommitDate: 2026-10-29 04:59:14 +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. Sponsored by: BBOX.io (cherry picked from commit f496cd95cf9e1ed68b0df3ae2f7a24fc0f66aa6b) --- 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.