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 in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
$FreeBSD: head/share/man/man9/bus_activate_resource.9 112774 2003-03-29 05:16:15Z imp $
.Dd March 28, 2003 .Dt BUS_ACTIVATE_RESOURCE 9 .Os .Sh NAME .Nm bus_activate_resource, bus_deactivate_resources .Nd activates or deactivates a resources .Sh SYNOPSIS n sys/param.h n sys/bus.h
p n machine/bus.h n sys/rman.h n machine/resource.h .Ft int .Fn bus_activate_resource "device_t dev" "int type" "int *rid" "struct resource *r" .Ft int .Fn bus_deactivate_resource "device_t dev" "int type" "int *rid" "struct resource *r" .Sh DESCRIPTION Activates or deactivates 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.
p
Its arguments are as follows:
l -item t .Fa dev
is the device that requests ownership of the resource.
Before allocation, the resource is owned by the parent bus.
t .Fa type
is the type of resource you want to allocate.
It is one of:
l -tag -width SYS_RES_MEMORY t Dv SYS_RES_IRQ for IRQs
t Dv SYS_RES_DRQ for ISA DMA lines
t Dv SYS_RES_IOPORT for I/O ports
t Dv SYS_RES_MEMORY for I/O memory
.El
t .Fa rid
points to a bus specific handle that identifies the resource being allocated.
t .Fa r
points to the
.Ft struct resource
returned by
.Xr bus_alloc_resource 9 .
.El
.Sh RETURN VALUES
Zero indicates success.
Non-zero is an error from errno.h.
.Sh EXAMPLES
.Bd -literal
.Ed
.Sh SEE ALSO
.Xr bus_alloc_resource 9 ,
.Xr device 9 ,
.Xr driver 9
.Sh AUTHORS
.An -nosplit
This man page was written by
.An Warner Losh Aq imp@FreeBSD.org .