Add support for parsing of TaskState

[rst0git]

When parsing the state of a checkpoint, we need to take into account the state of the PID we are analysing. This can be alive, stopped, dead, or zombie. In particular, only processes in alive and stopped task state have CRIU images for memory pages, open files, sockets, etc. This patch extends checkpointctl to display the TaskState of non-alive processes, and skip parsing the runtime state of dead or zombie tasks.

Example:

$ checkpointctl inspect --ps-tree-env /tmp/test.tar 

Displaying container checkpoint tree view from /tmp/test.tar

recursing_meninsky
├── Image: docker.io/library/python:3-alpine
├── ID: fa8e42820889e31fbd668b9c223542b815ee8436df59a92734079cb4bf1eadd4
├── Runtime: runc
├── Created: 2026-01-11T13:50:07Z
├── Engine: Podman
├── Checkpoint size: 3.5 MiB
│   └── Memory pages size: 3.5 MiB
├── Root FS diff size: 34.0 KiB
└── Process tree
    └── [1]  python3
        ├── Environment variables
        │   ├── PYTHON_VERSION=3.14.2
        │   ├── PYTHON_SHA256=ce543ab854bc256b61b71e9b27f831ffd1bfd60a479d639f8be7f9757cf573e9
        │   ├── PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
        │   ├── container=podman
        │   ├── HOME=/root
        │   └── HOSTNAME=fa8e42820889
        └── [6 (Dead)]  python3

$ checkpointctl inspect --sockets /tmp/test.tar 

Displaying container checkpoint tree view from /tmp/test.tar

recursing_meninsky
├── Image: docker.io/library/python:3-alpine
├── ID: fa8e42820889e31fbd668b9c223542b815ee8436df59a92734079cb4bf1eadd4
├── Runtime: runc
├── Created: 2026-01-11T13:50:07Z
├── Engine: Podman
├── Checkpoint size: 3.5 MiB
│   └── Memory pages size: 3.5 MiB
├── Root FS diff size: 34.0 KiB
└── Process tree
    └── [1]  python3
        └── [6 (Dead)]  python3

This patch uses changes to go-criu from checkpoint-restore/go-criu#220

[rst0git]

cc: @TusharMohapatra07

[github-actions]

Test Results

61 tests  ±0   61 ✅ ±0   2s ⏱️ ±0s
 1 suites ±0    0 💤 ±0 
 1 files   ±0    0 ❌ ±0 

Results for commit 11d87da. ± Comparison against base commit a95931b.

♻️ This comment has been updated with latest results.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 86.66667% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.37%. Comparing base (45d1cc7) to head (11d87da).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
cmd/memparse.go	55.55%	2 Missing and 2 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #187      +/-   ##
==========================================
+ Coverage   74.14%   74.37%   +0.23%     
==========================================
  Files          13       13              
  Lines        1257     1284      +27     
==========================================
+ Hits          932      955      +23     
- Misses        251      253       +2     
- Partials       74       76       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[TusharMohapatra07]

I see! We had to propagate the task state to display dead/zombie state in process tree in the output. Thanks :)

[TusharMohapatra07]

Hey @rst0git, out of curiosity, I’d appreciate it if you could explain the design choice behind moving the task states to the go-criu library. Thanks in advance :)

[rst0git]

@TusharMohapatra07 The CRIT tool contains most of the code used for parsing CRIU images, and the Go version of this tool provides most of the core functionality used in checkpointctl. The problem described in #184 also occurs when parsing other image files: checkpoint-restore/go-criu@204cdf1

[TusharMohapatra07]

Makes sense! Thank you so much :)