From: Eli Zaretskii Date: Sat, 27 Aug 2005 12:05:01 +0000 (+0000) Subject: * main.c (print_gdb_help): Don't advertise the (long non-existent) X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=a94ab19323a1b38220f9d028846030d79fb1ac88;p=binutils-gdb.git * main.c (print_gdb_help): Don't advertise the (long non-existent) option --mapped. * gdb.texinfo (File Options): Don't document --mapped, it's gone since 19-Jan-2004. (Files): Likewise. --- diff --git a/gdb/ChangeLog b/gdb/ChangeLog index c6d2c595128..26f7ed66a3b 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,8 @@ +2005-08-27 Eli Zaretskii + + * main.c (print_gdb_help): Don't advertise the (long non-existent) + option --mapped. + 2005-08-21 Mark Kettenis * doublest.c (floatformat_mantissa): Use xsnprintf instead of diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index a269dda5b23..ce69cf1804c 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +2005-08-27 Eli Zaretskii + + * gdb.texinfo (File Options): Don't document --mapped, it's gone + since 19-Jan-2004. + (Files): Likewise. + 2005-08-01 Fred Fish * gdb.texinfo (SETUP_ARBITRARY_FRAME): Remove obsolete reference. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index fd3f9b8ec6a..79a924b99a1 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -938,25 +938,6 @@ Files,, Command files}. @cindex @code{-d} Add @var{directory} to the path to search for source files. -@item -m -@itemx -mapped -@cindex @code{--mapped} -@cindex @code{-m} -@emph{Warning: this option depends on operating system facilities that are not -supported on all systems.}@* -If memory-mapped files are available on your system through the @code{mmap} -system call, you can use this option -to have @value{GDBN} write the symbols from your -program into a reusable file in the current directory. If the program you are debugging is -called @file{/tmp/fred}, the mapped symbol file is @file{/tmp/fred.syms}. -Future @value{GDBN} debugging sessions notice the presence of this file, -and can quickly map in symbol information from it, rather than reading -the symbol table from the executable program. - -The @file{.syms} file is specific to the host machine where @value{GDBN} -is run. It holds an exact image of the internal @value{GDBN} symbol -table. It cannot be shared across multiple host platforms. - @item -r @itemx -readnow @cindex @code{--readnow} @@ -967,16 +948,6 @@ This makes startup slower, but makes future operations faster. @end table -You typically combine the @code{-mapped} and @code{-readnow} options in -order to build a @file{.syms} file that contains complete symbol -information. (@xref{Files,,Commands to specify files}, for information -on @file{.syms} files.) A simple @value{GDBN} invocation to do nothing -but build a @file{.syms} file for future use is: - -@smallexample -gdb -batch -nx -mapped -readnow programname -@end smallexample - @node Mode Options @subsection Choosing modes @@ -10666,15 +10637,6 @@ directories to search, just as the shell does when looking for a program to run. You can change the value of this variable, for both @value{GDBN} and your program, using the @code{path} command. -On systems with memory-mapped files, an auxiliary file named -@file{@var{filename}.syms} may hold symbol table information for -@var{filename}. If so, @value{GDBN} maps in the symbol table from -@file{@var{filename}.syms}, starting up more quickly. See the -descriptions of the file options @samp{-mapped} and @samp{-readnow} -(available on the command line, see @ref{File Options, , -readnow}, -and with the commands @code{file}, @code{symbol-file}, or -@code{add-symbol-file}, described below), for more information. - @cindex unlinked object files @cindex patching object files You can load unlinked object @file{.o} files into @value{GDBN} using @@ -10745,38 +10707,13 @@ in stabs format. @kindex readnow @cindex reading symbols immediately @cindex symbols, reading immediately -@kindex mapped -@cindex memory-mapped symbol file -@cindex saving symbol table -@item symbol-file @var{filename} @r{[} -readnow @r{]} @r{[} -mapped @r{]} -@itemx file @var{filename} @r{[} -readnow @r{]} @r{[} -mapped @r{]} +@item symbol-file @var{filename} @r{[} -readnow @r{]} +@itemx file @var{filename} @r{[} -readnow @r{]} You can override the @value{GDBN} two-stage strategy for reading symbol tables by using the @samp{-readnow} option with any of the commands that load symbol table information, if you want to be sure @value{GDBN} has the entire symbol table available. -If memory-mapped files are available on your system through the -@code{mmap} system call, you can use another option, @samp{-mapped}, to -cause @value{GDBN} to write the symbols for your program into a reusable -file. Future @value{GDBN} debugging sessions map in symbol information -from this auxiliary symbol file (if the program has not changed), rather -than spending time reading the symbol table from the executable -program. Using the @samp{-mapped} option has the same effect as -starting @value{GDBN} with the @samp{-mapped} command-line option. - -You can use both options together, to make sure the auxiliary symbol -file has all the symbol information for your program. - -The auxiliary symbol file for a program called @var{myprog} is called -@samp{@var{myprog}.syms}. Once this file exists (so long as it is newer -than the corresponding executable), @value{GDBN} always attempts to use -it when you debug @var{myprog}; no special options or commands are -needed. - -The @file{.syms} file is specific to the host machine where you run -@value{GDBN}. It holds an exact image of the internal @value{GDBN} -symbol table. It cannot be shared across multiple host platforms. - @c FIXME: for now no mention of directories, since this seems to be in @c flux. 13mar1992 status is that in theory GDB would look either in @c current dir or in same dir as myprog; but issues like competing @@ -10805,7 +10742,7 @@ the program is running. To do this, use the @code{kill} command @kindex add-symbol-file @cindex dynamic linking @item add-symbol-file @var{filename} @var{address} -@itemx add-symbol-file @var{filename} @var{address} @r{[} -readnow @r{]} @r{[} -mapped @r{]} +@itemx add-symbol-file @var{filename} @var{address} @r{[} -readnow @r{]} @itemx add-symbol-file @var{filename} @r{-s}@var{section} @var{address} @dots{} The @code{add-symbol-file} command reads additional symbol table information from the file @var{filename}. You would use this command @@ -10859,10 +10796,6 @@ way. @code{add-symbol-file} does not repeat if you press @key{RET} after using it. -You can use the @samp{-mapped} and @samp{-readnow} options just as with -the @code{symbol-file} command, to change how @value{GDBN} manages the symbol -table information for @var{filename}. - @kindex add-symbol-file-from-memory @cindex @code{syscall DSO} @cindex load symbols from memory diff --git a/gdb/main.c b/gdb/main.c index 6cd703a708b..f73af20795e 100644 --- a/gdb/main.c +++ b/gdb/main.c @@ -848,7 +848,6 @@ Options:\n\n\ "), stream); fputs_unfiltered (_("\ -l TIMEOUT Set timeout in seconds for remote debugging.\n\ - --mapped Use mapped symbol files if supported on this system.\n\ --nw Do not use a window interface.\n\ --nx Do not read "), stream); fputs_unfiltered (gdbinit, stream);