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

FreeBSD Manual Pages

  
 
  

home | help
GCORE(1)		    General Commands Manual		      GCORE(1)

NAME
       gcore --	get core images	of running process

SYNOPSIS
       gcore [-f] [-k] [-c core] [executable] pid

DESCRIPTION
       The  gcore utility creates a core image of the specified	process, suit-
       able for	use with gdb(1)	(ports/devel/gdb).  By default,	 the  core  is
       written to the file "core._pid_".  The process identifier, pid, must be
       given on	the command line.

       The following options are available:

       -c      Write   the   core  file	 to  the  specified  file  instead  of
	       "core._pid_".

       -f      Dumps all available segments, excluding only malformed and  un-
	       dumpable	 segments.   Unlike  the default invocation, this flag
	       dumps mappings of devices which may invalidate the state	of de-
	       vice transactions or trigger other unexpected behavior.	 As  a
	       result,	this flag should only be used when the behavior	of the
	       application and any devices it has mapped is  fully  understood
	       and any side effects can	be controlled or tolerated.

       -k      Use the ptrace(2) PT_COREDUMP kernel facility to	write the core
	       dump,  instead  of reading the process' memory and constructing
	       the dump	file in	gcore itself.  This is faster, and the dump is
	       written by the same kernel code that writes core	dumps upon fa-
	       tal signals.

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	  being	  investigated	 with	truss(1)   or	gdb(1)
       (ports/devel/gdb).  Additionally, interruptable sleeps  may  exit  with
       EINTR.

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

FreeBSD	13.2			April 24, 2021			      GCORE(1)

NAME | SYNOPSIS | DESCRIPTION | FILES | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gcore&manpath=FreeBSD+14.0-RELEASE+and+Ports>

home | help