SG(4)

📦 version 15.1, in freebsd 14.5, freebsd 15.1, nixpkgs unstable

💅 SG(4) — Kernel Interfaces Manual 💅

🌸 NAME 🌸

sg — Linux ioctl-compatible SCSI passthru device.

🦋 SYNOPSIS 🦋

device sg
device scbus

✨ DESCRIPTION ✨

Okay so the sg driver gives you a Linux compatible scsi passthru device. It attaches to all cam(4) peripheral devices. It’s similar to the pass(4) device, but it uses the Linux interfaces rather than the FreeBSD CAM interfaces. That’s the whole vibe. 💅

🎀 IOCTL 🎀

The following subset of the Linux sg ioctl interfaces are implemented:

  • SG_SET_TIMEOUT — u_int to Set the timeout in milliseconds.
  • SG_GET_TIMEOUT — Get the timeout in milliseconds.
  • SG_GET_RESERVED_SIZE — u_int Returns the size of the I/O one can do this device.
  • SG_GET_SCSI_ID — struct sg_scsi_id Returns the bus number, channel, scsi bus ID number, lun and other information about the SCSI device.
  • SG_GET_SG_TABLESIZE — u_int Returns the table size, though hard wired to 0.
  • SG_GET_VERSION_NUM — u_int Return the version number that is implemented.
  • SG_IO — struct sg_io_hdr

All other ioctl interfaces return ENODEV. No cap. 🫶

🌈 FILES 🌈

  • /dev/sg* — Passthru devices. ✨

🫶 SEE ALSO 🫶

cam(4), pass(4)

👑 HISTORY 👑

The sg driver first appeared in FreeBSD 7.0.

💖 xoxo, this one’s from Debian, dated May 6, 2024 — mwah 💋

📦 where this page comes from