List every configured PBS datastore with its path and any scheduled GC/prune jobs.

Total / used / available bytes for one datastore.

List every backup group on a datastore with its snapshot count, last-backup time, owner, and file count. Groups with zero files are flagged as likely corrupt.

List snapshots on a datastore with size, file count, protected flag, and last verify state — newest first, capped at limit. Set summary=true for one aggregate row per group instead (preferred for overviews).

Set or clear the protected flag on one snapshot. Protected snapshots are skipped by prune and cannot be forgotten until unprotected. Requires PBS_ALLOW_WRITE=true and confirm=true.

Permanently delete one snapshot. The on-disk chunks are freed by the next garbage collection. Requires PBS_ALLOW_WRITE=true and confirm=true.

Return current state of a PBS task (running / stopped) plus exit status if finished.

Fetch log lines from a PBS task. Supports pagination via start/limit, or tail=true for just the end of the log — usually all you need to see how a verify or GC finished.

Browse recent PBS tasks with optional type filter, running-only flag, and errors-only flag. Running or failed tasks come with their full UPID for follow-up via pbs_get_task_status / pbs_get_task_log.

Abort a running PBS task (e.g. a GC or verify stuck on a slow NFS datastore). The task stops at the next safe point; an interrupted GC or verify can simply be re-run later. Requires PBS_ALLOW_WRITE=true and confirm=true.

Return the last garbage-collection statistics: bytes referenced, pending, removed, plus any flagged-bad chunks.

Trigger a garbage-collection run. GC walks every chunk and frees those no longer referenced by any snapshot. Async — returns a UPID immediately. Requires PBS_ALLOW_WRITE=true and confirm=true.

List configured verify jobs: schedule, datastore, and re-verify policy. Answers 'is verification scheduled at all?' — pbs_list_datastores only shows GC/prune schedules.

Trigger a verify task. Verify re-reads every chunk and confirms it matches its expected hash, catching bitrot. By default skips snapshots that were verified OK in the past 30 days. Async — returns a UPID. Requires PBS_ALLOW_WRITE=true and confirm=true.

Preview which snapshots in a backup group would be kept or dropped by a given retention policy.

Apply a retention policy and drop matching snapshots. The on-disk chunks aren't freed until the next garbage collection. Always run pbs_prune_dry_run first. Requires PBS_ALLOW_WRITE=true and confirm=true.

One-call health report for a datastore: storage usage, node load, last GC result, snapshot/verify coverage, backup freshness, corrupt groups, and failed/running tasks. Start here for any 'is PBS okay?' question — it replaces separate status/gc/tasks/groups calls.