From owner-freebsd-doc@FreeBSD.ORG Sun Jul 17 17:20:13 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8F2B216A41C for ; Sun, 17 Jul 2005 17:20:13 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2108343D49 for ; Sun, 17 Jul 2005 17:20:13 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j6HHKCZ9049768 for ; Sun, 17 Jul 2005 17:20:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j6HHKCjU049767; Sun, 17 Jul 2005 17:20:12 GMT (envelope-from gnats) Resent-Date: Sun, 17 Jul 2005 17:20:12 GMT Resent-Message-Id: <200507171720.j6HHKCjU049767@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, scottro@nyc.rr.com Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 34A3316A41C for ; Sun, 17 Jul 2005 17:14:50 +0000 (GMT) (envelope-from scottro@scottro.net) Received: from ms-smtp-01.rdc-nyc.rr.com (ms-smtp-01-smtplb.rdc-nyc.rr.com [24.29.109.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id D087B43D46 for ; Sun, 17 Jul 2005 17:14:49 +0000 (GMT) (envelope-from scottro@scottro.net) Received: from mail.scottro.net (cpe-68-175-68-211.nyc.res.rr.com [68.175.68.211]) by ms-smtp-01.rdc-nyc.rr.com (8.12.10/8.12.7) with ESMTP id j6HHElT3014276 for ; Sun, 17 Jul 2005 13:14:47 -0400 (EDT) Received: by mail.scottro.net (Postfix, from userid 1001) id ED70240D0; Sun, 17 Jul 2005 13:14:46 -0400 (EDT) Message-Id: <20050717171446.ED70240D0@mail.scottro.net> Date: Sun, 17 Jul 2005 13:14:46 -0400 (EDT) From: Scott@scottro.net, Robbins@scottro.net To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/83621: p patch: Minor omissions in /usr/src/UPDATING X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: scottro@nyc.rr.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 17 Jul 2005 17:20:13 -0000 >Number: 83621 >Category: docs >Synopsis: p patch: Minor omissions in /usr/src/UPDATING >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sun Jul 17 17:20:12 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Scott Robbins >Release: FreeBSD 7.0-CURRENT i386 >Organization: >Environment: System: FreeBSD mail.scottro.net 7.0-CURRENT FreeBSD 7.0-CURRENT #0: Sun Jul 17 11:02:38 EDT 2005 root@mail.scottro.net:/usr/obj/usr/src/sys/S11 i386 >Description: /usr/src/UPDATING, although mentioning that disabling malloc debugging flags will improve performance, doesn't give the method to do so. Therefore, the question often comes up on the mailing lists. Additionally, UPDATING doesn't mention the relatively new make cleanworld target. (The handbook doesn't either.) >How-To-Repeat: >Fix: --- UPDATING Sun Jul 17 12:49:19 2005 +++ UPDATING.new Sun Jul 17 12:59:12 2005 @@ -19,7 +19,8 @@ related kernel options, INVARIANTS, malloc debugging flags in userland, and various verbose features in the kernel. Many developers choose to disable these features on build machines - to maximize performance. + to maximize performance. (To disable malloc debugging, + ln -s aj /etc/malloc.conf) 20050711: RELENG_6 branched here. @@ -227,6 +228,10 @@ prefix all make commands with 'env -i '. See the env(1) manual page for more details. + As of FreeBSD-5.x there is now a make cleanworld target. This + This removes the cruft of previous builds from /usr/obj. + + To build a kernel ----------------- If you are updating from a prior version of FreeBSD (even one just @@ -264,6 +269,7 @@ # is listed here if you are upgrading from a really old current. + make cleanworld make buildworld make kernel KERNCONF=YOUR_KERNEL_HERE [1] @@ -301,6 +307,7 @@ To upgrade in-place from 5.x-stable to current ---------------------------------------------- + make cleanworld make buildworld [9] make kernel KERNCONF=YOUR_KERNEL_HERE [8] [1] Err, google? >Release-Note: >Audit-Trail: >Unformatted: