Changeset 1b20da0 in mainline for kernel/generic/src/synch/waitq.c


Ignore:
Timestamp:
2018-02-28T17:52:03Z (7 years ago)
Author:
Jiří Zárevúcky <zarevucky.jiri@…>
Branches:
lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export
Children:
3061bc1
Parents:
df6ded8
git-author:
Jiří Zárevúcky <zarevucky.jiri@…> (2018-02-28 17:26:03)
git-committer:
Jiří Zárevúcky <zarevucky.jiri@…> (2018-02-28 17:52:03)
Message:

style: Remove trailing whitespace on non-empty lines, in certain file types.

Command used: tools/srepl '\([^[:space:]]\)\s\+$' '\1' -- *.c *.h *.py *.sh *.s *.S *.ag

File:
1 edited

Legend:

Unmodified
Added
Removed
  • kernel/generic/src/synch/waitq.c

    rdf6ded8 r1b20da0  
    341341                 * Wait for a waitq_wakeup() or waitq_unsleep() to complete
    342342                 * before returning from waitq_sleep() to the caller. Otherwise
    343                  * the caller might expect that the wait queue is no longer used 
    344                  * and deallocate it (although the wakeup on a another cpu has 
     343                 * the caller might expect that the wait queue is no longer used
     344                 * and deallocate it (although the wakeup on a another cpu has
    345345                 * not yet completed and is using the wait queue).
    346346                 *
     
    474474
    475475/** If there is a wakeup in progress actively waits for it to complete.
    476  * 
     476 *
    477477 * The function returns once the concurrently running waitq_wakeup()
    478  * exits. It returns immediately if there are no concurrent wakeups 
     478 * exits. It returns immediately if there are no concurrent wakeups
    479479 * at the time.
    480  * 
     480 *
    481481 * Interrupts must be disabled.
    482  * 
     482 *
    483483 * Example usage:
    484484 * @code
     
    488488 *     waitq_wakeup(wq);
    489489 * }
    490  * void wait_for_completion(void) 
     490 * void wait_for_completion(void)
    491491 * {
    492492 *     waitq wg;
     
    496496 *     // Wait for callback() to complete its work.
    497497 *     waitq_sleep(&wq);
    498  *     // callback() completed its work, but it may still be accessing 
    499  *     // wq in waitq_wakeup(). Therefore it is not yet safe to return 
    500  *     // from waitq_sleep() or it would clobber up our stack (where wq 
     498 *     // callback() completed its work, but it may still be accessing
     499 *     // wq in waitq_wakeup(). Therefore it is not yet safe to return
     500 *     // from waitq_sleep() or it would clobber up our stack (where wq
    501501 *     // is stored). waitq_sleep() ensures the wait queue is no longer
    502502 *     // in use by invoking waitq_complete_wakeup() internally.
    503  *     
     503 *
    504504 *     // waitq_sleep() returned, it is safe to free wq.
    505505 * }
    506506 * @endcode
    507  * 
     507 *
    508508 * @param wq  Pointer to a wait queue.
    509509 */
Note: See TracChangeset for help on using the changeset viewer.