From owner-svn-src-head@FreeBSD.ORG Tue Mar 2 18:43:12 2010 Return-Path: Delivered-To: svn-src-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DDF3F106568C; Tue, 2 Mar 2010 18:43:12 +0000 (UTC) (envelope-from alfred@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id B2BDD8FC15; Tue, 2 Mar 2010 18:43:12 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id o22IhCXm011244; Tue, 2 Mar 2010 18:43:12 GMT (envelope-from alfred@svn.freebsd.org) Received: (from alfred@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id o22IhCOb011242; Tue, 2 Mar 2010 18:43:12 GMT (envelope-from alfred@svn.freebsd.org) Message-Id: <201003021843.o22IhCOb011242@svn.freebsd.org> From: Alfred Perlstein Date: Tue, 2 Mar 2010 18:43:12 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r204595 - head/share/man/man5 X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Mar 2010 18:43:13 -0000 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 ,