DragonFly On-Line Manual Pages

GCORE(1)               DragonFly General Commands Manual              GCORE(1)

NAME
     gcore -- get core images of running process

SYNOPSIS
     gcore [-sv] [-c core] [-l seglimit] [executable] pid

DESCRIPTION
     The gcore utility creates a core image of the specified process, suitable
     for use with gdb(1).  By default, the core is written to the file
     ``core.<pid>''.  The process identifier, pid, must be given on the
     command line.  If no executable image is specified, gcore will use
     ``/proc/<pid>/file''.

     The following options are available:

     -c      Write the core file to the specified file instead of
             ``core.<pid>''.

     -l seglimit
             Tells gcore to skip map segments larger than the specified limit,
             in bytes.  Specify a suffix 'k', 'm', 'g', or 't' for kilobytes,
             etc.  Segments ignored due to the option will be reported.

     -s      Stop the process while gathering the core image, and resume it
             when done.  This guarantees that the resulting core dump will be
             in a consistent state.  The process is resumed even if it was
             already stopped.  The same effect can be achieved manually with
             kill(1).

     -v      Verbosely print out the map segments being dumped.

FILES
     core.<pid>         the core image
     /proc/<pid>/file   the executable image

HISTORY
     A gcore utility appeared in 4.2BSD.

BUGS
     Context switches or paging activity that occur while gcore is running may
     cause the program to become confused.  For best results, use -s to
     temporarily stop the target process.

     The gcore utility is not compatible with the original 4.2BSD version.

DragonFly 5.5                  February 2, 2019                  DragonFly 5.5