diff options
author | Joel Sherrill <joel.sherrill@OARcorp.com> | 2008-11-20 21:11:43 +0000 |
---|---|---|
committer | Joel Sherrill <joel.sherrill@OARcorp.com> | 2008-11-20 21:11:43 +0000 |
commit | cc107c9cb2ac5094896cb5b57762ad8ca1f6383c (patch) | |
tree | ffda565017d9feeee1427286596e6bb6556383c7 /doc | |
parent | 2008-11-20 Joel Sherrill <joel.sherrill@OARcorp.com> (diff) | |
download | rtems-cc107c9cb2ac5094896cb5b57762ad8ca1f6383c.tar.bz2 |
2008-11-20 Joel Sherrill <joel.sherrill@OARcorp.com>
PR 1340/cpukit
* user/chains.t: Add rtems_chain_initialize to public chain API.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rwxr-xr-x | doc/user/chains.t | 44 |
2 files changed, 47 insertions, 2 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 55de2a6707..c3745c8ec5 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,5 +1,10 @@ 2008-11-20 Joel Sherrill <joel.sherrill@OARcorp.com> + PR 1340/cpukit + * user/chains.t: Add rtems_chain_initialize to public chain API. + +2008-11-20 Joel Sherrill <joel.sherrill@OARcorp.com> + PR 1339/Ada * user/io.t: Re-add IO Manager to Ada binding. diff --git a/doc/user/chains.t b/doc/user/chains.t index 33c1311207..825bed8a04 100755 --- a/doc/user/chains.t +++ b/doc/user/chains.t @@ -21,6 +21,7 @@ provided by RTEMS is: @c build_id @item @code{@value{DIRPREFIX}chain_node} - Chain node used in user objects @item @code{@value{DIRPREFIX}chain_control} - Chain control node +@item @code{@value{DIRPREFIX}chain_initialize} - initialize the chain with nodes @item @code{@value{DIRPREFIX}chain_initialize_empty} - initialize the chain as empty @item @code{@value{DIRPREFIX}chain_is_null_node} - Is the node NULL ? @item @code{@value{DIRPREFIX}chain_head} - Return the chain's head @@ -196,12 +197,51 @@ void foobar (const char* match, The section details the Chains directives. @c +@c Initialize this Chain With Nodes +@c +@page +@subsection Initialize Chain With Nodes + +@cindex chain initialize + +@subheading CALLING SEQUENCE: + +@ifset is-C +@findex @value{DIRPREFIX}chain_initialize +@example +void @value{DIRPREFIX}chain_initialize( + @value{DIRPREFIX}chain_control *the_chain, + void *starting_address, + size_t number_nodes, + size_t node_size +) +@end example +@end ifset + +@subheading RETURNS + +Returns nothing. + +@subheading DESCRIPTION: + +This function take in a pointer to a chain control and initializes it +to contain a set of chain nodes. The chain will contain @code{number_nodes} +chain nodes from the memory pointed to by @code{start_address}. Each node +is assumed to be @code{node_size} bytes. + +@subheading NOTES: + +This call will discard any nodes on the chain. + +This call does NOT inititialize any user data on each node. + +@c @c Initialize this Chain as Empty @c @page -@subsection Initialise Empty +@subsection Initialize Empty -@cindex chain initialise empty +@cindex chain initialize empty @subheading CALLING SEQUENCE: |