/*
|
/*
|
* Message Queue Manager
|
* Message Queue Manager
|
*
|
*
|
*
|
*
|
* COPYRIGHT (c) 1989-1999.
|
* COPYRIGHT (c) 1989-1999.
|
* On-Line Applications Research Corporation (OAR).
|
* On-Line Applications Research Corporation (OAR).
|
*
|
*
|
* The license and distribution terms for this file may be
|
* The license and distribution terms for this file may be
|
* found in the file LICENSE in this distribution or at
|
* found in the file LICENSE in this distribution or at
|
* http://www.OARcorp.com/rtems/license.html.
|
* http://www.OARcorp.com/rtems/license.html.
|
*
|
*
|
* msgqreceive.c,v 1.5 2000/01/14 18:36:47 joel Exp
|
* msgqreceive.c,v 1.5 2000/01/14 18:36:47 joel Exp
|
*/
|
*/
|
|
|
#include <rtems/system.h>
|
#include <rtems/system.h>
|
#include <rtems/score/sysstate.h>
|
#include <rtems/score/sysstate.h>
|
#include <rtems/score/chain.h>
|
#include <rtems/score/chain.h>
|
#include <rtems/score/isr.h>
|
#include <rtems/score/isr.h>
|
#include <rtems/score/coremsg.h>
|
#include <rtems/score/coremsg.h>
|
#include <rtems/score/object.h>
|
#include <rtems/score/object.h>
|
#include <rtems/score/states.h>
|
#include <rtems/score/states.h>
|
#include <rtems/score/thread.h>
|
#include <rtems/score/thread.h>
|
#include <rtems/score/wkspace.h>
|
#include <rtems/score/wkspace.h>
|
#if defined(RTEMS_MULTIPROCESSING)
|
#if defined(RTEMS_MULTIPROCESSING)
|
#include <rtems/score/mpci.h>
|
#include <rtems/score/mpci.h>
|
#endif
|
#endif
|
#include <rtems/rtems/status.h>
|
#include <rtems/rtems/status.h>
|
#include <rtems/rtems/attr.h>
|
#include <rtems/rtems/attr.h>
|
#include <rtems/rtems/message.h>
|
#include <rtems/rtems/message.h>
|
#include <rtems/rtems/options.h>
|
#include <rtems/rtems/options.h>
|
#include <rtems/rtems/support.h>
|
#include <rtems/rtems/support.h>
|
|
|
/*PAGE
|
/*PAGE
|
*
|
*
|
* rtems_message_queue_receive
|
* rtems_message_queue_receive
|
*
|
*
|
* This directive dequeues a message from the designated message queue
|
* This directive dequeues a message from the designated message queue
|
* and copies it into the requesting thread's buffer.
|
* and copies it into the requesting thread's buffer.
|
*
|
*
|
* Input parameters:
|
* Input parameters:
|
* id - queue id
|
* id - queue id
|
* buffer - pointer to message buffer
|
* buffer - pointer to message buffer
|
* size - size of message receive
|
* size - size of message receive
|
* option_set - options on receive
|
* option_set - options on receive
|
* timeout - number of ticks to wait
|
* timeout - number of ticks to wait
|
*
|
*
|
* Output parameters:
|
* Output parameters:
|
* RTEMS_SUCCESSFUL - if successful
|
* RTEMS_SUCCESSFUL - if successful
|
* error code - if unsuccessful
|
* error code - if unsuccessful
|
*/
|
*/
|
|
|
rtems_status_code rtems_message_queue_receive(
|
rtems_status_code rtems_message_queue_receive(
|
Objects_Id id,
|
Objects_Id id,
|
void *buffer,
|
void *buffer,
|
unsigned32 *size,
|
unsigned32 *size,
|
unsigned32 option_set,
|
unsigned32 option_set,
|
rtems_interval timeout
|
rtems_interval timeout
|
)
|
)
|
{
|
{
|
register Message_queue_Control *the_message_queue;
|
register Message_queue_Control *the_message_queue;
|
Objects_Locations location;
|
Objects_Locations location;
|
boolean wait;
|
boolean wait;
|
|
|
the_message_queue = _Message_queue_Get( id, &location );
|
the_message_queue = _Message_queue_Get( id, &location );
|
switch ( location ) {
|
switch ( location ) {
|
|
|
case OBJECTS_REMOTE:
|
case OBJECTS_REMOTE:
|
#if defined(RTEMS_MULTIPROCESSING)
|
#if defined(RTEMS_MULTIPROCESSING)
|
return _Message_queue_MP_Send_request_packet(
|
return _Message_queue_MP_Send_request_packet(
|
MESSAGE_QUEUE_MP_RECEIVE_REQUEST,
|
MESSAGE_QUEUE_MP_RECEIVE_REQUEST,
|
id,
|
id,
|
buffer,
|
buffer,
|
size,
|
size,
|
option_set,
|
option_set,
|
timeout
|
timeout
|
);
|
);
|
#endif
|
#endif
|
|
|
case OBJECTS_ERROR:
|
case OBJECTS_ERROR:
|
return RTEMS_INVALID_ID;
|
return RTEMS_INVALID_ID;
|
|
|
case OBJECTS_LOCAL:
|
case OBJECTS_LOCAL:
|
if ( _Options_Is_no_wait( option_set ) )
|
if ( _Options_Is_no_wait( option_set ) )
|
wait = FALSE;
|
wait = FALSE;
|
else
|
else
|
wait = TRUE;
|
wait = TRUE;
|
|
|
_CORE_message_queue_Seize(
|
_CORE_message_queue_Seize(
|
&the_message_queue->message_queue,
|
&the_message_queue->message_queue,
|
the_message_queue->Object.id,
|
the_message_queue->Object.id,
|
buffer,
|
buffer,
|
size,
|
size,
|
wait,
|
wait,
|
timeout
|
timeout
|
);
|
);
|
_Thread_Enable_dispatch();
|
_Thread_Enable_dispatch();
|
return _Message_queue_Translate_core_message_queue_return_code(
|
return _Message_queue_Translate_core_message_queue_return_code(
|
_Thread_Executing->Wait.return_code
|
_Thread_Executing->Wait.return_code
|
);
|
);
|
|
|
}
|
}
|
|
|
return RTEMS_INTERNAL_ERROR; /* unreached - only to remove warnings */
|
return RTEMS_INTERNAL_ERROR; /* unreached - only to remove warnings */
|
}
|
}
|
|
|