← Back to issue list

docs: Add `snap run --strace` discussion to the “Debug a Snap” Guide

View original Github issue

Metadata

Project
snapcraft
Number
#5900
Type
issue
State
open
Author
hillpd
Labels
Type: Documentation
Created
Updated
Closed

Current evaluation

Docs request to add a `snap run --strace` section to the 'Debug a Snap' guide for capturing syscalls under confinement. Maintainer acknowledged it was likely lost in a docs migration; no strace content exists in the repo yet.

Suggested action: keep open

Reason: Maintainer @bepri acknowledged the request (2025-12-05), noting the `snap run --strace` content was likely lost in a recent docs overhaul/migration, confirming it is a real gap. The current debug-a-snap.rst ends with a 'Debug with snapd' section that only links out to snapd docs and contains no strace reference (verified via grep), so the request remains valid and applicable.

Impact: 25 Quick Win: 21.25 Staleness: 55 Complexity: 15 Confidence: 70 Support Request: 0

Issue body

Adding a short section would help developers understand how to capture syscalls inside snap confinement. This functionality isn’t documented anywhere outside the `snap(8)` manpage, so surfacing it in the debugging guide would make it more discoverable. --- *Reported from: https://documentation.ubuntu.com/snapcraft/stable/how-to/debugging/debug-a-snap/*

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 25
Quick Win: 21.25
Staleness: 55
Complexity: 15
Confidence: 70
Support Request: 0
keep open Docs request to add a `snap run --strace` section to the 'Debug a Snap' guide for capturing syscalls under confinement. Maintainer acknowledged it was likely lost in a docs migration; no strace content exists in the repo yet.
qwen/qwen3.6-35b-a3b
Staleness: 65
Complexity: 15
Confidence: 80
Support Request: 0
keep open Request to add snap run --strace documentation to the Debug a Snap guide. Currently unaddressed after a maintainer acknowledged it may have been lost during a docs overhaul.
qwen3.6-35b-a3b-mtp-q6
Staleness: 65
Complexity: 10
Confidence: 75
Support Request: 0
needs triage Request to add snap run --strace documentation to the Debug a Snap guide. Acknowledged by a contributor who notes the content may have been lost during a recent docs migration. Currently awaiting implementation.
qwen3.6-35b-a3b-mtp-q6
Staleness: 65
Complexity: 10
Confidence: 85
Support Request: 0
keep open Proposal to add snap run --strace documentation to the Debug a Snap guide for capturing syscalls in confined snaps. Previously existed but was lost during a docs migration. Open and pending documentation update.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.