diff options
author | Joel Sherrill <joel@rtems.org> | 2022-03-18 09:40:55 -0500 |
---|---|---|
committer | Joel Sherrill <joel@rtems.org> | 2022-03-22 11:34:23 -0500 |
commit | 5dec08934fe44c8483795147e3e6f9480660f099 (patch) | |
tree | d20c69745cfa77b6cbebdc41f00cf4cc0bbb634a /cpukit/libdl/rtl-debugger.c | |
parent | cpukit/libfs/src/defaults: Change license to BSD-2 (diff) | |
download | rtems-5dec08934fe44c8483795147e3e6f9480660f099.tar.bz2 |
cpukit/libdl: Manual file header reordering (SPDX, Doxygen, Copyright)
Updates #3053.
Diffstat (limited to 'cpukit/libdl/rtl-debugger.c')
-rw-r--r-- | cpukit/libdl/rtl-debugger.c | 33 |
1 files changed, 17 insertions, 16 deletions
diff --git a/cpukit/libdl/rtl-debugger.c b/cpukit/libdl/rtl-debugger.c index 65e9db8a5b..3c25605f5e 100644 --- a/cpukit/libdl/rtl-debugger.c +++ b/cpukit/libdl/rtl-debugger.c @@ -1,5 +1,22 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup rtl + * + * @brief RTEMS Module Loading Debugger Interface. + * + * Inspection of run-time linkers in NetBSD and Android show a common type of + * structure that is used to interface to GDB. The NetBSD definition of this + * interface is being used and is defined in <link.h>. It defines a protocol + * that is used by GDB to inspect the state of dynamic libraries. I have not + * checked GDB code at when writing this comment but I suspect GDB sets a break + * point on the r_brk field of _rtld_debug and it has code that detects this + * break point being hit. When this happens it reads the state and performs the + * operation based on the r_state field. + */ + /* * COPYRIGHT (c) 2012, 2018 Chris Johns <chrisj@rtems.org> * @@ -24,22 +41,6 @@ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ -/** - * @file - * - * @ingroup rtl - * - * @brief RTEMS Module Loading Debugger Interface. - * - * Inspection of run-time linkers in NetBSD and Android show a common type of - * structure that is used to interface to GDB. The NetBSD definition of this - * interface is being used and is defined in <link.h>. It defines a protocol - * that is used by GDB to inspect the state of dynamic libraries. I have not - * checked GDB code at when writing this comment but I suspect GDB sets a break - * point on the r_brk field of _rtld_debug and it has code that detects this - * break point being hit. When this happens it reads the state and performs the - * operation based on the r_state field. - */ #ifdef HAVE_CONFIG_H #include "config.h" |