1 /* GDB routines for supporting auto-loaded scripts.
3 Copyright (C) 2012-2014 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 "gdb_regex.h"
25 #include "filenames.h"
29 #include "exceptions.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"
36 #include "readline/tilde.h"
37 #include "completer.h"
40 #include "filestuff.h"
41 #include "extension.h"
42 #include "gdb/section-scripts.h"
44 /* The section to look in for auto-loaded scripts (in file formats that
46 Each entry in this section is a record that begins with a leading byte
47 identifying the record type.
48 At the moment we only support one record type: A leading byte of 1,
49 followed by the path of a python script to load. */
50 #define AUTO_SECTION_NAME ".debug_gdb_scripts"
52 static int maybe_add_script (struct auto_load_pspace_info *pspace_info,
53 int loaded, const char *name,
54 const char *full_path,
55 const struct extension_language_defn *language);
57 static int unsupported_script_warning_print (struct auto_load_pspace_info *);
59 static int script_not_found_warning_print (struct auto_load_pspace_info *);
61 /* Value of the 'set debug auto-load' configuration variable. */
62 static int debug_auto_load = 0;
64 /* "show" command for the debug_auto_load configuration variable. */
67 show_debug_auto_load (struct ui_file *file, int from_tty,
68 struct cmd_list_element *c, const char *value)
70 fprintf_filtered (file, _("Debugging output for files "
71 "of 'set auto-load ...' is %s.\n"),
75 /* User-settable option to enable/disable auto-loading of GDB_AUTO_FILE_NAME
77 set auto-load gdb-scripts on|off
78 This is true if we should auto-load associated scripts when an objfile
79 is opened, false otherwise. */
80 static int auto_load_gdb_scripts = 1;
82 /* "show" command for the auto_load_gdb_scripts configuration variable. */
85 show_auto_load_gdb_scripts (struct ui_file *file, int from_tty,
86 struct cmd_list_element *c, const char *value)
88 fprintf_filtered (file, _("Auto-loading of canned sequences of commands "
93 /* Return non-zero if auto-loading gdb scripts is enabled. */
96 auto_load_gdb_scripts_enabled (const struct extension_language_defn *extlang)
98 return auto_load_gdb_scripts;
101 /* Internal-use flag to enable/disable auto-loading.
102 This is true if we should auto-load python code when an objfile is opened,
105 Both auto_load_scripts && global_auto_load must be true to enable
108 This flag exists to facilitate deferring auto-loading during start-up
109 until after ./.gdbinit has been read; it may augment the search directories
110 used to find the scripts. */
111 int global_auto_load = 1;
113 /* Auto-load .gdbinit file from the current directory? */
114 int auto_load_local_gdbinit = 1;
116 /* Absolute pathname to the current directory .gdbinit, if it exists. */
117 char *auto_load_local_gdbinit_pathname = NULL;
119 /* Boolean value if AUTO_LOAD_LOCAL_GDBINIT_PATHNAME has been loaded. */
120 int auto_load_local_gdbinit_loaded = 0;
122 /* "show" command for the auto_load_local_gdbinit configuration variable. */
125 show_auto_load_local_gdbinit (struct ui_file *file, int from_tty,
126 struct cmd_list_element *c, const char *value)
128 fprintf_filtered (file, _("Auto-loading of .gdbinit script from current "
129 "directory is %s.\n"),
133 /* Directory list from which to load auto-loaded scripts. It is not checked
134 for absolute paths but they are strongly recommended. It is initialized by
135 _initialize_auto_load. */
136 static char *auto_load_dir;
138 /* "set" command for the auto_load_dir configuration variable. */
141 set_auto_load_dir (char *args, int from_tty, struct cmd_list_element *c)
143 /* Setting the variable to "" resets it to the compile time defaults. */
144 if (auto_load_dir[0] == '\0')
146 xfree (auto_load_dir);
147 auto_load_dir = xstrdup (AUTO_LOAD_DIR);
151 /* "show" command for the auto_load_dir configuration variable. */
154 show_auto_load_dir (struct ui_file *file, int from_tty,
155 struct cmd_list_element *c, const char *value)
157 fprintf_filtered (file, _("List of directories from which to load "
158 "auto-loaded scripts is %s.\n"),
162 /* Directory list safe to hold auto-loaded files. It is not checked for
163 absolute paths but they are strongly recommended. It is initialized by
164 _initialize_auto_load. */
165 static char *auto_load_safe_path;
167 /* Vector of directory elements of AUTO_LOAD_SAFE_PATH with each one normalized
168 by tilde_expand and possibly each entries has added its gdb_realpath
170 static VEC (char_ptr) *auto_load_safe_path_vec;
172 /* Expand $datadir and $debugdir in STRING according to the rules of
173 substitute_path_component. Return vector from dirnames_to_char_ptr_vec,
174 this vector must be freed by free_char_ptr_vec by the caller. */
176 static VEC (char_ptr) *
177 auto_load_expand_dir_vars (const char *string)
179 VEC (char_ptr) *dir_vec;
182 s = xstrdup (string);
183 substitute_path_component (&s, "$datadir", gdb_datadir);
184 substitute_path_component (&s, "$debugdir", debug_file_directory);
186 if (debug_auto_load && strcmp (s, string) != 0)
187 fprintf_unfiltered (gdb_stdlog,
188 _("auto-load: Expanded $-variables to \"%s\".\n"), s);
190 dir_vec = dirnames_to_char_ptr_vec (s);
196 /* Update auto_load_safe_path_vec from current AUTO_LOAD_SAFE_PATH. */
199 auto_load_safe_path_vec_update (void)
205 fprintf_unfiltered (gdb_stdlog,
206 _("auto-load: Updating directories of \"%s\".\n"),
207 auto_load_safe_path);
209 free_char_ptr_vec (auto_load_safe_path_vec);
211 auto_load_safe_path_vec = auto_load_expand_dir_vars (auto_load_safe_path);
212 len = VEC_length (char_ptr, auto_load_safe_path_vec);
214 /* Apply tilde_expand and gdb_realpath to each AUTO_LOAD_SAFE_PATH_VEC
216 for (ix = 0; ix < len; ix++)
218 char *dir = VEC_index (char_ptr, auto_load_safe_path_vec, ix);
219 char *expanded = tilde_expand (dir);
220 char *real_path = gdb_realpath (expanded);
222 /* Ensure the current entry is at least tilde_expand-ed. */
223 VEC_replace (char_ptr, auto_load_safe_path_vec, ix, expanded);
227 if (strcmp (expanded, dir) == 0)
228 fprintf_unfiltered (gdb_stdlog,
229 _("auto-load: Using directory \"%s\".\n"),
232 fprintf_unfiltered (gdb_stdlog,
233 _("auto-load: Resolved directory \"%s\" "
239 /* If gdb_realpath returns a different content, append it. */
240 if (strcmp (real_path, expanded) == 0)
244 VEC_safe_push (char_ptr, auto_load_safe_path_vec, real_path);
247 fprintf_unfiltered (gdb_stdlog,
248 _("auto-load: And canonicalized as \"%s\".\n"),
254 /* Variable gdb_datadir has been set. Update content depending on $datadir. */
257 auto_load_gdb_datadir_changed (void)
259 auto_load_safe_path_vec_update ();
262 /* "set" command for the auto_load_safe_path configuration variable. */
265 set_auto_load_safe_path (char *args, int from_tty, struct cmd_list_element *c)
267 /* Setting the variable to "" resets it to the compile time defaults. */
268 if (auto_load_safe_path[0] == '\0')
270 xfree (auto_load_safe_path);
271 auto_load_safe_path = xstrdup (AUTO_LOAD_SAFE_PATH);
274 auto_load_safe_path_vec_update ();
277 /* "show" command for the auto_load_safe_path configuration variable. */
280 show_auto_load_safe_path (struct ui_file *file, int from_tty,
281 struct cmd_list_element *c, const char *value)
285 /* Check if user has entered either "/" or for example ":".
286 But while more complicate content like ":/foo" would still also
287 permit any location do not hide those. */
289 for (cs = value; *cs && (*cs == DIRNAME_SEPARATOR || IS_DIR_SEPARATOR (*cs));
292 fprintf_filtered (file, _("Auto-load files are safe to load from any "
295 fprintf_filtered (file, _("List of directories from which it is safe to "
296 "auto-load files is %s.\n"),
300 /* "add-auto-load-safe-path" command for the auto_load_safe_path configuration
304 add_auto_load_safe_path (char *args, int from_tty)
308 if (args == NULL || *args == 0)
310 Directory argument required.\n\
311 Use 'set auto-load safe-path /' for disabling the auto-load safe-path security.\
314 s = xstrprintf ("%s%c%s", auto_load_safe_path, DIRNAME_SEPARATOR, args);
315 xfree (auto_load_safe_path);
316 auto_load_safe_path = s;
318 auto_load_safe_path_vec_update ();
321 /* Implementation for filename_is_in_pattern overwriting the caller's FILENAME
325 filename_is_in_pattern_1 (char *filename, char *pattern)
327 size_t pattern_len = strlen (pattern);
328 size_t filename_len = strlen (filename);
331 fprintf_unfiltered (gdb_stdlog, _("auto-load: Matching file \"%s\" "
332 "to pattern \"%s\"\n"),
335 /* Trim trailing slashes ("/") from PATTERN. Even for "d:\" paths as
336 trailing slashes are trimmed also from FILENAME it still matches
338 while (pattern_len && IS_DIR_SEPARATOR (pattern[pattern_len - 1]))
340 pattern[pattern_len] = '\0';
342 /* Ensure auto_load_safe_path "/" matches any FILENAME. On MS-Windows
343 platform FILENAME even after gdb_realpath does not have to start with
344 IS_DIR_SEPARATOR character, such as the 'C:\x.exe' filename. */
345 if (pattern_len == 0)
348 fprintf_unfiltered (gdb_stdlog,
349 _("auto-load: Matched - empty pattern\n"));
355 /* Trim trailing slashes ("/"). PATTERN also has slashes trimmed the
356 same way so they will match. */
357 while (filename_len && IS_DIR_SEPARATOR (filename[filename_len - 1]))
359 filename[filename_len] = '\0';
360 if (filename_len == 0)
363 fprintf_unfiltered (gdb_stdlog,
364 _("auto-load: Not matched - pattern \"%s\".\n"),
369 if (gdb_filename_fnmatch (pattern, filename, FNM_FILE_NAME | FNM_NOESCAPE)
373 fprintf_unfiltered (gdb_stdlog, _("auto-load: Matched - file "
374 "\"%s\" to pattern \"%s\".\n"),
379 /* Trim trailing FILENAME component. */
380 while (filename_len > 0 && !IS_DIR_SEPARATOR (filename[filename_len - 1]))
385 /* Return 1 if FILENAME matches PATTERN or if FILENAME resides in
386 a subdirectory of a directory that matches PATTERN. Return 0 otherwise.
387 gdb_realpath normalization is never done here. */
389 static ATTRIBUTE_PURE int
390 filename_is_in_pattern (const char *filename, const char *pattern)
392 char *filename_copy, *pattern_copy;
394 filename_copy = alloca (strlen (filename) + 1);
395 strcpy (filename_copy, filename);
396 pattern_copy = alloca (strlen (pattern) + 1);
397 strcpy (pattern_copy, pattern);
399 return filename_is_in_pattern_1 (filename_copy, pattern_copy);
402 /* Return 1 if FILENAME belongs to one of directory components of
403 AUTO_LOAD_SAFE_PATH_VEC. Return 0 otherwise.
404 auto_load_safe_path_vec_update is never called.
405 *FILENAME_REALP may be updated by gdb_realpath of FILENAME - it has to be
406 freed by the caller. */
409 filename_is_in_auto_load_safe_path_vec (const char *filename,
410 char **filename_realp)
415 for (ix = 0; VEC_iterate (char_ptr, auto_load_safe_path_vec, ix, pattern);
417 if (*filename_realp == NULL && filename_is_in_pattern (filename, pattern))
422 if (*filename_realp == NULL)
424 *filename_realp = gdb_realpath (filename);
425 if (debug_auto_load && strcmp (*filename_realp, filename) != 0)
426 fprintf_unfiltered (gdb_stdlog,
427 _("auto-load: Resolved "
428 "file \"%s\" as \"%s\".\n"),
429 filename, *filename_realp);
432 if (strcmp (*filename_realp, filename) != 0)
434 VEC_iterate (char_ptr, auto_load_safe_path_vec, ix, pattern); ++ix)
435 if (filename_is_in_pattern (*filename_realp, pattern))
442 fprintf_unfiltered (gdb_stdlog, _("auto-load: File \"%s\" matches "
443 "directory \"%s\".\n"),
451 /* Return 1 if FILENAME is located in one of the directories of
452 AUTO_LOAD_SAFE_PATH. Otherwise call warning and return 0. FILENAME does
453 not have to be an absolute path.
455 Existence of FILENAME is not checked. Function will still give a warning
456 even if the caller would quietly skip non-existing file in unsafe
460 file_is_auto_load_safe (const char *filename, const char *debug_fmt, ...)
462 char *filename_real = NULL;
463 struct cleanup *back_to;
464 static int advice_printed = 0;
470 va_start (debug_args, debug_fmt);
471 vfprintf_unfiltered (gdb_stdlog, debug_fmt, debug_args);
475 back_to = make_cleanup (free_current_contents, &filename_real);
477 if (filename_is_in_auto_load_safe_path_vec (filename, &filename_real))
479 do_cleanups (back_to);
483 auto_load_safe_path_vec_update ();
484 if (filename_is_in_auto_load_safe_path_vec (filename, &filename_real))
486 do_cleanups (back_to);
490 warning (_("File \"%s\" auto-loading has been declined by your "
491 "`auto-load safe-path' set to \"%s\"."),
492 filename_real, auto_load_safe_path);
496 const char *homedir = getenv ("HOME");
501 homeinit = xstrprintf ("%s/%s", homedir, gdbinit);
502 make_cleanup (xfree, homeinit);
504 printf_filtered (_("\
505 To enable execution of this file add\n\
506 \tadd-auto-load-safe-path %s\n\
507 line to your configuration file \"%s\".\n\
508 To completely disable this security protection add\n\
509 \tset auto-load safe-path /\n\
510 line to your configuration file \"%s\".\n\
511 For more information about this security protection see the\n\
512 \"Auto-loading safe path\" section in the GDB manual. E.g., run from the shell:\n\
513 \tinfo \"(gdb)Auto-loading safe path\"\n"),
514 filename_real, homeinit, homeinit);
518 do_cleanups (back_to);
522 /* For scripts specified in .debug_gdb_scripts, multiple objfiles may load
523 the same script. There's no point in loading the script multiple times,
524 and there can be a lot of objfiles and scripts, so we keep track of scripts
527 struct auto_load_pspace_info
529 /* For each program space we keep track of loaded scripts. */
530 struct htab *loaded_scripts;
532 /* Non-zero if we've issued the warning about an auto-load script not being
533 supported. We only want to issue this warning once. */
534 int unsupported_script_warning_printed;
536 /* Non-zero if we've issued the warning about an auto-load script not being
537 found. We only want to issue this warning once. */
538 int script_not_found_warning_printed;
541 /* Objects of this type are stored in the loaded script hash table. */
545 /* Name as provided by the objfile. */
548 /* Full path name or NULL if script wasn't found (or was otherwise
550 const char *full_path;
552 /* Non-zero if this script has been loaded. */
555 const struct extension_language_defn *language;
558 /* Per-program-space data key. */
559 static const struct program_space_data *auto_load_pspace_data;
562 auto_load_pspace_data_cleanup (struct program_space *pspace, void *arg)
564 struct auto_load_pspace_info *info = arg;
566 if (info->loaded_scripts)
567 htab_delete (info->loaded_scripts);
571 /* Get the current autoload data. If none is found yet, add it now. This
572 function always returns a valid object. */
574 static struct auto_load_pspace_info *
575 get_auto_load_pspace_data (struct program_space *pspace)
577 struct auto_load_pspace_info *info;
579 info = program_space_data (pspace, auto_load_pspace_data);
582 info = XCNEW (struct auto_load_pspace_info);
583 set_program_space_data (pspace, auto_load_pspace_data, info);
589 /* Hash function for the loaded script hash. */
592 hash_loaded_script_entry (const void *data)
594 const struct loaded_script *e = data;
596 return htab_hash_string (e->name) ^ htab_hash_pointer (e->language);
599 /* Equality function for the loaded script hash. */
602 eq_loaded_script_entry (const void *a, const void *b)
604 const struct loaded_script *ea = a;
605 const struct loaded_script *eb = b;
607 return strcmp (ea->name, eb->name) == 0 && ea->language == eb->language;
610 /* Initialize the table to track loaded scripts.
611 Each entry is hashed by the full path name. */
614 init_loaded_scripts_info (struct auto_load_pspace_info *pspace_info)
616 /* Choose 31 as the starting size of the hash table, somewhat arbitrarily.
617 Space for each entry is obtained with one malloc so we can free them
620 pspace_info->loaded_scripts = htab_create (31,
621 hash_loaded_script_entry,
622 eq_loaded_script_entry,
625 pspace_info->unsupported_script_warning_printed = FALSE;
626 pspace_info->script_not_found_warning_printed = FALSE;
629 /* Wrapper on get_auto_load_pspace_data to also allocate the hash table
630 for loading scripts. */
632 struct auto_load_pspace_info *
633 get_auto_load_pspace_data_for_loading (struct program_space *pspace)
635 struct auto_load_pspace_info *info;
637 info = get_auto_load_pspace_data (pspace);
638 if (info->loaded_scripts == NULL)
639 init_loaded_scripts_info (info);
644 /* Add script NAME in LANGUAGE to hash table of PSPACE_INFO. LOADED 1 if the
645 script has been (is going to) be loaded, 0 otherwise (such as if it has not
646 been found). FULL_PATH is NULL if the script wasn't found. The result is
647 true if the script was already in the hash table. */
650 maybe_add_script (struct auto_load_pspace_info *pspace_info, int loaded,
651 const char *name, const char *full_path,
652 const struct extension_language_defn *language)
654 struct htab *htab = pspace_info->loaded_scripts;
655 struct loaded_script **slot, entry;
659 entry.language = language;
660 slot = (struct loaded_script **) htab_find_slot (htab, &entry, INSERT);
661 in_hash_table = *slot != NULL;
663 /* If this script is not in the hash table, add it. */
669 /* Allocate all space in one chunk so it's easier to free. */
670 *slot = xmalloc (sizeof (**slot)
672 + (full_path != NULL ? (strlen (full_path) + 1) : 0));
673 p = ((char*) *slot) + sizeof (**slot);
676 if (full_path != NULL)
679 strcpy (p, full_path);
680 (*slot)->full_path = p;
683 (*slot)->full_path = NULL;
684 (*slot)->loaded = loaded;
685 (*slot)->language = language;
688 return in_hash_table;
691 /* Clear the table of loaded section scripts. */
694 clear_section_scripts (void)
696 struct program_space *pspace = current_program_space;
697 struct auto_load_pspace_info *info;
699 info = program_space_data (pspace, auto_load_pspace_data);
700 if (info != NULL && info->loaded_scripts != NULL)
702 htab_delete (info->loaded_scripts);
703 info->loaded_scripts = NULL;
704 info->unsupported_script_warning_printed = FALSE;
705 info->script_not_found_warning_printed = FALSE;
709 /* Look for the auto-load script in LANGUAGE associated with OBJFILE where
710 OBJFILE's gdb_realpath is REALNAME and load it. Return 1 if we found any
711 matching script, return 0 otherwise. */
714 auto_load_objfile_script_1 (struct objfile *objfile, const char *realname,
715 const struct extension_language_defn *language)
717 char *filename, *debugfile;
720 struct cleanup *cleanups;
721 const char *suffix = ext_lang_auto_load_suffix (language);
723 len = strlen (realname);
724 filename = xmalloc (len + strlen (suffix) + 1);
725 memcpy (filename, realname, len);
726 strcpy (filename + len, suffix);
728 cleanups = make_cleanup (xfree, filename);
730 input = gdb_fopen_cloexec (filename, "r");
731 debugfile = filename;
733 fprintf_unfiltered (gdb_stdlog, _("auto-load: Attempted file \"%s\" %s.\n"),
734 debugfile, input ? _("exists") : _("does not exist"));
742 /* Also try the same file in a subdirectory of gdb's data
745 vec = auto_load_expand_dir_vars (auto_load_dir);
746 make_cleanup_free_char_ptr_vec (vec);
749 fprintf_unfiltered (gdb_stdlog, _("auto-load: Searching 'set auto-load "
750 "scripts-directory' path \"%s\".\n"),
753 for (ix = 0; VEC_iterate (char_ptr, vec, ix, dir); ++ix)
755 debugfile = xmalloc (strlen (dir) + strlen (filename) + 1);
756 strcpy (debugfile, dir);
758 /* FILENAME is absolute, so we don't need a "/" here. */
759 strcat (debugfile, filename);
761 make_cleanup (xfree, debugfile);
762 input = gdb_fopen_cloexec (debugfile, "r");
764 fprintf_unfiltered (gdb_stdlog, _("auto-load: Attempted file "
767 input ? _("exists") : _("does not exist"));
776 struct auto_load_pspace_info *pspace_info;
778 make_cleanup_fclose (input);
781 = file_is_auto_load_safe (debugfile,
782 _("auto-load: Loading %s script \"%s\""
783 " by extension for objfile \"%s\".\n"),
784 ext_lang_name (language),
785 debugfile, objfile_name (objfile));
787 /* Add this script to the hash table too so
788 "info auto-load ${lang}-scripts" can print it. */
790 = get_auto_load_pspace_data_for_loading (current_program_space);
791 maybe_add_script (pspace_info, is_safe, debugfile, debugfile, language);
793 /* To preserve existing behaviour we don't check for whether the
794 script was already in the table, and always load it.
795 It's highly unlikely that we'd ever load it twice,
796 and these scripts are required to be idempotent under multiple
800 objfile_script_sourcer_func *sourcer
801 = ext_lang_objfile_script_sourcer (language);
803 /* We shouldn't get here if support for the language isn't
804 compiled in. And the extension language is required to implement
806 gdb_assert (sourcer != NULL);
807 sourcer (language, objfile, input, debugfile);
815 do_cleanups (cleanups);
819 /* Look for the auto-load script in LANGUAGE associated with OBJFILE and load
823 auto_load_objfile_script (struct objfile *objfile,
824 const struct extension_language_defn *language)
826 char *realname = gdb_realpath (objfile_name (objfile));
827 struct cleanup *cleanups = make_cleanup (xfree, realname);
829 if (!auto_load_objfile_script_1 (objfile, realname, language))
831 /* For Windows/DOS .exe executables, strip the .exe suffix, so that
832 FOO-gdb.gdb could be used for FOO.exe, and try again. */
834 size_t len = strlen (realname);
835 const size_t lexe = sizeof (".exe") - 1;
837 if (len > lexe && strcasecmp (realname + len - lexe, ".exe") == 0)
840 realname[len] = '\0';
842 fprintf_unfiltered (gdb_stdlog, _("auto-load: Stripped .exe suffix, "
843 "retrying with \"%s\".\n"),
845 auto_load_objfile_script_1 (objfile, realname, language);
849 do_cleanups (cleanups);
852 /* Load scripts specified in OBJFILE.
853 START,END delimit a buffer containing a list of nul-terminated
855 SECTION_NAME is used in error messages.
857 Scripts are found per normal "source -s" command processing.
858 First the script is looked for in $cwd. If not found there the
859 source search path is used.
861 The section contains a list of path names of script files to load.
862 Each path is null-terminated. */
865 source_section_scripts (struct objfile *objfile, const char *section_name,
866 const char *start, const char *end)
869 struct auto_load_pspace_info *pspace_info;
871 pspace_info = get_auto_load_pspace_data_for_loading (current_program_space);
873 for (p = start; p < end; ++p)
878 int opened, in_hash_table;
879 struct cleanup *back_to;
880 const struct extension_language_defn *language;
881 objfile_script_sourcer_func *sourcer;
885 case SECTION_SCRIPT_ID_PYTHON_FILE:
886 language = get_ext_lang_defn (EXT_LANG_PYTHON);
888 case SECTION_SCRIPT_ID_SCHEME_FILE:
889 language = get_ext_lang_defn (EXT_LANG_GUILE);
892 warning (_("Invalid entry in %s section"), section_name);
893 /* We could try various heuristics to find the next valid entry,
894 but it's safer to just punt. */
899 while (p < end && *p != '\0')
903 char *buf = alloca (p - file + 1);
905 memcpy (buf, file, p - file);
906 buf[p - file] = '\0';
907 warning (_("Non-null-terminated path in %s: %s"),
914 warning (_("Empty path in %s"), section_name);
918 /* Until we support more types of records in .debug_gdb_scripts we do
919 all the processing here. The expectation is to add a new
920 extension_language_script_ops "method" that handles all the records
921 for the language. For now we can just use
922 extension_language_script_ops.objfile_script_sourcer. */
924 /* Skip this script if support is not compiled in. */
925 sourcer = ext_lang_objfile_script_sourcer (language);
928 /* We don't throw an error, the program is still debuggable. */
929 if (!unsupported_script_warning_print (pspace_info))
931 warning (_("Unsupported auto-load scripts referenced in"
934 "Use `info auto-load %s-scripts [REGEXP]'"
936 section_name, objfile_name (objfile),
937 ext_lang_name (language));
939 /* We *could* still try to open it, but there's no point. */
940 maybe_add_script (pspace_info, 0, file, NULL, language);
944 /* Skip this script if auto-loading it has been disabled. */
945 if (!ext_lang_auto_load_enabled (language))
947 /* No message is printed, just skip it. */
951 opened = find_and_open_script (file, 1 /*search_path*/,
952 &stream, &full_path);
954 back_to = make_cleanup (null_cleanup, NULL);
957 make_cleanup_fclose (stream);
958 make_cleanup (xfree, full_path);
960 if (!file_is_auto_load_safe (full_path,
961 _("auto-load: Loading %s script "
962 "\"%s\" from section \"%s\" of "
963 "objfile \"%s\".\n"),
964 ext_lang_name (language), full_path,
965 section_name, objfile_name (objfile)))
972 /* If one script isn't found it's not uncommon for more to not be
973 found either. We don't want to print a message for each script,
974 too much noise. Instead, we print the warning once and tell the
975 user how to find the list of scripts that weren't loaded.
976 We don't throw an error, the program is still debuggable.
978 IWBN if complaints.c were more general-purpose. */
980 if (script_not_found_warning_print (pspace_info))
981 warning (_("Missing auto-load scripts referenced in section %s\n\
983 Use `info auto-load %s-scripts [REGEXP]' to list them."),
984 section_name, objfile_name (objfile),
985 ext_lang_name (language));
988 in_hash_table = maybe_add_script (pspace_info, opened, file, full_path,
991 /* If this file is not currently loaded, load it. */
992 if (opened && !in_hash_table)
993 sourcer (language, objfile, stream, full_path);
995 do_cleanups (back_to);
999 /* Load scripts specified in section SECTION_NAME of OBJFILE. */
1002 auto_load_section_scripts (struct objfile *objfile, const char *section_name)
1004 bfd *abfd = objfile->obfd;
1005 asection *scripts_sect;
1006 bfd_byte *data = NULL;
1008 scripts_sect = bfd_get_section_by_name (abfd, section_name);
1009 if (scripts_sect == NULL)
1012 if (!bfd_get_full_section_contents (abfd, scripts_sect, &data))
1013 warning (_("Couldn't read %s section of %s"),
1014 section_name, bfd_get_filename (abfd));
1017 struct cleanup *cleanups;
1018 char *p = (char *) data;
1020 cleanups = make_cleanup (xfree, p);
1021 source_section_scripts (objfile, section_name, p,
1022 p + bfd_get_section_size (scripts_sect));
1023 do_cleanups (cleanups);
1027 /* Load any auto-loaded scripts for OBJFILE. */
1030 load_auto_scripts_for_objfile (struct objfile *objfile)
1032 /* Return immediately if auto-loading has been globally disabled.
1033 This is to handle sequencing of operations during gdb startup.
1034 Also return immediately if OBJFILE is not actually a file. */
1035 if (!global_auto_load || (objfile->flags & OBJF_NOT_FILENAME) != 0)
1038 /* Load any extension language scripts for this objfile.
1039 E.g., foo-gdb.gdb, foo-gdb.py. */
1040 auto_load_ext_lang_scripts_for_objfile (objfile);
1042 /* Load any scripts mentioned in AUTO_SECTION_NAME (.debug_gdb_scripts). */
1043 auto_load_section_scripts (objfile, AUTO_SECTION_NAME);
1046 /* This is a new_objfile observer callback to auto-load scripts.
1048 Two flavors of auto-loaded scripts are supported.
1049 1) based on the path to the objfile
1050 2) from .debug_gdb_scripts section */
1053 auto_load_new_objfile (struct objfile *objfile)
1057 /* OBJFILE is NULL when loading a new "main" symbol-file. */
1058 clear_section_scripts ();
1062 load_auto_scripts_for_objfile (objfile);
1065 /* Collect scripts to be printed in a vec. */
1067 typedef struct loaded_script *loaded_script_ptr;
1068 DEF_VEC_P (loaded_script_ptr);
1070 struct collect_matching_scripts_data
1072 VEC (loaded_script_ptr) **scripts_p;
1074 const struct extension_language_defn *language;
1077 /* Traversal function for htab_traverse.
1078 Collect the entry if it matches the regexp. */
1081 collect_matching_scripts (void **slot, void *info)
1083 struct loaded_script *script = *slot;
1084 struct collect_matching_scripts_data *data = info;
1086 if (script->language == data->language && re_exec (script->name))
1087 VEC_safe_push (loaded_script_ptr, *data->scripts_p, script);
1095 print_script (struct loaded_script *script)
1097 struct ui_out *uiout = current_uiout;
1098 struct cleanup *chain;
1100 chain = make_cleanup_ui_out_tuple_begin_end (uiout, NULL);
1102 ui_out_field_string (uiout, "loaded", script->loaded ? "Yes" : "No");
1103 ui_out_field_string (uiout, "script", script->name);
1104 ui_out_text (uiout, "\n");
1106 /* If the name isn't the full path, print it too. */
1107 if (script->full_path != NULL
1108 && strcmp (script->name, script->full_path) != 0)
1110 ui_out_text (uiout, "\tfull name: ");
1111 ui_out_field_string (uiout, "full_path", script->full_path);
1112 ui_out_text (uiout, "\n");
1115 do_cleanups (chain);
1118 /* Helper for info_auto_load_scripts to sort the scripts by name. */
1121 sort_scripts_by_name (const void *ap, const void *bp)
1123 const struct loaded_script *a = *(const struct loaded_script **) ap;
1124 const struct loaded_script *b = *(const struct loaded_script **) bp;
1126 return FILENAME_CMP (a->name, b->name);
1129 /* Special internal GDB value of auto_load_info_scripts's PATTERN identify
1130 the "info auto-load XXX" command has been executed through the general
1131 "info auto-load" invocation. Extra newline will be printed if needed. */
1132 char auto_load_info_scripts_pattern_nl[] = "";
1134 /* Implementation for "info auto-load gdb-scripts"
1135 (and "info auto-load python-scripts"). List scripts in LANGUAGE matching
1136 PATTERN. FROM_TTY is the usual GDB boolean for user interactivity. */
1139 auto_load_info_scripts (char *pattern, int from_tty,
1140 const struct extension_language_defn *language)
1142 struct ui_out *uiout = current_uiout;
1143 struct auto_load_pspace_info *pspace_info;
1144 struct cleanup *script_chain;
1145 VEC (loaded_script_ptr) *scripts;
1150 pspace_info = get_auto_load_pspace_data (current_program_space);
1152 if (pattern && *pattern)
1154 char *re_err = re_comp (pattern);
1157 error (_("Invalid regexp: %s"), re_err);
1164 /* We need to know the number of rows before we build the table.
1165 Plus we want to sort the scripts by name.
1166 So first traverse the hash table collecting the matching scripts. */
1168 scripts = VEC_alloc (loaded_script_ptr, 10);
1169 script_chain = make_cleanup (VEC_cleanup (loaded_script_ptr), &scripts);
1171 if (pspace_info != NULL && pspace_info->loaded_scripts != NULL)
1173 struct collect_matching_scripts_data data = { &scripts, language };
1175 /* Pass a pointer to scripts as VEC_safe_push can realloc space. */
1176 htab_traverse_noresize (pspace_info->loaded_scripts,
1177 collect_matching_scripts, &data);
1180 nr_scripts = VEC_length (loaded_script_ptr, scripts);
1182 /* Table header shifted right by preceding "gdb-scripts: " would not match
1184 if (nr_scripts > 0 && pattern == auto_load_info_scripts_pattern_nl)
1185 ui_out_text (uiout, "\n");
1187 make_cleanup_ui_out_table_begin_end (uiout, 2, nr_scripts,
1188 "AutoLoadedScriptsTable");
1190 ui_out_table_header (uiout, 7, ui_left, "loaded", "Loaded");
1191 ui_out_table_header (uiout, 70, ui_left, "script", "Script");
1192 ui_out_table_body (uiout);
1197 loaded_script_ptr script;
1199 qsort (VEC_address (loaded_script_ptr, scripts),
1200 VEC_length (loaded_script_ptr, scripts),
1201 sizeof (loaded_script_ptr), sort_scripts_by_name);
1202 for (i = 0; VEC_iterate (loaded_script_ptr, scripts, i, script); ++i)
1203 print_script (script);
1206 do_cleanups (script_chain);
1208 if (nr_scripts == 0)
1210 if (pattern && *pattern)
1211 ui_out_message (uiout, 0, "No auto-load scripts matching %s.\n",
1214 ui_out_message (uiout, 0, "No auto-load scripts.\n");
1218 /* Wrapper for "info auto-load gdb-scripts". */
1221 info_auto_load_gdb_scripts (char *pattern, int from_tty)
1223 auto_load_info_scripts (pattern, from_tty, &extension_language_gdb);
1226 /* Implement 'info auto-load local-gdbinit'. */
1229 info_auto_load_local_gdbinit (char *args, int from_tty)
1231 if (auto_load_local_gdbinit_pathname == NULL)
1232 printf_filtered (_("Local .gdbinit file was not found.\n"));
1233 else if (auto_load_local_gdbinit_loaded)
1234 printf_filtered (_("Local .gdbinit file \"%s\" has been loaded.\n"),
1235 auto_load_local_gdbinit_pathname);
1237 printf_filtered (_("Local .gdbinit file \"%s\" has not been loaded.\n"),
1238 auto_load_local_gdbinit_pathname);
1241 /* Return non-zero if UNSUPPORTED_SCRIPT_WARNING_PRINTED of PSPACE_INFO was
1242 unset before calling this function. Always set
1243 UNSUPPORTED_SCRIPT_WARNING_PRINTED of PSPACE_INFO. */
1246 unsupported_script_warning_print (struct auto_load_pspace_info *pspace_info)
1248 int retval = !pspace_info->unsupported_script_warning_printed;
1250 pspace_info->unsupported_script_warning_printed = 1;
1255 /* Return non-zero if SCRIPT_NOT_FOUND_WARNING_PRINTED of PSPACE_INFO was unset
1256 before calling this function. Always set SCRIPT_NOT_FOUND_WARNING_PRINTED
1260 script_not_found_warning_print (struct auto_load_pspace_info *pspace_info)
1262 int retval = !pspace_info->script_not_found_warning_printed;
1264 pspace_info->script_not_found_warning_printed = 1;
1269 /* The only valid "set auto-load" argument is off|0|no|disable. */
1272 set_auto_load_cmd (char *args, int from_tty)
1274 struct cmd_list_element *list;
1277 /* See parse_binary_operation in use by the sub-commands. */
1279 length = args ? strlen (args) : 0;
1281 while (length > 0 && (args[length - 1] == ' ' || args[length - 1] == '\t'))
1284 if (length == 0 || (strncmp (args, "off", length) != 0
1285 && strncmp (args, "0", length) != 0
1286 && strncmp (args, "no", length) != 0
1287 && strncmp (args, "disable", length) != 0))
1288 error (_("Valid is only global 'set auto-load no'; "
1289 "otherwise check the auto-load sub-commands."));
1291 for (list = *auto_load_set_cmdlist_get (); list != NULL; list = list->next)
1292 if (list->var_type == var_boolean)
1294 gdb_assert (list->type == set_cmd);
1295 do_set_command (args, from_tty, list);
1299 /* Initialize "set auto-load " commands prefix and return it. */
1301 struct cmd_list_element **
1302 auto_load_set_cmdlist_get (void)
1304 static struct cmd_list_element *retval;
1307 add_prefix_cmd ("auto-load", class_maintenance, set_auto_load_cmd, _("\
1308 Auto-loading specific settings.\n\
1309 Configure various auto-load-specific variables such as\n\
1310 automatic loading of Python scripts."),
1311 &retval, "set auto-load ",
1312 1/*allow-unknown*/, &setlist);
1317 /* Command "show auto-load" displays summary of all the current
1318 "show auto-load " settings. */
1321 show_auto_load_cmd (char *args, int from_tty)
1323 cmd_show_list (*auto_load_show_cmdlist_get (), from_tty, "");
1326 /* Initialize "show auto-load " commands prefix and return it. */
1328 struct cmd_list_element **
1329 auto_load_show_cmdlist_get (void)
1331 static struct cmd_list_element *retval;
1334 add_prefix_cmd ("auto-load", class_maintenance, show_auto_load_cmd, _("\
1335 Show auto-loading specific settings.\n\
1336 Show configuration of various auto-load-specific variables such as\n\
1337 automatic loading of Python scripts."),
1338 &retval, "show auto-load ",
1339 0/*allow-unknown*/, &showlist);
1344 /* Command "info auto-load" displays whether the various auto-load files have
1345 been loaded. This is reimplementation of cmd_show_list which inserts
1346 newlines at proper places. */
1349 info_auto_load_cmd (char *args, int from_tty)
1351 struct cmd_list_element *list;
1352 struct cleanup *infolist_chain;
1353 struct ui_out *uiout = current_uiout;
1355 infolist_chain = make_cleanup_ui_out_tuple_begin_end (uiout, "infolist");
1357 for (list = *auto_load_info_cmdlist_get (); list != NULL; list = list->next)
1359 struct cleanup *option_chain
1360 = make_cleanup_ui_out_tuple_begin_end (uiout, "option");
1362 gdb_assert (!list->prefixlist);
1363 gdb_assert (list->type == not_set_cmd);
1365 ui_out_field_string (uiout, "name", list->name);
1366 ui_out_text (uiout, ": ");
1367 cmd_func (list, auto_load_info_scripts_pattern_nl, from_tty);
1369 /* Close the tuple. */
1370 do_cleanups (option_chain);
1373 /* Close the tuple. */
1374 do_cleanups (infolist_chain);
1377 /* Initialize "info auto-load " commands prefix and return it. */
1379 struct cmd_list_element **
1380 auto_load_info_cmdlist_get (void)
1382 static struct cmd_list_element *retval;
1385 add_prefix_cmd ("auto-load", class_info, info_auto_load_cmd, _("\
1386 Print current status of auto-loaded files.\n\
1387 Print whether various files like Python scripts or .gdbinit files have been\n\
1388 found and/or loaded."),
1389 &retval, "info auto-load ",
1390 0/*allow-unknown*/, &infolist);
1395 void _initialize_auto_load (void);
1398 _initialize_auto_load (void)
1400 struct cmd_list_element *cmd;
1401 char *scripts_directory_help, *gdb_name_help, *python_name_help;
1402 char *guile_name_help;
1405 auto_load_pspace_data
1406 = register_program_space_data_with_cleanup (NULL,
1407 auto_load_pspace_data_cleanup);
1409 observer_attach_new_objfile (auto_load_new_objfile);
1411 add_setshow_boolean_cmd ("gdb-scripts", class_support,
1412 &auto_load_gdb_scripts, _("\
1413 Enable or disable auto-loading of canned sequences of commands scripts."), _("\
1414 Show whether auto-loading of canned sequences of commands scripts is enabled."),
1416 If enabled, canned sequences of commands are loaded when the debugger reads\n\
1417 an executable or shared library.\n\
1418 This options has security implications for untrusted inferiors."),
1419 NULL, show_auto_load_gdb_scripts,
1420 auto_load_set_cmdlist_get (),
1421 auto_load_show_cmdlist_get ());
1423 add_cmd ("gdb-scripts", class_info, info_auto_load_gdb_scripts,
1424 _("Print the list of automatically loaded sequences of commands.\n\
1425 Usage: info auto-load gdb-scripts [REGEXP]"),
1426 auto_load_info_cmdlist_get ());
1428 add_setshow_boolean_cmd ("local-gdbinit", class_support,
1429 &auto_load_local_gdbinit, _("\
1430 Enable or disable auto-loading of .gdbinit script in current directory."), _("\
1431 Show whether auto-loading .gdbinit script in current directory is enabled."),
1433 If enabled, canned sequences of commands are loaded when debugger starts\n\
1434 from .gdbinit file in current directory. Such files are deprecated,\n\
1435 use a script associated with inferior executable file instead.\n\
1436 This options has security implications for untrusted inferiors."),
1437 NULL, show_auto_load_local_gdbinit,
1438 auto_load_set_cmdlist_get (),
1439 auto_load_show_cmdlist_get ());
1441 add_cmd ("local-gdbinit", class_info, info_auto_load_local_gdbinit,
1442 _("Print whether current directory .gdbinit file has been loaded.\n\
1443 Usage: info auto-load local-gdbinit"),
1444 auto_load_info_cmdlist_get ());
1446 auto_load_dir = xstrdup (AUTO_LOAD_DIR);
1448 suffix = ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_GDB));
1451 GDB scripts: OBJFILE%s\n"),
1453 python_name_help = NULL;
1455 suffix = ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_PYTHON));
1458 Python scripts: OBJFILE%s\n"),
1461 guile_name_help = NULL;
1463 suffix = ext_lang_auto_load_suffix (get_ext_lang_defn (EXT_LANG_GUILE));
1466 Guile scripts: OBJFILE%s\n"),
1469 scripts_directory_help
1471 Automatically loaded scripts are located in one of the directories listed\n\
1477 This option is ignored for the kinds of scripts \
1478 having 'set auto-load ... off'.\n\
1479 Directories listed here need to be present also \
1480 in the 'set auto-load safe-path'\n\
1483 python_name_help ? python_name_help : "",
1484 guile_name_help ? guile_name_help : "");
1486 add_setshow_optional_filename_cmd ("scripts-directory", class_support,
1487 &auto_load_dir, _("\
1488 Set the list of directories from which to load auto-loaded scripts."), _("\
1489 Show the list of directories from which to load auto-loaded scripts."),
1490 scripts_directory_help,
1491 set_auto_load_dir, show_auto_load_dir,
1492 auto_load_set_cmdlist_get (),
1493 auto_load_show_cmdlist_get ());
1494 xfree (scripts_directory_help);
1495 xfree (python_name_help);
1496 xfree (gdb_name_help);
1497 xfree (guile_name_help);
1499 auto_load_safe_path = xstrdup (AUTO_LOAD_SAFE_PATH);
1500 auto_load_safe_path_vec_update ();
1501 add_setshow_optional_filename_cmd ("safe-path", class_support,
1502 &auto_load_safe_path, _("\
1503 Set the list of files and directories that are safe for auto-loading."), _("\
1504 Show the list of files and directories that are safe for auto-loading."), _("\
1505 Various files loaded automatically for the 'set auto-load ...' options must\n\
1506 be located in one of the directories listed by this option. Warning will be\n\
1507 printed and file will not be used otherwise.\n\
1508 You can mix both directory and filename entries.\n\
1509 Setting this parameter to an empty list resets it to its default value.\n\
1510 Setting this parameter to '/' (without the quotes) allows any file\n\
1511 for the 'set auto-load ...' options. Each path entry can be also shell\n\
1512 wildcard pattern; '*' does not match directory separator.\n\
1513 This option is ignored for the kinds of files having 'set auto-load ... off'.\n\
1514 This options has security implications for untrusted inferiors."),
1515 set_auto_load_safe_path,
1516 show_auto_load_safe_path,
1517 auto_load_set_cmdlist_get (),
1518 auto_load_show_cmdlist_get ());
1519 observer_attach_gdb_datadir_changed (auto_load_gdb_datadir_changed);
1521 cmd = add_cmd ("add-auto-load-safe-path", class_support,
1522 add_auto_load_safe_path,
1523 _("Add entries to the list of directories from which it is safe "
1524 "to auto-load files.\n\
1525 See the commands 'set auto-load safe-path' and 'show auto-load safe-path' to\n\
1526 access the current full list setting."),
1528 set_cmd_completer (cmd, filename_completer);
1530 add_setshow_boolean_cmd ("auto-load", class_maintenance,
1531 &debug_auto_load, _("\
1532 Set auto-load verifications debugging."), _("\
1533 Show auto-load verifications debugging."), _("\
1534 When non-zero, debugging output for files of 'set auto-load ...'\n\
1536 NULL, show_debug_auto_load,
1537 &setdebuglist, &showdebuglist);