BUS_SET_RESOURCE(9)

okay bestie, welcome to BUS_SET_RESOURCE(9), straight from the Kernel Developer's Manual — and it's giving “associate a definite resource with a given resource ID” energy. like, this is the page for bus_set_resource, and we're gonna get into it 💅✨

🌸 NAME 🌸

bus_set_resource — associate a definite resource with a given resource ID 🎀

✨ SYNOPSIS ✨

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

#include <machine/bus.h>
#include <sys/rman.h>
#include <machine/resource.h>

int
bus_set_resource(device_t dev, int type, int rid, rman_res_t start,
    rman_res_t count);

🎀 DESCRIPTION 🎀

okay so the bus_set_resource() function sets the start address of the resource type, rid pair to be count long. that's the whole move, bestie 💖

ngl, client drivers typically do not use this interface. bus drivers, though? they use it a lot to set up the resources a client driver uses. main character bus-driver behavior, honestly 🫶

💅 the arguments 💅

• dev — the device you're setting the resource on.
• type — the type of resource you want to allocate. it is one of:
  • SYS_RES_IRQ — for IRQs
  • SYS_RES_DRQ — for ISA DMA lines
  • SYS_RES_IOPORT — for I/O ports
  • SYS_RES_MEMORY — for I/O memory
• rid — a bus-specific handle that identifies the resource being allocated.
• start — the start address of this resource.
• count — the length of the resource. for example, the size of the memory in bytes. yes, bytes, bestie 🍓

💖 RETURN VALUES 💖

zero is returned on success — otherwise, an error is returned. so like, zero = slay, anything else = the vibe check failed 😭👑

🦋 SEE ALSO 🦋

go peek at these, iykyk:

• bus_alloc_resource(9)
• bus_get_resource(9)
• device(9)
• driver(9)

👑 AUTHORS 👑

this manual page was written by Warner Losh <imp@FreeBSD.org> 💜

💅 that's the whole page, bestie — this cutie comes from the Debian manpage drop, dated March 29, 2003, and it's filed under BUS_SET_RESOURCE(9). mwah 💖🌈