{
  "status": "shipping",
  "advantages": [],
  "limitations": [],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-11-16",
  "slug": "write-lifetime-hint",
  "term": "Write lifetime hint",
  "aliases": [
    "F_SET_RW_HINT",
    "RWH_WRITE_LIFE"
  ],
  "definition": "A write lifetime hint describes the relative expected time before written data are overwritten or erased, without guaranteeing device placement.",
  "note": "API meaning: SHORT, MEDIUM, LONG and EXTREME are relative classes, not durations in seconds. The Linux manual describes inode hints and open-file-description hints, but imposes no functional guarantee on how storage consumes them. [manual]\n\nVersion boundary: Linux v6.12 fs/fcntl.c dispatches F_GET_RW_HINT and F_SET_RW_HINT to inode state. It has no F_GET_FILE_RW_HINT or F_SET_FILE_RW_HINT cases, even though those names appear in the manual. Header constants and documentation are not a runtime capability test. [linux]\n\nMeasured example: On Linux 6.8.0-149-generic, two separately opened descriptors observed the same inode hint. An invalid value returned EINVAL without changing it; both per-file-description commands returned EINVAL. The probe uses one newly created temporary file and records only syscall results and stored values, not physical placement, WAF or endurance. [observation]\n\nPractical use: Check the actual command result and trace the filesystem, block layer, driver and device path before claiming that a hint separates NAND writes. A read-back value establishes stored metadata only.",
  "related": [
    "multi-stream-ssd",
    "fstream"
  ],
  "citations": [
    {
      "id": "manual",
      "title": "Linux man-pages 6.19: F_GET_RW_HINT(2const), relative lifetime classes",
      "url": "https://man7.org/linux/man-pages/man2/F_GET_RW_HINT.2const.html",
      "accessed": "2026-11-16"
    },
    {
      "id": "linux",
      "title": "Linux v6.12 fs/fcntl.c: inode hint accessors and fcntl command dispatch",
      "url": "https://github.com/torvalds/linux/blob/v6.12/fs/fcntl.c#L337-L393",
      "accessed": "2026-11-16"
    },
    {
      "id": "probe",
      "title": "Hesela: temporary-file write-hint probe source (C)",
      "url": "https://hesela.dev/research/write-hint-probe.c",
      "accessed": "2026-11-16"
    },
    {
      "id": "observation",
      "title": "Hesela: write-hint syscall observations, 2026-11-16",
      "url": "https://hesela.dev/research/write-hint-observation.json",
      "accessed": "2026-11-16"
    }
  ],
  "provenance": [
    "One local API observation on x86_64 with filesystem type 0xef53; this is not a multi-stream SSD experiment.",
    "The reviewed upstream source is v6.12; the native observation is from the separately identified 6.8 Ubuntu kernel. Do not conflate them."
  ]
}
