From 1564a2618d1766c3ea3a27dfa2ae77fe4ef51ef3 Mon Sep 17 00:00:00 2001 From: Jan Kratochvil Date: Sun, 20 May 2012 20:35:19 +0000 Subject: gdb/ * NEWS (--with-auto-load-dir): Prepend $debugdir to the default path. Describe it. * auto-load.c (auto_load_expand_dir_vars): New function. (auto_load_safe_path_vec_update): Use it, remove the substitute_path_component call thanks to it. (auto_load_objfile_script): Remove the debug_file_directory processing. Use auto_load_expand_dir_vars, remove the substitute_path_component call thanks to it. * configure: Regenerate. * configure.ac (--with-auto-load-dir): Prepend $debugdir to the default path. Escape $ also for $debugdir. (--with_auto_load_safe_path): Escape $ also for $debugdir. * utils.c (substitute_path_component): Accept also DIRNAME_SEPARATOR. gdb/doc/ * gdb.texinfo (Separate Debug Files): New anchor debug-file-directory. Mention also --with-separate-debug-dir. (Auto-loading): Prepend $debugdir in the sample output. (Auto-loading safe path): Likewise. Mention also $debugdir for the auto-load safe-path variable. (objfile-gdb.py file): Remove the extra debug-file-directory paragraph. Mention also $debugdir for 'set auto-load scripts-directory'. --- gdb/doc/ChangeLog | 10 ++++++++++ gdb/doc/gdb.texinfo | 52 +++++++++++++++++++++++++++------------------------- 2 files changed, 37 insertions(+), 25 deletions(-) (limited to 'gdb/doc') diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 360d95b..70e4e41 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,13 @@ +2012-05-20 Jan Kratochvil + + * gdb.texinfo (Separate Debug Files): New anchor debug-file-directory. + Mention also --with-separate-debug-dir. + (Auto-loading): Prepend $debugdir in the sample output. + (Auto-loading safe path): Likewise. Mention also $debugdir for the + auto-load safe-path variable. + (objfile-gdb.py file): Remove the extra debug-file-directory paragraph. + Mention also $debugdir for 'set auto-load scripts-directory'. + 2012-05-19 Eli Zaretskii * gdb.texinfo (Continuing and Stepping, Selection, Byte Order) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 790eea1..c12f976 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -16465,8 +16465,11 @@ debug information files, in the indicated order: @file{/usr/lib/debug/usr/bin/ls.debug}. @end itemize -You can set the global debugging info directories, and view the -list @value{GDBN} is currently using. +@anchor{debug-file-directory} +Global debugging info directories default to what is set by @value{GDBN} +configure option @option{--with-separate-debug-dir}. During @value{GDBN} run +you can also set the global debugging info directories, and view the list +@value{GDBN} is currently using. @table @code @@ -21232,9 +21235,9 @@ local-gdbinit: Auto-loading of .gdbinit script from current directory is on. python-scripts: Auto-loading of Python scripts is on. safe-path: List of directories from which it is safe to auto-load files - is $datadir/auto-load. + is $debugdir:$datadir/auto-load. scripts-directory: List of directories from which to load auto-loaded scripts - is $datadir/auto-load. + is $debugdir:$datadir/auto-load. @end smallexample @anchor{info auto-load} @@ -21450,9 +21453,11 @@ get loaded: $ ./gdb -q ./gdb Reading symbols from /home/user/gdb/gdb...done. warning: File "/home/user/gdb/gdb-gdb.gdb" auto-loading has been - declined by your `auto-load safe-path' set to "$datadir/auto-load". + declined by your `auto-load safe-path' set + to "$debugdir:$datadir/auto-load". warning: File "/home/user/gdb/gdb-gdb.py" auto-loading has been - declined by your `auto-load safe-path' set to "$datadir/auto-load". + declined by your `auto-load safe-path' set + to "$debugdir:$datadir/auto-load". @end smallexample The list of trusted directories is controlled by the following commands: @@ -21485,11 +21490,10 @@ host platform path separator in use. @end table This variable defaults to what @code{--with-auto-load-dir} has been configured -to (@pxref{with-auto-load-dir}). @file{$datadir} substituation applies the same -as for @xref{set auto-load scripts-directory}. -The default @code{set -auto-load safe-path} value can be also overriden by @value{GDBN} configuration -option @option{--with-auto-load-safe-path}. +to (@pxref{with-auto-load-dir}). @file{$debugdir} and @file{$datadir} +substitution applies the same as for @ref{set auto-load scripts-directory}. +The default @code{set auto-load safe-path} value can be also overriden by +@value{GDBN} configuration option @option{--with-auto-load-safe-path}. Setting this variable to @file{/} disables this security protection, corresponding @value{GDBN} configuration option is @@ -25701,12 +25705,7 @@ that the file name is absolute, following all symlinks, and resolving @code{.} and @code{..} components. If this file exists and is readable, @value{GDBN} will evaluate it as a Python script. -If this file does not exist, and if the parameter -@code{debug-file-directory} is set (@pxref{Separate Debug Files}), -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 +If this file does not exist, then @value{GDBN} will look for @var{script-name} file in all of the directories as specified below. Note that loading of this script file also requires accordingly configured @@ -25724,14 +25723,17 @@ Each entry here needs to be covered also by the security setting @code{set auto-load safe-path} (@pxref{set auto-load safe-path}). @anchor{with-auto-load-dir} -This variable defaults to @file{$datadir/auto-load}. The default @code{set -auto-load safe-path} value can be also overriden by @value{GDBN} configuration -option @option{--with-auto-load-dir}. - -Any used string @file{$datadir} will get replaced by @var{data-directory} which -is determined at @value{GDBN} startup (@pxref{Data Files}). @file{$datadir} -must be placed as a directory component --- either alone or delimited by -@file{/} or @file{\} directory separators, depending on the host platform. +This variable defaults to @file{$debugdir:$datadir/auto-load}. The default +@code{set auto-load safe-path} value can be also overriden by @value{GDBN} +configuration option @option{--with-auto-load-dir}. + +Any reference to @file{$debugdir} will get replaced by +@var{debug-file-directory} value (@pxref{Separate Debug Files}) and any +reference to @file{$datadir} will get replaced by @var{data-directory} which is +determined at @value{GDBN} startup (@pxref{Data Files}). @file{$debugdir} and +@file{$datadir} must be placed as a directory component --- either alone or +delimited by @file{/} or @file{\} directory separators, depending on the host +platform. The list of directories uses path separator (@samp{:} on GNU and Unix systems, @samp{;} on MS-Windows and MS-DOS) to separate directories, similarly -- cgit v1.1