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

コアイメージファイル名の最初の部分の core を filename に置き換えます。filename には、coreadm(1M) のパスと同じ拡張トークンを含めることができます。

-p

coreadm(1M) によって構成されたとおりに、プロセス固有のコンテンツを使用して、プロセス固有の場所にコアイメージファイルを生成します。ユーザーがプロセスごとのコアファイルリポジトリへのアクセス権を持っていない場合、このコマンドは失敗します。

オペランド

次のオペランドがサポートされています。

process-id

プロセス ID

使用法

-F フラグを使用するときは注意してください。2 つの制御プロセスを 1 つの犠牲プロセスに課すと混乱することがあります。一次制御プロセス (通常はデバッガ) が犠牲プロセスを停止しており、一次制御プロセスが当該の proc ツールの適用時に何も実行していない場合のみ、安全性が確保されます。

終了ステータス

次の終了値が返されます。

0

成功の場合。

0 以外

失敗した場合 (存在しないプロセス ID など)。

ファイル

core.process-id

コアイメージ

属性

属性についての詳細は、attributes(5) を参照してください。

コマンドの構文は「確実」です。出力形式は「不確実」です。

関連項目

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

注意事項

gcore は、RLIMIT_CORE 値を使用した setrlimit(2) システムコールによる影響を受けません。