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.
This commit is contained in:
Joel Sherrill
2008-11-13 15:10:15 +00:00
parent ea4cf27769
commit b8b0920874
3 changed files with 80 additions and 6 deletions

View File

@@ -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> 2008-11-07 Joel Sherrill <joel.sherrill@OARcorp.com>
* user/concepts.t: Use 32 bit version centered. * user/concepts.t: Use 32 bit version centered.

View File

@@ -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_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_head} - Is the node the head ?
@item @code{@value{DIRPREFIX}chain_is_tail} - Is the node the tail ? @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_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_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_insert} - Insert the node into the chain
@item @code{@value{DIRPREFIX}chain_append} - Append the node to 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_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 @end itemize
@section Background @section Background
@@ -647,6 +649,39 @@ This routine appends a node to the end of a chain.
Interrupts are disabled during the append to ensure the atomicity of Interrupts are disabled during the append to ensure the atomicity of
the operation. the operation.
@c
@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 @c
@c @c
@@ -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 Interrupts are disabled during the prepend to ensure the atomicity of
the operation. 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.

View File

@@ -7,7 +7,7 @@
@c @c
@ifinfo @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 @end ifinfo
@chapter Directive Status Codes @chapter Directive Status Codes
@table @b @table @b