Skip to content

Commit 018a350

Browse files
api.md: regenerate from nasty@8ee3ac9
1 parent c0c2573 commit 018a350

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

api.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -257,6 +257,11 @@ this to surface a top-bar "reboot pending" cue. False when
257257
the running version probe fails (unknown) or the wrapper has
258258
no pinned ref to compare against. |
259259
| `bcachefs_pinned_ref` | string | no | The ref currently pinned in `/etc/nixos/flake.lock` for `bcachefs-tools`. |
260+
| `bcachefs_recommended_ref` | string | no | The bcachefs-tools ref this NASty build was shipped/tested with
261+
(parsed from nasty's flake.nix baked into the engine at build
262+
time). When this differs from `bcachefs_pinned_ref`, the WebUI's
263+
top-bar chip offers a one-click switch of the operator's pin to
264+
this ref. `None` if the embedded flake can't be parsed. |
260265
| `bcachefs_version` | string | yes | Output of `bcachefs version` (first line). |
261266
| `engine_built` | string | no | Build timestamp of the engine binary. |
262267
| `engine_commit` | string | no | Git commit the engine binary was compiled from. |
@@ -6781,15 +6786,28 @@ no recorded failure. |
67816786

67826787
| Field | Type | Required | Description |
67836788
|-------|------|:--------:|-------------|
6789+
| `checksum_errors` | integer | no | Cumulative checksum errors (since filesystem creation). |
67846790
| `data_allowed` | string | no | Which data types are allowed on this device (e.g. "journal,btree,user"). |
67856791
| `discard` | boolean | no | Whether TRIM/discard is enabled on this device. |
67866792
| `durability` | integer | no | How many replicas a copy on this device counts for.
67876793
0 = cache only, 1 = normal (default), 2 = hardware RAID. |
67886794
| `has_data` | string | no | Which data types are currently stored on this device (e.g. "btree,user"). |
67896795
| `label` | string | no | Hierarchical label (e.g. "ssd.fast", "hdd.archive").
67906796
Used for target-based tiering. |
6797+
| `member_index` | integer | no | bcachefs member index (the `Device N` slot). Stable across
6798+
reboots and independent of the kernel device name, so it
6799+
disambiguates "is this the same member?" when a disk is removed
6800+
and re-added — possibly in a different physical slot. From
6801+
show-super, so available mounted or not. See #452. |
67916802
| `path` | string | yes | |
6803+
| `read_errors` | integer | no | Cumulative read IO errors (since filesystem creation), from
6804+
`/sys/fs/bcachefs/<uuid>/dev-N/io_errors`. Only populated while
6805+
the filesystem is mounted (sysfs is absent otherwise). |
67926806
| `state` | string | no | Persistent device state: rw, ro, evacuating, spare. |
6807+
| `uuid` | string | no | Stable per-device bcachefs UUID (distinct from the filesystem
6808+
UUID). From `/sys/fs/bcachefs/<fs>/dev-N/uuid`, so populated only
6809+
while mounted. |
6810+
| `write_errors` | integer | no | Cumulative write IO errors (since filesystem creation). |
67936811

67946812
### `FilesystemOptions`
67956813

0 commit comments

Comments
 (0)