Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

staging: xillybus: Removed outdated part in README

The dedicated memory management routines have been replaced with devres API,
so the related part is removed from the doc.

Signed-off-by: Eli Billauer <eli.billauer@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Eli Billauer and committed by
Greg Kroah-Hartman
44909e65 84590b1a

-23
-23
drivers/staging/xillybus/README
··· 26 26 -- Data granularity 27 27 -- Probing 28 28 -- Buffer allocation 29 - -- Memory management 30 29 -- The "nonempty" message (supporting poll) 31 30 32 31 ··· 363 364 Or, if there already is a partially used page at hand, the buffer is packed 364 365 into that page. It can be shown that all pages requested from the kernel 365 366 (except possibly for the last) are 100% utilized this way. 366 - 367 - Memory management 368 - ----------------- 369 - 370 - The tricky part about the buffer allocation procedure described above is 371 - freeing and unmapping the buffers, in particular if something goes wrong in 372 - the middle, and the allocations need to be rolled back. The three-stage 373 - probing procedure makes this even more crucial, since temporary buffers are 374 - set up and mapped in the first of its two stages. 375 - 376 - To keep the code clean from complicated and bug-prone memory release routines, 377 - there are special routines for allocating memory. For example, instead of 378 - calling kzalloc, there's 379 - 380 - void *xilly_malloc(struct xilly_cleanup *mem, size_t size) 381 - 382 - which effectively allocates a zeroed buffer of size "size". Its first 383 - argument, "mem", is where this allocation is enlisted, so that it's released 384 - when xillybus_do_cleanup() is called with the same "mem" structure. 385 - 386 - Two other functions enlist allocations in this structure: xilly_pagealloc() 387 - for page allocations and xilly_map_single_*() for DMA mapping. 388 367 389 368 The "nonempty" message (supporting poll) 390 369 ---------------------------------------