Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
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.

     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

HISTORY
     A gcore utility appeared in 4.2BSD.

BUGS
     Because of	the ptrace(2) usage gcore may not work with processes which
     are actively investigated with truss(1) or	gdb(1).	 Additionally, inter-
     ruptable sleeps may exit with EINTR.

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

FreeBSD	9.3		       November	18, 2009		   FreeBSD 9.3

NAME | SYNOPSIS | DESCRIPTION | FILES | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=gcore&sektion=1&manpath=FreeBSD+8.1-RELEASE>

home | help