ata_sg_init(9)

💅 ata_sg_init — like, the Kernel API Manual (section 9) said hi

okay so bestie, welcome to ata_sg_init(9) 💖 this one lives in the Kernel API Manual, section 9, and it's genuinely so simple it's kind of iconic for it. no cap.

---

✨ NAME ✨

ata_sg_init — associate a command with a scatter-gather table. that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

void ata_sg_init (struct ata_queued_cmd *qc , struct scatterlist *sg ,
unsigned int n_elem );

like yeah, three args, returns nothing (void), we love a low-stakes king 👑

---

🦋 ARGUMENTS 🦋

• qc — the command you're associating with the table. your main character struct, fr.
• sg — the scatter-gather table itself. the little black dress of the operation 💅
• n_elem — how many elements are in that s/g table. count 'em, bestie, don't guess 🔢

---

💜 DESCRIPTION 💜

so what it does is initialize the data-related elements of the queued_cmd qc so they point at a scatter-gather table sg, which contains n_elem elements. that's it. that's the function. she's straightforward and she knows it ✨

LOCKING: spin_lock_irqsave(host lock)

⚠️ real talk: this is the locking the doc calls out — spin_lock_irqsave(host lock). don't be out here freelancing with your own lock strategy, iykyk 🙈

---

🔥 SEE ALSO 🔥

and now for the part where the manpage just lists, like, everybody. it's giving group photo energy. the kernel file is ./drivers/ata/libata-core.c, and here's the full squad, in order, no skipping, because i would never do you like that 🫶

ata_link_next(9), ata_dev_next(9), ata_dev_phys_link(9), ata_force_cbl(9), ata_force_pflags(9), ata_force_link_limits(9), ata_force_xfermask(9), ata_force_quirks(9), atapi_cmd_type(9), ata_set_rwcmd_protocol(9), ata_tf_read_block(9), ata_build_rw_tf(9), ata_pack_xfermask(9), ata_unpack_xfermask(9), ata_xfer_mask2mode(9), ata_xfer_mode2mask(9), ata_xfer_mode2shift(9), ata_mode_string(9), ata_dev_classify(9), ata_id_string(9), ata_id_c_string(9), ata_read_native_max_address(9), ata_set_max_sectors(9), ata_hpa_resize(9), ata_dump_id(9), ata_id_xfermask(9), ata_exec_internal(9), ata_pio_need_iordy(9), ata_pio_mask_no_iordy(9), ata_do_dev_read_id(9), ata_dev_read_id(9), ata_dev_power_set_standby(9), ata_dev_power_set_active(9), ata_read_log_page(9), ata_dev_configure(9), ata_cable_40wire(9), ata_cable_80wire(9), ata_cable_unknown(9), ata_cable_ignore(9), ata_cable_sata(9), sata_print_link_status(9), ata_dev_pair(9), ata_timing_cycle2mode(9), ata_down_xfermask_limit(9), ata_set_mode(9), ata_wait_ready(9), ata_wait_after_reset(9), ata_std_prereset(9), ata_std_postreset(9), ata_dev_same_device(9), ata_dev_reread_id(9), ata_dev_revalidate(9), ata_is_40wire(9), cable_is_40wire(9), ata_dev_xfermask(9), ata_dev_set_xfermode(9), ata_dev_set_feature(9), ata_dev_init_params(9), atapi_check_dma(9), ata_std_qc_defer(9), ata_sg_clean(9), ata_sg_setup(9), swap_buf_le16(9), ata_qc_free(9), ata_qc_complete(9), ata_qc_get_active(9), ata_qc_issue(9), ata_phys_link_online(9), ata_phys_link_offline(9), ata_link_online(9), ata_link_offline(9), ata_host_suspend(9), ata_host_resume(9), ata_dev_init(9), ata_link_init(9), sata_link_init_spd(9), ata_port_alloc(9), ata_host_alloc(9), ata_host_alloc_pinfo(9), ata_finalize_port_ops(9), ata_host_start(9), ata_host_init(9), ata_host_register(9), ata_host_activate(9), ata_dev_free_resources(9), ata_port_detach(9), ata_host_detach(9), ata_pci_remove_one(9), ata_platform_remove_one(9), ata_msleep(9), ata_wait_register(9)

like. that's the whole friend group. say hi back when you see them 💀

---

and that's the page, bestie 🌈 this little cutie came out of ./drivers/ata, dated October 2026, and obviously it's ata_sg_init(9) — slay, go initialize something, periodt 👑✨