diff options
author | Joel Sherrill <joel.sherrill@OARcorp.com> | 2008-11-13 15:10:36 +0000 |
---|---|---|
committer | Joel Sherrill <joel.sherrill@OARcorp.com> | 2008-11-13 15:10:36 +0000 |
commit | 76101939c40e7c350d48efe65d8ad29589738635 (patch) | |
tree | 0c547eb4fb4c9a8c1b93c7fa49e4f8c48121ffaa /doc | |
parent | 2008-11-12 Joel Sherrill <joel.sherrill@oarcorp.com> (diff) | |
download | rtems-76101939c40e7c350d48efe65d8ad29589738635.tar.bz2 |
2008-11-13 Joel Sherrill <joel.sherrill@OARcorp.com>
PR 1336/cpukit
* user/chains.t, user/dirstat.texi: Add rtems_chain_prepend_unprotected
and rtems_chain_append_unprotected.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/ChangeLog | 6 | ||||
-rwxr-xr-x | doc/user/chains.t | 78 | ||||
-rw-r--r-- | doc/user/dirstat.texi | 2 |
3 files changed, 80 insertions, 6 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 8b85ec0a3d..2d5944db39 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,9 @@ +2008-11-13 Joel Sherrill <joel.sherrill@OARcorp.com> + + PR 1336/cpukit + * user/chains.t, user/dirstat.texi: Add rtems_chain_prepend_unprotected + and rtems_chain_append_unprotected. + 2008-11-07 Joel Sherrill <joel.sherrill@OARcorp.com> * user/concepts.t: Use 32 bit version centered. diff --git a/doc/user/chains.t b/doc/user/chains.t index baa12234c0..33c1311207 100755 --- a/doc/user/chains.t +++ b/doc/user/chains.t @@ -32,11 +32,13 @@ provided by RTEMS is: @item @code{@value{DIRPREFIX}chain_has_only_one_node} - Does the node have one node ? @item @code{@value{DIRPREFIX}chain_is_head} - Is the node the head ? @item @code{@value{DIRPREFIX}chain_is_tail} - Is the node the tail ? -@item @code{@value{DIRPREFIX}chain_extract} - Extract the node from the chain ? -@item @code{@value{DIRPREFIX}chain_get} - Return the first node on the chain ? -@item @code{@value{DIRPREFIX}chain_insert} - Insert the node into the chain ? -@item @code{@value{DIRPREFIX}chain_append} - Append the node to chain ? -@item @code{@value{DIRPREFIX}chain_prepend} - Prepend the node to the end of the chain ? +@item @code{@value{DIRPREFIX}chain_extract} - Extract the node from the chain +@item @code{@value{DIRPREFIX}chain_get} - Return the first node on the chain +@item @code{@value{DIRPREFIX}chain_insert} - Insert the node into the chain +@item @code{@value{DIRPREFIX}chain_append} - Append the node to chain +@item @code{@value{DIRPREFIX}chain_append_unprotected} - Append the node to chain (unprotected) +@item @code{@value{DIRPREFIX}chain_prepend} - Prepend the node to the end of the chain +@item @code{@value{DIRPREFIX}chain_prepend_unprotected} - Prepend the node to chain (unprotected) @end itemize @section Background @@ -651,6 +653,39 @@ the operation. @c @c @page +@subsection Append a Node (unprotected) + +@cindex chain append a node unprotected + +@subheading CALLING SEQUENCE: + +@ifset is-C +@findex @value{DIRPREFIX}chain_append_unprotected +@example +void @value{DIRPREFIX}chain_append_unprotected( + @value{DIRPREFIX}chain_control *the_chain, + @value{DIRPREFIX}chain_node *the_node +); +@end example +@end ifset + +@subheading RETURNS + +Returns nothing. + +@subheading DESCRIPTION: + +This routine appends a node to the end of a chain. + +@subheading NOTES: + +Interrupts are NOT disabled during the append to ensure the atomicity of +the operation. + +@c +@c +@c +@page @subsection Prepend a Node @cindex prepend node @@ -679,3 +714,36 @@ This routine prepends a node to the front of the chain. Interrupts are disabled during the prepend to ensure the atomicity of the operation. + +@c +@c +@c +@page +@subsection Prepend a Node (unprotected) + +@cindex prepend node + +@subheading CALLING SEQUENCE: + +@ifset is-C +@findex @value{DIRPREFIX}chain_prepend_unprotected +@example +void @value{DIRPREFIX}chain_prepend_unprotected( + @value{DIRPREFIX}chain_control *the_chain, + @value{DIRPREFIX}chain_node *the_node +); +@end example +@end ifset + +@subheading RETURNS + +Returns nothing. + +@subheading DESCRIPTION: + +This routine prepends a node to the front of the chain. + +@subheading NOTES: + +Interrupts are NOT disabled during the prepend to ensure the atomicity of +the operation. diff --git a/doc/user/dirstat.texi b/doc/user/dirstat.texi index 727bc8d355..5994733bf3 100644 --- a/doc/user/dirstat.texi +++ b/doc/user/dirstat.texi @@ -7,7 +7,7 @@ @c @ifinfo -@node Directive Status Codes, Example Application, Chains Prepend a Node, Top +@node Directive Status Codes, Example Application, Chains Prepend a Node (unprotected), Top @end ifinfo @chapter Directive Status Codes @table @b |