* gdb.texinfo (Core File Generation): New section.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 920ccb5f7b949cd5024d91a90209cbb8d953a2d7..466c92982d6cacde7f840cb1ab8f51cc8fe5d01a 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -9,6 +9,7 @@
        is first used, and add an index entry for the term.
        (Calling): Expand and elaborate text.  Add "print".  Add the
        description of problems with weak aliases.
+       (Core File Generation): New section.
 
 2004-10-12  Andrew Cagney  <cagney@gnu.org>
 

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 3d424951995441d7167d8b897c65fe491fc8f88c..b78e7b77d87252014c1bcbf61b2e08ad4eba51da 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -4780,6 +4780,7 @@ Table}.
 * Auxiliary Vector::            Auxiliary data provided by operating system
 * Memory Region Attributes::    Memory region attributes
 * Dump/Restore Files::          Copy between memory and a file
+* Core File Generation::        Cause a program dump its core
 * Character Sets::              Debugging programs that use a different
                                 character set than GDB does
 @end menu
@@ -6176,6 +6177,36 @@ the @var{bias} argument is applied.
 
 @end table
 
+@node Core File Generation
+@section How to Produce a Core File from Your Program
+@cindex dump core from inferior
+
+A @dfn{core file} or @dfn{core dump} is a file that records the memory
+image of a running process and its process status (register values
+etc.).  Its primary use is post-mortem debugging of a program that
+crashed while it ran outside a debugger.  A program that crashes
+automatically produces a core file, unless this feature is disabled by
+the user.  @xref{Files}, for information on invoking @value{GDBN} in
+the post-mortem debugging mode.
+
+Occasionally, you may wish to produce a core file of the program you
+are debugging in order to preserve a snapshot of its state.
+@value{GDBN} has a special command for that.
+
+@table @code
+@kindex gcore
+@kindex generate-core-file
+@item generate-core-file [@var{file}]
+@itemx gcore [@var{file}]
+Produce a core dump of the inferior process.  The optional argument
+@var{file} 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 inferior process ID.
+
+Note that this command is implemented only for some systems (as of
+this writing, @sc{gnu}/Linux, FreeBSD, Solaris, Unixware, and S390).
+@end table
+
 @node Character Sets
 @section Character Sets
 @cindex character sets