Manual page: gcore(1)

GCORE(1)                FreeBSD General Commands Manual               GCORE(1)

NAME

     gcore -- get core images of running process

SYNOPSIS

     gcore [-s] [-c core] [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 com-
     mand 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>''.

     -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).

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 tempo-
     rarily stop the target process.

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

FreeBSD 7.0                     April 18, 1994                     FreeBSD 7.0