{
  "slug": "scsi-report-luns",
  "term": "SCSI REPORT LUNS",
  "aliases": [
    "REPORT LUNS"
  ],
  "definition": "REPORT LUNS is a SCSI command that returns a SELECT REPORT-filtered inventory of logical unit numbers accessible through the requesting initiator-target nexus.",
  "note": "Scope: SELECT REPORT filters address classes; 02h requests all accessible LUNs, not an array-wide census. A returned LUN is an address, not a persistent device identifier. Enumeration can succeed while other commands are not ready. [seagate-report-luns]\n\nCompleteness: LUN LIST LENGTH counts descriptor bytes, excluding the eight-byte header. The cited library's two-LUN example allocates 16 bytes and receives one eight-byte descriptor plus the header, although the length field still reports 16. An unchanged two-entry inventory needs 24 bytes in total. [oracle-report-luns]\n\nReader guidance: Preserve the requested selection, nexus and actual received length. Check the header and complete descriptors before decoding; bound allocation arithmetic and re-check any larger response. A retry does not establish a stable inventory snapshot.\n\nHost discovery: Linux v6.12 probes returned LUNs separately. Its sequential fallback may stop at a missing LUN unless sparse scanning applies; the visible host inventory depends on scan policy as well as the target's list. [linux-lun-scan]",
  "status": "shipping",
  "advantages": [],
  "limitations": [],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-11-14",
  "related": [
    "scsi-logical-unit",
    "logical-unit-number",
    "lun-masking",
    "initiator-target",
    "scsi-device-identification"
  ],
  "citations": [
    {
      "id": "seagate-report-luns",
      "title": "Seagate SCSI Commands Reference Rev. M (June 2022), sections 2.2.6, 3.36 and 5.4.9",
      "url": "https://www.seagate.com/content/dam/seagate/migrated-assets/staticfiles/support/docs/manual/Interface%20manuals/100293068m.pdf",
      "accessed": "2026-11-14"
    },
    {
      "id": "oracle-report-luns",
      "title": "Oracle SL4000 SCSI Reference: REPORT LUNS (A0h), Select Report and Report LUNs Data",
      "url": "https://docs.oracle.com/en/storage/tape-storage/sl4000/slksr/report-luns-a0h.html",
      "accessed": "2026-11-14"
    },
    {
      "id": "linux-lun-scan",
      "title": "Linux v6.12 scsi_scan.c: REPORT LUNS and sequential scanning",
      "url": "https://github.com/torvalds/linux/blob/adc218676eef25575469234709c2d87185ca223a/drivers/scsi/scsi_scan.c",
      "accessed": "2026-11-14"
    }
  ],
  "provenance": [
    "Primary-source synthesis; the allocation example is documented arithmetic, not captured hardware I/O.",
    "Reader validation and retry guidance are engineering deductions, not a universal device retry rule.",
    "The host-discovery statement is source inspection at Linux v6.12, not a rescan experiment or a claim about all kernels."
  ]
}