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.