Changeset d81b56bd in rtems


Ignore:
Timestamp:
Jul 2, 2009, 10:04:42 PM (10 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.10, 4.11, master
Children:
2ed512bf
Parents:
2f9092ed
Message:

2009-07-02 Joel Sherrill <joel.sherrill@…>

  • score/include/rtems/score/coremsg.h, score/src/coremsgflushwait.c: Mark _CORE_message_queue_Flush_waiting_threads with FUNCTIONALITY_NOT_CURRENTLY_USED_BY_ANY_API since there is no way to reach it via an API.
Location:
cpukit
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • cpukit/ChangeLog

    r2f9092ed rd81b56bd  
     12009-07-02      Joel Sherrill <joel.sherrill@OARcorp.com>
     2
     3        * score/include/rtems/score/coremsg.h, score/src/coremsgflushwait.c:
     4        Mark _CORE_message_queue_Flush_waiting_threads with
     5        FUNCTIONALITY_NOT_CURRENTLY_USED_BY_ANY_API since there is no way to
     6        reach it via an API.
     7
    182009-07-01      Joel Sherrill <joel.sherrill@OARcorp.com>
    29
  • cpukit/score/include/rtems/score/coremsg.h

    r2f9092ed rd81b56bd  
    294294);
    295295
    296 /**
    297  *  @brief Flush Waiting Threads.
    298  *
    299  *  This function flushes the threads which are blocked on
    300  *  @a the_message_queue's pending message queue.  They are
    301  *  unblocked whether blocked sending or receiving.
    302  *
    303  *  @param[in] the_message_queue points to the message queue to flush
    304  */
    305 void _CORE_message_queue_Flush_waiting_threads(
    306   CORE_message_queue_Control *the_message_queue
    307 );
     296#if defined(FUNCTIONALITY_NOT_CURRENTLY_USED_BY_ANY_API)
     297  /**
     298   *  @brief Flush Waiting Threads.
     299   *
     300   *  This function flushes the threads which are blocked on
     301   *  @a the_message_queue's pending message queue.  They are
     302   *  unblocked whether blocked sending or receiving.
     303   *
     304   *  @param[in] the_message_queue points to the message queue to flush
     305   */
     306  void _CORE_message_queue_Flush_waiting_threads(
     307    CORE_message_queue_Control *the_message_queue
     308  );
     309#endif
    308310
    309311/**
  • cpukit/score/src/coremsgflushwait.c

    r2f9092ed rd81b56bd  
    3131#include <rtems/score/wkspace.h>
    3232
    33 /*PAGE
    34  *
    35  *  _CORE_message_queue_Flush_waiting_threads
    36  *
    37  *  This function flushes the message_queue's task wait queue.  The number
    38  *  of messages flushed from the queue is returned.
    39  *
    40  *  Input parameters:
    41  *    the_message_queue - the message_queue to be flushed
    42  *
    43  *  Output parameters:
    44  *    returns - the number of messages flushed from the queue
    45  */
    46 
    47 void _CORE_message_queue_Flush_waiting_threads(
    48   CORE_message_queue_Control *the_message_queue
    49 )
    50 {
    51   /* XXX this is not supported for global message queues */
    52 
    53   /*
    54    *  IF there are no pending messages,
    55    *  THEN threads may be blocked waiting to RECEIVE a message,
     33#if defined(FUNCTIONALITY_NOT_CURRENTLY_USED_BY_ANY_API)
     34  /*PAGE
    5635   *
    57    *  IF the pending message queue is full
    58    *  THEN threads may be blocked waiting to SEND a message
     36   *  _CORE_message_queue_Flush_waiting_threads
    5937   *
    60    *  But in either case, we will return "unsatisfied nowait"
    61    *  to indicate that the blocking condition was not satisfied
    62    *  and that the blocking state was canceled.
     38   *  This function flushes the message_queue's task wait queue.  The number
     39   *  of messages flushed from the queue is returned.
     40   *
     41   *  Input parameters:
     42   *    the_message_queue - the message_queue to be flushed
     43   *
     44   *  Output parameters:
     45   *    returns - the number of messages flushed from the queue
    6346   */
    6447
    65   _Thread_queue_Flush(
    66     &the_message_queue->Wait_queue,
    67     NULL,
    68     CORE_MESSAGE_QUEUE_STATUS_UNSATISFIED_NOWAIT
    69   );
    70 }
     48  void _CORE_message_queue_Flush_waiting_threads(
     49    CORE_message_queue_Control *the_message_queue
     50  )
     51  {
     52    /* XXX this is not supported for global message queues */
     53
     54    /*
     55     *  IF there are no pending messages,
     56     *  THEN threads may be blocked waiting to RECEIVE a message,
     57     *
     58     *  IF the pending message queue is full
     59     *  THEN threads may be blocked waiting to SEND a message
     60     *
     61     *  But in either case, we will return "unsatisfied nowait"
     62     *  to indicate that the blocking condition was not satisfied
     63     *  and that the blocking state was canceled.
     64     */
     65
     66    _Thread_queue_Flush(
     67      &the_message_queue->Wait_queue,
     68      NULL,
     69      CORE_MESSAGE_QUEUE_STATUS_UNSATISFIED_NOWAIT
     70    );
     71  }
     72#endif
Note: See TracChangeset for help on using the changeset viewer.