From owner-svn-src-all@FreeBSD.ORG Tue Mar 2 18:49:46 2010 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F0D42106564A; Tue, 2 Mar 2010 18:49:46 +0000 (UTC) (envelope-from bright@elvis.mu.org) Received: from elvis.mu.org (elvis.mu.org [192.203.228.196]) by mx1.freebsd.org (Postfix) with ESMTP id DDB928FC14; Tue, 2 Mar 2010 18:49:46 +0000 (UTC) Received: by elvis.mu.org (Postfix, from userid 1192) id A7AB51A3C76; Tue, 2 Mar 2010 10:49:41 -0800 (PST) Date: Tue, 2 Mar 2010 10:49:41 -0800 From: Alfred Perlstein To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Message-ID: <20100302184941.GU55658@elvis.mu.org> References: <201003021843.o22IhCOb011242@svn.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <201003021843.o22IhCOb011242@svn.freebsd.org> User-Agent: Mutt/1.4.2.3i Cc: Ed Maste Subject: Re: svn commit: r204595 - head/share/man/man5 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Mar 2010 18:49:47 -0000 No snub intended to Ed Maste, prematurely hit :x in vi. this was suggested by: emaste -Alfred * Alfred Perlstein [100302 10:43] wrote: > 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 , -- - Alfred Perlstein .- AMA, VMOA #5191, 03 vmax, 92 gs500, 85 ch250 .- FreeBSD committer