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 re‐
                      quests that were made using memcntl(2) and are currently
                      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  ex‐
                      pected  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 be‐
       low.



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

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

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

HISTORY
       The -R option was added in Oracle Solaris 11.4.30.


       The -P option was added in Oracle Solaris 11.3.0.


       The -c, -F, -g, and -p options were added in Solaris 10 3/05.


       The  gcore command, with support for the -o option, has been present in
       all Sun and Oracle releases of Solaris.

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