asd_update_port_links(9)

💅 asd_update_port_links — like, the Kernel API Manual, bestie (section 9) ✨

okay so picture this: you're deep in the asd_update_port_links(9) manpage from the Kernel API Manual, and honestly? it's giving "small function, big responsibilities" and we're gonna get into it 🫶

---

🌸 NAME 🌸

asd_update_port_links — update port_map_by_links and phy_is_up ✨

like yes, that's the whole pitch, but the lore is so much juicier, keep reading 💖

---

🦋 SYNOPSIS 🦋

void asd_update_port_links (struct asd_ha_struct *asd_ha , struct
       asd_phy *phy );

it returns nothing (void, periodt) and it takes exactly two things. no more, no less, no cap 💀

---

🎀 ARGUMENTS 🎀

• asd_ha — a pointer to the host adapter structure, aka the main character of this whole operation 👑
• phy — a pointer to the phy that's been added to a port, the little guy we're doing all this for 🥺

---

🌈 DESCRIPTION 🌈

so there are like, two whole situations where this function gets called, and both of them are iconic in their own way:

1. when a link reset has completed and we got BYTES DMAED with a valid frame, we call this function for that phy, to say "hey bestie, this phy is up" — meaning we update the phy_is_up in DDB 0 ✨ and here's the tea: the sequencer checks phy_is_up when pending SCBs are to be sent, and also when an open address frame has been received. so yeah, it matters. a lot. 🔥
2. when we know of ports, we call this function to update the map of phys participating in that port — so we update the port_map_by_links in DDB 0 📋 and when a HARD_RESET primitive has been received, the sequencer disables all phys in that port 😭 so like, respect the map, fr fr. also port_map_by_links is used as the conn_mask byte in the initiator/target port DDB. multitasking icon behavior, honestly 💅

no fr, both of these are just "update the DDB 0 fields" but the why is doing so much heavy lifting here and we love that for us 🎀

---

💜 SEE ALSO 💜

you're gonna want to peek at the kernel file ./drivers/scsi/aic94xx/aic94xx_seq.c (the source of truth, the mothership, the vibe) and then honestly just binge the whole friend group:

• asd_pause_cseq(9)
• asd_unpause_cseq(9)
• asd_seq_pause_lseq(9)
• asd_pause_lseq(9)
• asd_seq_unpause_lseq(9)
• asd_verify_lseq(9)
• asd_verify_seq(9)
• asd_seq_download_seqs(9)
• asd_init_cseq_mip(9)
• asd_init_cseq_mdp(9)
• asd_init_cseq_scratch(9)
• asd_init_lseq_mip(9)
• asd_init_lseq_mdp(9)
• asd_init_lseq_scratch(9)
• asd_init_scb_sites(9)
• asd_init_cseq_cio(9)
• asd_init_lseq_cio(9)
• asd_post_init_cseq(9)
• asd_init_ddb_0(9)
• asd_seq_setup_seqs(9)
• asd_seq_start_cseq(9)
• asd_seq_start_lseq(9)

like that's the whole friend group, iykyk 🌸

---

and that's the page!! this little beauty lives in ./drivers/scsi/aic94xx and the version on deck is dated October 2026 — go off, you absolute icon 🧚‍♀️⭐ mwah 💋