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

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

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

home | help