NAME    [Toc]    [Back]

     gcore -- get core images of running process

SYNOPSIS    [Toc]    [Back]

     gcore [-s] [-c core] [executable] pid

DESCRIPTION    [Toc]    [Back]

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

     -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    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

     A gcore utility appeared in 4.2BSD.

BUGS    [Toc]    [Back]

     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.


FreeBSD 5.2.1			April 18, 1994			 FreeBSD 5.2.1