[darwinbuild-changes] [508] trunk/README

[source_changes at macosforge.org]

Revision: 508
          http://trac.macosforge.org/projects/darwinbuild/changeset/508
Author:   wsiegrist at apple.com
Date:     2009-04-17 18:22:06 -0700 (Fri, 17 Apr 2009)
Log Message:
-----------
Update the README with the new storage options

Modified Paths:
--------------
    trunk/README

Modified: trunk/README
===================================================================
--- trunk/README	2009-04-18 01:03:44 UTC (rev 507)
+++ trunk/README	2009-04-18 01:22:06 UTC (rev 508)
@@ -17,6 +17,7 @@
   5.1 Private Headers
   5.2 Build Tools
   5.3 Static Libraries
+  5.4 Alternate BuildRoot Storage
 Appendix
 A. darwinxref
 
@@ -74,22 +75,13 @@
 2.1 Creating the Build Directory
 
 After installation, you must initialize the build directory using darwinbuild. 
-In order to build Xcode-based projects, you need to use UFS to workaround a 
-bug. For Makefile-based projects, you can use any filesystem. You know you 
-have hit the bug when you get a build error about a missing project or 
-platform (depending on which version of Xcode you have). 
+Assuming you wanted to build projects from 9G55 in your home directory:
 
-To create a UFS disk image:
-
-  % hdiutil create -size 4g -type UDIF -fs UFS -volname dbufs -attach dbufs.dmg
-
-To initialize your build environment, assuming you used the step above:
-
-  # cd /Volumes/dbufs
-  # mkdir 9G55
-  # cd 9G55
+  # mkdir ~/9G55
+  # cd ~/9G55
   # sudo -s
   # darwinbuild -init 9G55
+  Creating build root disk image ...
   Attempting to download http://svn.macosforge.org/repository/darwinbuild/trunk/plists//9G55.plist ...
   Download complete
   Attempting to download http://svn.macosforge.org/repository/darwinbuild/trunk/plists//9F33.plist ...
@@ -97,6 +89,7 @@
   ...
   Attempting to download http://svn.macosforge.org/repository/darwinbuild/trunk/plists//9A581.plist ...
   Download complete
+  Initialization Complete
   # ls
   .build  Headers Logs    Roots   Sources Symbols
 
@@ -272,6 +265,26 @@
 use of many static libraries from Libc, Libinfo, and more.
 
 
+5.4 Alternate BuildRoot Storage
+
+By default, "darwinbuild -init" will setup your environment to use a HFSX
+sparsebundle to host your BuildRoot. A sparsebundle is used to work around
+problems with using xcodebuild inside of a chroot. There are two other
+storage methods to choose from: NFS Loopback and Legacy Directory. 
+
+  1. NFS Loopback      (ex: darwinbuild -init 9G55 -nfs)
+     The NFS loopback method places a directory under .build and adds that 
+     directory to /etc/exports. When you try to build a project, darwinbuild 
+     will mount the NFS export on localhost. The NFS mount also works around 
+     the xcodebuild problems. 
+
+  2. Legacy Directory  (ex: darwinbuild -init 9G55 -nodmg)
+     This is just the way darwinbuild worked before the sparsebundle and NFS
+     support was added. It just makes a directory for BuildRoot and builds 
+     on whatever filesystem you are on at the time. If you are on HFS or ZFS,
+     this storage will cause problems for Xcode-based projects. 
+  
+
 =============
 A. darwinxref
 =============
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/darwinbuild-changes/attachments/20090417/531373a7/attachment.html>