From nobody@FreeBSD.org  Thu Jun 25 13:36:42 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 0E7D5106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 25 Jun 2009 13:36:42 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id F0D218FC17
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 25 Jun 2009 13:36:41 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n5PDafnW055043
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 25 Jun 2009 13:36:41 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n5PDaft6055042;
	Thu, 25 Jun 2009 13:36:41 GMT
	(envelope-from nobody)
Message-Id: <200906251336.n5PDaft6055042@www.freebsd.org>
Date: Thu, 25 Jun 2009 13:36:41 GMT
From: anonymous <>
To: freebsd-gnats-submit@FreeBSD.org
Subject: MALLOC_PRODUCTION knob should be mentioned somewhere, e.g. in make.conf(5)
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         136029
>Category:       docs
>Synopsis:       MALLOC_PRODUCTION knob should be mentioned somewhere, e.g. in make.conf(5)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 25 13:40:00 UTC 2009
>Closed-Date:    Mon Jun 06 21:42:01 UTC 2011
>Last-Modified:  Mon Jun  6 21:50:11 UTC 2011
>Originator:     anonymous
>Release:        
>Organization:
>Environment:
>Description:
MALLOC_PRODUCTION disables not only run-time but compile-time debugging, too. It wouldn't hurt to mention it in src/UPDATING along with `-aj' or in make.conf(5).
It's the only knob that wasn't mentioned anywhere in documentation[1]. We can use existing comment from malloc.c in man page:

/*
 * MALLOC_PRODUCTION disables assertions and statistics gathering.  It also
 * defaults the A and J runtime options to off.  These settings are appropriate
 * for production systems.
 */

[1] http://wiki.freebsd.org/DefaultDebuggingKnobs

>How-To-Repeat:

>Fix:
--- make.conf.5.diff begins here ---
Index: share/man/man5/make.conf.5
===================================================================
--- share/man/man5/make.conf.5	(revision 194197)
+++ share/man/man5/make.conf.5	(working copy)
@@ -466,6 +466,12 @@
 and allow access over FireWire(IEEE1394) using
 .Xr dconschat 8 .
 Currently, only i386 and amd64 are supported.
+.It Va MALLOC_PRODUCTION
+.Pq Vt bool
+Set this to disable assertions and statistics gathering in
+.Xr malloc 3 .
+It also defaults the A and J runtime options to off. Disabled by
+default on -CURRENT.
 .It Va MODULES_WITH_WORLD
 .Pq Vt bool
 Set to build modules with the system instead of the kernel.
--- make.conf.5.diff ends here ---


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: maxim 
State-Changed-When: Tue Sep 1 05:55:57 UTC 2009 
State-Changed-Why:  
Committed to HEAD.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=136029 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/136029: commit references a PR
Date: Tue,  1 Sep 2009 05:55:22 +0000 (UTC)

 Author: maxim
 Date: Tue Sep  1 05:55:10 2009
 New Revision: 196727
 URL: http://svn.freebsd.org/changeset/base/196727
 
 Log:
   o Document MALLOC_PRODUCTION knob.
   
   PR:		docs/136029
   Submitted by:	anonymous
   MFC after:	2 weeks
 
 Modified:
   head/share/man/man5/make.conf.5
 
 Modified: head/share/man/man5/make.conf.5
 ==============================================================================
 --- head/share/man/man5/make.conf.5	Tue Sep  1 05:15:45 2009	(r196726)
 +++ head/share/man/man5/make.conf.5	Tue Sep  1 05:55:10 2009	(r196727)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd September 5, 2006
 +.Dd September 1, 2009
  .Dt MAKE.CONF 5
  .Os
  .Sh NAME
 @@ -466,6 +466,12 @@ console driver to
  and allow access over FireWire(IEEE1394) using
  .Xr dconschat 8 .
  Currently, only i386 and amd64 are supported.
 +.It Va MALLOC_PRODUCTION
 +.Pq Vt bool
 +Set this to disable assertions and statistics gathering in
 +.Xr malloc 3 .
 +It also defaults the A and J runtime options to off.
 +Disabled by default on -CURRENT.
  .It Va MODULES_WITH_WORLD
  .Pq Vt bool
  Set to build modules with the system instead of the kernel.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Mon Jun 6 21:41:42 UTC 2011 
State-Changed-Why:  
MFCd to stable/8 and stable/7. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=136029 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/136029: commit references a PR
Date: Mon,  6 Jun 2011 21:40:47 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Mon Jun  6 21:40:38 2011
 New Revision: 222784
 URL: http://svn.freebsd.org/changeset/base/222784
 
 Log:
   MFC 196727 [1]:
   
   Document MALLOC_PRODUCTION knob.
   
   PR:		136029
   Original commit by:	maxim [1]
 
 Modified:
   stable/8/share/man/man5/make.conf.5
 Directory Properties:
   stable/8/share/man/man5/   (props changed)
 
 Modified: stable/8/share/man/man5/make.conf.5
 ==============================================================================
 --- stable/8/share/man/man5/make.conf.5	Mon Jun  6 21:38:39 2011	(r222783)
 +++ stable/8/share/man/man5/make.conf.5	Mon Jun  6 21:40:38 2011	(r222784)
 @@ -486,6 +486,12 @@ console driver to
  and allow access over FireWire(IEEE1394) using
  .Xr dconschat 8 .
  Currently, only i386 and amd64 are supported.
 +.It Va MALLOC_PRODUCTION
 +.Pq Vt bool
 +Set this to disable assertions and statistics gathering in
 +.Xr malloc 3 .
 +It also defaults the A and J runtime options to off.
 +Disabled by default on -CURRENT.
  .It Va MODULES_WITH_WORLD
  .Pq Vt bool
  Set to build modules with the system instead of the kernel.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/136029: commit references a PR
Date: Mon,  6 Jun 2011 21:41:38 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Mon Jun  6 21:41:10 2011
 New Revision: 222785
 URL: http://svn.freebsd.org/changeset/base/222785
 
 Log:
   MFC 196727 [1]:
   
   Document MALLOC_PRODUCTION knob.
   
   PR:		136029
   Original commit by:	maxim [1]
 
 Modified:
   stable/7/share/man/man5/make.conf.5
 Directory Properties:
   stable/7/share/man/man5/   (props changed)
 
 Modified: stable/7/share/man/man5/make.conf.5
 ==============================================================================
 --- stable/7/share/man/man5/make.conf.5	Mon Jun  6 21:40:38 2011	(r222784)
 +++ stable/7/share/man/man5/make.conf.5	Mon Jun  6 21:41:10 2011	(r222785)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd September 5, 2006
 +.Dd September 1, 2009
  .Dt MAKE.CONF 5
  .Os
  .Sh NAME
 @@ -474,6 +474,12 @@ console driver to
  and allow access over FireWire(IEEE1394) using
  .Xr dconschat 8 .
  Currently, only i386 and amd64 are supported.
 +.It Va MALLOC_PRODUCTION
 +.Pq Vt bool
 +Set this to disable assertions and statistics gathering in
 +.Xr malloc 3 .
 +It also defaults the A and J runtime options to off.
 +Disabled by default on -CURRENT.
  .It Va MODULES_WITH_WORLD
  .Pq Vt bool
  Set to build modules with the system instead of the kernel.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
