From: Jan Kratochvil Date: Fri, 11 May 2012 18:23:11 +0000 (+0000) Subject: gdb/doc/ X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=c1668e4eee759cf1bbeae6879cbc67f20df32540;p=binutils-gdb.git gdb/doc/ * gdb.texinfo (Auto-loading, Init File in the Current Directory) (libthread_db.so.1 file, objfile-gdb.gdb file, objfile-gdb.py file) (dotdebug_gdb_scripts section): Add reference to 'Auto-loading safe path'. --- diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index d8fb693de76..40329ee67d4 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,10 @@ +2012-05-11 Jan Kratochvil + + * gdb.texinfo (Auto-loading, Init File in the Current Directory) + (libthread_db.so.1 file, objfile-gdb.gdb file, objfile-gdb.py file) + (dotdebug_gdb_scripts section): Add reference + to 'Auto-loading safe path'. + 2012-05-11 Jan Kratochvil Implement multi-component --with-auto-load-dir. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 7a23c699507..38ef0794770 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -20973,6 +20973,10 @@ without being explicitly told so by the user. We call this feature results or introduce security risks (e.g., if the file comes from untrusted sources). +Note that loading of these associated files (including the local @file{.gdbinit} +file) requires accordingly configured @code{auto-load safe-path} +(@pxref{Auto-loading safe path}). + For these reasons, @value{GDBN} includes commands and options to let you control when to auto-load files and which files should be auto-loaded. @@ -21112,6 +21116,9 @@ By default, @value{GDBN} reads and executes the canned sequences of commands from init file (if any) in the current working directory, see @ref{Init File in the Current Directory during Startup}. +Note that loading of this local @file{.gdbinit} file also requires accordingly +configured @code{auto-load safe-path} (@pxref{Auto-loading safe path}). + @table @code @anchor{set auto-load local-gdbinit} @kindex set auto-load local-gdbinit @@ -21148,6 +21155,9 @@ libraries have to be trusted in general. In all other cases of auto-load libthread-db} is enabled before trying to open such thread debugging library. +Note that loading of this debugging library also requires accordingly configured +@code{auto-load safe-path} (@pxref{Auto-loading safe path}). + @table @code @anchor{set auto-load libthread-db} @kindex set auto-load libthread-db @@ -21175,6 +21185,9 @@ for each such library print list of inferior @var{pid}s using it. canned sequences of commands (@pxref{Sequences}), as long as @samp{set auto-load gdb-scripts} is set to @samp{on}. +Note that loading of this script file also requires accordingly configured +@code{auto-load safe-path} (@pxref{Auto-loading safe path}). + For more background refer to the similar Python scripts auto-loading description (@pxref{objfile-gdb.py file}). @@ -25465,7 +25478,10 @@ then @value{GDBN} will look for @var{script-name} in all of the directories mentioned in the value of @code{debug-file-directory}. Finally, if this file does not exist, then @value{GDBN} will look for -@var{script-name} file in all of the directories specified by: +@var{script-name} file in all of the directories as specified below. + +Note that loading of this script file also requires accordingly configured +@code{auto-load safe-path} (@pxref{Auto-loading safe path}). @table @code @anchor{set auto-load scripts-directory} @@ -25542,6 +25558,9 @@ DEFINE_GDB_SCRIPT ("my-app-scripts.py") The script name may include directories if desired. +Note that loading of this script file also requires accordingly configured +@code{auto-load safe-path} (@pxref{Auto-loading safe path}). + If the macro is put in a header, any application or library using this header will get a reference to the specified script.