{
  "slug": "iocost",
  "term": "IOCost",
  "aliases": [
    "I/O cost model based controller"
  ],
  "definition": "IOCost is a Linux block-I/O controller that distributes service among cgroups using modeled device occupancy and proportional weights.",
  "note": "Accounting: modeled cost represents occupancy, not the completion latency of an individual request. The linear model distinguishes read/write, sequential/random access and request size. Equal bytes or IOPS need not consume equal modeled service. [paper]\n\nSharing: hierarchical weights influence budgets; unused budget can be donated to active groups. Device feedback adjusts the overall issuance rate. This combines proportional allocation with work conservation, rather than assigning every group a fixed IOPS allowance. [paper]\n\nConfiguration: Linux 6.12 exposes device-keyed io.cost.model and io.cost.qos only in the root cgroup; io.weight belongs to non-root groups. Latency percentiles and thresholds in io.cost.qos govern device-level feedback, not separate application deadlines. [linux-doc]",
  "status": "shipping",
  "advantages": [],
  "limitations": [
    {
      "text": "Model calibration and feedback affect achieved sharing; weights alone do not guarantee a fixed throughput ratio.",
      "citationIds": [
        "paper",
        "linux-code"
      ]
    },
    {
      "text": "IOCost availability requires kernel support and device enablement; selecting an elevator does not itself enable this controller.",
      "citationIds": [
        "linux-doc",
        "linux-code"
      ]
    }
  ],
  "related": [
    "cgroup-v2-io-controller",
    "io-scheduler"
  ],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-11-16",
  "citations": [
    {
      "id": "paper",
      "title": "Heo et al. IOCost: Block IO Control for Containers in Datacenters. ASPLOS 2022, sections 3.1-3.6; DOI 10.1145/3503222.3507727.",
      "url": "https://www.cs.cmu.edu/~dskarlat/publications/iocost_asplos22.pdf",
      "accessed": "2026-11-16"
    },
    {
      "id": "linux-doc",
      "title": "Linux 6.12: cgroup v2 I/O interface files",
      "url": "https://docs.kernel.org/6.12/admin-guide/cgroup-v2.html#io-interface-files",
      "accessed": "2026-11-16"
    },
    {
      "id": "linux-code",
      "title": "Linux v6.12: blk-iocost.c, cost model, feedback and cgroup interfaces",
      "url": "https://github.com/torvalds/linux/blob/v6.12/block/blk-iocost.c",
      "accessed": "2026-11-16"
    },
    {
      "id": "hesela",
      "title": "Hesela: Sharing an SSD: who pays for the slowdown?",
      "url": "https://hesela.com/analyses/ssd-fairness-shared-queues/",
      "accessed": "2026-11-16"
    }
  ],
  "provenance": [
    "Source synthesis from the ASPLOS 2022 paper and Linux v6.12; no hardware benchmark or controller experiment was performed."
  ]
}
