gcore - 実行中のプロセスのコアイメージを取得する
gcore [-pgF] [-o filename] [-c content] process-id...
gcore ユーティリティーは、指定した各プロセスのコアイメージを作成します。デフォルトでは、プロセス ID が process-id のプロセスのコアイメージファイルは、core.process-id という名前になります。
サポートしているオプションは、次のとおりです。
指定したコンテンツを使用してコアイメージファイルを生成します。コンテンツの記述では、coreadm(1M) のトークンと同じトークンを使用します。–c オプションは、–p または –g フラグによって生成されるコアには適用されません。
強制。別のプロセスが制御していても、ターゲットプロセスを捕捉します。
coreadm(1M) によって構成されたとおりに、大域コンテンツを使用してコアイメージファイルを大域コアファイルリポジトリ内に生成します。ユーザーが大域コアファイルリポジトリへのアクセス権を持っていない場合、コマンドは失敗します。
コアイメージファイル名の最初の部分の core を filename に置き換えます。filename には、coreadm(1M) のパスと同じ拡張トークンを含めることができます。
coreadm(1M) によって構成されたとおりに、プロセス固有のコンテンツを使用して、プロセス固有の場所にコアイメージファイルを生成します。ユーザーがプロセスごとのコアファイルリポジトリへのアクセス権を持っていない場合、このコマンドは失敗します。
デフォルトで、gcore はmemcntl(2) を使用して行われたプルーニング要求を考慮し、現在プロセスのアドレス空間でアクティブになっています。そのようなプロセスで gcore の使用中にこのフラグを指定すると、プロセスのコアのダンプ中にアクティブなプルーニング要求が無視されることがあります。
次のオペランドを指定できます。
プロセス ID
–F フラグを使用するときは注意してください。2 つの制御プロセスを 1 つの犠牲プロセスに課すと混乱することがあります。プライマリ制御プロセス (通常はデバッガ) が犠牲プロセスを停止しており、プライマリ制御プロセスが当該の proc ツールの適用時に何も実行していない場合のみ、安全性が確保されます。
次の終了ステータスが返されます。
成功の場合。
失敗した場合 (存在しないプロセス ID など)。
コアイメージ
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
コマンドの構文は「確実」です。出力形式は「不確実」です。
kill(1)、coreadm(1M)、setrlimit(2)、core(4)、proc(4)、attributes(5)、memcntl(2)
gcore は、RLIMIT_CORE 値を使用した setrlimit(2) システムコールによる影響を受けません。