bus_activate_resource (9)

Leading comments

Copyright (c) 2003 M. Warner Losh

All rights reserved.

This program is free software.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer...

(The comments found at the beginning of the groff file "man9/bus_activate_resource.9freebsd".)

NAME

bus_activate_resource , bus_deactivate_resource - activate or deactivate a resource

SYNOPSIS

In sys/param.h In sys/bus.h

In machine/bus.h In sys/rman.h In machine/resource.h Ft int Fo bus_activate_resource Fa device_t dev int type int rid struct resource *r Fc Ft int Fo bus_deactivate_resource Fa device_t dev int type int rid struct resource *r Fc

DESCRIPTION

These functions activate or deactivate a previously allocated resource. In general, resources must be activated before they can be accessed by the driver so that the bus driver can map the resource into the devices space.

The arguments are as follows:

Fa dev

The device that requests ownership of the resource. Before allocation, the resource is owned by the parent bus.

Fa 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

Fa rid

A pointer to a bus specific handle that identifies the resource being allocated.

Fa r

A pointer to the Vt struct resource returned by bus_alloc_resource9.

RETURN VALUES

Zero is returned on success, otherwise an error is returned.

SEE ALSO

bus_alloc_resource9, device(9), driver(9)

AUTHORS

This manual page was written by An Warner Losh Aq imp@FreeBSD.org .