svn commit: r204595 - head/share/man/man5

Alfred Perlstein alfred at
Tue Mar 2 18:43:13 UTC 2010

Author: alfred
Date: Tue Mar  2 18:43:12 2010
New Revision: 204595

  Document COMPRESS_USER_CORES, and the new %I and %H core formatters.


Modified: head/share/man/man5/core.5
--- head/share/man/man5/core.5	Tue Mar  2 18:42:29 2010	(r204594)
+++ head/share/man/man5/core.5	Tue Mar  2 18:43:12 2010	(r204595)
@@ -68,13 +68,27 @@ the core image to.
 This filename can be absolute, or relative (which
 will resolve to the current working directory of the program
 generating it).
-Any sequence of
-.Em \&%N
-in this filename template will be replaced by the process name,
-.Em \&%P
-by the processes PID, and
-.Em \&%U
-by the UID.
+The following format specifiers may be used in the
+.Va kern.corefile
+sysctl to insert additional information into the resulting core file
+.Bl -tag -width "1234567890" -compact -offset "12345"
+.It Em \&%H
+Machine hostname.
+.It Em \&%I
+An index starting at zero until the sysctl
+.Em debug.num_cores
+is reached.  This can be useful for limiting the number of corefiles
+generated by a particular process.
+.It Em \&%N
+process name.
+.It Em \&%P
+processes PID.
+.It Em \&%U
+process UID.
 The name defaults to
 .Em \&%N.core ,
 yielding the traditional
@@ -89,6 +103,26 @@ changed to generate a core dump by setti
 .Va kern.sugid_coredump
 to 1.
+Corefiles can be compressed by the kernel if the following items
+are included in the kernel configuration file:
+.Bl -tag -width "1234567890" -compact -offset "12345"
+.It options
+.It devices
+When COMPRESS_USER_CORES is included the following sysctls can control
+if core files will be compressed:
+.Bl -tag -width "kern.compress_user_cores_gzlevel" -compact -offset "12345"
+.It Em kern.compress_user_cores_gzlevel
+Gzip compression level.  Defaults to -1.
+.It Em kern.compress_user_cores
+Actually compress user cores.  Core files will have the suffix
+.Em .gz
+appended to them.
 In order to store all core images in per-user private areas under
 .Pa /var/coredumps ,

More information about the svn-src-all mailing list