The Core Pattern (core_pattern), or how to specify filename and path for core dumps

1. Introduction to Core Dumps

In most GNU/Linux systems (all of those I personally have used, at least), core dump files generated after an uncaught signal in a process (as a SIGSEGV or SIGQUIT), are generated in the base directory where the program was executed, and named as “core” or “core.PID”.

For example:

$> cd /home/user
$> ulimit -c unlimited
$> kill -s SIGSEGV $$

This will trigger a segmentation fault in your current shell (you probably guessed it after seeing that the shell session where you executed it was closed), and generate a core file in:

Now… is it possible to change where that file is generated by default instead of the current directory? And is it possible to change the name of that generated file? The answer is YES! to both. Let’s see how we can get this.

2. The Core Pattern in Kernel

Since some years ago, the kernel configuration includes a file named “core_pattern”:

In my system, that file contains just this single word:

As expected, this pattern shows how the core file will be generated. Two things can be understood from the previous line: The filename of the core dump file generated will be “core”; and second, the current directory will be used to store it (as the path specified is completely relative to the current directory).

Now, if we change the contents of that file… (as root, of course)

$> mkdir -p /tmp/cores
$> chmod a+rwx /tmp/cores
$> echo "/tmp/cores/core.%e.%p.%h.%t" > /proc/sys/kernel/core_pattern

And we run the same as before:

$> cd /home/user
$> ulimit -c unlimited
$> $> kill -s SIGSEGV $$

We get… voilá!

Not only the program name (“bash“) or the PID (“8539“), but also the hostname (“drehbahn-mbp“) and the unix time (“1236975953“) are appended in the name of the core file!! And of course, it is stored in the absolute path we specified (“/tmp/cores/“).

You can use the following pattern elements in the core_pattern file:

%p: pid
%: '%' is dropped
%%: output one '%'
%u: uid
%g: gid
%s: signal number
%t: UNIX time of dump
%h: hostname
%e: executable filename
%: both are dropped

Isn’t is great?! Imagine that you have a cluster of machines and you want to use a NFS directory to store all core files from all the nodes. You will be able to detect which node generated the core file (with the hostname), which program generated it (with the program name), and also when did it happen (with the unix time).

3. Configure it forever

The changes done before are only applicable until the next reboot. In order to make the change in all future reboots, you will need to add the following in “/etc/sysctl.conf“:

# Own core file pattern...

sysctl.conf is the file controlling every configuration under /proc/sys

Posted on March 13, 2009, in Development and tagged , , , , . Bookmark the permalink. 13 Comments.

  1. Really good explanation :) Thanks Alex for it :)

  2. o/

    just wanted to say that there is no need to edit the file manually. simply run the sysctl command, which does the stuff for ya.


  3. I have the following in a simulator environment

    echo “|/etc/ /misc/scratch/core/%h_%e_%p.core” > /proc/sys/kernel/core_pattern

    where has
    /pkg/bin/gzip – > $1.gz
    /pkg/bin/(my_program) > /tmp/core

    When I kill a process, I see that the core file is zipped and placed correctly at /misc/scratch/core. But /pkg/bin/(my_program) which has lot of prints does not show up in /tmp/core. ie /tmp/core is an empty file

    If I simply run etc/, then all the prints show up in the /tmp/core

    What could be wrong?

  4. Very good explanation.
    Thanks! I didn’t know it was so flexible.

  5. James Cuzella

    savvy Ubuntu users may have noticed that their /proc/sys/kernel/core_pattern file contains the following:

    |/usr/share/apport/apport %p %s %c

    This is how Ubuntu is able to detect when a program has crashed/dumped core, and apport is able to send crash reports to launchpad. This also led me to find out that ‘%c’ (another unmentioned ‘pattern element’) is supported in the core_pattern file. Running ‘apport’ with –help reveals what it is:

    /usr/share/apport/apport –help
    Usage: /usr/share/apport/apport
    The core dump is read from stdin.


    %c = core file ulimit

  6. Thanks Aleksander for the very good clear explanation.

  7. is there anything same in AIX.
    I tried ‘chore’ but it changes it to default naming convention . Can it be tailored according to need like here in linux.

  8. No idea in AIX, sorry.

  9. Thanks! It really helped me on tracking down a process that was crashing randomly. So I dont need to get gdb running to track down the problem.

  10. I really like your writing style, good information, regards for putting up acadkddcekab

  11. I should just let it be but, given the year it was posted. But well.

    just wanted to say that there is no need to edit the file manually. simply run the sysctl command, which does the stuff for ya.

    Yes, true. Until you reboot, that is. Then it magically ‘disappears’ because you set it temporarily (variables that are not saved and loaded to/from disk only remain – because this is all that is possible – while the process that owns it, exists). sysctl changes it at runtime – the configuration file itself makes it persistent. While it is less important for this setting (though why not make it persist if you have a use for it beyond one time, is beyond me), other settings it is rather important that you do indeed make it persistent, if you actually have a need for the setting (networking settings come to mind).

  12. slightly tangential to topic at hand but, dumping core on nfs mounted file-systems, sigh ! what could possibly go wrong :) ?

  1. Pingback: Kernel Core Pattern « wirelined

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s


Get every new post delivered to your Inbox.

Join 109 other followers

%d bloggers like this: