From owner-freebsd-doc@FreeBSD.ORG Thu Jan 20 23:20:02 2005 Return-Path: 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 0391516A4CE for ; Thu, 20 Jan 2005 23:20:02 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C9FC643D4C for ; Thu, 20 Jan 2005 23:20:01 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id j0KNK1og083558 for ; Thu, 20 Jan 2005 23:20:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.1/8.13.1/Submit) id j0KNK1pr083557; Thu, 20 Jan 2005 23:20:01 GMT (envelope-from gnats) Resent-Date: Thu, 20 Jan 2005 23:20:01 GMT Resent-Message-Id: <200501202320.j0KNK1pr083557@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, pete wright Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B9E4216A4CE for ; Thu, 20 Jan 2005 23:11:56 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9B3AC43D39 for ; Thu, 20 Jan 2005 23:11:56 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.13.1/8.13.1) with ESMTP id j0KNBu1A075050 for ; Thu, 20 Jan 2005 23:11:56 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id j0KNBuTB075049; Thu, 20 Jan 2005 23:11:56 GMT (envelope-from nobody) Message-Id: <200501202311.j0KNBuTB075049@www.freebsd.org> Date: Thu, 20 Jan 2005 23:11:56 GMT From: pete wright To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/76515: missleading use of make -j flag in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 20 Jan 2005 23:20:02 -0000 >Number: 76515 >Category: docs >Synopsis: missleading use of make -j flag in handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Jan 20 23:20:01 GMT 2005 >Closed-Date: >Last-Modified: >Originator: pete wright >Release: 5.3-STABLE >Organization: nomadlogic.org >Environment: FreeBSD finn.nomadlogic.org 5.3-STABLE FreeBSD 5.3-STABLE #1: Tue Jan 4 19:06:52 EST 2005 root@finn.nomadlogic.org:/usr/obj/usr/src/sys/SMP i386 >Description: At: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html It states that: "It is now possible to specify a -j option to make which will cause it to spawn several simultaneous processes. This is most useful on multi-CPU machines. However, since much of the compiling process is IO bound rather than CPU bound it is also useful on single CPU machines." After testing this out on a SMP system doing a: $ make -jN buildworld (when "N" ranges from 1 to 8) I found that compile times do *not* decrease after starting two make jobs (make -j2 buildworld). This was also tested by others on Uniproc machines and they did not find a decrease in time after starting one make job (make -j1 buildworld). Here are edited results on my SMP system: building world with 1 jobs... real 95m20.543s user 83m18.550s sys 13m20.120s cleaning /usr/src.... building world with 2 jobs... real 54m15.856s user 84m42.337s sys 16m39.216s cleaning /usr/src.... building world with 3 jobs... real 53m53.239s user 85m12.189s sys 17m13.039s cleaning /usr/src.... building world with 4 jobs... real 53m56.539s user 85m22.767s sys 17m22.433s >How-To-Repeat: Here is the script I used to produce these results: #!/usr/local/bin/bash MAX=8 for ((i=1; i <= MAX ; i++)) do echo "cleaning /usr/src...." sudo make clean > /home/pete/tmp/clean echo "building world with $i jobs..." time make -j$i buildworld > /home/pete/tmp/build_world_$i echo "" sleep 90 done >Fix: It seems that the -j flag is usefull only in direct proportion to the amount of CPU's available to the system. Maybe the doc should be corrected to relate this. >Release-Note: >Audit-Trail: >Unformatted: