Bug 136029

Summary:

MALLOC_PRODUCTION knob should be mentioned somewhere, e.g. in make.conf(5)

Product:

Documentation

Reporter:

GNATS administrator <gnats-admin>

Component:

Books & Articles

Assignee:

freebsd-doc (Nobody) <doc>

Status:

Closed FIXED

Severity:

Affects Only Me

Priority:

Normal

Version:

Latest

Hardware:

Any

OS:

Any

Attachments:

Description	Flags
make.conf.5.diff	none

Description GNATS administrator freebsd_committer

2009-06-25 14:40:00 UTC

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

Comment 1 dfilter service freebsd_committer

2009-09-01 06:55:22 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"

Comment 2 Maxim Konovalov freebsd_committer

2009-09-01 06:55:57 UTC

State Changed
From-To: open->patched

Committed to HEAD.  Thanks!

Comment 3 dfilter service freebsd_committer

2011-06-06 22:40:47 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"

Comment 4 dfilter service freebsd_committer

2011-06-06 22:41:38 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"

Comment 5 Glen Barber freebsd_committer

2011-06-06 22:41:42 UTC

State Changed
From-To: patched->closed

MFCd to stable/8 and stable/7.