nfs-stateid · shipping · also NFS state identifier

NFSv4 stateid

An NFSv4 stateid is a protocol value identifying server-managed state such as an open, byte-range lock, delegation or layout.

In NFSv4.1 the 16-byte representation contains a sequence field and an opaque part. A filehandle identifies the object; an ordinary stateid identifies associated state and must agree with the current filehandle. Special stateid values have operation-specific meanings. A stateid is neither a content checksum nor a persistence receipt. [1]

After state loss or revocation, recovery must follow the protocol; retaining a filehandle alone does not preserve the previous open or lock state. [2]

Relations

related

nfs-storage, nfs-delegation, nfs-lease, nfs-state-reclaim

Limitations

• The opaque part is not a stable file ID or proof of valid post-restart state. [1, 2]

Citations

1. RFC 8881 (NFSv4.1), section 8.2, Stateid Definition. (accessed 2026-10-18)
2. RFC 8881 (NFSv4.1), section 8.4, Crash Recovery. (accessed 2026-10-18)

Further reading

3. NFS stable writes: what COMMIT, flush and FUA actually promise (accessed 2026-10-18)

JSON: /data/terms/nfs-stateid.json