Skip to content

Commit 9771d8b

Browse files
api.md: regenerate from nasty@0eae6e2
1 parent df870ea commit 9771d8b

1 file changed

Lines changed: 20 additions & 1 deletion

File tree

api.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1131,8 +1131,23 @@ Return current scrub status.
11311131

11321132
| Field | Type | Required | Description |
11331133
|-------|------|:--------:|-------------|
1134-
| `raw` | string | yes | Raw text output from the bcachefs scrub status command. |
1134+
| `last_duration_secs` | integer | no | Duration of the most recent completed scrub, in seconds. |
1135+
| `last_outcome` | `ScrubOutcome` \| null | no | Outcome of the most recent completed scrub. |
1136+
| `last_output` | string | no | Captured stdout+stderr from the most recent completed scrub.
1137+
Truncated to the last `SCRUB_OUTPUT_KEEP_BYTES` so a chatty
1138+
long-running scrub doesn't bloat the state file. |
1139+
| `last_run_at` | integer | no | Unix seconds when the most recent completed scrub finished. |
1140+
| `progress_percent` | number | no | 0-100 progress of the in-flight scrub, parsed from the
1141+
most recent `XX%` token in bcachefs's streaming output. Only
1142+
populated while `running`; deliberately NOT persisted so an
1143+
engine restart while a scrub is in flight doesn't surface
1144+
a stale percent from a child that's no longer being read. |
1145+
| `raw` | string | yes | Human-readable summary string — kept for backward compatibility
1146+
with the existing Diagnostics tab renderer (which reads `raw`).
1147+
New WebUI surfaces should prefer the typed fields above. |
11351148
| `running` | boolean | yes | Whether a scrub is currently in progress. |
1149+
| `started_at` | integer | no | Unix seconds when the current run started. `Some` while
1150+
`running`; cleared on completion. |
11361151

11371152

11381153
### `fs.reconcile.status`
@@ -6992,6 +7007,10 @@ transition is also visible on the wizard's polled UI. |
69927007

69937008
Enum: `admin`
69947009

7010+
### `ScrubOutcome`
7011+
7012+
*(see schema)*
7013+
69957014
### `ScsiErrorCounters`
69967015

69977016
| Field | Type | Required | Description |

0 commit comments

Comments
 (0)