1 /* GDB routines for supporting auto-loaded scripts.
3 Copyright (C) 2012-2019 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/>. */
22 #include "auto-load.h"
23 #include "progspace.h"
24 #include "gdb_regex.h"
26 #include "filenames.h"
28 #include "observable.h"
30 #include "cli/cli-script.h"
32 #include "cli/cli-cmds.h"
33 #include "cli/cli-decode.h"
34 #include "cli/cli-setshow.h"
35 #include "readline/tilde.h"
36 #include "completer.h"
39 #include "common/filestuff.h"
40 #include "extension.h"
41 #include "gdb/section-scripts.h"
43 #include "common/pathstuff.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 static void maybe_print_unsupported_script_warning
54 (struct auto_load_pspace_info *, struct objfile *objfile,
55 const struct extension_language_defn *language,
56 const char *section_name, unsigned offset);
58 static void maybe_print_script_not_found_warning
59 (struct auto_load_pspace_info *, struct objfile *objfile,
60 const struct extension_language_defn *language,
61 const char *section_name, unsigned offset);
63 /* Value of the 'set debug auto-load' configuration variable. */
64 static int debug_auto_load = 0;
66 /* "show" command for the debug_auto_load configuration variable. */
69 show_debug_auto_load (struct ui_file *file, int from_tty,
70 struct cmd_list_element *c, const char *value)
72 fprintf_filtered (file, _("Debugging output for files "
73 "of 'set auto-load ...' is %s.\n"),
77 /* User-settable option to enable/disable auto-loading of GDB_AUTO_FILE_NAME
79 set auto-load gdb-scripts on|off
80 This is true if we should auto-load associated scripts when an objfile
81 is opened, false otherwise. */
82 static int auto_load_gdb_scripts = 1;
84 /* "show" command for the auto_load_gdb_scripts configuration variable. */
87 show_auto_load_gdb_scripts (struct ui_file *file, int from_tty,
88 struct cmd_list_element *c, const char *value)
90 fprintf_filtered (file, _("Auto-loading of canned sequences of commands "
95 /* Return non-zero if auto-loading gdb scripts is enabled. */
98 auto_load_gdb_scripts_enabled (const struct extension_language_defn *extlang)
100 return auto_load_gdb_scripts;
103 /* Internal-use flag to enable/disable auto-loading.
104 This is true if we should auto-load python code when an objfile is opened,
107 Both auto_load_scripts && global_auto_load must be true to enable
110 This flag exists to facilitate deferring auto-loading during start-up
111 until after ./.gdbinit has been read; it may augment the search directories
112 used to find the scripts. */
113 int global_auto_load = 1;
115 /* Auto-load .gdbinit file from the current directory? */
116 int auto_load_local_gdbinit = 1;
118 /* Absolute pathname to the current directory .gdbinit, if it exists. */
119 char *auto_load_local_gdbinit_pathname = NULL;
121 /* Boolean value if AUTO_LOAD_LOCAL_GDBINIT_PATHNAME has been loaded. */
122 int auto_load_local_gdbinit_loaded = 0;
124 /* "show" command for the auto_load_local_gdbinit configuration variable. */
127 show_auto_load_local_gdbinit (struct ui_file *file, int from_tty,
128 struct cmd_list_element *c, const char *value)
130 fprintf_filtered (file, _("Auto-loading of .gdbinit script from current "
131 "directory is %s.\n"),
135 /* Directory list from which to load auto-loaded scripts. It is not checked
136 for absolute paths but they are strongly recommended. It is initialized by
137 _initialize_auto_load. */
138 static char *auto_load_dir;
140 /* "set" command for the auto_load_dir configuration variable. */
143 set_auto_load_dir (const char *args, int from_tty, struct cmd_list_element *c)
145 /* Setting the variable to "" resets it to the compile time defaults. */
146 if (auto_load_dir[0] == '\0')
148 xfree (auto_load_dir);
149 auto_load_dir = xstrdup (AUTO_LOAD_DIR);
153 /* "show" command for the auto_load_dir configuration variable. */
156 show_auto_load_dir (struct ui_file *file, int from_tty,
157 struct cmd_list_element *c, const char *value)
159 fprintf_filtered (file, _("List of directories from which to load "
160 "auto-loaded scripts is %s.\n"),
164 /* Directory list safe to hold auto-loaded files. It is not checked for
165 absolute paths but they are strongly recommended. It is initialized by
166 _initialize_auto_load. */
167 static char *auto_load_safe_path;
169 /* Vector of directory elements of AUTO_LOAD_SAFE_PATH with each one normalized
170 by tilde_expand and possibly each entries has added its gdb_realpath
172 std::vector<gdb::unique_xmalloc_ptr<char>> auto_load_safe_path_vec;
174 /* Expand $datadir and $debugdir in STRING according to the rules of
175 substitute_path_component. */
177 static std::vector<gdb::unique_xmalloc_ptr<char>>
178 auto_load_expand_dir_vars (const char *string)
180 char *s = xstrdup (string);
181 substitute_path_component (&s, "$datadir", gdb_datadir);
182 substitute_path_component (&s, "$debugdir", debug_file_directory);
184 if (debug_auto_load && strcmp (s, string) != 0)
185 fprintf_unfiltered (gdb_stdlog,
186 _("auto-load: Expanded $-variables to \"%s\".\n"), 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)
201 fprintf_unfiltered (gdb_stdlog,
202 _("auto-load: Updating directories of \"%s\".\n"),
203 auto_load_safe_path);
205 auto_load_safe_path_vec = auto_load_expand_dir_vars (auto_load_safe_path);
206 size_t len = auto_load_safe_path_vec.size ();
208 /* Apply tilde_expand and gdb_realpath to each AUTO_LOAD_SAFE_PATH_VEC
210 for (size_t i = 0; i < len; i++)
212 gdb::unique_xmalloc_ptr<char> &in_vec = auto_load_safe_path_vec[i];
213 gdb::unique_xmalloc_ptr<char> expanded (tilde_expand (in_vec.get ()));
214 gdb::unique_xmalloc_ptr<char> real_path = gdb_realpath (expanded.get ());
216 /* Ensure the current entry is at least tilde_expand-ed. ORIGINAL makes
217 sure we free the original string. */
218 gdb::unique_xmalloc_ptr<char> original = std::move (in_vec);
219 in_vec = std::move (expanded);
223 if (strcmp (in_vec.get (), original.get ()) == 0)
224 fprintf_unfiltered (gdb_stdlog,
225 _("auto-load: Using directory \"%s\".\n"),
228 fprintf_unfiltered (gdb_stdlog,
229 _("auto-load: Resolved directory \"%s\" "
231 original.get (), in_vec.get ());
234 /* If gdb_realpath returns a different content, append it. */
235 if (strcmp (real_path.get (), in_vec.get ()) != 0)
238 fprintf_unfiltered (gdb_stdlog,
239 _("auto-load: And canonicalized as \"%s\".\n"),
242 auto_load_safe_path_vec.push_back (std::move (real_path));
247 /* Variable gdb_datadir has been set. Update content depending on $datadir. */
250 auto_load_gdb_datadir_changed (void)
252 auto_load_safe_path_vec_update ();
255 /* "set" command for the auto_load_safe_path configuration variable. */
258 set_auto_load_safe_path (const char *args,
259 int from_tty, struct cmd_list_element *c)
261 /* Setting the variable to "" resets it to the compile time defaults. */
262 if (auto_load_safe_path[0] == '\0')
264 xfree (auto_load_safe_path);
265 auto_load_safe_path = xstrdup (AUTO_LOAD_SAFE_PATH);
268 auto_load_safe_path_vec_update ();
271 /* "show" command for the auto_load_safe_path configuration variable. */
274 show_auto_load_safe_path (struct ui_file *file, int from_tty,
275 struct cmd_list_element *c, const char *value)
279 /* Check if user has entered either "/" or for example ":".
280 But while more complicate content like ":/foo" would still also
281 permit any location do not hide those. */
283 for (cs = value; *cs && (*cs == DIRNAME_SEPARATOR || IS_DIR_SEPARATOR (*cs));
286 fprintf_filtered (file, _("Auto-load files are safe to load from any "
289 fprintf_filtered (file, _("List of directories from which it is safe to "
290 "auto-load files is %s.\n"),
294 /* "add-auto-load-safe-path" command for the auto_load_safe_path configuration
298 add_auto_load_safe_path (const char *args, int from_tty)
302 if (args == NULL || *args == 0)
304 Directory argument required.\n\
305 Use 'set auto-load safe-path /' for disabling the auto-load safe-path security.\
308 s = xstrprintf ("%s%c%s", auto_load_safe_path, DIRNAME_SEPARATOR, args);
309 xfree (auto_load_safe_path);
310 auto_load_safe_path = s;
312 auto_load_safe_path_vec_update ();
315 /* "add-auto-load-scripts-directory" command for the auto_load_dir configuration
319 add_auto_load_dir (const char *args, int from_tty)
323 if (args == NULL || *args == 0)
324 error (_("Directory argument required."));
326 s = xstrprintf ("%s%c%s", auto_load_dir, DIRNAME_SEPARATOR, args);
327 xfree (auto_load_dir);
331 /* Implementation for filename_is_in_pattern overwriting the caller's FILENAME
335 filename_is_in_pattern_1 (char *filename, char *pattern)
337 size_t pattern_len = strlen (pattern);
338 size_t filename_len = strlen (filename);
341 fprintf_unfiltered (gdb_stdlog, _("auto-load: Matching file \"%s\" "
342 "to pattern \"%s\"\n"),
345 /* Trim trailing slashes ("/") from PATTERN. Even for "d:\" paths as
346 trailing slashes are trimmed also from FILENAME it still matches
348 while (pattern_len && IS_DIR_SEPARATOR (pattern[pattern_len - 1]))
350 pattern[pattern_len] = '\0';
352 /* Ensure auto_load_safe_path "/" matches any FILENAME. On MS-Windows
353 platform FILENAME even after gdb_realpath does not have to start with
354 IS_DIR_SEPARATOR character, such as the 'C:\x.exe' filename. */
355 if (pattern_len == 0)
358 fprintf_unfiltered (gdb_stdlog,
359 _("auto-load: Matched - empty pattern\n"));
365 /* Trim trailing slashes ("/"). PATTERN also has slashes trimmed the
366 same way so they will match. */
367 while (filename_len && IS_DIR_SEPARATOR (filename[filename_len - 1]))
369 filename[filename_len] = '\0';
370 if (filename_len == 0)
373 fprintf_unfiltered (gdb_stdlog,
374 _("auto-load: Not matched - pattern \"%s\".\n"),
379 if (gdb_filename_fnmatch (pattern, filename, FNM_FILE_NAME | FNM_NOESCAPE)
383 fprintf_unfiltered (gdb_stdlog, _("auto-load: Matched - file "
384 "\"%s\" to pattern \"%s\".\n"),
389 /* Trim trailing FILENAME component. */
390 while (filename_len > 0 && !IS_DIR_SEPARATOR (filename[filename_len - 1]))
395 /* Return 1 if FILENAME matches PATTERN or if FILENAME resides in
396 a subdirectory of a directory that matches PATTERN. Return 0 otherwise.
397 gdb_realpath normalization is never done here. */
399 static ATTRIBUTE_PURE int
400 filename_is_in_pattern (const char *filename, const char *pattern)
402 char *filename_copy, *pattern_copy;
404 filename_copy = (char *) alloca (strlen (filename) + 1);
405 strcpy (filename_copy, filename);
406 pattern_copy = (char *) alloca (strlen (pattern) + 1);
407 strcpy (pattern_copy, pattern);
409 return filename_is_in_pattern_1 (filename_copy, pattern_copy);
412 /* Return 1 if FILENAME belongs to one of directory components of
413 AUTO_LOAD_SAFE_PATH_VEC. Return 0 otherwise.
414 auto_load_safe_path_vec_update is never called.
415 *FILENAME_REALP may be updated by gdb_realpath of FILENAME. */
418 filename_is_in_auto_load_safe_path_vec (const char *filename,
419 gdb::unique_xmalloc_ptr<char> *filename_realp)
421 const char *pattern = NULL;
423 for (const gdb::unique_xmalloc_ptr<char> &p : auto_load_safe_path_vec)
424 if (*filename_realp == NULL && filename_is_in_pattern (filename, p.get ()))
432 if (*filename_realp == NULL)
434 *filename_realp = gdb_realpath (filename);
435 if (debug_auto_load && strcmp (filename_realp->get (), filename) != 0)
436 fprintf_unfiltered (gdb_stdlog,
437 _("auto-load: Resolved "
438 "file \"%s\" as \"%s\".\n"),
439 filename, filename_realp->get ());
442 if (strcmp (filename_realp->get (), filename) != 0)
443 for (const gdb::unique_xmalloc_ptr<char> &p : auto_load_safe_path_vec)
444 if (filename_is_in_pattern (filename_realp->get (), p.get ()))
454 fprintf_unfiltered (gdb_stdlog, _("auto-load: File \"%s\" matches "
455 "directory \"%s\".\n"),
463 /* Return 1 if FILENAME is located in one of the directories of
464 AUTO_LOAD_SAFE_PATH. Otherwise call warning and return 0. FILENAME does
465 not have to be an absolute path.
467 Existence of FILENAME is not checked. Function will still give a warning
468 even if the caller would quietly skip non-existing file in unsafe
472 file_is_auto_load_safe (const char *filename, const char *debug_fmt, ...)
474 gdb::unique_xmalloc_ptr<char> filename_real;
475 static int advice_printed = 0;
481 va_start (debug_args, debug_fmt);
482 vfprintf_unfiltered (gdb_stdlog, debug_fmt, debug_args);
486 if (filename_is_in_auto_load_safe_path_vec (filename, &filename_real))
489 auto_load_safe_path_vec_update ();
490 if (filename_is_in_auto_load_safe_path_vec (filename, &filename_real))
493 warning (_("File \"%s\" auto-loading has been declined by your "
494 "`auto-load safe-path' set to \"%s\"."),
495 filename_real.get (), auto_load_safe_path);
499 const char *homedir = getenv ("HOME");
503 std::string homeinit = string_printf ("%s/%s", homedir, gdbinit);
505 printf_filtered (_("\
506 To enable execution of this file add\n\
507 \tadd-auto-load-safe-path %s\n\
508 line to your configuration file \"%s\".\n\
509 To completely disable this security protection add\n\
510 \tset auto-load safe-path /\n\
511 line to your configuration file \"%s\".\n\
512 For more information about this security protection see the\n\
513 \"Auto-loading safe path\" section in the GDB manual. E.g., run from the shell:\n\
514 \tinfo \"(gdb)Auto-loading safe path\"\n"),
515 filename_real.get (),
516 homeinit.c_str (), homeinit.c_str ());
523 /* For scripts specified in .debug_gdb_scripts, multiple objfiles may load
524 the same script. There's no point in loading the script multiple times,
525 and there can be a lot of objfiles and scripts, so we keep track of scripts
528 struct auto_load_pspace_info
530 /* For each program space we keep track of loaded scripts, both when
531 specified as file names and as scripts to be executed directly. */
532 struct htab *loaded_script_files;
533 struct htab *loaded_script_texts;
535 /* Non-zero if we've issued the warning about an auto-load script not being
536 supported. We only want to issue this warning once. */
537 int unsupported_script_warning_printed;
539 /* Non-zero if we've issued the warning about an auto-load script not being
540 found. We only want to issue this warning once. */
541 int script_not_found_warning_printed;
544 /* Objects of this type are stored in the loaded_script hash table. */
548 /* Name as provided by the objfile. */
551 /* Full path name or NULL if script wasn't found (or was otherwise
552 inaccessible), or NULL for loaded_script_texts. */
553 const char *full_path;
555 /* Non-zero if this script has been loaded. */
558 const struct extension_language_defn *language;
561 /* Per-program-space data key. */
562 static const struct program_space_data *auto_load_pspace_data;
565 auto_load_pspace_data_cleanup (struct program_space *pspace, void *arg)
567 struct auto_load_pspace_info *info = (struct auto_load_pspace_info *) arg;
569 if (info->loaded_script_files)
570 htab_delete (info->loaded_script_files);
571 if (info->loaded_script_texts)
572 htab_delete (info->loaded_script_texts);
576 /* Get the current autoload data. If none is found yet, add it now. This
577 function always returns a valid object. */
579 static struct auto_load_pspace_info *
580 get_auto_load_pspace_data (struct program_space *pspace)
582 struct auto_load_pspace_info *info;
584 info = ((struct auto_load_pspace_info *)
585 program_space_data (pspace, auto_load_pspace_data));
588 info = XCNEW (struct auto_load_pspace_info);
589 set_program_space_data (pspace, auto_load_pspace_data, info);
595 /* Hash function for the loaded script hash. */
598 hash_loaded_script_entry (const void *data)
600 const struct loaded_script *e = (const struct loaded_script *) data;
602 return htab_hash_string (e->name) ^ htab_hash_pointer (e->language);
605 /* Equality function for the loaded script hash. */
608 eq_loaded_script_entry (const void *a, const void *b)
610 const struct loaded_script *ea = (const struct loaded_script *) a;
611 const struct loaded_script *eb = (const struct loaded_script *) b;
613 return strcmp (ea->name, eb->name) == 0 && ea->language == eb->language;
616 /* Initialize the table to track loaded scripts.
617 Each entry is hashed by the full path name. */
620 init_loaded_scripts_info (struct auto_load_pspace_info *pspace_info)
622 /* Choose 31 as the starting size of the hash table, somewhat arbitrarily.
623 Space for each entry is obtained with one malloc so we can free them
626 pspace_info->loaded_script_files = htab_create (31,
627 hash_loaded_script_entry,
628 eq_loaded_script_entry,
630 pspace_info->loaded_script_texts = htab_create (31,
631 hash_loaded_script_entry,
632 eq_loaded_script_entry,
635 pspace_info->unsupported_script_warning_printed = FALSE;
636 pspace_info->script_not_found_warning_printed = FALSE;
639 /* Wrapper on get_auto_load_pspace_data to also allocate the hash table
640 for loading scripts. */
642 struct auto_load_pspace_info *
643 get_auto_load_pspace_data_for_loading (struct program_space *pspace)
645 struct auto_load_pspace_info *info;
647 info = get_auto_load_pspace_data (pspace);
648 if (info->loaded_script_files == NULL)
649 init_loaded_scripts_info (info);
654 /* Add script file NAME in LANGUAGE to hash table of PSPACE_INFO.
655 LOADED 1 if the script has been (is going to) be loaded, 0 otherwise
656 (such as if it has not been found).
657 FULL_PATH is NULL if the script wasn't found.
658 The result is true if the script was already in the hash table. */
661 maybe_add_script_file (struct auto_load_pspace_info *pspace_info, int loaded,
662 const char *name, const char *full_path,
663 const struct extension_language_defn *language)
665 struct htab *htab = pspace_info->loaded_script_files;
666 struct loaded_script **slot, entry;
670 entry.language = language;
671 slot = (struct loaded_script **) htab_find_slot (htab, &entry, INSERT);
672 in_hash_table = *slot != NULL;
674 /* If this script is not in the hash table, add it. */
680 /* Allocate all space in one chunk so it's easier to free. */
681 *slot = ((struct loaded_script *)
682 xmalloc (sizeof (**slot)
684 + (full_path != NULL ? (strlen (full_path) + 1) : 0)));
685 p = ((char*) *slot) + sizeof (**slot);
688 if (full_path != NULL)
691 strcpy (p, full_path);
692 (*slot)->full_path = p;
695 (*slot)->full_path = NULL;
696 (*slot)->loaded = loaded;
697 (*slot)->language = language;
700 return in_hash_table;
703 /* Add script contents NAME in LANGUAGE to hash table of PSPACE_INFO.
704 LOADED 1 if the script has been (is going to) be loaded, 0 otherwise
705 (such as if it has not been found).
706 The result is true if the script was already in the hash table. */
709 maybe_add_script_text (struct auto_load_pspace_info *pspace_info,
710 int loaded, const char *name,
711 const struct extension_language_defn *language)
713 struct htab *htab = pspace_info->loaded_script_texts;
714 struct loaded_script **slot, entry;
718 entry.language = language;
719 slot = (struct loaded_script **) htab_find_slot (htab, &entry, INSERT);
720 in_hash_table = *slot != NULL;
722 /* If this script is not in the hash table, add it. */
728 /* Allocate all space in one chunk so it's easier to free. */
729 *slot = ((struct loaded_script *)
730 xmalloc (sizeof (**slot) + strlen (name) + 1));
731 p = ((char*) *slot) + sizeof (**slot);
734 (*slot)->full_path = NULL;
735 (*slot)->loaded = loaded;
736 (*slot)->language = language;
739 return in_hash_table;
742 /* Clear the table of loaded section scripts. */
745 clear_section_scripts (void)
747 struct program_space *pspace = current_program_space;
748 struct auto_load_pspace_info *info;
750 info = ((struct auto_load_pspace_info *)
751 program_space_data (pspace, auto_load_pspace_data));
752 if (info != NULL && info->loaded_script_files != NULL)
754 htab_delete (info->loaded_script_files);
755 htab_delete (info->loaded_script_texts);
756 info->loaded_script_files = NULL;
757 info->loaded_script_texts = NULL;
758 info->unsupported_script_warning_printed = FALSE;
759 info->script_not_found_warning_printed = FALSE;
763 /* Look for the auto-load script in LANGUAGE associated with OBJFILE where
764 OBJFILE's gdb_realpath is REALNAME and load it. Return 1 if we found any
765 matching script, return 0 otherwise. */
768 auto_load_objfile_script_1 (struct objfile *objfile, const char *realname,
769 const struct extension_language_defn *language)
771 const char *debugfile;
773 const char *suffix = ext_lang_auto_load_suffix (language);
775 std::string filename = std::string (realname) + suffix;
777 gdb_file_up input = gdb_fopen_cloexec (filename.c_str (), "r");
778 debugfile = filename.c_str ();
780 fprintf_unfiltered (gdb_stdlog, _("auto-load: Attempted file \"%s\" %s.\n"),
781 debugfile, input ? _("exists") : _("does not exist"));
783 std::string debugfile_holder;
786 /* Also try the same file in a subdirectory of gdb's data
789 std::vector<gdb::unique_xmalloc_ptr<char>> vec
790 = auto_load_expand_dir_vars (auto_load_dir);
793 fprintf_unfiltered (gdb_stdlog, _("auto-load: Searching 'set auto-load "
794 "scripts-directory' path \"%s\".\n"),
797 for (const gdb::unique_xmalloc_ptr<char> &dir : vec)
799 /* FILENAME is absolute, so we don't need a "/" here. */
800 debugfile_holder = dir.get () + filename;
801 debugfile = debugfile_holder.c_str ();
803 input = gdb_fopen_cloexec (debugfile, "r");
805 fprintf_unfiltered (gdb_stdlog, _("auto-load: Attempted file "
808 input ? _("exists") : _("does not exist"));
817 struct auto_load_pspace_info *pspace_info;
820 = file_is_auto_load_safe (debugfile,
821 _("auto-load: Loading %s script \"%s\""
822 " by extension for objfile \"%s\".\n"),
823 ext_lang_name (language),
824 debugfile, objfile_name (objfile));
826 /* Add this script to the hash table too so
827 "info auto-load ${lang}-scripts" can print it. */
829 = get_auto_load_pspace_data_for_loading (current_program_space);
830 maybe_add_script_file (pspace_info, is_safe, debugfile, debugfile,
833 /* To preserve existing behaviour we don't check for whether the
834 script was already in the table, and always load it.
835 It's highly unlikely that we'd ever load it twice,
836 and these scripts are required to be idempotent under multiple
840 objfile_script_sourcer_func *sourcer
841 = ext_lang_objfile_script_sourcer (language);
843 /* We shouldn't get here if support for the language isn't
844 compiled in. And the extension language is required to implement
846 gdb_assert (sourcer != NULL);
847 sourcer (language, objfile, input.get (), debugfile);
858 /* Look for the auto-load script in LANGUAGE associated with OBJFILE and load
862 auto_load_objfile_script (struct objfile *objfile,
863 const struct extension_language_defn *language)
865 gdb::unique_xmalloc_ptr<char> realname
866 = gdb_realpath (objfile_name (objfile));
868 if (!auto_load_objfile_script_1 (objfile, realname.get (), language))
870 /* For Windows/DOS .exe executables, strip the .exe suffix, so that
871 FOO-gdb.gdb could be used for FOO.exe, and try again. */
873 size_t len = strlen (realname.get ());
874 const size_t lexe = sizeof (".exe") - 1;
876 if (len > lexe && strcasecmp (realname.get () + len - lexe, ".exe") == 0)
879 realname.get ()[len] = '\0';
881 fprintf_unfiltered (gdb_stdlog, _("auto-load: Stripped .exe suffix, "
882 "retrying with \"%s\".\n"),
884 auto_load_objfile_script_1 (objfile, realname.get (), language);
889 /* Subroutine of source_section_scripts to simplify it.
890 Load FILE as a script in extension language LANGUAGE.
891 The script is from section SECTION_NAME in OBJFILE at offset OFFSET. */
894 source_script_file (struct auto_load_pspace_info *pspace_info,
895 struct objfile *objfile,
896 const struct extension_language_defn *language,
897 const char *section_name, unsigned int offset,
901 objfile_script_sourcer_func *sourcer;
903 /* Skip this script if support is not compiled in. */
904 sourcer = ext_lang_objfile_script_sourcer (language);
907 /* We don't throw an error, the program is still debuggable. */
908 maybe_print_unsupported_script_warning (pspace_info, objfile, language,
909 section_name, offset);
910 /* We *could* still try to open it, but there's no point. */
911 maybe_add_script_file (pspace_info, 0, file, NULL, language);
915 /* Skip this script if auto-loading it has been disabled. */
916 if (!ext_lang_auto_load_enabled (language))
918 /* No message is printed, just skip it. */
922 gdb::optional<open_script> opened = find_and_open_script (file,
927 if (!file_is_auto_load_safe (opened->full_path.get (),
928 _("auto-load: Loading %s script "
929 "\"%s\" from section \"%s\" of "
930 "objfile \"%s\".\n"),
931 ext_lang_name (language),
932 opened->full_path.get (),
933 section_name, objfile_name (objfile)))
938 /* If one script isn't found it's not uncommon for more to not be
939 found either. We don't want to print a message for each script,
940 too much noise. Instead, we print the warning once and tell the
941 user how to find the list of scripts that weren't loaded.
942 We don't throw an error, the program is still debuggable.
944 IWBN if complaints.c were more general-purpose. */
946 maybe_print_script_not_found_warning (pspace_info, objfile, language,
947 section_name, offset);
950 in_hash_table = maybe_add_script_file (pspace_info, bool (opened), file,
952 ? opened->full_path.get ()
956 /* If this file is not currently loaded, load it. */
957 if (opened && !in_hash_table)
958 sourcer (language, objfile, opened->stream.get (),
959 opened->full_path.get ());
962 /* Subroutine of source_section_scripts to simplify it.
963 Execute SCRIPT as a script in extension language LANG.
964 The script is from section SECTION_NAME in OBJFILE at offset OFFSET. */
967 execute_script_contents (struct auto_load_pspace_info *pspace_info,
968 struct objfile *objfile,
969 const struct extension_language_defn *language,
970 const char *section_name, unsigned int offset,
973 objfile_script_executor_func *executor;
974 const char *newline, *script_text;
976 int is_safe, in_hash_table;
978 /* The first line of the script is the name of the script.
979 It must not contain any kind of space character. */
981 newline = strchr (script, '\n');
982 std::string name_holder;
987 /* Put the name in a buffer and validate it. */
988 name_holder = std::string (script, newline - script);
989 buf = name_holder.c_str ();
990 for (p = buf; *p != '\0'; ++p)
995 /* We don't allow nameless scripts, they're not helpful to the user. */
996 if (p != buf && *p == '\0')
1001 /* We don't throw an error, the program is still debuggable. */
1003 Missing/bad script name in entry at offset %u in section %s\n\
1005 offset, section_name, objfile_name (objfile));
1008 script_text = newline + 1;
1010 /* Skip this script if support is not compiled in. */
1011 executor = ext_lang_objfile_script_executor (language);
1012 if (executor == NULL)
1014 /* We don't throw an error, the program is still debuggable. */
1015 maybe_print_unsupported_script_warning (pspace_info, objfile, language,
1016 section_name, offset);
1017 maybe_add_script_text (pspace_info, 0, name, language);
1021 /* Skip this script if auto-loading it has been disabled. */
1022 if (!ext_lang_auto_load_enabled (language))
1024 /* No message is printed, just skip it. */
1028 is_safe = file_is_auto_load_safe (objfile_name (objfile),
1029 _("auto-load: Loading %s script "
1030 "\"%s\" from section \"%s\" of "
1031 "objfile \"%s\".\n"),
1032 ext_lang_name (language), name,
1033 section_name, objfile_name (objfile));
1035 in_hash_table = maybe_add_script_text (pspace_info, is_safe, name, language);
1037 /* If this file is not currently loaded, load it. */
1038 if (is_safe && !in_hash_table)
1039 executor (language, objfile, name, script_text);
1042 /* Load scripts specified in OBJFILE.
1043 START,END delimit a buffer containing a list of nul-terminated
1045 SECTION_NAME is used in error messages.
1047 Scripts specified as file names are found per normal "source -s" command
1048 processing. First the script is looked for in $cwd. If not found there
1049 the source search path is used.
1051 The section contains a list of path names of script files to load or
1052 actual script contents. Each entry is nul-terminated. */
1055 source_section_scripts (struct objfile *objfile, const char *section_name,
1056 const char *start, const char *end)
1059 struct auto_load_pspace_info *pspace_info;
1061 pspace_info = get_auto_load_pspace_data_for_loading (current_program_space);
1063 for (p = start; p < end; ++p)
1066 const struct extension_language_defn *language;
1067 unsigned int offset = p - start;
1072 case SECTION_SCRIPT_ID_PYTHON_FILE:
1073 case SECTION_SCRIPT_ID_PYTHON_TEXT:
1074 language = get_ext_lang_defn (EXT_LANG_PYTHON);
1076 case SECTION_SCRIPT_ID_SCHEME_FILE:
1077 case SECTION_SCRIPT_ID_SCHEME_TEXT:
1078 language = get_ext_lang_defn (EXT_LANG_GUILE);
1081 warning (_("Invalid entry in %s section"), section_name);
1082 /* We could try various heuristics to find the next valid entry,
1083 but it's safer to just punt. */
1088 while (p < end && *p != '\0')
1092 warning (_("Non-nul-terminated entry in %s at offset %u"),
1093 section_name, offset);
1094 /* Don't load/execute it. */
1100 case SECTION_SCRIPT_ID_PYTHON_FILE:
1101 case SECTION_SCRIPT_ID_SCHEME_FILE:
1104 warning (_("Empty entry in %s at offset %u"),
1105 section_name, offset);
1108 source_script_file (pspace_info, objfile, language,
1109 section_name, offset, entry);
1111 case SECTION_SCRIPT_ID_PYTHON_TEXT:
1112 case SECTION_SCRIPT_ID_SCHEME_TEXT:
1113 execute_script_contents (pspace_info, objfile, language,
1114 section_name, offset, entry);
1120 /* Load scripts specified in section SECTION_NAME of OBJFILE. */
1123 auto_load_section_scripts (struct objfile *objfile, const char *section_name)
1125 bfd *abfd = objfile->obfd;
1126 asection *scripts_sect;
1127 bfd_byte *data = NULL;
1129 scripts_sect = bfd_get_section_by_name (abfd, section_name);
1130 if (scripts_sect == NULL
1131 || (bfd_get_section_flags (abfd, scripts_sect) & SEC_HAS_CONTENTS) == 0)
1134 if (!bfd_get_full_section_contents (abfd, scripts_sect, &data))
1135 warning (_("Couldn't read %s section of %s"),
1136 section_name, bfd_get_filename (abfd));
1139 gdb::unique_xmalloc_ptr<bfd_byte> data_holder (data);
1141 char *p = (char *) data;
1142 source_section_scripts (objfile, section_name, p,
1143 p + bfd_get_section_size (scripts_sect));
1147 /* Load any auto-loaded scripts for OBJFILE. */
1150 load_auto_scripts_for_objfile (struct objfile *objfile)
1152 /* Return immediately if auto-loading has been globally disabled.
1153 This is to handle sequencing of operations during gdb startup.
1154 Also return immediately if OBJFILE was not created from a file
1155 on the local filesystem. */
1156 if (!global_auto_load
1157 || (objfile->flags & OBJF_NOT_FILENAME) != 0
1158 || is_target_filename (objfile->original_name))
1161 /* Load any extension language scripts for this objfile.
1162 E.g., foo-gdb.gdb, foo-gdb.py. */
1163 auto_load_ext_lang_scripts_for_objfile (objfile);
1165 /* Load any scripts mentioned in AUTO_SECTION_NAME (.debug_gdb_scripts). */
1166 auto_load_section_scripts (objfile, AUTO_SECTION_NAME);
1169 /* This is a new_objfile observer callback to auto-load scripts.
1171 Two flavors of auto-loaded scripts are supported.
1172 1) based on the path to the objfile
1173 2) from .debug_gdb_scripts section */
1176 auto_load_new_objfile (struct objfile *objfile)
1180 /* OBJFILE is NULL when loading a new "main" symbol-file. */
1181 clear_section_scripts ();
1185 load_auto_scripts_for_objfile (objfile);
1188 /* Collect scripts to be printed in a vec. */
1190 struct collect_matching_scripts_data
1192 collect_matching_scripts_data (std::vector<loaded_script *> *scripts_p_,
1193 const extension_language_defn *language_)
1194 : scripts_p (scripts_p_), language (language_)
1197 std::vector<loaded_script *> *scripts_p;
1198 const struct extension_language_defn *language;
1201 /* Traversal function for htab_traverse.
1202 Collect the entry if it matches the regexp. */
1205 collect_matching_scripts (void **slot, void *info)
1207 struct loaded_script *script = (struct loaded_script *) *slot;
1208 struct collect_matching_scripts_data *data
1209 = (struct collect_matching_scripts_data *) info;
1211 if (script->language == data->language && re_exec (script->name))
1212 data->scripts_p->push_back (script);
1220 print_script (struct loaded_script *script)
1222 struct ui_out *uiout = current_uiout;
1224 ui_out_emit_tuple tuple_emitter (uiout, NULL);
1226 uiout->field_string ("loaded", script->loaded ? "Yes" : "No");
1227 uiout->field_string ("script", script->name);
1230 /* If the name isn't the full path, print it too. */
1231 if (script->full_path != NULL
1232 && strcmp (script->name, script->full_path) != 0)
1234 uiout->text ("\tfull name: ");
1235 uiout->field_string ("full_path", script->full_path);
1240 /* Helper for info_auto_load_scripts to sort the scripts by name. */
1243 sort_scripts_by_name (loaded_script *a, loaded_script *b)
1245 return FILENAME_CMP (a->name, b->name) < 0;
1248 /* Special internal GDB value of auto_load_info_scripts's PATTERN identify
1249 the "info auto-load XXX" command has been executed through the general
1250 "info auto-load" invocation. Extra newline will be printed if needed. */
1251 char auto_load_info_scripts_pattern_nl[] = "";
1253 /* Subroutine of auto_load_info_scripts to simplify it.
1257 print_scripts (const std::vector<loaded_script *> &scripts)
1259 for (loaded_script *script : scripts)
1260 print_script (script);
1263 /* Implementation for "info auto-load gdb-scripts"
1264 (and "info auto-load python-scripts"). List scripts in LANGUAGE matching
1265 PATTERN. FROM_TTY is the usual GDB boolean for user interactivity. */
1268 auto_load_info_scripts (const char *pattern, int from_tty,
1269 const struct extension_language_defn *language)
1271 struct ui_out *uiout = current_uiout;
1272 struct auto_load_pspace_info *pspace_info;
1276 pspace_info = get_auto_load_pspace_data (current_program_space);
1278 if (pattern && *pattern)
1280 char *re_err = re_comp (pattern);
1283 error (_("Invalid regexp: %s"), re_err);
1290 /* We need to know the number of rows before we build the table.
1291 Plus we want to sort the scripts by name.
1292 So first traverse the hash table collecting the matching scripts. */
1294 std::vector<loaded_script *> script_files, script_texts;
1296 if (pspace_info != NULL && pspace_info->loaded_script_files != NULL)
1298 collect_matching_scripts_data data (&script_files, language);
1300 /* Pass a pointer to scripts as VEC_safe_push can realloc space. */
1301 htab_traverse_noresize (pspace_info->loaded_script_files,
1302 collect_matching_scripts, &data);
1304 std::sort (script_files.begin (), script_files.end (),
1305 sort_scripts_by_name);
1308 if (pspace_info != NULL && pspace_info->loaded_script_texts != NULL)
1310 collect_matching_scripts_data data (&script_texts, language);
1312 /* Pass a pointer to scripts as VEC_safe_push can realloc space. */
1313 htab_traverse_noresize (pspace_info->loaded_script_texts,
1314 collect_matching_scripts, &data);
1316 std::sort (script_texts.begin (), script_texts.end (),
1317 sort_scripts_by_name);
1320 int nr_scripts = script_files.size () + script_texts.size ();
1322 /* Table header shifted right by preceding "gdb-scripts: " would not match
1324 if (nr_scripts > 0 && pattern == auto_load_info_scripts_pattern_nl)
1328 ui_out_emit_table table_emitter (uiout, 2, nr_scripts,
1329 "AutoLoadedScriptsTable");
1331 uiout->table_header (7, ui_left, "loaded", "Loaded");
1332 uiout->table_header (70, ui_left, "script", "Script");
1333 uiout->table_body ();
1335 print_scripts (script_files);
1336 print_scripts (script_texts);
1339 if (nr_scripts == 0)
1341 if (pattern && *pattern)
1342 uiout->message ("No auto-load scripts matching %s.\n", pattern);
1344 uiout->message ("No auto-load scripts.\n");
1348 /* Wrapper for "info auto-load gdb-scripts". */
1351 info_auto_load_gdb_scripts (const char *pattern, int from_tty)
1353 auto_load_info_scripts (pattern, from_tty, &extension_language_gdb);
1356 /* Implement 'info auto-load local-gdbinit'. */
1359 info_auto_load_local_gdbinit (const char *args, int from_tty)
1361 if (auto_load_local_gdbinit_pathname == NULL)
1362 printf_filtered (_("Local .gdbinit file was not found.\n"));
1363 else if (auto_load_local_gdbinit_loaded)
1364 printf_filtered (_("Local .gdbinit file \"%s\" has been loaded.\n"),
1365 auto_load_local_gdbinit_pathname);
1367 printf_filtered (_("Local .gdbinit file \"%s\" has not been loaded.\n"),
1368 auto_load_local_gdbinit_pathname);
1371 /* Print an "unsupported script" warning if it has not already been printed.
1372 The script is in language LANGUAGE at offset OFFSET in section SECTION_NAME
1376 maybe_print_unsupported_script_warning
1377 (struct auto_load_pspace_info *pspace_info,
1378 struct objfile *objfile, const struct extension_language_defn *language,
1379 const char *section_name, unsigned offset)
1381 if (!pspace_info->unsupported_script_warning_printed)
1384 Unsupported auto-load script at offset %u in section %s\n\
1386 Use `info auto-load %s-scripts [REGEXP]' to list them."),
1387 offset, section_name, objfile_name (objfile),
1388 ext_lang_name (language));
1389 pspace_info->unsupported_script_warning_printed = 1;
1393 /* Return non-zero if SCRIPT_NOT_FOUND_WARNING_PRINTED of PSPACE_INFO was unset
1394 before calling this function. Always set SCRIPT_NOT_FOUND_WARNING_PRINTED
1398 maybe_print_script_not_found_warning
1399 (struct auto_load_pspace_info *pspace_info,
1400 struct objfile *objfile, const struct extension_language_defn *language,
1401 const char *section_name, unsigned offset)
1403 if (!pspace_info->script_not_found_warning_printed)
1406 Missing auto-load script at offset %u in section %s\n\
1408 Use `info auto-load %s-scripts [REGEXP]' to list them."),
1409 offset, section_name, objfile_name (objfile),
1410 ext_lang_name (language));
1411 pspace_info->script_not_found_warning_printed = 1;
1415 /* The only valid "set auto-load" argument is off|0|no|disable. */
1418 set_auto_load_cmd (const char *args, int from_tty)
1420 struct cmd_list_element *list;
1423 /* See parse_binary_operation in use by the sub-commands. */
1425 length = args ? strlen (args) : 0;
1427 while (length > 0 && (args[length - 1] == ' ' || args[length - 1] == '\t'))
1430 if (length == 0 || (strncmp (args, "off", length) != 0
1431 && strncmp (args, "0", length) != 0
1432 && strncmp (args, "no", length) != 0
1433 && strncmp (args, "disable", length) != 0))
1434 error (_("Valid is only global 'set auto-load no'; "
1435 "otherwise check the auto-load sub-commands."));
1437 for (list = *auto_load_set_cmdlist_get (); list != NULL; list = list->next)
1438 if (list->var_type == var_boolean)
1440 gdb_assert (list->type == set_cmd);
1441 do_set_command (args, from_tty, list);
1445 /* Initialize "set auto-load " commands prefix and return it. */
1447 struct cmd_list_element **
1448 auto_load_set_cmdlist_get (void)
1450 static struct cmd_list_element *retval;
1453 add_prefix_cmd ("auto-load", class_maintenance, set_auto_load_cmd, _("\
1454 Auto-loading specific settings.\n\
1455 Configure various auto-load-specific variables such as\n\
1456 automatic loading of Python scripts."),
1457 &retval, "set auto-load ",
1458 1/*allow-unknown*/, &setlist);
1463 /* Command "show auto-load" displays summary of all the current
1464 "show auto-load " settings. */
1467 show_auto_load_cmd (const char *args, int from_tty)
1469 cmd_show_list (*auto_load_show_cmdlist_get (), from_tty, "");
1472 /* Initialize "show auto-load " commands prefix and return it. */
1474 struct cmd_list_element **
1475 auto_load_show_cmdlist_get (void)
1477 static struct cmd_list_element *retval;
1480 add_prefix_cmd ("auto-load", class_maintenance, show_auto_load_cmd, _("\
1481 Show auto-loading specific settings.\n\
1482 Show configuration of various auto-load-specific variables such as\n\
1483 automatic loading of Python scripts."),
1484 &retval, "show auto-load ",
1485 0/*allow-unknown*/, &showlist);
1490 /* Command "info auto-load" displays whether the various auto-load files have
1491 been loaded. This is reimplementation of cmd_show_list which inserts
1492 newlines at proper places. */
1495 info_auto_load_cmd (const char *args, int from_tty)
1497 struct cmd_list_element *list;
1498 struct ui_out *uiout = current_uiout;
1500 ui_out_emit_tuple tuple_emitter (uiout, "infolist");
1502 for (list = *auto_load_info_cmdlist_get (); list != NULL; list = list->next)
1504 ui_out_emit_tuple option_emitter (uiout, "option");
1506 gdb_assert (!list->prefixlist);
1507 gdb_assert (list->type == not_set_cmd);
1509 uiout->field_string ("name", list->name);
1511 cmd_func (list, auto_load_info_scripts_pattern_nl, from_tty);
1515 /* Initialize "info auto-load " commands prefix and return it. */
1517 struct cmd_list_element **
1518 auto_load_info_cmdlist_get (void)
1520 static struct cmd_list_element *retval;
1523 add_prefix_cmd ("auto-load", class_info, info_auto_load_cmd, _("\
1524 Print current status of auto-loaded files.\n\
1525 Print whether various files like Python scripts or .gdbinit files have been\n\
1526 found and/or loaded."),
1527 &retval, "info auto-load ",
1528 0/*allow-unknown*/, &infolist);
1534 _initialize_auto_load (void)
1536 struct cmd_list_element *cmd;
1537 char *scripts_directory_help, *gdb_name_help, *python_name_help;
1538 char *guile_name_help;
1541 auto_load_pspace_data
1542 = register_program_space_data_with_cleanup (NULL,
1543 auto_load_pspace_data_cleanup);
1545 gdb::observers::new_objfile.attach (auto_load_new_objfile);
1547 add_setshow_boolean_cmd ("gdb-scripts", class_support,
1548 &auto_load_gdb_scripts, _("\
1549 Enable or disable auto-loading of canned sequences of commands scripts."), _("\
1550 Show whether auto-loading of canned sequences of commands scripts is enabled."),
1552 If enabled, canned sequences of commands are loaded when the debugger reads\n\
1553 an executable or shared library.\n\
1554 This options has security implications for untrusted inferiors."),
1555 NULL, show_auto_load_gdb_scripts,
1556 auto_load_set_cmdlist_get (),
1557 auto_load_show_cmdlist_get ());
1559 add_cmd ("gdb-scripts", class_info, info_auto_load_gdb_scripts,
1560 _("Print the list of automatically loaded sequences of commands.\n\
1561 Usage: info auto-load gdb-scripts [REGEXP]"),
1562 auto_load_info_cmdlist_get ());
1564 add_setshow_boolean_cmd ("local-gdbinit", class_support,
1565 &auto_load_local_gdbinit, _("\
1566 Enable or disable auto-loading of .gdbinit script in current directory."), _("\
1567 Show whether auto-loading .gdbinit script in current directory is enabled."),
1569 If enabled, canned sequences of commands are loaded when debugger starts\n\
1570 from .gdbinit file in current directory. Such files are deprecated,\n\
1571 use a script associated with inferior executable file instead.\n\
1572 This options has security implications for untrusted inferiors."),
1573 NULL, show_auto_load_local_gdbinit,
1574 auto_load_set_cmdlist_get (),
1575 auto_load_show_cmdlist_get ());
1577 add_cmd ("local-gdbinit", class_info, info_auto_load_local_gdbinit,
1578 _("Print whether current directory .gdbinit file has been loaded.\n\
1579 Usage: info auto-load local-gdbinit"),
1580 auto_load_info_cmdlist_get ());
1582 auto_load_dir = xstrdup (AUTO_LOAD_DIR);
1584 suffix = ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_GDB));
1587 GDB scripts: OBJFILE%s\n"),
1589 python_name_help = NULL;
1591 suffix = ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_PYTHON));
1594 Python scripts: OBJFILE%s\n"),
1597 guile_name_help = NULL;
1599 suffix = ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_GUILE));
1602 Guile scripts: OBJFILE%s\n"),
1605 scripts_directory_help
1607 Automatically loaded scripts are located in one of the directories listed\n\
1613 This option is ignored for the kinds of scripts \
1614 having 'set auto-load ... off'.\n\
1615 Directories listed here need to be present also \
1616 in the 'set auto-load safe-path'\n\
1619 python_name_help ? python_name_help : "",
1620 guile_name_help ? guile_name_help : "");
1622 add_setshow_optional_filename_cmd ("scripts-directory", class_support,
1623 &auto_load_dir, _("\
1624 Set the list of directories from which to load auto-loaded scripts."), _("\
1625 Show the list of directories from which to load auto-loaded scripts."),
1626 scripts_directory_help,
1627 set_auto_load_dir, show_auto_load_dir,
1628 auto_load_set_cmdlist_get (),
1629 auto_load_show_cmdlist_get ());
1630 xfree (scripts_directory_help);
1631 xfree (python_name_help);
1632 xfree (gdb_name_help);
1633 xfree (guile_name_help);
1635 auto_load_safe_path = xstrdup (AUTO_LOAD_SAFE_PATH);
1636 auto_load_safe_path_vec_update ();
1637 add_setshow_optional_filename_cmd ("safe-path", class_support,
1638 &auto_load_safe_path, _("\
1639 Set the list of files and directories that are safe for auto-loading."), _("\
1640 Show the list of files and directories that are safe for auto-loading."), _("\
1641 Various files loaded automatically for the 'set auto-load ...' options must\n\
1642 be located in one of the directories listed by this option. Warning will be\n\
1643 printed and file will not be used otherwise.\n\
1644 You can mix both directory and filename entries.\n\
1645 Setting this parameter to an empty list resets it to its default value.\n\
1646 Setting this parameter to '/' (without the quotes) allows any file\n\
1647 for the 'set auto-load ...' options. Each path entry can be also shell\n\
1648 wildcard pattern; '*' does not match directory separator.\n\
1649 This option is ignored for the kinds of files having 'set auto-load ... off'.\n\
1650 This options has security implications for untrusted inferiors."),
1651 set_auto_load_safe_path,
1652 show_auto_load_safe_path,
1653 auto_load_set_cmdlist_get (),
1654 auto_load_show_cmdlist_get ());
1655 gdb::observers::gdb_datadir_changed.attach (auto_load_gdb_datadir_changed);
1657 cmd = add_cmd ("add-auto-load-safe-path", class_support,
1658 add_auto_load_safe_path,
1659 _("Add entries to the list of directories from which it is safe "
1660 "to auto-load files.\n\
1661 See the commands 'set auto-load safe-path' and 'show auto-load safe-path' to\n\
1662 access the current full list setting."),
1664 set_cmd_completer (cmd, filename_completer);
1666 cmd = add_cmd ("add-auto-load-scripts-directory", class_support,
1668 _("Add entries to the list of directories from which to load "
1669 "auto-loaded scripts.\n\
1670 See the commands 'set auto-load scripts-directory' and\n\
1671 'show auto-load scripts-directory' to access the current full list setting."),
1673 set_cmd_completer (cmd, filename_completer);
1675 add_setshow_boolean_cmd ("auto-load", class_maintenance,
1676 &debug_auto_load, _("\
1677 Set auto-load verifications debugging."), _("\
1678 Show auto-load verifications debugging."), _("\
1679 When non-zero, debugging output for files of 'set auto-load ...'\n\
1681 NULL, show_debug_auto_load,
1682 &setdebuglist, &showdebuglist);