gcore(1) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

gcore(1)

gcore(1)                         User Commands                        gcore(1)



NAME
       gcore - get core images of running processes

SYNOPSIS
       gcore [-pgFR] [-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 is 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 core‐
                      adm(8).  The  -c option does not apply to cores produced
                      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 repos‐
                      itory with the global content  as  configured  by  core‐
                      adm(8). The command fails if the user does not have per‐
                      missions 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(8).


       -p             Produces a core image file in the process-specific loca‐
                      tion with the process-specific content for each  process
                      as  configured  by  coreadm(8). The command fails if the
                      user does not have permissions to the  per-process  core
                      file repository.


       -P             By   default,  gcore  takes  into  account  any  pruning
                      requests that were made using memcntl(2)  and  are  cur‐
                      rently  active in the process' address space. Specifying
                      this flag while using gcore  on  such  a  process  would
                      result  in  any  active  pruning  requests being ignored
                      while dumping the core of the process.


       -R             Bring in the content of the  process  to  memory  before
                      dumping  its  core. This is a best effort and pages read
                      are not locked. For  large  processes,  this  option  is
                      expected to shorten the time they remain stopped, at the
                      cost of increasing the total time of  execution  of  the
                      command.


OPERANDS
       The following operand is supported:

       process-id    process ID


USAGE
       Caution  should  be exercised when using the -F flag. Imposing two con‐
       trolling processes on one victim process can lead to chaos.  Safety  is
       assured  only if the primary controlling process, typically a debugger,
       has stopped the victim process and the primary controlling  process  is
       doing  nothing  at  the moment of application of the proc tool in ques‐
       tion.

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(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE  _  Availabilitysystem/core-os  _ Interface StabilitySee
       below.



       The command syntax is Committed. The Output Formats are Uncommitted.

SEE ALSO
       kill(1), setrlimit(2),  core(5),  proc(5),  attributes(7),  memcntl(2),
       coreadm(8)

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



Oracle Solaris 11.4               21 Nov 2020                         gcore(1)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3