ntb_peer_port_number(9)

💅 ntb_peer_port_number(9) 💅

okay so bestie, welcome to the Kernel API Manual — today's main character is ntb_peer_port_number(9), and she is literally the friend who knows everyone at the party and can tell you exactly who's who. 🎀

---

✨ NAME ✨

ntb_peer_port_number — get the peer port by given index

(it's giving "you give me a number, I give you a number" but make it kernel 💫)

---

🌸 SYNOPSIS 🌸

int ntb_peer_port_number (struct ntb_dev *ntb , int pidx );

---

🦋 ARGUMENTS 🦋

• ntb — NTB device context. this is the whole device situation you're working with, your main character struct 🫶
• pidx — Peer port index. the little slot number you're asking about ✨

---

💜 DESCRIPTION 💜

so here's the tea: peer ports are continuously enumerated by the NTB API logic — like, the API is always out here keeping count, no cap 🔥 — so this method lets you retrieve a port's real number by its index. iykyk 💅

(index in, real port number out. that's the whole vibe. 🧚)

---

⭐ RETURN ⭐

the peer device port, or a negative value indicating an error 😭 (so like… vibe check the return value before you trust it, fr fr)

---

👑 SEE ALSO 👑

Kernel file ./include/linux/ntb.h and honestly the whole NTB friend group showed up to the group chat:

• enum ntb_topo(9)
• enum ntb_speed(9)
• enum ntb_width(9)
• enum ntb_default_port(9)
• struct ntb_client_ops(9)
• struct ntb_ctx_ops(9)
• struct ntb_dev_ops(9)
• struct ntb_client(9)
• struct ntb_dev(9)
• ntb_register_client(9)
• ntb_unregister_client(9)
• ntb_register_device(9)
• ntb_unregister_device(9)
• ntb_set_ctx(9)
• ntb_clear_ctx(9)
• ntb_link_event(9)
• ntb_db_event(9)
• ntb_msg_event(9)
• ntb_default_port_number(9)
• ntb_default_peer_port_count(9)
• ntb_default_peer_port_number(9)
• ntb_default_peer_port_idx(9)
• ntb_port_number(9)
• ntb_peer_port_count(9)
• ntb_logical_port_number(9)
• ntb_peer_logical_port_number(9)
• ntb_peer_port_idx(9)
• ntb_link_is_up(9)
• ntb_link_enable(9)
• ntb_link_disable(9)
• ntb_mw_count(9)
• ntb_mw_get_align(9)
• ntb_mw_set_trans(9)
• ntb_mw_clear_trans(9)
• ntb_peer_mw_count(9)
• ntb_peer_mw_get_addr(9)
• ntb_peer_mw_set_trans(9)
• ntb_peer_mw_clear_trans(9)
• ntb_db_is_unsafe(9)
• ntb_db_valid_mask(9)
• ntb_db_vector_count(9)
• ntb_db_vector_mask(9)
• ntb_db_read(9)
• ntb_db_set(9)
• ntb_db_clear(9)
• ntb_db_read_mask(9)
• ntb_db_set_mask(9)
• ntb_db_clear_mask(9)
• ntb_peer_db_addr(9)
• ntb_peer_db_read(9)
• ntb_peer_db_set(9)
• ntb_peer_db_clear(9)
• ntb_peer_db_read_mask(9)
• ntb_peer_db_set_mask(9)
• ntb_peer_db_clear_mask(9)
• ntb_spad_is_unsafe(9)
• ntb_spad_count(9)
• ntb_spad_read(9)
• ntb_spad_write(9)
• ntb_peer_spad_addr(9)
• ntb_peer_spad_read(9)
• ntb_peer_spad_write(9)
• ntb_msg_count(9)
• ntb_msg_inbits(9)
• ntb_msg_outbits(9)
• ntb_msg_read_sts(9)
• ntb_msg_clear_sts(9)
• ntb_msg_set_mask(9)
• ntb_msg_clear_mask(9)
• ntb_msg_read(9)
• ntb_peer_msg_write(9)
• ntb_get_dma_dev(9)
• ntb_peer_resource_idx(9)
• ntb_peer_highest_mw_idx(9)

like… the whole extended family. iconic behavior, honestly 🌈

---

💀 reminder bestie: a negative return means error, so don't go treating it like a port number or you WILL be debugging at 3am 😭

---

and that's the page! this lil gem lives over in ./include/linux and the version stamp is October 2026 — so yeah, she's fresh, she's current, and she ate. periodt. 🍓💖