Post-2026.1.0.52 sweep, Tier 2: driver-command-queue API, sandbox owner by display name - #25
Closed
nahumtimerman wants to merge 1 commit into
Closed
Conversation
… by display name Driver command queue inspection and recovery (Trunk CS 189900, ticket 67008). New how-to page for the four sysadmin-gated methods - GetRunningCommands, GetResourceCommandExecutions, CancelResourceCommand, ClearResourceCommands - plus a What's New entry. Signatures, parameter semantics and the sysadmin requirement come from Tools/API/XmlDocumentation/TestShell API/ApiDocumentation.xml, where all four are registered Lang="all". The response shape is RunningCommandListInfo from ApiCommandResult.cs: a Commands list of RunningCommandInfo with ExecutionId, ResourceFullName, CommandName, Status, StartTime and ReservationId. The page leads with why the resource-scoped pair exists - a command belonging to a previous, possibly ended, sandbox blocking an exclusive non-concurrent resource, which a new sandbox cannot see because its view is reservation scoped - and notes that ClearResourceCommands cancels out-of-band so it does not wait behind the command it is clearing, which is what makes it usable from Setup. Sandbox owners and permitted users accepted by display name (CS 189998 + 190000, ticket 67309; release note Docs/ReleaseNotes/2026.1/ sandbox-owner-resolved-by-display-name.md). Keeps the two points that make it safe to rely on: usernames are matched first so nothing existing changes, and an ambiguous display name is rejected rather than resolved arbitrarily. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
nahumtimerman
force-pushed
the
docs/2026.1-patch-sweep-tier2
branch
from
September 9, 2026 14:40
d0a900f to
6eb770b
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Second batch of the post-2026.1.0.52 catch-up. Based on
docs/2026.1-patch-sweep-tier1(#24) — both tiers editwhats-new.md, so they're stacked to avoid a conflict. Merge #24 first and this will retarget tomain.Driver command queue inspection and recovery API
Trunk CS 189900 (ticket 67008). New how-to page for the four sysadmin-gated methods:
GetRunningCommandsCancelResourceCommand(one, by id)GetResourceCommandExecutionsClearResourceCommands(all)Signatures, parameter semantics and the sysadmin requirement come from
Tools/API/XmlDocumentation/TestShell API/ApiDocumentation.xml, where all four are registeredLang="all". The response shape isRunningCommandListInfofromApiCommandResult.cs— aCommandslist ofRunningCommandInfowithExecutionId,ResourceFullName,CommandName,Status,StartTime,ReservationId.The page leads with why the resource-scoped pair exists, since that's the part the method names don't convey: a command belonging to a previous — possibly already ended — sandbox blocks an exclusive, non-concurrent resource, and a new sandbox can't see it because everything it can reach is reservation-scoped. It also notes that
ClearResourceCommandscancels out-of-band and so doesn't wait behind the very command it's clearing, which is what makes it usable from a Setup script.Carries a warning that cancelling a driver command mid-run leaves the device in whatever state it reached — recovery tool, not routine flow.
Sandbox owners and permitted users accepted by display name
CS 189998 + 190000 (ticket 67309), with the release note at
Docs/ReleaseNotes/2026.1/sandbox-owner-resolved-by-display-name.md. Keeps the two points that make it safe to rely on: usernames are matched first so no existing behavior changes, and a display name shared by several users is rejected rather than resolved arbitrarily.Files
docs/devguide/available-cs-api/useful-cs-api-examples/inspect-and-clear-driver-commands.md— new page (sidebar_position: 10; the category index is an auto-generatedDocCardList, so no index edit needed)docs/release-notes/whats-new.md— two new 2026.1 entriesnpx docusaurus buildpasses; the 3 broken links reported are pre-existing and unrelated.🤖 Generated with Claude Code