include/gdb/section-scripts.h

   1 /* Definition of kinds of records in section .debug_gdb_scripts.
   2
   3    Copyright (C) 2014-2024 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef GDB_SECTION_SCRIPTS_H
  21 #define GDB_SECTION_SCRIPTS_H
  22
  23 /* Each entry in section .debug_gdb_scripts begins with a byte that is used to
  24    identify the entry.  This byte is to use as we choose.
  25    0 is reserved so that it is never used (to catch errors).
  26    It is recommended to avoid ASCII values 32-127 to help catch (most) cases
  27    of forgetting to include this byte.
  28    Other unused values needn't specify different scripting languages,
  29    but we have no need for anything else at the moment.
  30
  31    These values are defined as macros so that they can be used in embedded
  32    asms and assembler source files.  */
  33
  34 /* Reserved.  */
  35 #define SECTION_SCRIPT_ID_NEVER_USE 0
  36
  37 /* The record is a nul-terminated file name to load as a python file.  */
  38 #define SECTION_SCRIPT_ID_PYTHON_FILE 1
  39
  40 /* Native GDB scripts are not currently supported in .debug_gdb_scripts,
  41    but we reserve a value for it.  */
  42 /*#define SECTION_SCRIPT_ID_GDB_FILE 2*/
  43
  44 /* The record is a nul-terminated file name to load as a guile(scheme)
  45    file.  */
  46 #define SECTION_SCRIPT_ID_SCHEME_FILE 3
  47
  48 /* The record is a nul-terminated string.
  49    The first line is the name of the script.
  50    Subsequent lines are interpreted as a python script.  */
  51 #define SECTION_SCRIPT_ID_PYTHON_TEXT 4
  52
  53 /* Native GDB scripts are not currently supported in .debug_gdb_scripts,
  54    but we reserve a value for it.  */
  55 /*#define SECTION_SCRIPT_ID_GDB_TEXT 5*/
  56
  57 /* The record is a nul-terminated string.
  58    The first line is the name of the script.
  59    Subsequent lines are interpreted as a guile(scheme) script.  */
  60 #define SECTION_SCRIPT_ID_SCHEME_TEXT 6
  61
  62 #endif /* GDB_SECTION_SCRIPTS_H */