aboutsummaryrefslogtreecommitdiff
path: root/share/man/man9/bus_activate_resource.9
Commit message (Collapse)AuthorAgeFilesLines
* Remove $FreeBSD$: two-line nroff patternWarner Losh2023-08-231-2/+0
| | | | | | | Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/ Similar commit in main: (cherry picked from commit fa9896e082a1)
* Fix accidentally changed copyright year.Warner Losh2019-12-041-1/+1
| | | | | | | Noticed by: bapt@ Notes: svn path=/head/; revision=355393
* Regularize copyright notices for me.Warner Losh2019-12-031-5/+1
| | | | | | | | Remove stray All Rights Reserved and other non-license stuff. Make sure all copyrights have year. Notes: svn path=/head/; revision=355330
* Add new bus methods for mapping resources.John Baldwin2016-05-201-1/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a pair of bus methods that can be used to "map" resources for direct CPU access using bus_space(9). bus_map_resource() creates a mapping and bus_unmap_resource() releases a previously created mapping. Mappings are described by 'struct resource_map' object. Pointers to these objects can be passed as the first argument to the bus_space wrapper API used for bus resources. Drivers that wish to map all of a resource using default settings (for example, using uncacheable memory attributes) do not need to change. However, drivers that wish to use non-default settings can now do so without jumping through hoops. First, an RF_UNMAPPED flag is added to request that a resource is not implicitly mapped with the default settings when it is activated. This permits other activation steps (such as enabling I/O or memory decoding in a device's PCI command register) to be taken without creating a mapping. Right now the AGP drivers don't set RF_ACTIVE to avoid using up a large amount of KVA to map the AGP aperture on 32-bit platforms. Once RF_UNMAPPED is supported on all platforms that support AGP this can be changed to using RF_UNMAPPED with RF_ACTIVE instead. Second, bus_map_resource accepts an optional structure that defines additional settings for a given mapping. For example, a driver can now request to map only a subset of a resource instead of the entire range. The AGP driver could also use this to only map the first page of the aperture (IIRC, it calls pmap_mapdev() directly to map the first page currently). I will also eventually change the PCI-PCI bridge driver to request mappings of the subset of the I/O window resource on its parent side to create mappings for child devices rather than passing child resources directly up to nexus to be mapped. This also permits bridges that do address translation to request suitable mappings from a resource on the "upper" side of the bus when mapping resources on the "lower" side of the bus. Another attribute that can be specified is an alternate memory attribute for memory-mapped resources. This can be used to request a Write-Combining mapping of a PCI BAR in an MI fashion. (Currently the drivers that do this call pmap_change_attr() directly for x86 only.) Note that this commit only adds the MI framework. Each platform needs to add support for handling RF_UNMAPPED and thew new bus_map/unmap_resource methods. Generally speaking, any drivers that are calling rman_set_bustag() and rman_set_bushandle() need to be updated. Discussed on: arch Reviewed by: cem Differential Revision: https://reviews.freebsd.org/D5237 Notes: svn path=/head/; revision=300317
* Add a missing section to a cross-reference.John Baldwin2016-05-101-2/+3
| | | | | | | While here, add bus_space(9) to the SEE ALSO section. Notes: svn path=/head/; revision=299372
* Add some notes about the implicit resource mapping for activated resources.John Baldwin2016-04-281-2/+47
| | | | | | | | | Specifically, mention that rman_get_bustag/handle/virtual are valid after a resource is activated. Also, mention the wrapper API that accepts a struct resource instead of a bus tag and handle. Notes: svn path=/head/; revision=298752
* Document PCI_RES_BUS as a possible resource type.John Baldwin2016-04-281-1/+3
| | | | Notes: svn path=/head/; revision=298749
* use .Mt to mark up email addresses consistently (part6)Baptiste Daroussin2014-06-261-1/+1
| | | | | | | | PR: 191174 Submitted by: Franco Fichtner <franco at lastsummer.de> Notes: svn path=/head/; revision=267936
* Assorted mdoc(7) fixes.Ruslan Ermilov2003-05-301-28/+24
| | | | Notes: svn path=/head/; revision=115418
* rid is not a pointer to int, but rather just a plain int.Warner Losh2003-03-301-2/+2
| | | | Notes: svn path=/head/; revision=112832
* Add a new man page for bus_activate_resource andWarner Losh2003-03-291-0/+97
bus_deactivate_resource. It could use some improvement, and others are welcomed to do so :-) Notes: svn path=/head/; revision=112774