WSL2-Linux-Kernel/Documentation
Tejun Heo 9ac7849e35 devres: device resource management
Implement device resource management, in short, devres.  A device
driver can allocate arbirary size of devres data which is associated
with a release function.  On driver detach, release function is
invoked on the devres data, then, devres data is freed.

devreses are typed by associated release functions.  Some devreses are
better represented by single instance of the type while others need
multiple instances sharing the same release function.  Both usages are
supported.

devreses can be grouped using devres group such that a device driver
can easily release acquired resources halfway through initialization
or selectively release resources (e.g. resources for port 1 out of 4
ports).

This patch adds devres core including documentation and the following
managed interfaces.

* alloc/free	: devm_kzalloc(), devm_kzfree()
* IO region	: devm_request_region(), devm_release_region()
* IRQ		: devm_request_irq(), devm_free_irq()
* DMA		: dmam_alloc_coherent(), dmam_free_coherent(),
		  dmam_declare_coherent_memory(), dmam_pool_create(),
		  dmam_pool_destroy()
* PCI		: pcim_enable_device(), pcim_pin_device(), pci_is_managed()
* iomap		: devm_ioport_map(), devm_ioport_unmap(), devm_ioremap(),
		  devm_ioremap_nocache(), devm_iounmap(), pcim_iomap_table(),
		  pcim_iomap(), pcim_iounmap()

Signed-off-by: Tejun Heo <htejun@gmail.com>
Signed-off-by: Jeff Garzik <jeff@garzik.org>
2007-02-09 17:39:36 -05:00
..
ABI [PATCH] pktcdvd: add sysfs and debugfs interface 2006-12-08 08:28:38 -08:00
DocBook libata doc: "error : unterminated entity reference exceptions" 2007-01-19 19:09:31 -05:00
RCU [PATCH] rcu: add sched torture type to rcutorture 2006-10-04 07:55:31 -07:00
accounting [PATCH] io-accounting: add to getdelays 2006-12-10 09:55:42 -08:00
aoe Fix typos in Documentation/: 'D'-'E' 2006-10-03 22:47:42 +02:00
arm [ARM] 4071/1: S3C24XX: Documentation update 2006-12-30 17:05:07 +00:00
block [PATCH] block: document io scheduler allow_merge_fn hook 2006-12-20 11:06:15 +01:00
cdrom [PATCH] pktcdvd: add sysfs and debugfs interface 2006-12-08 08:28:38 -08:00
connector [CONNECTOR]: Add userspace example code into Documentation/connector/ 2006-08-26 18:42:00 -07:00
console [PATCH] VT binding: Update documentation 2006-06-26 09:58:33 -07:00
cpu-freq Merge ../linus 2006-12-12 17:41:41 -05:00
cris
crypto [CRYPTO] doc: added the developer of Camellia cipher 2007-02-07 09:21:05 +11:00
device-mapper
driver-model devres: device resource management 2007-02-09 17:39:36 -05:00
drivers/edac [PATCH] Fix and enable EDAC sysfs operation 2006-07-10 13:24:25 -07:00
dvb V4L/DVB (4813): Added information about Technisat Sky2Pc cards 2006-12-10 08:51:18 -02:00
early-userspace
fault-injection [PATCH] fault-injection: Correct, disambiguate, and reformat documentation 2006-12-08 08:29:03 -08:00
fb Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
filesystems [PATCH] 9p: update documentation regarding server applications 2007-01-26 13:50:59 -08:00
firmware_class
fujitsu/frv Fix typos in /Documentation : Misc 2006-11-30 05:21:10 +01:00
hwmon hwmon/w83793: Ignore disabled temperature channels 2007-01-18 22:14:24 +01:00
i2c i2c: i2c-i801 documentation update 2006-12-10 21:21:31 +01:00
i2o
i386 [PATCH] Boot loader ID for Gujin 2007-01-26 14:59:48 -08:00
ia64 Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
infiniband IB/ipoib: Remove broken link from Kconfig and documentation 2006-08-03 10:48:31 -07:00
input Fix typos in /Documentation : Misc 2006-11-30 05:21:10 +01:00
ioctl [PATCH] Document how to decode an IOCTL number 2006-12-10 09:55:40 -08:00
isdn Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
kbuild kconfig: Standardize "depends" -> "depends on" in Kconfig files 2006-12-12 20:04:19 +01:00
kdump [PATCH] Kdump documentation update: ia64 portion 2007-01-23 07:52:07 -08:00
m68k Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
mips [MIPS] Fixup migration to GENERIC_TIME 2006-10-31 20:13:23 +00:00
netlabel [NetLabel]: documentation 2006-09-22 14:53:31 -07:00
networking [DCCP]: Update documentation 2006-12-11 14:34:38 -08:00
parisc
pcmcia [PATCH] pcmcia: expose tool in pcmcia/Documentation/pcmcia/ 2006-06-30 22:09:10 +02:00
power [PATCH] s2ram debugging documentation 2006-12-07 08:39:28 -08:00
powerpc [POWERPC] Make it blatantly clear; mpc5200 device tree is not yet stable 2007-01-22 21:27:35 +11:00
s390 [S390] Fix register usage description. 2007-02-05 21:17:34 +01:00
scsi [SCSI] aacraid: Product List Update 2007-01-06 09:02:37 -06:00
serial
sh Fix typos in Documentation/: 'H'-'M' 2006-10-03 22:50:39 +02:00
sound [ALSA] ASoC documentation updates 2007-02-09 09:04:04 +01:00
sparc Fix typos in Documentation/: 'Q'-'R' 2006-10-03 22:54:15 +02:00
spi [PATCH] spi: stabilize PIO mode transfers on PXA2xx systems 2006-12-10 09:55:40 -08:00
sysctl [PATCH] x86: add sysctl for kstack_depth_to_print 2006-12-07 02:14:11 +01:00
telephony
uml Fix typos in /Documentation : 'U-Z' 2006-11-30 04:58:40 +01:00
usb USB: add binary API to usbmon 2007-02-07 15:44:34 -08:00
video4linux V4L/DVB (4887): Remove the broken VIDEO_ZR36120 driver 2006-12-10 09:05:23 -02:00
vm Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
w1
watchdog Fix typos in /Documentation : 'T'' 2006-11-30 04:55:36 +01:00
x86_64 Revert "[PATCH] x86-64: Try multiple timer variants in check_timer" 2007-01-08 15:04:46 -08:00
00-INDEX Remove long-unmaintained ftape driver subsystem. 2006-12-03 22:22:41 -05:00
BUG-HUNTING
Changes Fix typos in doc and comments 2006-11-30 05:32:19 +01:00
CodingStyle [PATCH] Add a new section to CodingStyle, promoting include/linux/kernel.h 2006-12-22 08:55:49 -08:00
DMA-API.txt [PATCH] Pass struct dev pointer to dma_cache_sync() 2006-12-07 08:39:41 -08:00
DMA-ISA-LPC.txt Fix typos in /Documentation : 'T'' 2006-11-30 04:55:36 +01:00
DMA-mapping.txt Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
HOWTO HOWTO: Add a reference to Harbison and Steele 2007-02-07 10:37:13 -08:00
IO-mapping.txt
IPMI.txt [PATCH] IPMI: system interface hotplug 2006-12-07 08:39:47 -08:00
IRQ-affinity.txt
IRQ.txt [PATCH] genirq: irq: document what an IRQ is 2006-06-29 10:26:25 -07:00
MSI-HOWTO.txt Fix typos in /Documentation : 'U-Z' 2006-11-30 04:58:40 +01:00
ManagementStyle
PCIEBUS-HOWTO.txt
README.DAC960 [PATCH] devfs: Last little devfs cleanups throughout the kernel tree. 2006-06-26 12:25:09 -07:00
README.cycladesZ
SAK.txt
SecurityBugs
SubmitChecklist [PATCH] SubmitChecklist update 2007-01-23 07:52:06 -08:00
SubmittingDrivers [PATCH] Documentation/SubmittingDrivers: minor update 2006-09-29 09:18:25 -07:00
SubmittingPatches Change Linus' email address too 2007-01-23 14:22:35 -08:00
VGA-softcursor.txt
acpi-hotkey.txt
applying-patches.txt
atomic_ops.txt Spelling fixes for Documentation/atomic_ops.txt 2006-06-26 18:27:35 +02:00
basic_profiling.txt
binfmt_misc.txt
cachetlb.txt [ARM] pass vma for flush_anon_page() 2007-01-08 19:49:54 +00:00
cciss.txt Fix typos in Documentation/: 'D'-'E' 2006-10-03 22:47:42 +02:00
cli-sti-removal.txt
computone.txt remove mentionings of devfs in documentation 2006-10-03 22:17:48 +02:00
cpqarray.txt
cpu-hotplug.txt Fix typos in /Documentation : Misc 2006-11-30 05:21:10 +01:00
cpusets.txt [PATCH] cpuset: top_cpuset tracks hotplug changes to node_online_map 2006-09-29 09:18:21 -07:00
cputopology.txt Fix typos in Documentation/: 'D'-'E' 2006-10-03 22:47:42 +02:00
dcdbas.txt
debugging-modules.txt
dell_rbu.txt Fix typos in Documentation/: 'N'-'P' 2006-10-03 22:52:05 +02:00
devices.txt [PATCH] New updated devices.txt - LANANA 2006-12-07 08:39:45 -08:00
digiepca.txt typo fixes: aquire -> acquire 2006-06-30 18:23:04 +02:00
dnotify.txt
dontdiff dontdiff: add utsrelease.h 2006-09-25 13:33:04 +02:00
ecryptfs.txt [PATCH] ecryptfs: fs/Makefile and fs/Kconfig 2006-10-04 07:55:24 -07:00
eisa.txt Fix typos in /Documentation : 'U-Z' 2006-11-30 04:58:40 +01:00
exception.txt Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
feature-removal-schedule.txt Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/ieee1394/linux1394-2.6 2007-02-09 10:25:38 -08:00
floppy.txt
hayes-esp.txt
highuid.txt Fix "can not" in Documentation and Kconfig 2006-10-03 22:53:09 +02:00
hpet.txt
hrtimers.txt Fix typos in Documentation/: 'S' 2006-10-03 22:55:17 +02:00
hw_random.txt
ibm-acpi.txt ACPI: ibm-acpi: implement fan watchdog command 2006-12-07 01:38:44 -05:00
ide.txt Fix typos in /Documentation : 'U-Z' 2006-11-30 04:58:40 +01:00
initrd.txt [PATCH] documentation: Documentation/initrd.txt 2006-07-31 13:28:44 -07:00
io_ordering.txt
ioctl-number.txt [PATCH] mbxfb: Document the new ioctl 2006-12-08 08:29:06 -08:00
iostats.txt
irqflags-tracing.txt [PATCH] lockdep: irqtrace subsystem, docs 2006-07-03 15:27:03 -07:00
isapnp.txt
java.txt Fix "can not" in Documentation and Kconfig 2006-10-03 22:53:09 +02:00
kernel-doc-nano-HOWTO.txt [PATCH] update some docbook comments 2006-11-03 12:27:56 -08:00
kernel-docs.txt remove mentionings of devfs in documentation 2006-10-03 22:17:48 +02:00
kernel-parameters.txt UHCI: module parameter to ignore overcurrent changes 2006-12-20 10:14:26 -08:00
keys-request-key.txt [PATCH] Keys: Allow in-kernel key requestor to pass auxiliary data to upcaller 2006-06-29 10:26:20 -07:00
keys.txt Fix typos in /Documentation : Misc 2006-11-30 05:21:10 +01:00
kobject.txt Fix typos in Documentation/: 'D'-'E' 2006-10-03 22:47:42 +02:00
kprobes.txt [PATCH] Don't give bad kprobes example aka ") < 0))" typo 2006-11-16 11:43:38 -08:00
kref.txt
laptop-mode.txt Fix typos in /Documentation : Misc 2006-11-30 05:21:10 +01:00
ldm.txt
leds-class.txt
lockdep-design.txt [PATCH] fix lockdep-design.txt 2006-10-11 11:14:24 -07:00
locks.txt
logo.gif
logo.txt
magic-number.txt
mandatory.txt
mca.txt Fix some typos in Documentation/: 'A' 2006-10-03 22:45:33 +02:00
md.txt Fix typos in Documentation/: 'Q'-'R' 2006-10-03 22:54:15 +02:00
memory-barriers.txt Fix typos in /Documentation : 'T'' 2006-11-30 04:55:36 +01:00
memory.txt
mono.txt Fix "can not" in Documentation and Kconfig 2006-10-03 22:53:09 +02:00
moxa-smartio
mtrr.txt
mutex-design.txt
nbd.txt
nfsroot.txt Fix typos in Documentation/: 'D'-'E' 2006-10-03 22:47:42 +02:00
nmi_watchdog.txt
nommu-mmap.txt [PATCH] NOMMU: Make futexes work under NOMMU conditions 2006-09-27 08:26:15 -07:00
numastat.txt
oops-tracing.txt
paride.txt
parport-lowlevel.txt
parport.txt
pci-error-recovery.txt Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
pci.txt PCI: rework Documentation/pci.txt 2007-01-22 12:00:54 -08:00
pcieaer-howto.txt PCI-Express AER implemetation: aer howto document 2006-09-26 17:43:52 -07:00
pi-futex.txt fix a typo in Documentation/pi-futex.txt 2006-10-03 23:39:02 +02:00
pm.txt Fix "can not" in Documentation and Kconfig 2006-10-03 22:53:09 +02:00
pnp.txt Fix typos in /Documentation : 'U-Z' 2006-11-30 04:58:40 +01:00
preempt-locking.txt
prio_tree.txt Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
ramdisk.txt [PATCH] Update ramdisk documentation 2006-07-14 21:53:53 -07:00
riscom8.txt
robust-futex-ABI.txt Fix typos in /Documentation : 'U-Z' 2006-11-30 04:58:40 +01:00
robust-futexes.txt Fix typos in /Documentation : Misc 2006-11-30 05:21:10 +01:00
rocket.txt Fix typos in Documentation/: 'S' 2006-10-03 22:55:17 +02:00
rpc-cache.txt Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
rt-mutex-design.txt [PATCH] typo fixes for rt-mutex-design.txt 2006-10-01 00:39:24 -07:00
rt-mutex.txt [PATCH] pi-futex: rt mutex docs 2006-06-27 17:32:47 -07:00
rtc.txt [PATCH] Documentation/rtc.txt updates (for rtc class) 2006-11-25 13:28:33 -08:00
sched-arch.txt
sched-coding.txt Fix typos in Documentation/: 'H'-'M' 2006-10-03 22:50:39 +02:00
sched-design.txt Fix typos in Documentation/: 'H'-'M' 2006-10-03 22:50:39 +02:00
sched-domains.txt
sched-stats.txt
serial-console.txt
sgi-ioc4.txt
sgi-visws.txt
sharedsubtree.txt Fix typos in /Documentation : 'T'' 2006-11-30 04:55:36 +01:00
smart-config.txt
smp.txt
sonypi.txt
sparse.txt kbuild: clarify "make C=" build option 2006-09-25 10:10:56 +02:00
specialix.txt
spinlocks.txt
stable_api_nonsense.txt [PATCH] i386: always enable regparm 2006-12-07 02:14:12 +01:00
stable_kernel_rules.txt Fix typos in /Documentation : Misc 2006-11-30 05:21:10 +01:00
stallion.txt
svga.txt
sx.txt
sysrq.txt [PATCH] sysrq: showBlockedTasks is sysrq-W 2007-02-01 16:22:42 -08:00
time_interpolators.txt
tipar.txt
tty.txt [PATCH] Update to Documentation/tty.txt on line disciplines 2006-12-30 10:55:55 -08:00
unicode.txt
unshare.txt Documentation: remove duplicated words 2006-10-03 22:57:56 +02:00
video-output.txt output: Add output class document 2006-12-20 01:46:58 -05:00
voyager.txt
xterm-linux.xpm
zorro.txt

README.cycladesZ

The Cyclades-Z must have firmware loaded onto the card before it will
operate.  This operation should be performed during system startup,

The firmware, loader program and the latest device driver code are
available from Cyclades at
    ftp://ftp.cyclades.com/pub/cyclades/cyclades-z/linux/