From 91afc9334d59ebf779f5d99dc3d81a93711f81d0 Mon Sep 17 00:00:00 2001
From: Jonathan Wiltshire <jmw@debian.org>
Date: Thu, 31 Jul 2025 07:03:18 +0100
Subject: [PATCH] issues.rst: document openssh issue on interrupted upgrades

---
 source/issues.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/issues.rst b/source/issues.rst
index 470194ab..164407c5 100644
--- a/source/issues.rst
+++ b/source/issues.rst
@@ -17,6 +17,21 @@ Things to be aware of while upgrading to |RELEASENAME|
 This section covers items related to the upgrade from |OLDRELEASENAME| to
 |RELEASENAME|.
 
+.. _bookworm_ssh_issue:
+
+Interrupted remote upgrades
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+An issue in OpenSSH in bookworm can lead to inaccessible remote systems if an
+upgrade being supervised over an SSH connection is interrupted.  Users may
+be unable to re-connect to the remote system to resume the upgrade.
+
+Updated packages for bookworm will resolve this issue in Debian 12.12, but this
+release was still in preparation at the time of releasing trixie.  Instead,
+users planning upgrades to remote systems over an SSH connection are advised to
+first update OpenSSH to version 1:9.2p1-2+deb12u7 or greater through the
+`stable-updates <https://wiki.debian.org/StableUpdates>`__ mechanism.
+
 .. _i386_reduced_support:
 
 Reduced support for i386
-- 
2.47.2

