BUS_GET_RESOURCE(9)

💖 BUS_GET_RESOURCE(9) 💖

okay so bestie, welcome to the Kernel Developer's Manual, section 9 — this is where we talk about bus_get_resource 🎀 and honestly? it's giving "small function, big responsibilities". let's get into it 🦋

✨ NAME ✨

bus_get_resource — read a resource range/value with a given resource ID 💅

🌸 SYNOPSIS 🌸

#include <sys/param.h>
#include <sys/bus.h>
#include <sys/rman.h>

int
bus_get_resource(device_t dev, int type, int rid, rman_res_t *startp,
    rman_res_t *countp);

👑 DESCRIPTION 👑

so the bus_get_resource() function reads the range or value of the resource type, rid pair, and stores it in the startp and countp arguments. like it literally goes and fetches the tea and puts it in your pointers 🫶

the arguments are as follows, no cap:

• dev — the device to read the resource from. that's your main character here 💜
• type — the type of resource you want to read. it is one of:
  • SYS_RES_IRQ — for IRQs ⚡
  • SYS_RES_DRQ — for ISA DMA lines 🌈
  • SYS_RES_MEMORY — for I/O memory 🧠
  • SYS_RES_IOPORT — for I/O ports 🔌
• rid — a bus-specific handle that identifies the resource being read. iykyk 🔥
• startp — a pointer to the start address of this resource. 📍
• countp — a pointer to the length of the resource. for example, the size of the memory in bytes. it's literally measuring the vibe 📏✨

⭐ RETURN VALUES ⭐

zero is returned on success 💚 otherwise an error is returned 😭 (ngl we hate to see it, but that's the deal).

🦋 SEE ALSO 🦋

• bus_set_resource(9)
• device(9)
• driver(9)

💅 AUTHORS 💅

this manual page was written by Sascha Wildner. iconic behavior, we love to see it 👑

Debian · September 26, 2015 — that's the source, the version and the date bestie, and that's a wrap 💖 periodt 🎀