ntb_spad_is_unsafe(9)

Hey bestie 💖 welcome to ntb_spad_is_unsafe(9), straight outta the Kernel API Manual ✨ This is the tiny helper that does a vibe check on whether it’s safe to use the hardware scratchpads, and ngl it’s giving “short but important” 🫶.

💖 NAME 💖

ntb_spad_is_unsafe — check if it is safe to use the hardware scratchpads 💅

✨ SYNOPSIS ✨

int ntb_spad_is_unsafe (struct ntb_dev *ntb );

So you pass in a struct ntb_dev * named ntb, and you get an int back. That’s the whole signature, bestie 🎀.

🫶 ARGUMENTS 🫶

• ntb — NTB device context. It’s the device’s little context passport, and you’re handing it over so the function knows who we’re talking about 🦋.

🌸 DESCRIPTION 🌸

Okay so here’s the tea ☕: some NTB hardware can be affected by errata 😭. Hardware drivers can advise clients to avoid using scratchpads. Clients may ignore this advice, though caution is recommended — like, this is the driver softly saying “bestie, maybe don’t,” and you can ignore it, but the caution is real 💀✨.

🎀 RETURN 🎀

Zero if it is safe to use scratchpads, or One if it is not safe. That’s it — a tiny return vibe check, no cap 🫶.

🦋 SEE ALSO 🦋

Kernel file ./include/linux/ntb.h — and then the whole extended fam in the exact order: 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_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_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) — periodt, that’s the whole squad 🌈👑.

Cute sign-off: this page says source/version ./include/linux, date October 2026, and page name ntb_spad_is_unsafe(9) — iconic, literally 🎀💜.