X-Git-Url: http://pilppa.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=Documentation%2Fpci.txt;h=2b395e478961ca6606a97dfce813c0da91346317;hb=49b1e3ea19b1c95c2f012b8331ffb3b169e4c042;hp=66bbbf1d1ef64e90cede27c2738290c5d6b4c2ef;hpb=2edc322d420a4cec8dbc184a1220ecd7fa9f8ae6;p=linux-2.6-omap-h63xx.git

diff --git a/Documentation/pci.txt b/Documentation/pci.txt
index 66bbbf1d1ef..2b395e47896 100644
--- a/Documentation/pci.txt
+++ b/Documentation/pci.txt
@@ -213,11 +213,19 @@ have been remapped by the kernel.
 
    See Documentation/IO-mapping.txt for how to access device memory.
 
-   You still need to call request_region() for I/O regions and
-request_mem_region() for memory regions to make sure nobody else is using the
-same device.
-
-   All interrupt handlers should be registered with SA_SHIRQ and use the devid
+   The device driver needs to call pci_request_region() to make sure
+no other device is already using the same resource. The driver is expected
+to determine MMIO and IO Port resource availability _before_ calling
+pci_enable_device().  Conversely, drivers should call pci_release_region()
+_after_ calling pci_disable_device(). The idea is to prevent two devices
+colliding on the same address range.
+
+Generic flavors of pci_request_region() are request_mem_region()
+(for MMIO ranges) and request_region() (for IO Port ranges).
+Use these for address resources that are not described by "normal" PCI
+interfaces (e.g. BAR).
+
+   All interrupt handlers should be registered with IRQF_SHARED and use the devid
 to map IRQs to devices (remember that all PCI interrupts are shared).