


GCORE(1)	    UNIX Programmer's Manual		 GCORE(1)



NAME
     gcore - get core image of running process

SYNOPSIS
     gcore [-s][-c core] _p_i_d

DESCRIPTION
     _g_c_o_r_e creates a core image of each specified process, suit-
     able for use with _a_d_b(1).	By default the core image is
     written to the file <_p_i_d>._c_o_r_e.

     The options are:

     -c   Write the core file to the specified file instead of
	  <_p_i_d>._c_o_r_e.

     -s   Stop the process while creating the core image and
	  resume it when done.	This makes sure that the core
	  dump will be in a consistent state.  The process is
	  resumed even if it was already stopped.  Of course, you
	  can obtain the same result by manually stopping the
	  process with kill(1).

     The core image name was changed from _c_o_r_e.<_p_i_d> to
     <_p_i_d>._c_o_r_e to prevent matching names like _c_o_r_e._h and _c_o_r_e._c
     when using programs such as _f_i_n_d(_1).

FILES
     <process-id>.core	 The core image.

BUGS
     If gcore encounters an error while creating the core image
     and the -s option was used the process will remain stopped.

     Swapped out processes and system processes (the swapper) may
     not be gcore'd.



















Printed 11/26/99	 April 15, 1994                         1



