svn commit: r204595 - head/share/man/man5
Alfred Perlstein
alfred at FreeBSD.org
Tue Mar 2 18:43:13 UTC 2010
Author: alfred
Date: Tue Mar 2 18:43:12 2010
New Revision: 204595
URL: http://svn.freebsd.org/changeset/base/204595
Log:
Document COMPRESS_USER_CORES, and the new %I and %H core formatters.
Modified:
head/share/man/man5/core.5
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.
+.Pp
+The following format specifiers may be used in the
+.Va kern.corefile
+sysctl to insert additional information into the resulting core file
+name:
+.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.
+.El
+.Pp
The name defaults to
.Em \&%N.core ,
yielding the traditional
@@ -89,6 +103,26 @@ changed to generate a core dump by setti
variable
.Va kern.sugid_coredump
to 1.
+.Pp
+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
+COMPRESS_USER_CORES
+.It devices
+gzio
+.El
+.Pp
+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.
+.El
.Sh EXAMPLES
In order to store all core images in per-user private areas under
.Pa /var/coredumps ,
More information about the svn-src-head
mailing list