zephyr/samples/microkernel/test/test_mail
Benjamin Walsh 87564a4602 pipes/mailboxes: rename functions using mem blocks
task_pipe_put_async -> task_pipe_block_put

  task_mbox_put_async -> task_mbox_block_put

  task_mbox_data_get_async_block -> task_mbox_data_block_get
  task_mbox_data_get_async_block_wait -> task_mbox_data_block_get_wait
  task_mbox_data_get_async_block_wait_timeout ->
       task_mbox_data_block_get_wait_timeout

Previous names, focusing on 'async', were misleading, because:

- some of those APIs can be used synchronously as well
- other APIs can also do asynchronous transfer, and don't have 'async'
  in their names
- the key concept of these APIs is that they use memory pool blocks
  rather than raw data buffers.

Change-Id: I0c08a6cf950ab23bb4172ce25eb6f9886b037649
Signed-off-by: Benjamin Walsh <benjamin.walsh@windriver.com>
2016-02-05 20:15:21 -05:00
..
src pipes/mailboxes: rename functions using mem blocks 2016-02-05 20:15:21 -05:00
Makefile Renames supported platform configurations 2016-02-05 20:14:39 -05:00
README.txt pipes/mailboxes: rename functions using mem blocks 2016-02-05 20:15:21 -05:00
prj.mdef Rename VPF files to use MDEF file extension 2016-02-05 20:14:15 -05:00
prj_arm.conf samples: remove explicit enabling of SW_ISR_TABLE/DYNAMIC 2016-02-05 20:13:45 -05:00
prj_x86.conf Kbuild: Updates to the microkernel config overlays. 2016-02-05 20:14:07 -05:00
testcase.ini initial commit for next-gen sanity checks 2016-02-05 20:14:42 -05:00

README.txt

Title: test_mail

Description:

This test verifies that the microkernel mailbox APIs operate as expected.

--------------------------------------------------------------------------------

Building and Running Project:

This microkernel project outputs to the console.  It can be built and executed
on QEMU as follows:

    make qemu

--------------------------------------------------------------------------------

Troubleshooting:

Problems caused by out-dated project information can be addressed by
issuing one of the following commands then rebuilding the project:

    make clean          # discard results of previous builds
                        # but keep existing configuration info
or
    make pristine       # discard results of previous builds
                        # and restore pre-defined configuration info

--------------------------------------------------------------------------------

Sample Output:

Starting mailbox tests
===================================================================
MsgSenderTask: task_mbox_put to non-waiting task is OK
MsgRcvrTask: task_mbox_get when no message is OK
MsgSenderTask: task_mbox_put_wait_timeout to non-waiting task is OK
MsgRcvrTask: task_mbox_get_wait_timeout when no message is OK
MsgRcvrTask: task_mbox_get_wait from specified task is OK
MsgSenderTask: task_mbox_put to specified waiting task is OK
MsgRcvrTask: task_mbox_get from anonymous task is OK
MsgSenderTask: task_mbox_put_wait_timeout to anonymous non-waiting task is OK
MsgSenderTask: task_mbox_put_wait of empty message is OK
MsgRcvrTask: task_mbox_get_wait of empty message is OK
MsgRcvrTask: task_mbox_get_wait of message header #3 is OK
MsgRcvrTask: task_mbox_data_get of message data #3 is OK
MsgSenderTask: task_mbox_put_wait_timeout for 2 part receive test is OK
MsgRcvrTask: task_mbox_get_wait_timeout of message header #4 is OK
MsgRcvrTask: task_mbox_data_get cancellation of message #4 is OK
MsgSenderTask: task_mbox_put_wait for cancelled receive test is OK
MsgRcvrTask: task_mbox_get_wait of message header #1 is OK
MsgRcvrTask: task_mbox_data_block_get of message data #1 is OK
MsgSenderTask: task_mbox_put_wait for block-based receive test is OK
MsgRcvrTask: task_mbox_get_wait of message header #2 is OK
MsgRcvrTask: task_mbox_data_block_get of message data #2 is OK
MsgSenderTask: task_mbox_put_wait for block-exhaustion receive test is OK
MsgRcvrTask: task_mbox_get_wait of message header #3 is OK
MsgRcvrTask: task_mbox_data_get of message data #3 is OK
MsgSenderTask: task_mbox_put_wait_timeout for long-duration receive test is OK
===================================================================
PROJECT EXECUTION SUCCESSFUL