Skip to content

Commit 10e72d0

Browse files
K2GO-386 docs(app-backstop): fix stale debug-receiver Javadoc after the reorient
The debug hook doc still described the old stop-and-stay-down path (set desired=DOWN, box stays down). After the L3b reorient the debug hook runs the FORCED path: it always CONTAINs, reaps and reclaims, then leaves desired=UP and lets the reconciler relaunch the box. It never advances the escalation count. Correct the class Javadoc to match. Device-verified on HD1901.
1 parent 82b3039 commit 10e72d0

1 file changed

Lines changed: 6 additions & 4 deletions

File tree

‎controller/app/src/debug/java/org/appdevforall/k2go/diskguard/debug/DebugDiskGuardReceiver.java‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,8 @@
99

1010
/**
1111
* DEBUG-ONLY. K2GO-386 device-verify hook. Forces one disk-guard check with an injected floor so the
12-
* full protective path (set desired=DOWN → reap the box → reclaim the runaway log → notify) can be
13-
* verified on device WITHOUT first filling ~58 GB. Lives in src/debug, so it never ships in release.
12+
* protective path (reap the box -> reclaim the runaway log -> restart) can be verified on device WITHOUT
13+
* first filling ~58 GB. Lives in src/debug, so it never ships in release.
1414
*
1515
* <p>Exported (it is the whole point — an adb-reachable surface, unlike the app's non-exported
1616
* services), mirroring {@link org.appdevforall.k2go.delivery.debug.DebugDeliveryReceiver}. A huge
@@ -23,8 +23,10 @@
2323
* --el floor_bytes 999999999999
2424
* </pre>
2525
*
26-
* Watch it act in logcat: {@code adb logcat -s K2Go-DiskGuard}. Because it sets desired=DOWN, the box
27-
* stays down after the reap; re-enable the server from the app to bring it back.
26+
* Watch it act in logcat: {@code adb logcat -s K2Go-DiskGuard}. The debug hook runs the FORCED path,
27+
* which always CONTAINs: it reaps and reclaims, then leaves the server desired=UP and asks the
28+
* reconciler to relaunch a fresh box. It never advances the real escalation count, so repeated
29+
* triggers cannot stop the box.
2830
*/
2931
public final class DebugDiskGuardReceiver extends BroadcastReceiver {
3032

0 commit comments

Comments
 (0)