<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>change log for rtems (2011-08-01)</title>
</head>
<body text='#000000' bgcolor='#ffffff'>
<a name='cs1'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>jennifer</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2011-08-01 Jennifer Averett <Jennifer.Averett@OARcorp.com>
* score/include/rtems/score/isr.h: Cleaned up comments.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/ChangeLog.diff?r1=text&tr1=1.2896&r2=text&tr2=1.2897&diff_format=h">M</a></td><td width='1%'>1.2897</td><td width='100%'>cpukit/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/include/rtems/score/isr.h.diff?r1=text&tr1=1.36&r2=text&tr2=1.37&diff_format=h">M</a></td><td width='1%'>1.37</td><td width='100%'>cpukit/score/include/rtems/score/isr.h</td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/cpukit/ChangeLog:1.2896 rtems/cpukit/ChangeLog:1.2897
--- rtems/cpukit/ChangeLog:1.2896 Mon Aug 1 12:30:17 2011
+++ rtems/cpukit/ChangeLog Mon Aug 1 14:21:46 2011
</font><font color='#997700'>@@ -1,5 +1,9 @@
</font> 2011-08-01 Jennifer Averett <Jennifer.Averett@OARcorp.com>
<font color='#000088'>+ * score/include/rtems/score/isr.h: Cleaned up comments.
+
+2011-08-01 Jennifer Averett <Jennifer.Averett@OARcorp.com>
+
</font> * score/include/rtems/score/smplock.h: Fix comments.
2011-08-01 Jennifer Averett <Jennifer.Averett@OARcorp.com>
<font color='#006600'>diff -u rtems/cpukit/score/include/rtems/score/isr.h:1.36 rtems/cpukit/score/include/rtems/score/isr.h:1.37
--- rtems/cpukit/score/include/rtems/score/isr.h:1.36 Fri Jul 15 09:36:37 2011
+++ rtems/cpukit/score/include/rtems/score/isr.h Mon Aug 1 14:21:47 2011
</font><font color='#997700'>@@ -90,9 +90,13 @@
</font> void _ISR_Handler_initialization ( void );
/**
<font color='#000088'>+ * @brief Disable Interrupts
+ *
</font> * This routine disables all interrupts so that a critical section
<font color='#880000'>- * of code can be executing without being interrupted. Upon return,
- * the argument _level will contain the previous interrupt mask level.
</font><font color='#000088'>+ * of code can be executing without being interrupted.
+ *
+ * @return The argument @a _level will contain the previous interrupt
+ * mask level.
</font> */
#define _ISR_Disable( _level ) \
do { \
<font color='#997700'>@@ -101,9 +105,14 @@
</font> } while (0)
/**
<font color='#000088'>+ * @brief Enable Interrupts
+ *
</font> * This routine enables interrupts to the previous interrupt mask
* LEVEL. It is used at the end of a critical section of code to
* enable interrupts so they can be processed again.
<font color='#000088'>+ *
+ * @param[in] level contains the interrupt level mask level
+ * previously returned by @ref _ISR_Disable_on_core.
</font> */
#define _ISR_Enable( _level ) \
do { \
<font color='#997700'>@@ -112,16 +121,23 @@
</font> } while (0)
/**
<font color='#000088'>+ * @brief Temporarily Enable Interrupts
+ *
</font> * This routine temporarily enables interrupts to the previous
* interrupt mask level and then disables all interrupts so that
* the caller can continue into the second part of a critical
<font color='#880000'>- * section. This routine is used to temporarily enable interrupts
</font><font color='#000088'>+ * section.
+ *
+ * This routine is used to temporarily enable interrupts
</font> * during a long critical section. It is used in long sections of
* critical code when a point is reached at which interrupts can
* be temporarily enabled. Deciding where to flash interrupts
* in a long critical section is often difficult and the point
* must be selected with care to ensure that the critical section
* properly protects itself.
<font color='#000088'>+ *
+ * @param[in] level contains the interrupt level mask level
+ * previously returned by @ref _ISR_Disable_on_core.
</font> */
#define _ISR_Flash( _level ) \
do { \
<font color='#997700'>@@ -131,33 +147,51 @@
</font> } while (0)
/**
<font color='#000088'>+ * @brief Install Interrupt Handler Vector
+ *
</font> * This routine installs new_handler as the interrupt service routine
* for the specified vector. The previous interrupt service routine is
* returned as old_handler.
<font color='#000088'>+ *
+ * @param[in] _vector is the vector number
+ * @param[in] _new_handler is ISR handler to install
+ * @param[in] _old_handler is a pointer to a variable which will be set
+ * to the old handler
+ *
+ * @return *_old_handler will be set to the old ISR handler
</font> */
#define _ISR_Install_vector( _vector, _new_handler, _old_handler ) \
_CPU_ISR_install_vector( _vector, _new_handler, _old_handler )
/**
<font color='#000088'>+ * @brief Return Current Interrupt Level
+ *
</font> * This routine returns the current interrupt level.
<font color='#000088'>+ *
+ * @return This method returns the current level.
</font> */
#define _ISR_Get_level() \
_CPU_ISR_Get_level()
/**
<font color='#000088'>+ * @brief Set Current Interrupt Level
+ *
</font> * This routine sets the current interrupt level to that specified
<font color='#880000'>- * by new_level. The new interrupt level is effective when the
</font><font color='#000088'>+ * by @a _new_level. The new interrupt level is effective when the
</font> * routine exits.
<font color='#000088'>+ *
+ * @param[in] _new_level contains the desired interrupt level.
</font> */
#define _ISR_Set_level( _new_level ) \
do { \
RTEMS_COMPILER_MEMORY_BARRIER(); \
_CPU_ISR_Set_level( _new_level ); \
RTEMS_COMPILER_MEMORY_BARRIER(); \
<font color='#880000'>- } while (0)
-
</font><font color='#000088'>+ } while (0)
</font>
/**
<font color='#000088'>+ * @brief ISR Handler or Dispatcher
+ *
</font> * This routine is the interrupt dispatcher. ALL interrupts
* are vectored to this routine so that minimal context can be saved
* and setup performed before the application's high-level language
<font color='#997700'>@@ -172,6 +206,8 @@
</font> void _ISR_Handler( void );
/**
<font color='#000088'>+ * @brief ISR Wrapper for Thread Dispatcher
+ *
</font> * This routine provides a wrapper so that the routine
* @ref _Thread_Dispatch can be invoked when a reschedule is necessary
* at the end of the outermost interrupt service routine. This
<font color='#997700'>@@ -180,20 +216,24 @@
</font> * corrupted by _Thread_Dispatch. This context typically consists
* of registers which are not preserved across routine invocations.
*
<font color='#880000'>- * @note Implemented in assembly language.
</font><font color='#000088'>+ * @note Typically mplemented in assembly language.
</font> */
void _ISR_Dispatch( void );
/**
<font color='#000088'>+ * @brief Is an ISR in Progress
+ *
</font> * This function returns true if the processor is currently servicing
* and interrupt and false otherwise. A return value of true indicates
<font color='#880000'>- * that the caller is an interrupt service routine, NOT a thread. The
</font><font color='#000088'>+ * that the caller is an interrupt service routine, NOT a thread.
+ *
+ * @return This methods returns true when called from an ISR.
</font> */
#if (CPU_PROVIDES_ISR_IS_IN_PROGRESS == TRUE)
<font color='#880000'>-bool _ISR_Is_in_progress( void );
</font><font color='#000088'>+ bool _ISR_Is_in_progress( void );
</font> #else
<font color='#880000'>-#define _ISR_Is_in_progress() \
- (_ISR_Nest_level != 0)
</font><font color='#000088'>+ #define _ISR_Is_in_progress() \
+ (_ISR_Nest_level != 0)
</font> #endif
#include <rtems/score/isr.inl>
</pre>
<p> </p>
<p>--<br />
<small>Generated by <a href="http://www.codewiz.org/projects/index.html#loginfo">Deluxe Loginfo</a> 2.122 by Bernardo Innocenti <bernie@develer.com></small></p>
</body>
</html>