1 /* GDB routines for supporting auto-loaded scripts.
3 Copyright (C) 2012-2024 Free Software Foundation, Inc.
5 This file is part of GDB.
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.
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.
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/>. */
21 #include "auto-load.h"
22 #include "progspace.h"
23 #include "gdbsupport/gdb_regex.h"
25 #include "filenames.h"
27 #include "observable.h"
29 #include "cli/cli-script.h"
31 #include "cli/cli-cmds.h"
32 #include "cli/cli-decode.h"
33 #include "cli/cli-setshow.h"
34 #include "readline/tilde.h"
35 #include "completer.h"
38 #include "gdbsupport/filestuff.h"
39 #include "extension.h"
40 #include "gdb/section-scripts.h"
42 #include "gdbsupport/pathstuff.h"
43 #include "cli/cli-style.h"
45 /* The section to look in for auto-loaded scripts (in file formats that
47 Each entry in this section is a record that begins with a leading byte
48 identifying the record type.
49 At the moment we only support one record type: A leading byte of 1,
50 followed by the path of a python script to load. */
51 #define AUTO_SECTION_NAME ".debug_gdb_scripts"
53 /* The section to look in for the name of a separate debug file. */
54 #define DEBUGLINK_SECTION_NAME ".gnu_debuglink"
56 static void maybe_print_unsupported_script_warning
57 (struct auto_load_pspace_info
*, struct objfile
*objfile
,
58 const struct extension_language_defn
*language
,
59 const char *section_name
, unsigned offset
);
61 static void maybe_print_script_not_found_warning
62 (struct auto_load_pspace_info
*, struct objfile
*objfile
,
63 const struct extension_language_defn
*language
,
64 const char *section_name
, unsigned offset
);
66 /* See auto-load.h. */
68 bool debug_auto_load
= false;
70 /* "show" command for the debug_auto_load configuration variable. */
73 show_debug_auto_load (struct ui_file
*file
, int from_tty
,
74 struct cmd_list_element
*c
, const char *value
)
76 gdb_printf (file
, _("Debugging output for files "
77 "of 'set auto-load ...' is %s.\n"),
81 /* User-settable option to enable/disable auto-loading of GDB_AUTO_FILE_NAME
83 set auto-load gdb-scripts on|off
84 This is true if we should auto-load associated scripts when an objfile
85 is opened, false otherwise. */
86 static bool auto_load_gdb_scripts
= true;
88 /* "show" command for the auto_load_gdb_scripts configuration variable. */
91 show_auto_load_gdb_scripts (struct ui_file
*file
, int from_tty
,
92 struct cmd_list_element
*c
, const char *value
)
94 gdb_printf (file
, _("Auto-loading of canned sequences of commands "
99 /* See auto-load.h. */
102 auto_load_gdb_scripts_enabled (const struct extension_language_defn
*extlang
)
104 return auto_load_gdb_scripts
;
107 /* Internal-use flag to enable/disable auto-loading.
108 This is true if we should auto-load python code when an objfile is opened,
111 Both auto_load_scripts && global_auto_load must be true to enable
114 This flag exists to facilitate deferring auto-loading during start-up
115 until after ./.gdbinit has been read; it may augment the search directories
116 used to find the scripts. */
117 bool global_auto_load
= true;
119 /* Auto-load .gdbinit file from the current directory? */
120 bool auto_load_local_gdbinit
= true;
122 /* Absolute pathname to the current directory .gdbinit, if it exists. */
123 char *auto_load_local_gdbinit_pathname
= NULL
;
125 /* if AUTO_LOAD_LOCAL_GDBINIT_PATHNAME has been loaded. */
126 bool auto_load_local_gdbinit_loaded
= false;
128 /* "show" command for the auto_load_local_gdbinit configuration variable. */
131 show_auto_load_local_gdbinit (struct ui_file
*file
, int from_tty
,
132 struct cmd_list_element
*c
, const char *value
)
134 gdb_printf (file
, _("Auto-loading of .gdbinit script from current "
135 "directory is %s.\n"),
139 /* Directory list from which to load auto-loaded scripts. It is not checked
140 for absolute paths but they are strongly recommended. It is initialized by
141 _initialize_auto_load. */
142 static std::string auto_load_dir
= AUTO_LOAD_DIR
;
144 /* "set" command for the auto_load_dir configuration variable. */
147 set_auto_load_dir (const char *args
, int from_tty
, struct cmd_list_element
*c
)
149 /* Setting the variable to "" resets it to the compile time defaults. */
150 if (auto_load_dir
.empty ())
151 auto_load_dir
= AUTO_LOAD_DIR
;
154 /* "show" command for the auto_load_dir configuration variable. */
157 show_auto_load_dir (struct ui_file
*file
, int from_tty
,
158 struct cmd_list_element
*c
, const char *value
)
160 gdb_printf (file
, _("List of directories from which to load "
161 "auto-loaded scripts is %s.\n"),
165 /* Directory list safe to hold auto-loaded files. It is not checked for
166 absolute paths but they are strongly recommended. It is initialized by
167 _initialize_auto_load. */
168 static std::string auto_load_safe_path
= AUTO_LOAD_SAFE_PATH
;
170 /* Vector of directory elements of AUTO_LOAD_SAFE_PATH with each one normalized
171 by tilde_expand and possibly each entries has added its gdb_realpath
173 static std::vector
<gdb::unique_xmalloc_ptr
<char>> auto_load_safe_path_vec
;
175 /* Expand $datadir and $debugdir in STRING according to the rules of
176 substitute_path_component. */
178 static std::vector
<gdb::unique_xmalloc_ptr
<char>>
179 auto_load_expand_dir_vars (const char *string
)
181 char *s
= xstrdup (string
);
182 substitute_path_component (&s
, "$datadir", gdb_datadir
.c_str ());
183 substitute_path_component (&s
, "$debugdir", debug_file_directory
.c_str ());
185 if (debug_auto_load
&& strcmp (s
, string
) != 0)
186 auto_load_debug_printf ("Expanded $-variables to \"%s\".", s
);
188 std::vector
<gdb::unique_xmalloc_ptr
<char>> dir_vec
189 = dirnames_to_char_ptr_vec (s
);
195 /* Update auto_load_safe_path_vec from current AUTO_LOAD_SAFE_PATH. */
198 auto_load_safe_path_vec_update (void)
200 auto_load_debug_printf ("Updating directories of \"%s\".",
201 auto_load_safe_path
.c_str ());
203 auto_load_safe_path_vec
204 = auto_load_expand_dir_vars (auto_load_safe_path
.c_str ());
205 size_t len
= auto_load_safe_path_vec
.size ();
207 /* Apply tilde_expand and gdb_realpath to each AUTO_LOAD_SAFE_PATH_VEC
209 for (size_t i
= 0; i
< len
; i
++)
211 gdb::unique_xmalloc_ptr
<char> &in_vec
= auto_load_safe_path_vec
[i
];
212 gdb::unique_xmalloc_ptr
<char> expanded (tilde_expand (in_vec
.get ()));
213 gdb::unique_xmalloc_ptr
<char> real_path
= gdb_realpath (expanded
.get ());
215 /* Ensure the current entry is at least tilde_expand-ed. ORIGINAL makes
216 sure we free the original string. */
217 gdb::unique_xmalloc_ptr
<char> original
= std::move (in_vec
);
218 in_vec
= std::move (expanded
);
222 if (strcmp (in_vec
.get (), original
.get ()) == 0)
223 auto_load_debug_printf ("Using directory \"%s\".",
226 auto_load_debug_printf ("Resolved directory \"%s\" as \"%s\".",
227 original
.get (), in_vec
.get ());
230 /* If gdb_realpath returns a different content, append it. */
231 if (strcmp (real_path
.get (), in_vec
.get ()) != 0)
233 auto_load_debug_printf ("And canonicalized as \"%s\".",
236 auto_load_safe_path_vec
.push_back (std::move (real_path
));
241 /* Variable gdb_datadir has been set. Update content depending on $datadir. */
244 auto_load_gdb_datadir_changed (void)
246 auto_load_safe_path_vec_update ();
249 /* "set" command for the auto_load_safe_path configuration variable. */
252 set_auto_load_safe_path (const char *args
,
253 int from_tty
, struct cmd_list_element
*c
)
255 /* Setting the variable to "" resets it to the compile time defaults. */
256 if (auto_load_safe_path
.empty ())
257 auto_load_safe_path
= AUTO_LOAD_SAFE_PATH
;
259 auto_load_safe_path_vec_update ();
262 /* "show" command for the auto_load_safe_path configuration variable. */
265 show_auto_load_safe_path (struct ui_file
*file
, int from_tty
,
266 struct cmd_list_element
*c
, const char *value
)
270 /* Check if user has entered either "/" or for example ":".
271 But while more complicate content like ":/foo" would still also
272 permit any location do not hide those. */
274 for (cs
= value
; *cs
&& (*cs
== DIRNAME_SEPARATOR
|| IS_DIR_SEPARATOR (*cs
));
277 gdb_printf (file
, _("Auto-load files are safe to load from any "
280 gdb_printf (file
, _("List of directories from which it is safe to "
281 "auto-load files is %s.\n"),
285 /* "add-auto-load-safe-path" command for the auto_load_safe_path configuration
289 add_auto_load_safe_path (const char *args
, int from_tty
)
291 if (args
== NULL
|| *args
== 0)
293 Directory argument required.\n\
294 Use 'set auto-load safe-path /' for disabling the auto-load safe-path security.\
297 auto_load_safe_path
= string_printf ("%s%c%s", auto_load_safe_path
.c_str (),
298 DIRNAME_SEPARATOR
, args
);
300 auto_load_safe_path_vec_update ();
303 /* "add-auto-load-scripts-directory" command for the auto_load_dir configuration
307 add_auto_load_dir (const char *args
, int from_tty
)
309 if (args
== NULL
|| *args
== 0)
310 error (_("Directory argument required."));
312 auto_load_dir
= string_printf ("%s%c%s", auto_load_dir
.c_str (),
313 DIRNAME_SEPARATOR
, args
);
316 /* Implementation for filename_is_in_pattern overwriting the caller's FILENAME
320 filename_is_in_pattern_1 (char *filename
, char *pattern
)
322 size_t pattern_len
= strlen (pattern
);
323 size_t filename_len
= strlen (filename
);
325 auto_load_debug_printf ("Matching file \"%s\" to pattern \"%s\"",
328 /* Trim trailing slashes ("/") from PATTERN. Even for "d:\" paths as
329 trailing slashes are trimmed also from FILENAME it still matches
331 while (pattern_len
&& IS_DIR_SEPARATOR (pattern
[pattern_len
- 1]))
333 pattern
[pattern_len
] = '\0';
335 /* Ensure auto_load_safe_path "/" matches any FILENAME. On MS-Windows
336 platform FILENAME even after gdb_realpath does not have to start with
337 IS_DIR_SEPARATOR character, such as the 'C:\x.exe' filename. */
338 if (pattern_len
== 0)
340 auto_load_debug_printf ("Matched - empty pattern");
346 /* Trim trailing slashes ("/"). PATTERN also has slashes trimmed the
347 same way so they will match. */
348 while (filename_len
&& IS_DIR_SEPARATOR (filename
[filename_len
- 1]))
350 filename
[filename_len
] = '\0';
351 if (filename_len
== 0)
353 auto_load_debug_printf ("Not matched - pattern \"%s\".", pattern
);
357 if (gdb_filename_fnmatch (pattern
, filename
, FNM_FILE_NAME
| FNM_NOESCAPE
)
360 auto_load_debug_printf ("Matched - file \"%s\" to pattern \"%s\".",
365 /* Trim trailing FILENAME component. */
366 while (filename_len
> 0 && !IS_DIR_SEPARATOR (filename
[filename_len
- 1]))
371 /* Return 1 if FILENAME matches PATTERN or if FILENAME resides in
372 a subdirectory of a directory that matches PATTERN. Return 0 otherwise.
373 gdb_realpath normalization is never done here. */
375 static ATTRIBUTE_PURE
int
376 filename_is_in_pattern (const char *filename
, const char *pattern
)
378 char *filename_copy
, *pattern_copy
;
380 filename_copy
= (char *) alloca (strlen (filename
) + 1);
381 strcpy (filename_copy
, filename
);
382 pattern_copy
= (char *) alloca (strlen (pattern
) + 1);
383 strcpy (pattern_copy
, pattern
);
385 return filename_is_in_pattern_1 (filename_copy
, pattern_copy
);
388 /* Return 1 if FILENAME belongs to one of directory components of
389 AUTO_LOAD_SAFE_PATH_VEC. Return 0 otherwise.
390 auto_load_safe_path_vec_update is never called.
391 *FILENAME_REALP may be updated by gdb_realpath of FILENAME. */
394 filename_is_in_auto_load_safe_path_vec (const char *filename
,
395 gdb::unique_xmalloc_ptr
<char> *filename_realp
)
397 const char *pattern
= NULL
;
399 for (const gdb::unique_xmalloc_ptr
<char> &p
: auto_load_safe_path_vec
)
400 if (*filename_realp
== NULL
&& filename_is_in_pattern (filename
, p
.get ()))
408 if (*filename_realp
== NULL
)
410 *filename_realp
= gdb_realpath (filename
);
411 if (debug_auto_load
&& strcmp (filename_realp
->get (), filename
) != 0)
412 auto_load_debug_printf ("Resolved file \"%s\" as \"%s\".",
413 filename
, filename_realp
->get ());
416 if (strcmp (filename_realp
->get (), filename
) != 0)
417 for (const gdb::unique_xmalloc_ptr
<char> &p
: auto_load_safe_path_vec
)
418 if (filename_is_in_pattern (filename_realp
->get (), p
.get ()))
427 auto_load_debug_printf ("File \"%s\" matches directory \"%s\".",
435 /* See auto-load.h. */
438 file_is_auto_load_safe (const char *filename
)
440 gdb::unique_xmalloc_ptr
<char> filename_real
;
441 static bool advice_printed
= false;
443 if (filename_is_in_auto_load_safe_path_vec (filename
, &filename_real
))
446 auto_load_safe_path_vec_update ();
447 if (filename_is_in_auto_load_safe_path_vec (filename
, &filename_real
))
450 warning (_("File \"%ps\" auto-loading has been declined by your "
451 "`auto-load safe-path' set to \"%s\"."),
452 styled_string (file_name_style
.style (), filename_real
.get ()),
453 auto_load_safe_path
.c_str ());
457 /* Find the existing home directory config file. */
459 std::string home_config
= find_gdb_home_config_file (GDBINIT
, &buf
);
460 if (home_config
.empty ())
462 /* The user doesn't have an existing home directory config file,
463 so we should suggest a suitable path for them to use. */
464 std::string config_dir_file
465 = get_standard_config_filename (GDBINIT
);
466 if (!config_dir_file
.empty ())
467 home_config
= config_dir_file
;
470 const char *homedir
= getenv ("HOME");
471 if (homedir
== nullptr)
473 home_config
= (std::string (homedir
) + SLASH_STRING
474 + std::string (GDBINIT
));
479 To enable execution of this file add\n\
480 \tadd-auto-load-safe-path %s\n\
481 line to your configuration file \"%ps\".\n\
482 To completely disable this security protection add\n\
483 \tset auto-load safe-path /\n\
484 line to your configuration file \"%ps\".\n\
485 For more information about this security protection see the\n\
486 \"Auto-loading safe path\" section in the GDB manual. E.g., run from the shell:\n\
487 \tinfo \"(gdb)Auto-loading safe path\"\n"),
488 filename_real
.get (),
489 styled_string (file_name_style
.style (),
490 home_config
.c_str ()),
491 styled_string (file_name_style
.style (),
492 home_config
.c_str ()));
493 advice_printed
= true;
499 /* For scripts specified in .debug_gdb_scripts, multiple objfiles may load
500 the same script. There's no point in loading the script multiple times,
501 and there can be a lot of objfiles and scripts, so we keep track of scripts
504 struct auto_load_pspace_info
506 /* For each program space we keep track of loaded scripts, both when
507 specified as file names and as scripts to be executed directly. */
508 htab_up loaded_script_files
;
509 htab_up loaded_script_texts
;
511 /* Non-zero if we've issued the warning about an auto-load script not being
512 supported. We only want to issue this warning once. */
513 bool unsupported_script_warning_printed
= false;
515 /* Non-zero if we've issued the warning about an auto-load script not being
516 found. We only want to issue this warning once. */
517 bool script_not_found_warning_printed
= false;
520 /* Objects of this type are stored in the loaded_script hash table. */
524 /* Name as provided by the objfile. */
527 /* Full path name or NULL if script wasn't found (or was otherwise
528 inaccessible), or NULL for loaded_script_texts. */
529 const char *full_path
;
531 /* True if this script has been loaded. */
534 const struct extension_language_defn
*language
;
537 /* Per-program-space data key. */
538 static const registry
<program_space
>::key
<auto_load_pspace_info
>
539 auto_load_pspace_data
;
541 /* Get the current autoload data. If none is found yet, add it now. This
542 function always returns a valid object. */
544 static struct auto_load_pspace_info
*
545 get_auto_load_pspace_data (struct program_space
*pspace
)
547 struct auto_load_pspace_info
*info
;
549 info
= auto_load_pspace_data
.get (pspace
);
551 info
= auto_load_pspace_data
.emplace (pspace
);
556 /* Hash function for the loaded script hash. */
559 hash_loaded_script_entry (const void *data
)
561 const struct loaded_script
*e
= (const struct loaded_script
*) data
;
563 return htab_hash_string (e
->name
) ^ htab_hash_pointer (e
->language
);
566 /* Equality function for the loaded script hash. */
569 eq_loaded_script_entry (const void *a
, const void *b
)
571 const struct loaded_script
*ea
= (const struct loaded_script
*) a
;
572 const struct loaded_script
*eb
= (const struct loaded_script
*) b
;
574 return strcmp (ea
->name
, eb
->name
) == 0 && ea
->language
== eb
->language
;
577 /* Initialize the table to track loaded scripts.
578 Each entry is hashed by the full path name. */
581 init_loaded_scripts_info (struct auto_load_pspace_info
*pspace_info
)
583 /* Choose 31 as the starting size of the hash table, somewhat arbitrarily.
584 Space for each entry is obtained with one malloc so we can free them
587 pspace_info
->loaded_script_files
.reset
589 hash_loaded_script_entry
,
590 eq_loaded_script_entry
,
592 pspace_info
->loaded_script_texts
.reset
594 hash_loaded_script_entry
,
595 eq_loaded_script_entry
,
598 pspace_info
->unsupported_script_warning_printed
= false;
599 pspace_info
->script_not_found_warning_printed
= false;
602 /* Wrapper on get_auto_load_pspace_data to also allocate the hash table
603 for loading scripts. */
605 struct auto_load_pspace_info
*
606 get_auto_load_pspace_data_for_loading (struct program_space
*pspace
)
608 struct auto_load_pspace_info
*info
;
610 info
= get_auto_load_pspace_data (pspace
);
611 if (info
->loaded_script_files
== NULL
)
612 init_loaded_scripts_info (info
);
617 /* Add script file NAME in LANGUAGE to hash table of PSPACE_INFO.
618 LOADED is true if the script has been (is going to) be loaded, false
619 otherwise (such as if it has not been found).
620 FULL_PATH is NULL if the script wasn't found.
622 The result is true if the script was already in the hash table. */
625 maybe_add_script_file (struct auto_load_pspace_info
*pspace_info
, bool loaded
,
626 const char *name
, const char *full_path
,
627 const struct extension_language_defn
*language
)
629 struct htab
*htab
= pspace_info
->loaded_script_files
.get ();
630 struct loaded_script
**slot
, entry
;
633 entry
.language
= language
;
634 slot
= (struct loaded_script
**) htab_find_slot (htab
, &entry
, INSERT
);
635 bool in_hash_table
= *slot
!= NULL
;
637 /* If this script is not in the hash table, add it. */
643 /* Allocate all space in one chunk so it's easier to free. */
644 *slot
= ((struct loaded_script
*)
645 xmalloc (sizeof (**slot
)
647 + (full_path
!= NULL
? (strlen (full_path
) + 1) : 0)));
648 p
= ((char*) *slot
) + sizeof (**slot
);
651 if (full_path
!= NULL
)
654 strcpy (p
, full_path
);
655 (*slot
)->full_path
= p
;
658 (*slot
)->full_path
= NULL
;
659 (*slot
)->loaded
= loaded
;
660 (*slot
)->language
= language
;
663 return in_hash_table
;
666 /* Add script contents NAME in LANGUAGE to hash table of PSPACE_INFO.
667 LOADED is true if the script has been (is going to) be loaded, false
668 otherwise (such as if it has not been found).
670 The result is true if the script was already in the hash table. */
673 maybe_add_script_text (struct auto_load_pspace_info
*pspace_info
,
674 bool loaded
, const char *name
,
675 const struct extension_language_defn
*language
)
677 struct htab
*htab
= pspace_info
->loaded_script_texts
.get ();
678 struct loaded_script
**slot
, entry
;
681 entry
.language
= language
;
682 slot
= (struct loaded_script
**) htab_find_slot (htab
, &entry
, INSERT
);
683 bool in_hash_table
= *slot
!= NULL
;
685 /* If this script is not in the hash table, add it. */
691 /* Allocate all space in one chunk so it's easier to free. */
692 *slot
= ((struct loaded_script
*)
693 xmalloc (sizeof (**slot
) + strlen (name
) + 1));
694 p
= ((char*) *slot
) + sizeof (**slot
);
697 (*slot
)->full_path
= NULL
;
698 (*slot
)->loaded
= loaded
;
699 (*slot
)->language
= language
;
702 return in_hash_table
;
705 /* Clear the table of loaded section scripts. */
708 clear_section_scripts (program_space
*pspace
)
710 auto_load_pspace_info
*info
= auto_load_pspace_data
.get (pspace
);
711 if (info
!= NULL
&& info
->loaded_script_files
!= NULL
)
712 auto_load_pspace_data
.clear (pspace
);
715 /* Look for the auto-load script in LANGUAGE associated with OBJFILE where
716 OBJFILE's gdb_realpath is REALNAME and load it. Return 1 if we found any
717 matching script, return 0 otherwise. */
720 auto_load_objfile_script_1 (struct objfile
*objfile
, const char *realname
,
721 const struct extension_language_defn
*language
)
723 const char *debugfile
;
725 const char *suffix
= ext_lang_auto_load_suffix (language
);
727 std::string filename
= std::string (realname
) + suffix
;
729 gdb_file_up input
= gdb_fopen_cloexec (filename
.c_str (), "r");
730 debugfile
= filename
.c_str ();
732 auto_load_debug_printf ("Attempted file \"%ps\" %s.",
733 styled_string (file_name_style
.style (), debugfile
),
734 input
!= nullptr ? "exists" : "does not exist");
736 std::string debugfile_holder
;
739 /* Also try the same file in a subdirectory of gdb's data
742 std::vector
<gdb::unique_xmalloc_ptr
<char>> vec
743 = auto_load_expand_dir_vars (auto_load_dir
.c_str ());
745 auto_load_debug_printf
746 ("Searching 'set auto-load scripts-directory' path \"%s\".",
747 auto_load_dir
.c_str ());
749 /* Convert Windows file name from c:/dir/file to /c/dir/file. */
750 if (HAS_DRIVE_SPEC (debugfile
))
751 filename
= (std::string("\\") + debugfile
[0]
752 + STRIP_DRIVE_SPEC (debugfile
));
754 for (const gdb::unique_xmalloc_ptr
<char> &dir
: vec
)
756 /* FILENAME is absolute, so we don't need a "/" here. */
757 debugfile_holder
= dir
.get () + filename
;
758 debugfile
= debugfile_holder
.c_str ();
760 input
= gdb_fopen_cloexec (debugfile
, "r");
762 auto_load_debug_printf ("Attempted file \"%ps\" %s.",
763 styled_string (file_name_style
.style (),
767 : "does not exist"));
776 struct auto_load_pspace_info
*pspace_info
;
778 auto_load_debug_printf
779 ("Loading %s script \"%s\" by extension for objfile \"%s\".",
780 ext_lang_name (language
), debugfile
, objfile_name (objfile
));
782 bool is_safe
= file_is_auto_load_safe (debugfile
);
784 /* Add this script to the hash table too so
785 "info auto-load ${lang}-scripts" can print it. */
787 = get_auto_load_pspace_data_for_loading (objfile
->pspace
);
788 maybe_add_script_file (pspace_info
, is_safe
, debugfile
, debugfile
,
791 /* To preserve existing behaviour we don't check for whether the
792 script was already in the table, and always load it.
793 It's highly unlikely that we'd ever load it twice,
794 and these scripts are required to be idempotent under multiple
798 objfile_script_sourcer_func
*sourcer
799 = ext_lang_objfile_script_sourcer (language
);
801 /* We shouldn't get here if support for the language isn't
802 compiled in. And the extension language is required to implement
804 gdb_assert (sourcer
!= NULL
);
805 sourcer (language
, objfile
, input
.get (), debugfile
);
816 /* Look for the auto-load script in LANGUAGE associated with OBJFILE and load
820 auto_load_objfile_script (struct objfile
*objfile
,
821 const struct extension_language_defn
*language
)
823 gdb::unique_xmalloc_ptr
<char> realname
824 = gdb_realpath (objfile_name (objfile
));
826 if (auto_load_objfile_script_1 (objfile
, realname
.get (), language
))
829 /* For Windows/DOS .exe executables, strip the .exe suffix, so that
830 FOO-gdb.gdb could be used for FOO.exe, and try again. */
832 size_t len
= strlen (realname
.get ());
833 const size_t lexe
= sizeof (".exe") - 1;
835 if (len
> lexe
&& strcasecmp (realname
.get () + len
- lexe
, ".exe") == 0)
838 realname
.get ()[len
] = '\0';
840 auto_load_debug_printf
841 ("Stripped .exe suffix, retrying with \"%s\".", realname
.get ());
843 auto_load_objfile_script_1 (objfile
, realname
.get (), language
);
847 /* If OBJFILE is a separate debug file and its name does not match
848 the name given in the parent's .gnu_debuglink section, try to
849 find the auto-load script using the parent's path and the
852 struct objfile
*parent
= objfile
->separate_debug_objfile_backlink
;
853 if (parent
!= nullptr)
856 gdb::unique_xmalloc_ptr
<char> debuglink
857 (bfd_get_debug_link_info (parent
->obfd
.get (), &crc32
));
859 if (debuglink
.get () != nullptr
860 && strcmp (debuglink
.get (), lbasename (realname
.get ())) != 0)
862 /* Replace the last component of the parent's path with the
865 std::string p_realname
= gdb_realpath (objfile_name (parent
)).get ();
866 size_t last
= p_realname
.find_last_of ('/');
868 if (last
!= std::string::npos
)
870 p_realname
.replace (last
+ 1, std::string::npos
,
873 auto_load_debug_printf
874 ("Debug filename mismatch, retrying with \"%s\".",
875 p_realname
.c_str ());
877 auto_load_objfile_script_1 (objfile
,
878 p_realname
.c_str (), language
);
884 /* Subroutine of source_section_scripts to simplify it.
885 Load FILE as a script in extension language LANGUAGE.
886 The script is from section SECTION_NAME in OBJFILE at offset OFFSET. */
889 source_script_file (struct auto_load_pspace_info
*pspace_info
,
890 struct objfile
*objfile
,
891 const struct extension_language_defn
*language
,
892 const char *section_name
, unsigned int offset
,
895 objfile_script_sourcer_func
*sourcer
;
897 /* Skip this script if support is not compiled in. */
898 sourcer
= ext_lang_objfile_script_sourcer (language
);
901 /* We don't throw an error, the program is still debuggable. */
902 maybe_print_unsupported_script_warning (pspace_info
, objfile
, language
,
903 section_name
, offset
);
904 /* We *could* still try to open it, but there's no point. */
905 maybe_add_script_file (pspace_info
, 0, file
, NULL
, language
);
909 /* Skip this script if auto-loading it has been disabled. */
910 if (!ext_lang_auto_load_enabled (language
))
912 /* No message is printed, just skip it. */
916 std::optional
<open_script
> opened
= find_and_open_script (file
,
921 auto_load_debug_printf
922 ("Loading %s script \"%s\" from section \"%s\" of objfile \"%s\".",
923 ext_lang_name (language
), opened
->full_path
.get (),
924 section_name
, objfile_name (objfile
));
926 if (!file_is_auto_load_safe (opened
->full_path
.get ()))
931 /* If one script isn't found it's not uncommon for more to not be
932 found either. We don't want to print a message for each script,
933 too much noise. Instead, we print the warning once and tell the
934 user how to find the list of scripts that weren't loaded.
935 We don't throw an error, the program is still debuggable.
937 IWBN if complaints.c were more general-purpose. */
939 maybe_print_script_not_found_warning (pspace_info
, objfile
, language
,
940 section_name
, offset
);
944 = maybe_add_script_file (pspace_info
, bool (opened
), file
,
945 (opened
? opened
->full_path
.get (): NULL
),
948 /* If this file is not currently loaded, load it. */
949 if (opened
&& !in_hash_table
)
950 sourcer (language
, objfile
, opened
->stream
.get (),
951 opened
->full_path
.get ());
954 /* Subroutine of source_section_scripts to simplify it.
955 Execute SCRIPT as a script in extension language LANG.
956 The script is from section SECTION_NAME in OBJFILE at offset OFFSET. */
959 execute_script_contents (struct auto_load_pspace_info
*pspace_info
,
960 struct objfile
*objfile
,
961 const struct extension_language_defn
*language
,
962 const char *section_name
, unsigned int offset
,
965 objfile_script_executor_func
*executor
;
966 const char *newline
, *script_text
;
969 /* The first line of the script is the name of the script.
970 It must not contain any kind of space character. */
972 newline
= strchr (script
, '\n');
973 std::string name_holder
;
978 /* Put the name in a buffer and validate it. */
979 name_holder
= std::string (script
, newline
- script
);
980 buf
= name_holder
.c_str ();
981 for (p
= buf
; *p
!= '\0'; ++p
)
986 /* We don't allow nameless scripts, they're not helpful to the user. */
987 if (p
!= buf
&& *p
== '\0')
992 /* We don't throw an error, the program is still debuggable. */
994 Missing/bad script name in entry at offset %u in section %s\n\
996 offset
, section_name
,
997 styled_string (file_name_style
.style (),
998 objfile_name (objfile
)));
1001 script_text
= newline
+ 1;
1003 /* Skip this script if support is not compiled in. */
1004 executor
= ext_lang_objfile_script_executor (language
);
1005 if (executor
== NULL
)
1007 /* We don't throw an error, the program is still debuggable. */
1008 maybe_print_unsupported_script_warning (pspace_info
, objfile
, language
,
1009 section_name
, offset
);
1010 maybe_add_script_text (pspace_info
, 0, name
, language
);
1014 /* Skip this script if auto-loading it has been disabled. */
1015 if (!ext_lang_auto_load_enabled (language
))
1017 /* No message is printed, just skip it. */
1021 auto_load_debug_printf
1022 ("Loading %s script \"%s\" from section \"%s\" of objfile \"%s\".",
1023 ext_lang_name (language
), name
, section_name
, objfile_name (objfile
));
1025 bool is_safe
= file_is_auto_load_safe (objfile_name (objfile
));
1028 = maybe_add_script_text (pspace_info
, is_safe
, name
, language
);
1030 /* If this file is not currently loaded, load it. */
1031 if (is_safe
&& !in_hash_table
)
1032 executor (language
, objfile
, name
, script_text
);
1035 /* Load scripts specified in OBJFILE.
1036 START,END delimit a buffer containing a list of nul-terminated
1038 SECTION_NAME is used in error messages.
1040 Scripts specified as file names are found per normal "source -s" command
1041 processing. First the script is looked for in $cwd. If not found there
1042 the source search path is used.
1044 The section contains a list of path names of script files to load or
1045 actual script contents. Each entry is nul-terminated. */
1048 source_section_scripts (struct objfile
*objfile
, const char *section_name
,
1049 const char *start
, const char *end
)
1051 auto_load_pspace_info
*pspace_info
1052 = get_auto_load_pspace_data_for_loading (objfile
->pspace
);
1054 for (const char *p
= start
; p
< end
; ++p
)
1057 const struct extension_language_defn
*language
;
1058 unsigned int offset
= p
- start
;
1063 case SECTION_SCRIPT_ID_PYTHON_FILE
:
1064 case SECTION_SCRIPT_ID_PYTHON_TEXT
:
1065 language
= get_ext_lang_defn (EXT_LANG_PYTHON
);
1067 case SECTION_SCRIPT_ID_SCHEME_FILE
:
1068 case SECTION_SCRIPT_ID_SCHEME_TEXT
:
1069 language
= get_ext_lang_defn (EXT_LANG_GUILE
);
1072 warning (_("Invalid entry in %s section"), section_name
);
1073 /* We could try various heuristics to find the next valid entry,
1074 but it's safer to just punt. */
1079 while (p
< end
&& *p
!= '\0')
1083 warning (_("Non-nul-terminated entry in %s at offset %u"),
1084 section_name
, offset
);
1085 /* Don't load/execute it. */
1091 case SECTION_SCRIPT_ID_PYTHON_FILE
:
1092 case SECTION_SCRIPT_ID_SCHEME_FILE
:
1095 warning (_("Empty entry in %s at offset %u"),
1096 section_name
, offset
);
1099 source_script_file (pspace_info
, objfile
, language
,
1100 section_name
, offset
, entry
);
1102 case SECTION_SCRIPT_ID_PYTHON_TEXT
:
1103 case SECTION_SCRIPT_ID_SCHEME_TEXT
:
1104 execute_script_contents (pspace_info
, objfile
, language
,
1105 section_name
, offset
, entry
);
1111 /* Load scripts specified in section SECTION_NAME of OBJFILE. */
1114 auto_load_section_scripts (struct objfile
*objfile
, const char *section_name
)
1116 bfd
*abfd
= objfile
->obfd
.get ();
1117 asection
*scripts_sect
;
1118 bfd_byte
*data
= NULL
;
1120 scripts_sect
= bfd_get_section_by_name (abfd
, section_name
);
1121 if (scripts_sect
== NULL
1122 || (bfd_section_flags (scripts_sect
) & SEC_HAS_CONTENTS
) == 0)
1125 if (!bfd_get_full_section_contents (abfd
, scripts_sect
, &data
))
1126 warning (_("Couldn't read %s section of %ps"),
1128 styled_string (file_name_style
.style (),
1129 bfd_get_filename (abfd
)));
1132 gdb::unique_xmalloc_ptr
<bfd_byte
> data_holder (data
);
1134 char *p
= (char *) data
;
1135 source_section_scripts (objfile
, section_name
, p
,
1136 p
+ bfd_section_size (scripts_sect
));
1140 /* Load any auto-loaded scripts for OBJFILE.
1142 Two flavors of auto-loaded scripts are supported.
1143 1) based on the path to the objfile
1144 2) from .debug_gdb_scripts section */
1147 load_auto_scripts_for_objfile (struct objfile
*objfile
)
1149 /* Return immediately if auto-loading has been globally disabled.
1150 This is to handle sequencing of operations during gdb startup.
1151 Also return immediately if OBJFILE was not created from a file
1152 on the local filesystem. */
1153 if (!global_auto_load
1154 || (objfile
->flags
& OBJF_NOT_FILENAME
) != 0
1155 || is_target_filename (objfile
->original_name
))
1158 /* Load any extension language scripts for this objfile.
1159 E.g., foo-gdb.gdb, foo-gdb.py. */
1160 auto_load_ext_lang_scripts_for_objfile (objfile
);
1162 /* Load any scripts mentioned in AUTO_SECTION_NAME (.debug_gdb_scripts). */
1163 auto_load_section_scripts (objfile
, AUTO_SECTION_NAME
);
1166 /* Collect scripts to be printed in a vec. */
1168 struct collect_matching_scripts_data
1170 collect_matching_scripts_data (std::vector
<loaded_script
*> *scripts_p_
,
1171 const extension_language_defn
*language_
)
1172 : scripts_p (scripts_p_
), language (language_
)
1175 std::vector
<loaded_script
*> *scripts_p
;
1176 const struct extension_language_defn
*language
;
1179 /* Traversal function for htab_traverse.
1180 Collect the entry if it matches the regexp. */
1183 collect_matching_scripts (void **slot
, void *info
)
1185 struct loaded_script
*script
= (struct loaded_script
*) *slot
;
1186 struct collect_matching_scripts_data
*data
1187 = (struct collect_matching_scripts_data
*) info
;
1189 if (script
->language
== data
->language
&& re_exec (script
->name
))
1190 data
->scripts_p
->push_back (script
);
1198 print_script (struct loaded_script
*script
)
1200 struct ui_out
*uiout
= current_uiout
;
1202 ui_out_emit_tuple
tuple_emitter (uiout
, NULL
);
1204 uiout
->field_string ("loaded", script
->loaded
? "Yes" : "No");
1205 uiout
->field_string ("script", script
->name
);
1208 /* If the name isn't the full path, print it too. */
1209 if (script
->full_path
!= NULL
1210 && strcmp (script
->name
, script
->full_path
) != 0)
1212 uiout
->text ("\tfull name: ");
1213 uiout
->field_string ("full_path", script
->full_path
);
1218 /* Helper for info_auto_load_scripts to sort the scripts by name. */
1221 sort_scripts_by_name (loaded_script
*a
, loaded_script
*b
)
1223 return FILENAME_CMP (a
->name
, b
->name
) < 0;
1226 /* Special internal GDB value of auto_load_info_scripts's PATTERN identify
1227 the "info auto-load XXX" command has been executed through the general
1228 "info auto-load" invocation. Extra newline will be printed if needed. */
1229 char auto_load_info_scripts_pattern_nl
[] = "";
1231 /* Subroutine of auto_load_info_scripts to simplify it.
1235 print_scripts (const std::vector
<loaded_script
*> &scripts
)
1237 for (loaded_script
*script
: scripts
)
1238 print_script (script
);
1241 /* Implementation for "info auto-load gdb-scripts"
1242 (and "info auto-load python-scripts"). List scripts in LANGUAGE matching
1243 PATTERN. FROM_TTY is the usual GDB boolean for user interactivity. */
1246 auto_load_info_scripts (program_space
*pspace
, const char *pattern
,
1247 int from_tty
, const extension_language_defn
*language
)
1249 struct ui_out
*uiout
= current_uiout
;
1253 auto_load_pspace_info
*pspace_info
= get_auto_load_pspace_data (pspace
);
1255 if (pattern
&& *pattern
)
1257 char *re_err
= re_comp (pattern
);
1260 error (_("Invalid regexp: %s"), re_err
);
1267 /* We need to know the number of rows before we build the table.
1268 Plus we want to sort the scripts by name.
1269 So first traverse the hash table collecting the matching scripts. */
1271 std::vector
<loaded_script
*> script_files
, script_texts
;
1273 if (pspace_info
!= NULL
&& pspace_info
->loaded_script_files
!= NULL
)
1275 collect_matching_scripts_data
data (&script_files
, language
);
1277 /* Pass a pointer to scripts as VEC_safe_push can realloc space. */
1278 htab_traverse_noresize (pspace_info
->loaded_script_files
.get (),
1279 collect_matching_scripts
, &data
);
1281 std::sort (script_files
.begin (), script_files
.end (),
1282 sort_scripts_by_name
);
1285 if (pspace_info
!= NULL
&& pspace_info
->loaded_script_texts
!= NULL
)
1287 collect_matching_scripts_data
data (&script_texts
, language
);
1289 /* Pass a pointer to scripts as VEC_safe_push can realloc space. */
1290 htab_traverse_noresize (pspace_info
->loaded_script_texts
.get (),
1291 collect_matching_scripts
, &data
);
1293 std::sort (script_texts
.begin (), script_texts
.end (),
1294 sort_scripts_by_name
);
1297 int nr_scripts
= script_files
.size () + script_texts
.size ();
1299 /* Table header shifted right by preceding "gdb-scripts: " would not match
1301 if (nr_scripts
> 0 && pattern
== auto_load_info_scripts_pattern_nl
)
1305 ui_out_emit_table
table_emitter (uiout
, 2, nr_scripts
,
1306 "AutoLoadedScriptsTable");
1308 uiout
->table_header (7, ui_left
, "loaded", "Loaded");
1309 uiout
->table_header (70, ui_left
, "script", "Script");
1310 uiout
->table_body ();
1312 print_scripts (script_files
);
1313 print_scripts (script_texts
);
1316 if (nr_scripts
== 0)
1318 if (pattern
&& *pattern
)
1319 uiout
->message ("No auto-load scripts matching %s.\n", pattern
);
1321 uiout
->message ("No auto-load scripts.\n");
1325 /* Wrapper for "info auto-load gdb-scripts". */
1328 info_auto_load_gdb_scripts (const char *pattern
, int from_tty
)
1330 auto_load_info_scripts (current_program_space
, pattern
, from_tty
,
1331 &extension_language_gdb
);
1334 /* Implement 'info auto-load local-gdbinit'. */
1337 info_auto_load_local_gdbinit (const char *args
, int from_tty
)
1339 if (auto_load_local_gdbinit_pathname
== NULL
)
1340 gdb_printf (_("Local .gdbinit file was not found.\n"));
1341 else if (auto_load_local_gdbinit_loaded
)
1342 gdb_printf (_("Local .gdbinit file \"%ps\" has been loaded.\n"),
1343 styled_string (file_name_style
.style (),
1344 auto_load_local_gdbinit_pathname
));
1346 gdb_printf (_("Local .gdbinit file \"%ps\" has not been loaded.\n"),
1347 styled_string (file_name_style
.style (),
1348 auto_load_local_gdbinit_pathname
));
1351 /* Print an "unsupported script" warning if it has not already been printed.
1352 The script is in language LANGUAGE at offset OFFSET in section SECTION_NAME
1356 maybe_print_unsupported_script_warning
1357 (struct auto_load_pspace_info
*pspace_info
,
1358 struct objfile
*objfile
, const struct extension_language_defn
*language
,
1359 const char *section_name
, unsigned offset
)
1361 if (!pspace_info
->unsupported_script_warning_printed
)
1364 Unsupported auto-load script at offset %u in section %s\n\
1366 Use `info auto-load %s-scripts [REGEXP]' to list them."),
1367 offset
, section_name
,
1368 styled_string (file_name_style
.style (),
1369 objfile_name (objfile
)),
1370 ext_lang_name (language
));
1371 pspace_info
->unsupported_script_warning_printed
= true;
1375 /* Return non-zero if SCRIPT_NOT_FOUND_WARNING_PRINTED of PSPACE_INFO was unset
1376 before calling this function. Always set SCRIPT_NOT_FOUND_WARNING_PRINTED
1380 maybe_print_script_not_found_warning
1381 (struct auto_load_pspace_info
*pspace_info
,
1382 struct objfile
*objfile
, const struct extension_language_defn
*language
,
1383 const char *section_name
, unsigned offset
)
1385 if (!pspace_info
->script_not_found_warning_printed
)
1388 Missing auto-load script at offset %u in section %s\n\
1390 Use `info auto-load %s-scripts [REGEXP]' to list them."),
1391 offset
, section_name
,
1392 styled_string (file_name_style
.style (),
1393 objfile_name (objfile
)),
1394 ext_lang_name (language
));
1395 pspace_info
->script_not_found_warning_printed
= true;
1399 /* The only valid "set auto-load" argument is off|0|no|disable. */
1402 set_auto_load_cmd (const char *args
, int from_tty
)
1404 struct cmd_list_element
*list
;
1407 /* See parse_binary_operation in use by the sub-commands. */
1409 length
= args
? strlen (args
) : 0;
1411 while (length
> 0 && (args
[length
- 1] == ' ' || args
[length
- 1] == '\t'))
1414 if (length
== 0 || (strncmp (args
, "off", length
) != 0
1415 && strncmp (args
, "0", length
) != 0
1416 && strncmp (args
, "no", length
) != 0
1417 && strncmp (args
, "disable", length
) != 0))
1418 error (_("Valid is only global 'set auto-load no'; "
1419 "otherwise check the auto-load sub-commands."));
1421 for (list
= *auto_load_set_cmdlist_get (); list
!= NULL
; list
= list
->next
)
1422 if (list
->var
->type () == var_boolean
)
1424 gdb_assert (list
->type
== set_cmd
);
1425 do_set_command (args
, from_tty
, list
);
1429 /* Initialize "set auto-load " commands prefix and return it. */
1431 struct cmd_list_element
**
1432 auto_load_set_cmdlist_get (void)
1434 static struct cmd_list_element
*retval
;
1437 add_prefix_cmd ("auto-load", class_maintenance
, set_auto_load_cmd
, _("\
1438 Auto-loading specific settings.\n\
1439 Configure various auto-load-specific variables such as\n\
1440 automatic loading of Python scripts."),
1441 &retval
, 1/*allow-unknown*/, &setlist
);
1446 /* Initialize "show auto-load " commands prefix and return it. */
1448 struct cmd_list_element
**
1449 auto_load_show_cmdlist_get (void)
1451 static struct cmd_list_element
*retval
;
1454 add_show_prefix_cmd ("auto-load", class_maintenance
, _("\
1455 Show auto-loading specific settings.\n\
1456 Show configuration of various auto-load-specific variables such as\n\
1457 automatic loading of Python scripts."),
1458 &retval
, 0/*allow-unknown*/, &showlist
);
1463 /* Command "info auto-load" displays whether the various auto-load files have
1464 been loaded. This is reimplementation of cmd_show_list which inserts
1465 newlines at proper places. */
1468 info_auto_load_cmd (const char *args
, int from_tty
)
1470 struct cmd_list_element
*list
;
1471 struct ui_out
*uiout
= current_uiout
;
1473 ui_out_emit_tuple
tuple_emitter (uiout
, "infolist");
1475 for (list
= *auto_load_info_cmdlist_get (); list
!= NULL
; list
= list
->next
)
1477 ui_out_emit_tuple
option_emitter (uiout
, "option");
1479 gdb_assert (!list
->is_prefix ());
1480 gdb_assert (list
->type
== not_set_cmd
);
1482 uiout
->field_string ("name", list
->name
);
1484 cmd_func (list
, auto_load_info_scripts_pattern_nl
, from_tty
);
1488 /* Initialize "info auto-load " commands prefix and return it. */
1490 struct cmd_list_element
**
1491 auto_load_info_cmdlist_get (void)
1493 static struct cmd_list_element
*retval
;
1496 add_prefix_cmd ("auto-load", class_info
, info_auto_load_cmd
, _("\
1497 Print current status of auto-loaded files.\n\
1498 Print whether various files like Python scripts or .gdbinit files have been\n\
1499 found and/or loaded."),
1500 &retval
, 0/*allow-unknown*/, &infolist
);
1505 /* See auto-load.h. */
1507 gdb::observers::token auto_load_new_objfile_observer_token
;
1509 void _initialize_auto_load ();
1511 _initialize_auto_load ()
1513 struct cmd_list_element
*cmd
;
1514 gdb::unique_xmalloc_ptr
<char> scripts_directory_help
, gdb_name_help
,
1515 python_name_help
, guile_name_help
;
1518 gdb::observers::new_objfile
.attach (load_auto_scripts_for_objfile
,
1519 auto_load_new_objfile_observer_token
,
1521 gdb::observers::all_objfiles_removed
.attach (clear_section_scripts
,
1523 add_setshow_boolean_cmd ("gdb-scripts", class_support
,
1524 &auto_load_gdb_scripts
, _("\
1525 Enable or disable auto-loading of canned sequences of commands scripts."), _("\
1526 Show whether auto-loading of canned sequences of commands scripts is enabled."),
1528 If enabled, canned sequences of commands are loaded when the debugger reads\n\
1529 an executable or shared library.\n\
1530 This option has security implications for untrusted inferiors."),
1531 NULL
, show_auto_load_gdb_scripts
,
1532 auto_load_set_cmdlist_get (),
1533 auto_load_show_cmdlist_get ());
1535 add_cmd ("gdb-scripts", class_info
, info_auto_load_gdb_scripts
,
1536 _("Print the list of automatically loaded sequences of commands.\n\
1537 Usage: info auto-load gdb-scripts [REGEXP]"),
1538 auto_load_info_cmdlist_get ());
1540 add_setshow_boolean_cmd ("local-gdbinit", class_support
,
1541 &auto_load_local_gdbinit
, _("\
1542 Enable or disable auto-loading of .gdbinit script in current directory."), _("\
1543 Show whether auto-loading .gdbinit script in current directory is enabled."),
1545 If enabled, canned sequences of commands are loaded when debugger starts\n\
1546 from .gdbinit file in current directory. Such files are deprecated,\n\
1547 use a script associated with inferior executable file instead.\n\
1548 This option has security implications for untrusted inferiors."),
1549 NULL
, show_auto_load_local_gdbinit
,
1550 auto_load_set_cmdlist_get (),
1551 auto_load_show_cmdlist_get ());
1553 add_cmd ("local-gdbinit", class_info
, info_auto_load_local_gdbinit
,
1554 _("Print whether current directory .gdbinit file has been loaded.\n\
1555 Usage: info auto-load local-gdbinit"),
1556 auto_load_info_cmdlist_get ());
1558 suffix
= ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_GDB
));
1561 GDB scripts: OBJFILE%s\n"),
1563 python_name_help
= NULL
;
1565 suffix
= ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_PYTHON
));
1568 Python scripts: OBJFILE%s\n"),
1571 guile_name_help
= NULL
;
1573 suffix
= ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_GUILE
));
1576 Guile scripts: OBJFILE%s\n"),
1579 scripts_directory_help
1581 Automatically loaded scripts are located in one of the directories listed\n\
1587 This option is ignored for the kinds of scripts \
1588 having 'set auto-load ... off'.\n\
1589 Directories listed here need to be present also \
1590 in the 'set auto-load safe-path'\n\
1592 gdb_name_help
.get (),
1593 python_name_help
.get () ? python_name_help
.get () : "",
1594 guile_name_help
.get () ? guile_name_help
.get () : "");
1596 add_setshow_optional_filename_cmd ("scripts-directory", class_support
,
1597 &auto_load_dir
, _("\
1598 Set the list of directories from which to load auto-loaded scripts."), _("\
1599 Show the list of directories from which to load auto-loaded scripts."),
1600 scripts_directory_help
.get (),
1601 set_auto_load_dir
, show_auto_load_dir
,
1602 auto_load_set_cmdlist_get (),
1603 auto_load_show_cmdlist_get ());
1604 auto_load_safe_path_vec_update ();
1605 add_setshow_optional_filename_cmd ("safe-path", class_support
,
1606 &auto_load_safe_path
, _("\
1607 Set the list of files and directories that are safe for auto-loading."), _("\
1608 Show the list of files and directories that are safe for auto-loading."), _("\
1609 Various files loaded automatically for the 'set auto-load ...' options must\n\
1610 be located in one of the directories listed by this option. Warning will be\n\
1611 printed and file will not be used otherwise.\n\
1612 You can mix both directory and filename entries.\n\
1613 Setting this parameter to an empty list resets it to its default value.\n\
1614 Setting this parameter to '/' (without the quotes) allows any file\n\
1615 for the 'set auto-load ...' options. Each path entry can be also shell\n\
1616 wildcard pattern; '*' does not match directory separator.\n\
1617 This option is ignored for the kinds of files having 'set auto-load ... off'.\n\
1618 This option has security implications for untrusted inferiors."),
1619 set_auto_load_safe_path
,
1620 show_auto_load_safe_path
,
1621 auto_load_set_cmdlist_get (),
1622 auto_load_show_cmdlist_get ());
1623 gdb::observers::gdb_datadir_changed
.attach (auto_load_gdb_datadir_changed
,
1626 cmd
= add_cmd ("add-auto-load-safe-path", class_support
,
1627 add_auto_load_safe_path
,
1628 _("Add entries to the list of directories from which it is safe "
1629 "to auto-load files.\n\
1630 See the commands 'set auto-load safe-path' and 'show auto-load safe-path' to\n\
1631 access the current full list setting."),
1633 set_cmd_completer (cmd
, filename_completer
);
1635 cmd
= add_cmd ("add-auto-load-scripts-directory", class_support
,
1637 _("Add entries to the list of directories from which to load "
1638 "auto-loaded scripts.\n\
1639 See the commands 'set auto-load scripts-directory' and\n\
1640 'show auto-load scripts-directory' to access the current full list setting."),
1642 set_cmd_completer (cmd
, filename_completer
);
1644 add_setshow_boolean_cmd ("auto-load", class_maintenance
,
1645 &debug_auto_load
, _("\
1646 Set auto-load verifications debugging."), _("\
1647 Show auto-load verifications debugging."), _("\
1648 When non-zero, debugging output for files of 'set auto-load ...'\n\
1650 NULL
, show_debug_auto_load
,
1651 &setdebuglist
, &showdebuglist
);