{
  "slug": "zfs-error-scrub",
  "term": "ZFS error scrub",
  "aliases": [
    "OpenZFS error scrub"
  ],
  "definition": "A ZFS error scrub is an integrity scan restricted to files already recorded with data errors.",
  "note": "OpenZFS 2.3 exposes this mode as zpool scrub -e and requires a prior scrub with head_errlog enabled. [zscrub] It does not advance last_scrubbed_txg. [zprops]",
  "status": "shipping",
  "advantages": [],
  "limitations": [
    {
      "text": "It does not establish that files outside the known-error set are free of corruption.",
      "citationIds": [
        "zscrub"
      ]
    }
  ],
  "related": [
    "data-scrubbing",
    "checksum",
    "resilver",
    "zfs-transaction-group"
  ],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-10-16",
  "citations": [
    {
      "id": "zscrub",
      "title": "OpenZFS 2.3: zpool-scrub(8), error-scrub scope and prerequisites",
      "url": "https://openzfs.github.io/openzfs-docs/man/v2.3/8/zpool-scrub.8.html",
      "accessed": "2026-10-16"
    },
    {
      "id": "zprops",
      "title": "OpenZFS 2.3: zpoolprops(7), last_scrubbed_txg",
      "url": "https://openzfs.github.io/openzfs-docs/man/v2.3/7/zpoolprops.7.html#last_scrubbed_txg",
      "accessed": "2026-10-16"
    }
  ]
}