[rtems commit] doc: Add bdbuf configuration options

[Sebastian Huber]

Module:    rtems
Branch:    master
Commit:    a6a88f4b0efbf3999799d05246b700bb468b735e
Changeset: http://git.rtems.org/rtems/commit/?id=a6a88f4b0efbf3999799d05246b700bb468b735e

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Wed Apr 10 15:46:54 2013 +0200

doc: Add bdbuf configuration options

---

 doc/user/conf.t |  376 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 376 insertions(+), 0 deletions(-)

diff --git a/doc/user/conf.t b/doc/user/conf.t
index a1aabd4..890ab6d 100644
--- a/doc/user/conf.t
+++ b/doc/user/conf.t
@@ -2623,6 +2623,382 @@ intend to use any kind of filesystem support. This include the device
 infrastructure necessary to support @code{printf()}.
 
 @c
+ at c === Block Device Cache Configuration ===
+ at c
+ at section Block Device Cache Configuration
+
+This section defines Block Device Cache (bdbuf) related configuration
+parameters.
+
+ at c
+ at c === CONFIGURE_APPLICATION_NEEDS_LIBBLOCK ===
+ at c
+ at subsection Enable Block Device Cache
+
+ at findex CONFIGURE_APPLICATION_NEEDS_LIBBLOCK
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_APPLICATION_NEEDS_LIBBLOCK}
+
+ at item DATA TYPE:
+Boolean feature macro.
+
+ at item RANGE:
+Defined or undefined.
+
+ at item DEFAULT VALUE:
+This option is not defined by default.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Provides a Block Device Cache configuration.
+
+ at subheading NOTES:
+Each option of the Block Device Cache configuration can be explicitly set by
+the user with the configuration options below.  The Block Device Cache is used
+for example by the RFS and DOSFS file systems.
+
+ at c
+ at c === CONFIGURE_BDBUF_CACHE_MEMORY_SIZE ===
+ at c
+ at subsection Size of the Cache Memory
+
+ at findex CONFIGURE_BDBUF_CACHE_MEMORY_SIZE
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_BDBUF_CACHE_MEMORY_SIZE}
+
+ at item DATA TYPE:
+Unsigned integer (@code{size_t}).
+
+ at item RANGE:
+Positive.
+
+ at item DEFAULT VALUE:
+The default value is 32KiB.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Size of the cache memory in bytes.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_BDBUF_BUFFER_MIN_SIZE ===
+ at c
+ at subsection Minimum Size of a Buffer
+
+ at findex CONFIGURE_BDBUF_BUFFER_MIN_SIZE
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_BDBUF_BUFFER_MIN_SIZE}
+
+ at item DATA TYPE:
+Unsigned integer (@code{uint32_t}).
+
+ at item RANGE:
+Positive.
+
+ at item DEFAULT VALUE:
+The default value is 512 bytes.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the minimum size of a buffer in bytes.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_BDBUF_BUFFER_MAX_SIZE ===
+ at c
+ at subsection Maximum Size of a Buffer
+
+ at findex CONFIGURE_BDBUF_BUFFER_MAX_SIZE
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_BDBUF_BUFFER_MAX_SIZE}
+
+ at item DATA TYPE:
+Unsigned integer (@code{uint32_t}).
+
+ at item RANGE:
+It must be positive and an integral multiple of the buffer minimum size.
+
+ at item DEFAULT VALUE:
+The default value is 4096 bytes.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the maximum size of a buffer in bytes.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_SWAPOUT_SWAP_PERIOD ===
+ at c
+ at subsection Swapout Task Swap Period
+
+ at findex CONFIGURE_SWAPOUT_SWAP_PERIOD
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_SWAPOUT_SWAP_PERIOD}
+
+ at item DATA TYPE:
+Unsigned integer (@code{uint32_t}).
+
+ at item RANGE:
+Positive.
+
+ at item DEFAULT VALUE:
+The default value is 250 milliseconds.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the swapout task swap period in milliseconds.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_SWAPOUT_BLOCK_HOLD ===
+ at c
+ at subsection Swapout Task Maximum Block Hold Time
+
+ at findex CONFIGURE_SWAPOUT_BLOCK_HOLD
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_SWAPOUT_BLOCK_HOLD}
+
+ at item DATA TYPE:
+Unsigned integer (@code{uint32_t}).
+
+ at item RANGE:
+Positive.
+
+ at item DEFAULT VALUE:
+The default value is 1000 milliseconds.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the swapout task maximum block hold time in milliseconds.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_SWAPOUT_TASK_PRIORITY ===
+ at c
+ at subsection Swapout Task Priority
+
+ at findex CONFIGURE_SWAPOUT_TASK_PRIORITY
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_SWAPOUT_TASK_PRIORITY}
+
+ at item DATA TYPE:
+Task priority (@code{rtems_task_priority}).
+
+ at item RANGE:
+Valid task priority.
+
+ at item DEFAULT VALUE:
+The default value is 15.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the swapout task priority.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS ===
+ at c
+ at subsection Maximum Blocks per Read-Ahead Request
+
+ at findex CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS}
+
+ at item DATA TYPE:
+Unsigned integer (@code{uint32_t}).
+
+ at item RANGE:
+Positive.
+
+ at item DEFAULT VALUE:
+The default value is 0.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the maximum blocks per read-ahead request.
+
+ at subheading NOTES:
+A value of 0 disables the read-ahead task (default).  The read-ahead task will
+issue speculative read transfers if a sequential access pattern is detected.
+This can improve the performance on some systems.
+
+ at c
+ at c === CONFIGURE_BDBUF_MAX_WRITE_BLOCKS ===
+ at c
+ at subsection Maximum Blocks per Write Request
+
+ at findex CONFIGURE_BDBUF_MAX_WRITE_BLOCKS
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_BDBUF_MAX_WRITE_BLOCKS}
+
+ at item DATA TYPE:
+Unsigned integer (@code{uint32_t}).
+
+ at item RANGE:
+Positive.
+
+ at item DEFAULT VALUE:
+The default value is 16.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the maximum blocks per write request.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_BDBUF_TASK_STACK_SIZE ===
+ at c
+ at subsection Task Stack Size of the Block Device Cache Tasks
+
+ at findex CONFIGURE_BDBUF_TASK_STACK_SIZE
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_BDBUF_TASK_STACK_SIZE}
+
+ at item DATA TYPE:
+Unsigned integer (@code{size_t}).
+
+ at item RANGE:
+Zero or positive.
+
+ at item DEFAULT VALUE:
+The default value is the RTEMS minimum stack size.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the task stack size of the Block Device Cache tasks in bytes.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY ===
+ at c
+ at subsection Read-Ahead Task Priority
+
+ at findex CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY}
+
+ at item DATA TYPE:
+Task priority (@code{rtems_task_priority}).
+
+ at item RANGE:
+Valid task priority.
+
+ at item DEFAULT VALUE:
+The default value is 15.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the read-ahead task priority.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_SWAPOUT_WORKER_TASKS ===
+ at c
+ at subsection Swapout Worker Task Count
+
+ at findex CONFIGURE_SWAPOUT_WORKER_TASKS
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_SWAPOUT_WORKER_TASKS}
+
+ at item DATA TYPE:
+Unsigned integer (@code{size_t}).
+
+ at item RANGE:
+Zero or positive.
+
+ at item DEFAULT VALUE:
+The default value is 0.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the swapout worker task count.
+
+ at subheading NOTES:
+None.
+
+ at c
+ at c === CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY ===
+ at c
+ at subsection Swapout Worker Task Priority
+
+ at findex CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY
+
+ at table @b
+ at item CONSTANT:
+ at code{CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY}
+
+ at item DATA TYPE:
+Task priority (@code{rtems_task_priority}).
+
+ at item RANGE:
+Valid task priority.
+
+ at item DEFAULT VALUE:
+The default value is 15.
+
+ at end table
+
+ at subheading DESCRIPTION:
+Defines the swapout worker task priority.
+
+ at subheading NOTES:
+None.
+
+ at c
 @c === BSP Specific Settings ===
 @c
 @section BSP Specific Settings