X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/1c79356b52d46aa6b508fb032f5ae709b1f2897b..5eebf7385fedb1517b66b53c28e5aa6bb0a2be50:/README?ds=sidebyside diff --git a/README b/README index 690dd7893..0d4d3285a 100644 --- a/README +++ b/README @@ -1,45 +1,6 @@ How to build XNU: -1) Setup your environment: - - Create and go to your sandbox directory - - $ cd - - Extract the xnu project from cvs: - - $ cvs co -r xnu - - where must be replaced by the matching xnu tag for - the xnu project level. - - Go to the top directory in your XNU project. - - $ cd /xnu - - If you are using a sh-style shell, run the following command: - $ . SETUP/setup.sh - - If you are using a csh-style shell, run the following command: - % source SETUP/setup.csh - - This will define the following environmental variables: - SRCROOT, OBJROOT, DSTROOT, SYMROOT - -2) Export the Component Header Files - - From the top directory, run: - - $ make exporthdrs - - This exports the component header files in the $OBJROOT/EXPORT_HDRS - directory. - -3) Build all the Components - - From the top directory. run: - - $ make all +1) Type: "make" This builds all the components for all architectures defined in ARCH_CONFIGS and for all kernel configurations defined in KERNEL_CONFIGS. @@ -52,7 +13,18 @@ How to build XNU: $(OBJROOT)/RELEASE_PPC/osfmk/RELEASE/osfmk.o: pre-linked object for osfmk component $(OBJROOT)/RELEASE_PPC/mach_kernel: bootable image -4) Building a Component +2) Building a Component + + Go to the top directory in your XNU project. + + If you are using a sh-style shell, run the following command: + $ . SETUP/setup.sh + + If you are using a csh-style shell, run the following command: + % source SETUP/setup.csh + + This will define the following environmental variables: + SRCROOT, OBJROOT, DSTROOT, SYMROOT From a component top directory: @@ -63,9 +35,6 @@ How to build XNU: By default, ARCH_CONFIGS contains one architecture, the build machine architecture, and KERNEL_CONFIGS is set to build for RELEASE . - WARNING: If a component header file has been modified, you will have to do - the above procedures 3 and 4. - Example: $(OBJROOT)/RELEASE_PPC/osfmk/RELEASE/osfmk.o: pre-linked object for osfmk component @@ -76,7 +45,10 @@ How to build XNU: This includes your component in the bootable image, mach_kernel, and in the kernel binary with symbols, mach_kernel.sys. -5) Building DEBUG + WARNING: If a component header file has been modified, you will have to do + the above procedure 1. + +3) Building DEBUG Define KERNEL_CONFIGS to DEBUG in your environment or when running a make command. Then, apply procedures 4, 5 @@ -92,7 +64,7 @@ How to build XNU: $(OBJROOT)/DEBUG_PPC/osfmk/DEBUG/osfmk.o: pre-linked object for osfmk component $(OBJROOT)/DEBUG_PPC/mach_kernel: bootable image -6) Building fat +4) Building fat Define ARCH_CONFIGS in your environment or when running a make command. Apply procedures 3, 4, 5 @@ -104,13 +76,13 @@ How to build XNU: $ export ARCH_CONFIGS="PPC I386" $ make exporthdrs all -7) Build check before integration +5) Build check before integration From the top directory, run: $ ~rc/bin/buildit . -arch ppc -arch i386 -noinstallsrc -nosum -8) Creating tags and cscope +6) Creating tags and cscope Set up your build environment as per instructions in 2a