[rtems commit] libtests: Add contents to rbheap and stackchk documentation files
Joel Sherrill
joel at rtems.org
Thu Jan 9 15:34:45 UTC 2014
Module: rtems
Branch: master
Commit: 46123cf24f017c371c66dd1fd51565bc3cdfb874
Changeset: http://git.rtems.org/rtems/commit/?id=46123cf24f017c371c66dd1fd51565bc3cdfb874
Author: Cynthia Rempel <cynt6007 at vandals.uidaho.edu>
Date: Thu Jan 9 09:41:44 2014 -0600
libtests: Add contents to rbheap and stackchk documentation files
---
testsuites/libtests/rbheap01/rbheap.doc | 145 +++++++++++++++++++++++++++
testsuites/libtests/stackchk/stackchk.doc | 20 ++++
testsuites/libtests/syscall01/syscall01.doc | 23 ++++-
3 files changed, 183 insertions(+), 5 deletions(-)
diff --git a/testsuites/libtests/rbheap01/rbheap.doc b/testsuites/libtests/rbheap01/rbheap.doc
new file mode 100644
index 0000000..48c01d7
--- /dev/null
+++ b/testsuites/libtests/rbheap01/rbheap.doc
@@ -0,0 +1,145 @@
+# COPYRIGHT (c) 2014.
+# On-Line Applications Research Corporation (OAR).
+# Cynthia Rempel <cynthia at rtems.org>
+# The license and distribution terms for this file may be
+# found in the file LICENSE in this distribution or at
+# http://www.rtems.com/license/LICENSE.
+#
+This file describes the directives and concepts tested by this test set.
+
+test set name: rbheap01
+
+test_init_chunk_alignment:
+
+test_init_begin_greater_than_end:
+directives:
+ + rtems_rbheap_initialize
+
+concepts:
+ + verifies RTEMS_INVALID_ADDRESS is returned when the beginning address is
+ larger than the ending address.
+
+test_init_begin_greater_than_aligned_begin:
+directives:
+ + rtems_rbheap_initialize
+
+concepts:
+ + verifies RTEMS_INVALID_ADDRESS is returned when the beginning address has a
+ negative offset from an address aligned with the pagesize.
+
+test_init_aligned_begin_greater_than_aligned_end:
+directives:
+ + rtems_rbheap_initialize
+
+concepts:
+ + verifies RTEMS_INVALID_ADDRESS is returned when the beginning address has a
+ positive offset from the ending address.
+
+test_init_empty_descriptors:
+directives:
+ + rtems_rbheap_initialize
+
+concepts:
+ + verifies RTEMS_NO_MEMORY is returned when attempting to initialize an rbtree
+ to an empty descriptor
+
+test_alloc_and_free_one:
+directives:
+ + rtems_rbheap_allocate
+ + rtems_rbheap_free
+
+concepts:
+ + allocates and frees a red-black-tree
+
+test_alloc_zero:
+directives:
+ + rtems_rbheap_allocate
+
+concepts:
+ + verifies that the allocating no memory for a red-black-tree returns a
+ NULL pointer
+
+test_alloc_huge_chunk:
+directives:
+ + rtems_rbheap_allocate
+
+concepts:
+ + verifies that the allocating more memory than is available for a
+ red-black-tree returns a NULL pointer
+
+test_alloc_one_chunk:
+directives:
+ + rtems_rbheap_allocate
+ + rtems_rbheap_free
+
+concepts:
+ + verifies that allocating one chunk of memory from an rbheap returns memory
+ + verifies that one chunk of memory can be freed
+
+test_alloc_many_chunks:
+directives:
+ + rtems_rbheap_allocate
+ + rtems_rbheap_free
+
+concepts:
+ + verifies that allocating eight (8) chunks of memory from an rbheap returns
+ memory
+ + verifies that one chunk of memory can be freed
+
+test_alloc_misaligned:
+directives:
+ + rtems_rbheap_allocate
+
+concepts:
+ + verifies that rtems_rbheap_allocate returns NULL (does not allocate memory)
+ if the size allocated is not aligned with the pagesize
+
+test_alloc_with_malloc_extend:
+directives:
+ + rtems_rbheap_allocate
+ + rtems_rbheap_initialize
+ + rtems_heap_greedy_allocate
+ + rtems_heap_greedy_free
+
+concepts:
+ + allocate as much memory as possible
+ + verify no more can be allocated
+ + free as much memory as possible
+ + verify memory can be allocated again
+
+test_free_null:
+directives:
+ + rtems_rbheap_free
+
+concepts:
+ + verify RTEMS_SUCCESSFUL is returned when freeing a NULL pointer
+
+test_free_invalid:
+directives:
+ + rtems_rbheap_free
+
+concepts:
+ + verifies freeing a non-zero rbheap fails with RTEMS_INVALID_ID
+
+test_free_double:
+directives:
+ + rtems_rbheap_allocate
+ + rtems_rbheap_free
+
+concepts:
+ + verifies allocating an rbheap returns memory
+ + verifies freeing a heap twice fails with RTEMS_INCORRECT_STATE
+
+test_free_merge_left_or_right:
+
+NOTE: test_free_merge_left_or_right should probably be broken into
+test_free_merge_left and test_free_merge_right...
+
+directives:
+ + rtems_rbheap_allocate
+ + rtems_rbheap_free
+
+concepts:
+ + allocates 5 rbheaps and frees memory in different ways
+
+TODO: break into different tests
\ No newline at end of file
diff --git a/testsuites/libtests/stackchk/stackchk.doc b/testsuites/libtests/stackchk/stackchk.doc
new file mode 100644
index 0000000..90d5657
--- /dev/null
+++ b/testsuites/libtests/stackchk/stackchk.doc
@@ -0,0 +1,20 @@
+# COPYRIGHT (c) 2014.
+# On-Line Applications Research Corporation (OAR).
+# Cynthia Rempel <cynthia at rtems.org>
+# The license and distribution terms for this file may be
+# found in the file LICENSE in this distribution or at
+# http://www.rtems.com/license/LICENSE.
+#
+This file describes the directives and concepts tested by this test set.
+
+test set name: stackchk
+
+directives:
+ + rtems_clock_get_tod
+ + rtems_task_ident
+ + rtems_task_wake_after
+ + rtems_stack_checker_report_usage
+
+concepts:
+ + This set of three tasks do some simple task switching for about
+ 15 seconds and then call a routine to "blow the stack".
\ No newline at end of file
diff --git a/testsuites/libtests/syscall01/syscall01.doc b/testsuites/libtests/syscall01/syscall01.doc
index 6ae2ec3..190d762 100644
--- a/testsuites/libtests/syscall01/syscall01.doc
+++ b/testsuites/libtests/syscall01/syscall01.doc
@@ -1,11 +1,24 @@
+# COPYRIGHT (c) 2014.
+# On-Line Applications Research Corporation (OAR).
+# Cynthia Rempel <cynthia at rtems.org>
+# The license and distribution terms for this file may be
+# found in the file LICENSE in this distribution or at
+# http://www.rtems.com/license/LICENSE.
+#
This file describes the directives and concepts tested by this test set.
-test set name: syscall01
+test set name: stackchk
directives:
-
- TBD
+ + close
+ + open
+ + send
+ + recv
+ + rtems_bsdnet_initialize_network
+ + rtems_io_register_name
concepts:
-
- TBD
+ + initializes the bsd network driver
+ + registers an io driver
+ + opens a buffer, sends a buffer across the network, receives a buffer,
+ and closes the file
\ No newline at end of file
More information about the vc
mailing list