{
  "slug": "btrfs-received-uuid",
  "term": "Btrfs received UUID",
  "aliases": [
    "received_uuid"
  ],
  "definition": "A Btrfs received UUID is a subvolume metadata field recording the source subvolume identity associated with a received replication stream.",
  "note": "It differs from the destination's own UUID and is not a content hash. In btrfs-progs v6.17, source lookup tries received UUID and then local UUID; subvol_uuid_search accepts a transid parameter without using it in its body. This observation concerns that lookup, not every check in the receive path. [receive-code] [lookup-code]\n\nThe property command protects a received read-only base against an ordinary switch to writable state. Its forced path attempts to clear the received identity after changing the flag; a clear failure is warned about. Inspect actual state and preserve the original base for further replication. [property-code]",
  "status": "shipping",
  "advantages": [],
  "limitations": [
    {
      "text": "A matching identity does not prove unchanged contents or application-consistent recovery.",
      "citationIds": [
        "receive-code",
        "lookup-code",
        "property-code"
      ]
    }
  ],
  "related": [
    "btrfs",
    "btrfs-send-stream",
    "btrfs-read-only-subvolume",
    "snapshot"
  ],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-10-18",
  "provenance": [
    "Version-pinned documentation and source review of btrfs-progs v6.17; no runtime or recovery experiment."
  ],
  "citations": [
    {
      "id": "receive-code",
      "title": "btrfs-progs v6.17: source lookup, receive finalization and dump dispatch",
      "url": "https://github.com/kdave/btrfs-progs/blob/c03e29f083678f47a7d7d810db4d21d905979b77/cmds/receive.c",
      "accessed": "2026-10-18"
    },
    {
      "id": "lookup-code",
      "title": "btrfs-progs v6.17: subvol_uuid_search implementation",
      "url": "https://github.com/kdave/btrfs-progs/blob/c03e29f083678f47a7d7d810db4d21d905979b77/common/send-utils.c",
      "accessed": "2026-10-18"
    },
    {
      "id": "property-code",
      "title": "btrfs-progs v6.17: prop_read_only and UUID reset error handling",
      "url": "https://github.com/kdave/btrfs-progs/blob/c03e29f083678f47a7d7d810db4d21d905979b77/cmds/property.c",
      "accessed": "2026-10-18"
    },
    {
      "id": "hesela",
      "title": "Keeping Btrfs incremental backups recoverable",
      "url": "https://hesela.com/analyses/btrfs-incremental-send-recovery-contract/",
      "accessed": "2026-10-18"
    }
  ]
}