gcore(1)

名称

gcore - 获取正在运行的进程的核心映像

用法概要

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

描述

gcore 实用程序为每个指定的进程创建核心映像。缺省情况下，其进程 ID 为 process-id 的进程的核心映像文件名为 core.process-id。

选项

支持以下选项：

–c content

使用指定的内容生成核心映像文件。内容描述使用的标记与 coreadm(1M) 中使用的标记相同。–c 选项不适用于使用 –p 或 –g 标志生成的核心。

–F

强制。抓取目标进程，即使另一进程已掌握了控制权。

–g

使用 coreadm(1M) 配置的全局内容在全局核心文件系统信息库中生成核心映像文件。如果用户对全局核心文件系统信息库没有权限，则该命令会失败。

–o filename

使用 filename 替换 core 作为核心映像文件名称的第一个部件。filename 可以包含要展开的与 coreadm (1M) 中的路径相同的标记。

–p

根据 coreadm(1M) 的配置使用特定于进程的内容在特定于进程的位置为每个进程生成核心映像文件。如果用户对每进程核心文件系统信息库没有权限，则该命令会失败。

操作数

支持下列操作数：

process-id

进程 ID

用法

使用 –F 标志时应谨慎。在一个被调试的进程上施加两个控制进程可能会导致混乱。仅当主控制进程（通常是调试器）已停止了被调试的进程，并且在应用 proc 工具的可疑时刻主控制进程未在执行任何操作，才能保证安全。

退出状态

将返回以下退出值：

0

成功时返回。

非零

失败时，例如进程 ID 不存在。

文件

core.process-id

核心映像

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 system/core-os 接口稳定性 请参见下文。

命令语法是 "Committed"（已确定）。输出格式是 "Uncommitted"（未确定）。

另请参见

kill(1)、coreadm(1M)、setrlimit(2)、core(4)、proc(4)、attributes(5)

附注

gcore 不受使用 RLIMIT_CORE 值的 setrlimit(2) 系统调用影响。