{
  "slug": "zfs-redaction-bookmark",
  "term": "ZFS redaction bookmark",
  "aliases": [
    "OpenZFS redaction bookmark"
  ],
  "definition": "A ZFS redaction bookmark records blocks to omit and the descendant snapshots used to define a redacted send.",
  "note": "The parent block is omitted only if none of the selected descendant snapshots references it. Keeping that block in even one selected snapshot means it is sent. [send]\n\nFor --redact, the bookmark must have been created for the snapshot being sent. The stream carries the selected-snapshot list; the receiver retains it and uses it to check compatible subsequent receives. [send]\n\nThe redaction_bookmarks feature supports creating this record; redacted_datasets supports receiving the resulting incomplete dataset. These are separate pool capabilities. [features]",
  "status": "shipping",
  "advantages": [],
  "limitations": [
    {
      "text": "Only user data is redacted; raw and redacted sends cannot be combined in OpenZFS v2.3.",
      "citationIds": [
        "send"
      ]
    },
    {
      "text": "The received redacted dataset is incomplete, not a directly usable full recovery image.",
      "citationIds": [
        "features"
      ]
    }
  ],
  "related": [
    "zfs-bookmark",
    "zfs-clone",
    "snapshot",
    "incremental-backup",
    "zfs-raw-send"
  ],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-11-11",
  "citations": [
    {
      "id": "send",
      "title": "OpenZFS v2.3: zfs-send(8), --redact, zfs redact and Redaction",
      "url": "https://openzfs.github.io/openzfs-docs/man/v2.3/8/zfs-send.8.html",
      "accessed": "2026-11-11"
    },
    {
      "id": "features",
      "title": "OpenZFS v2.3: zpool-features(7), redaction_bookmarks and redacted_datasets",
      "url": "https://openzfs.github.io/openzfs-docs/man/v2.3/7/zpool-features.7.html",
      "accessed": "2026-11-11"
    },
    {
      "id": "hesela-recovery",
      "title": "Hesela: Snapshots and backups: which failures can you recover from?",
      "url": "https://hesela.com/analyses/snapshot-backup-recovery-boundaries/#zfs-redaction",
      "accessed": "2026-11-10"
    }
  ],
  "provenance": [
    "Version scope: OpenZFS v2.3 manuals. Documentation review only; no pool operation or restore experiment."
  ]
}