From b292c7831823605b02a564b0a9274f95141c92ee Mon Sep 17 00:00:00 2001 From: Jan Kratochvil Date: Thu, 11 Apr 2013 14:13:44 +0000 Subject: gdb/ * Makefile.in (HAVE_NATIVE_GCORE_TARGET): New. (generated_files): Add gcore. (install-only, uninstall): Add gcore if HAVE_NATIVE_GCORE_TARGET or HAVE_NATIVE_GCORE_HOST. (gcore): New. * NEWS (Changes since GDB 7.6): Mention newly installed gcore. * config/alpha/alpha-osf3.mh, config/i386/fbsd.mh, config/i386/fbsd64.mh, config/i386/i386gnu.mh, config/i386/i386sol2.mh, config/i386/sol2-64.mh, config/mips/irix5.mh, config/mips/irix6.mh, config/powerpc/fbsd.mh, config/sparc/fbsd.mh, config/sparc/sol2.mh: Add HAVE_NATIVE_GCORE_HOST. * configure: Regenerate. * configure.ac (HAVE_NATIVE_GCORE_TARGET): New, set it, AC_SUBST it. New AC_SUBST fir GDB_TRANSFORM_NAME and GCORE_TRANSFORM_NAME. New AC_CONFIG_FILES for gcore. * configure.tgt: Add gdb_have_gcore to the initial comment. Set gdb_have_gcore. * gdb_gcore.sh: Rename to ... * gcore.in: ... here. Remove gcore.sh comment. Use GDB_TRANSFORM_NAME and GCORE_TRANSFORM_NAME substitutions. gdb/doc/ * Makefile.in (MAN1S): Add gcore.1. Remove "Host, target, and site specific Makefile fragments" comment. (@host_makefile_frag@, HAVE_NATIVE_GCORE_TARGET): New. (install-man1, uninstall-man1): Conditionalize gcore.1. (gcore.1): New. * gdb.texinfo (Man Pages): Add gcore man. (gcore man): New node. --- gdb/doc/ChangeLog | 10 ++++++++++ gdb/doc/Makefile.in | 27 ++++++++++++++++++++++++--- gdb/doc/gdb.texinfo | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 82 insertions(+), 3 deletions(-) (limited to 'gdb/doc') diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index e55b219..d62a5a6 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,13 @@ +2013-04-11 Jan Kratochvil + + * Makefile.in (MAN1S): Add gcore.1. + Remove "Host, target, and site specific Makefile fragments" comment. + (@host_makefile_frag@, HAVE_NATIVE_GCORE_TARGET): New. + (install-man1, uninstall-man1): Conditionalize gcore.1. + (gcore.1): New. + * gdb.texinfo (Man Pages): Add gcore man. + (gcore man): New node. + 2013-04-10 Pedro Alves * gdb.texinfo (Process Record and Replay): Document that "set diff --git a/gdb/doc/Makefile.in b/gdb/doc/Makefile.in index 70086a3..fdd57d6 100644 --- a/gdb/doc/Makefile.in +++ b/gdb/doc/Makefile.in @@ -177,11 +177,15 @@ POD2MAN5 = pod2man --center="GNU Development Tools" \ --release="gdb-`sed q $(srcdir)/../version.in`" --section=5 # List of man pages generated from gdb.texi -MAN1S = gdb.1 gdbserver.1 +MAN1S = gdb.1 gdbserver.1 gcore.1 MAN5S = gdbinit.5 MANS = $(MAN1S) $(MAN5S) -#### Host, target, and site specific Makefile fragments come in here. +# Host-dependent makefile fragment comes in here. +@host_makefile_frag@ +# End of host-dependent makefile fragment +HAVE_NATIVE_GCORE_TARGET = @HAVE_NATIVE_GCORE_TARGET@ + ### all: @@ -269,6 +273,10 @@ install-man: install-man1 install-man5 install-man1: $(MAN1S) test -z "$(man1dir)" || $(mkinstalldirs) "$(DESTDIR)$(man1dir)" @list='$(MAN1S)'; for p in $$list; do \ + if test "x$(HAVE_NATIVE_GCORE_TARGET)$(HAVE_NATIVE_GCORE_HOST)" = x \ + -a "$$p" = gcore.1; then \ + continue; \ + fi; \ if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ f=`echo $$p | sed -e 's|^.*/||'`; \ echo " $(INSTALL_DATA) '$$d$$p' '$(DESTDIR)$(man1dir)/$$f'"; \ @@ -288,7 +296,13 @@ uninstall-man: uninstall-man1 uninstall-man5 uninstall-man1: @test -n "$(man1dir)" || exit 0; \ - files=`{ l2='$(MAN1S)'; for i in $$l2; do echo "$$i"; done | \ + files=`{ l2='$(MAN1S)'; for i in $$l2; do \ + if test "x$(HAVE_NATIVE_GCORE_TARGET)$(HAVE_NATIVE_GCORE_HOST)" = x \ + -a "$$i" = gcore.1; then \ + continue; \ + fi; \ + echo "$$i"; \ + done | \ sed -n '/\.1[a-z]*$$/p'; \ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ @@ -605,6 +619,13 @@ gdbserver.1: $(GDB_DOC_FILES) mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) rm -f gdbserver.pod +gcore.1: $(GDB_DOC_FILES) + touch $@ + -$(TEXI2POD) $(MANCONF) -Dgcore < $(srcdir)/gdb.texinfo > gcore.pod + -($(POD2MAN1) gcore.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \ + mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) + rm -f gcore.pod + gdbinit.5: $(GDB_DOC_FILES) touch $@ -$(TEXI2POD) $(MANCONF) -Dgdbinit < $(srcdir)/gdb.texinfo > gdbinit.pod diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 15a8894..97d88ec 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -41652,6 +41652,7 @@ switch (die->tag) @menu * gdb man:: The GNU Debugger man page * gdbserver man:: Remote Server for the GNU Debugger man page +* gcore man:: Generate a core file of a running program * gdbinit man:: gdbinit scripts @end menu @@ -42177,6 +42178,53 @@ Richard M. Stallman and Roland H. Pesch, July 1991. @end ifset @c man end +@node gcore man +@heading gcore + +@c man title gcore Generate a core file of a running program + +@format +@c man begin SYNOPSIS gcore +gcore [-o @var{filename}] @var{pid} +@c man end +@end format + +@c man begin DESCRIPTION gcore +Generate a core dump of a running program with process ID @var{pid}. +Produced file is equivalent to a kernel produced core file as if the process +crashed (and if @kbd{ulimit -c} were used to set up an appropriate core dump +limit). Unlike after a crash, after @command{gcore} the program remains +running without any change. +@c man end + +@c man begin OPTIONS gcore +@table @env +@item -o @var{filename} +The optional argument +@var{filename} specifies the file name where to put the core dump. +If not specified, the file name defaults to @file{core.@var{pid}}, +where @var{pid} is the running program process ID. +@end table +@c man end + +@c man begin SEEALSO gcore +@ifset man +The full documentation for @value{GDBN} is maintained as a Texinfo manual. +If the @code{info} and @code{gdb} programs and @value{GDBN}'s Texinfo +documentation are properly installed at your site, the command + +@smallexample +info gdb +@end smallexample + +@noindent +should give you access to the complete manual. + +@cite{Using GDB: A Guide to the GNU Source-Level Debugger}, +Richard M. Stallman and Roland H. Pesch, July 1991. +@end ifset +@c man end + @node gdbinit man @heading gdbinit -- cgit v1.1