ntb_mw_get_align(9)

🎀 NAME 🎀

okay so bestie, you're on the ntb_mw_get_align(9) page from the Kernel API Manual, and the name is literally ntb_mw_get_align — get the restriction parameters of inbound memory window. iykyk 💅

✨ SYNOPSIS ✨

here's the exact summoning spell, no cap:

int ntb_mw_get_align (struct ntb_dev *ntb , int pidx , int widx ,
       resource_size_t *addr_align , resource_size_t *size_align ,
       resource_size_t *size_max );

🌸 ARGUMENTS 🌸

• ntb — NTB device context. it's giving main character device energy.
• pidx — Port index of peer device.
• widx — Memory window index.
• addr_align — OUT - the base alignment for translating the memory window.
• size_align — OUT - the size alignment for translating the memory window.
• size_max — OUT - the maximum size of the memory window.

🦋 DESCRIPTION 🦋

This one gets the alignments of an inbound memory window with the index you specified. literally what it says on the tin.

You can give NULL for any output parameter if the value is not needed — no pressure, bestie.

The alignment and size parameters may be used for allocation of proper shared memory. that's the tea 🍵.

⚠️ Note: this must only be called when the link is up. do not skip the vibe check on this one, fr fr.

💖 RETURN 💖

It returns zero on success, otherwise a negative error number. slay when it's zero, and when it's not, you get that negative error number 😭.

🌈 SEE ALSO 🌈

Kernel file ./include/linux/ntb.h — and then the whole squad, all iconic:

• 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_peer_port_number(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_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)

---

source/version ./include/linux · date October 2026 · ntb_mw_get_align(9) signing off, mwah 💋🫶