コアダンプファイルの名前

テンプレートの末尾に 1 個だけ % がある場合、その % はコアファイル名には含められない。また、上で列挙されていない % と文字の組み合わせがあった場合も同様である。テンプレートにおける他の文字は、コアファイル名としてそのまま使われる。テンプレートには'/'文字を入れることができ、ディレクトリ名の区切り文字と解釈される。結果として生成されるコアファイル名の最大サイズは 128 バイトである (2.6.19 より前のカーネルでは 64 バイト)。このファイルのデフォルト値は "core"である。以前のものとの互換性のため、 /proc/sys/kernel/core_pattern に "%p"が含まれず、かつ /proc/sys/kernel/core_uses_pid (下記参照) が 0 でない場合は、.PID がコアファイル名に追加される。

バージョン 2.4 以降の Linux ではコアダンプファイルの名前を制御する原始的な方法も提供されている。 /proc/sys/kernel/core_uses_pid ファイルに値 0 が書かれている場合、コアダンプファイルは単純に core という名前になる。このファイルに 0 以外の値が書かれている場合、コアダンプファイルは core.PID という形式の名前になり、ファイル名にプロセス ID が含まれる。

Since Linux 3.6, if /proc/sys/fs/suid_dumpable is set to 2 ("suidsafe"), the pattern must be either an absolute pathname (starting with a leading '/' character) or a pipe, as defined below.

コアダンプのプログラムへのパイプ

*

プログラムは絶対パス名 (もしくはルートディレクトリ / からの相対パス名) で指定されなければならない。また、'|' 文字の直後から始めなければならない。

*

プログラムを実行するために生成されるプロセスは、ユーザ、グループとも root として実行される。

*

コマンドライン引き数をプログラムに与えることができ (Linux 2.6.24 以降)、引き数はホワイトスペースで区切る (1行の最大長は 128 バイトが上限である)。

*

コマンドライン引き数には、上記のリストにある % 指示子を含めることができる。例えば、ダンプされるプロセスの PID を渡すには、引き数に %p を指定する。

どのマッピングをコアダンプに書き込むかを制御する

デフォルトでは、ビット 0, 1, 4, 5 がセットされる。 (ビット 4 がセットされるのは、カーネルが設定オプション CONFIG_CORE_DUMP_DEFAULT_ELF_HEADERS を有効にして作成された場合である)。このファイルの値は 16 進形式で表示される (したがって、デフォルト値は 33 と表示される)。

coredump_filter の値に関わらず、フレームバッファなどの memory-mapped I/O に関するページは決してダンプされず、仮想 DSO ページは常にダンプされる。

fork(2) で作成される子プロセスは親プロセスの coredump_filter の値を継承する。 execve(2) の前後で coredump_filter の値は保持される。

例のように、プログラムを実行する前に親シェルの coredump_filter を設定しておくと役立つことがある。

$ echo 0x7 > /proc/self/coredump_filter
$ ./some_program

このファイルが提供されるのは、カーネルが設定オプション CONFIG_ELF_CORE を有効にして作成された場合だけである。

プログラムのソース

#define _GNU_SOURCE
#include <sys/stat.h>
#include <fcntl.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

#define BUF_SIZE 1024

int
main(int argc, char *argv[])
{
int tot, j;
ssize_t nread;
char buf[BUF_SIZE];
FILE *fp;
char cwd[PATH_MAX];

/* Change our current working directory to that of the
crashing process */

snprintf(cwd, PATH_MAX, "/proc/%s/cwd", argv[1]);
chdir(cwd);

/* Write output to file "core.info" in that directory */

fp = fopen("core.info", "w+");
if (fp == NULL)
exit(EXIT_FAILURE);

/* Display command-line arguments given to core_pattern
pipe program */

fprintf(fp, "argc=%d\n", argc);
for (j = 0; j < argc; j++)
fprintf(fp, "argc[%d]=<%s>\n", j, argv[j]);

/* Count bytes in standard input (the core dump) */

tot = 0;
while ((nread = read(STDIN_FILENO, buf, BUF_SIZE)) > 0)
tot += nread;
fprintf(fp, "Total bytes in core dump: %d\n", tot);

exit(EXIT_SUCCESS);
}