unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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
                       location 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:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE   VALUE   AvailabilitySUNWtoo
       Interface StabilitySee 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)