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

FreeBSD Manual Pages

  
 
  

home | help
gcore(1)			 User Commands			      gcore(1)

NAME
       gcore - get core	images of running processes

SYNOPSIS
       gcore [-pgF] [-o	filename] [-c content] process-id...

DESCRIPTION
       The  gcore  utility  creates a core image of each specified process. By
       default,	the name of the	core image file	for the	process	whose  process
       ID is process-id	will be	core.process-id.

OPTIONS
       The following options are supported:

       -c content      Produces	 core  image files with	the specified content.
		       The content description uses  the  same	tokens	as  in
		       coreadm(1M). The	-c option does not apply to cores pro-
		       duced due to the	-p or -g flags.

       -F	       Force.  Grabs  the  target  process  even  if   another
		       process has control.

       -g	       Produces	 core  image  files  in	 the  global core file
		       repository with the global  content  as	configured  by
		       coreadm(1M). The	command	will fail if the user does not
		       have permissions	to the global core file	repository.

       -o filename     Substitutes filename in place of	core as	the first part
		       of  the name of the core	image files. filename can con-
		       tain the	same tokens to be expanded  as	the  paths  in
		       coreadm(1M).

       -p	       Produces	 a core	image file in the process-specific lo-
		       cation  with  the  process-specific  content  for  each
		       process	as configured by coreadm(1M). The command will
		       fail if the user	does not have permissions to the  per-
		       process core file repository.

OPERANDS
       The following operand is	supported:

       process-id      process ID

EXIT STATUS
       The following exit values are returned:

       0	       On success.

       non-zero	       On failure, such	as non-existent	process	ID.

FILES
       core.process-id	       core images

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWtoo			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |See below.		   |
       +-----------------------------+-----------------------------+

       Command Syntax is Evolving. Output Format(s) are	Unstable.

SEE ALSO
       kill(1),	coreadm(1M), setrlimit(2), core(4), proc(4), attributes(5)

NOTES
       gcore   is  unaffected  by  the	setrlimit(2)  system  call  using  the
       RLIMIT_CORE value.

SunOS 5.10			  11 Feb 2004			      gcore(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gcore&sektion=1&manpath=SunOS+5.10>

home | help