{
  "slug": "nfs-lease",
  "term": "NFSv4 lease",
  "aliases": [
    "NFS lease",
    "NFS client lease"
  ],
  "definition": "An NFSv4 lease is a renewable time interval during which the server maintains a client's locking state, subject to the protocol's revocation rules.",
  "note": "For NFSv4.1, one lease covers the state associated with a client ID, and successful SEQUENCE processing renews an unexpired lease. After expiration, renewal is conditional; clients must inspect SEQUENCE status flags for revoked state. Expiration permits revocation; it does not imply that every lock vanished at the deadline. Administrative revocation and unreturned recalls are separate cases. [lease] [expiration] [revocation]\n\nNFSv4.0 has different renewal rules, including RENEW. Lease renewal does not flush file data or validate cached content. [v40]",
  "related": [
    "nfs-storage",
    "nfs-delegation",
    "nfs-grace-period",
    "nfs-stateid"
  ],
  "limitations": [
    {
      "text": "A renewed lease is not a durable-write acknowledgement.",
      "citationIds": [
        "lease"
      ]
    }
  ],
  "citations": [
    {
      "id": "lease",
      "title": "RFC 8881 (NFSv4.1), section 8.3, Lease Renewal.",
      "url": "https://www.rfc-editor.org/rfc/rfc8881.html#section-8.3",
      "accessed": "2026-10-18"
    },
    {
      "id": "expiration",
      "title": "RFC 8881 (NFSv4.1), section 8.4.3, Network Partitions and Recovery.",
      "url": "https://www.rfc-editor.org/rfc/rfc8881.html#section-8.4.3",
      "accessed": "2026-10-18"
    },
    {
      "id": "revocation",
      "title": "RFC 8881 (NFSv4.1), section 8.5, Server Revocation of Locks.",
      "url": "https://www.rfc-editor.org/rfc/rfc8881.html#section-8.5",
      "accessed": "2026-10-18"
    },
    {
      "id": "v40",
      "title": "RFC 7530 (NFSv4.0), section 9.5, Lease Renewal.",
      "url": "https://www.rfc-editor.org/rfc/rfc7530.html#section-9.5",
      "accessed": "2026-10-18"
    },
    {
      "id": "hesela-stability",
      "title": "NFS stable writes: what COMMIT, flush and FUA actually promise",
      "url": "https://hesela.com/analyses/nfs-stable-writes-flush-fua/#state-recovery",
      "accessed": "2026-10-18"
    }
  ],
  "status": "shipping",
  "advantages": [],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-10-18"
}