Skip to main content
emisar

ZFS pool + dataset operations

v0.1.10

Pool status, dataset inventory, snapshot listing, scrub status, ARC stats, plus operator surface for storage incident response: scrub start/stop, clear pool errors, take/destroy snapshots, dataset rollback.

9 allowed by default 3 need approval by default 1 denied by default
Pack ID
zfs
Vendor
emisar
OS
linux
Actions
13
Required binaries. Install these on the host before relying on the pack — an action that calls a missing one fails at run time.
zpool zfs

Install

emisar pack install fetches this pack, re-validates it, and verifies its content hash against the --hash below — the exact bytes this page was rendered against, so a tampered copy is rejected — before copying it into the runner's packs dir. The command reloads a running daemon itself; no manual restart.

on the runner host 
sudo emisar pack install zfs --hash sha256:394990da7ec4c93e828a021c2b15fd3d4f0deffe3c904fbb06c312c15db73ebc

Actions 13 total

View on GitHub
  • zfs.arc_stats exec low

    /proc/spl/kstat/zfs/arcstats

    Show ARC cache statistics — size, hit ratio, eviction counts.

    View source on GitHub
  • zfs.clear_pool_errors exec high

    zpool clear <pool> [device]

    Clear pool error counters and re-online any FAULTED device that has come back. Use after replacing a failed disk, or after a transient I/O storm cleared. Does NOT touch on-disk data.

    View source on GitHub
  • zfs.dataset_list exec low

    zfs list

    List all datasets with used + avail + refer + mountpoint.

    View source on GitHub
  • zfs.dataset_rollback exec critical

    zfs rollback <dataset>@<snap>

    Roll a dataset back to an earlier snapshot. ALL changes after the snapshot are PERMANENTLY discarded. Intermediate snapshots between current and target are also destroyed (require -r flag). Use only after confirming current data is salvageable from elsewhere or the loss is acceptable.

    View source on GitHub
  • zfs.pool_iostat exec low

    zpool iostat (5s sample)

    Show one 5-second iostat sample per pool.

    View source on GitHub
  • zfs.pool_list exec low

    zpool list

    List all pools with size + alloc + free + fragmentation.

    View source on GitHub
  • zfs.pool_status exec low

    zpool status -v

    Show per-pool vdev tree, scrub state, errors. Use to debug DEGRADED pools.

    View source on GitHub
  • zfs.properties exec low

    zfs get all <dataset>

    List all properties of one dataset (compression, dedup, atime, quota, etc).

    View source on GitHub
  • zfs.scrub_stop exec medium

    zpool scrub -s <pool>

    Stop an in-progress scrub. Use when scrub is impacting workload and the verification can wait for a maintenance window.

    View source on GitHub
  • zfs.snapshot_destroy exec high

    zfs destroy <pool>/<dataset>@<snap>

    Delete one ZFS snapshot. Reclaims the snapshot-exclusive blocks immediately. Irreversible. Confirm the snapshot is not the only thing protecting against a recent ransomware/oops event before destroying.

    View source on GitHub
  • zfs.snapshot_list exec low

    zfs list -t snapshot

    List all snapshots with used + refer + creation.

    View source on GitHub
  • zfs.start_scrub exec high

    zpool scrub <pool>

    Starts a scrub on one pool. Re-reads every block and verifies checksums.

    View source on GitHub
  • zfs.take_snapshot exec medium

    zfs snapshot <dataset>@<name>

    Takes an atomic snapshot of one dataset. Copy-on-write, instant.

    View source on GitHub
← Back to registry
Pack reference Publish your own →