[rtems-libbsd commit] README.waf: Make set-up steps self contained

Sebastian Huber sebh at rtems.org
Fri May 6 11:44:58 UTC 2016


Module:    rtems-libbsd
Branch:    master
Commit:    cf729711695493cf61466586b734b351bba6eca8
Changeset: http://git.rtems.org/rtems-libbsd/commit/?id=cf729711695493cf61466586b734b351bba6eca8

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Fri May  6 13:28:25 2016 +0200

README.waf: Make set-up steps self contained

---

 README.waf | 110 ++++++++++++++++++++++++++++++++++++++++---------------------
 1 file changed, 72 insertions(+), 38 deletions(-)

diff --git a/README.waf b/README.waf
index 31c2e28..801665c 100644
--- a/README.waf
+++ b/README.waf
@@ -47,66 +47,100 @@ We will build an ARM Realview PBX A9 QEMU BSP using the name
 Steps
 -----
 
-1. Clone the RTEMS Source Build (RSB):
-
+-------------------------------------------------------------------------------
+sandbox="$PWD/sandbox"
+mkdir sandbox
+cd "$sandbox"
+git clone git://git.rtems.org/rtems-source-builder.git
+git clone git://git.rtems.org/rtems.git
+git clone git://git.rtems.org/rtems-libbsd.git
+cd "$sandbox"
+cd rtems-source-builder/rtems
+../source-builder/sb-set-builder --prefix="$sandbox/rtems-4.12" 4.12/rtems-arm
+cd "$sandbox"
+cd rtems
+PATH="$sandbox/rtems-4.12/bin:$PATH" ./bootstrap
+cd "$sandbox"
+mkdir b-realview_pbx_a9_qemu
+cd b-realview_pbx_a9_qemu
+PATH="$sandbox/rtems-4.12/bin:$PATH" "$sandbox/rtems/configure" \
+  --target=arm-rtems4.12 --prefix="$sandbox/rtems-4.12" \
+  --disable-networking --enable-rtemsbsp=realview_pbx_a9_qemu
+PATH="$sandbox/rtems-4.12/bin:$PATH" make
+PATH="$sandbox/rtems-4.12/bin:$PATH" make install
+cd "$sandbox"
+cd rtems-libbsd
+git submodule init
+git submodule update rtems_waf
+waf configure --prefix="$sandbox/rtems-4.12" \
+  --rtems-bsps=arm/realview_pbx_a9_qemu
+waf
+waf install
+-------------------------------------------------------------------------------
+
+1. Create a sandbox directory:
+
+    $ sandbox="$PWD/sandbox"
+    $ mkdir sandbox
+
+1. Clone the repositories:
+
+    $ cd "$sandbox"
     $ git clone git://git.rtems.org/rtems-source-builder.git
+    $ git clone git://git.rtems.org/rtems.git
+    $ git clone git://git.rtems.org/rtems-libbsd.git
 
 2. Build and install the tools. In this example the path is
-   /opt/rtems/4.12/tools:
+   $sandbox/rtems-4.12:
 
+    $ cd "$sandbox"
     $ cd rtems-source-builder/rtems
-    $ ../source-builder/sb-set-builder \
-            --prefix=/opt/rtems/4.12/tools 4.12/rtems-arm
-
-3. Clone RTEMS:
+    $ ../source-builder/sb-set-builder --prefix="$sandbox/rtems-4.12" 4.12/rtems-arm
 
-    $ git clone git://git.rtems.org/rtems.git rtems-4.12
+3. Bootstrap the RTEMS sources:
 
-4. Bootstrap the RTEMS sources:
-
-    $ cd rtems-4.12
-    $ ./bootstrap
+    $ cd "$sandbox"
+    $ cd rtems
+    $ PATH="$sandbox/rtems-4.12/bin:$PATH" ./bootstrap
 
 5. Build and install the RTEMS Board Support Packages (BSP) you want to use. In
    this example the path is /opt/rtems/4.12/bsps:
 
+    $ cd "$sandbox"
     $ mkdir b-realview_pbx_a9_qemu
     $ cd b-realview_pbx_a9_qemu
-    $ ../rtems-4.12/configure \
-            --target=arm-rtems4.12 --prefix=/opt/rtems/4.12/bsps \
-            --disable-networking --enable-rtemsbsp=realview_pbx_a9_qemu
-    $ make
-    $ make install
-
-6. Populate the rtems_waf git submodule:
+    $ PATH="$sandbox/rtems-4.12/bin:$PATH" "$sandbox/rtems/configure" \
+        --target=arm-rtems4.12 --prefix="$sandbox/rtems-4.12" \
+        --disable-networking --enable-rtemsbsp=realview_pbx_a9_qemu
+    $ PATH="$sandbox/rtems-4.12/bin:$PATH" make
+    $ PATH="$sandbox/rtems-4.12/bin:$PATH" make install
 
-    $ cd rtems-libbsd
-    $ git submodule init
-    $ git submodule update rtems_waf
+6. Populate the rtems_waf git submodule.  Note, make sure you specify
+   'rtems_waf' or the FreeBSD kernel source will be cloned:
 
-   Note, make sure you specify 'rtems_waf' or the FreeBSD kernel source will be
-   cloned.
+   $ cd "$sandbox"
+   $ cd rtems-libbsd
+   $ git submodule init
+   $ git submodule update rtems_waf
 
 7. Run Waf's configure with your specific settings. In this case the path to
    the tools and RTEMS are provided on the command line and so do not need to
-   be in your path or environment [1]:
-
-    $ waf configure --prefix=/opt/rtems/4.12/bsps \
-                    --rtems=/opt/rtems/4.12/bsps \
-                    --rtems-tools=/opt/rtems/4.12/tools \
-                    --rtems-bsps=arm/realview_pbx_a9_qemu
-
-   You can use '--rtems-archs=arm,sparc,i386' or
+   be in your path or environment [1].  You can use
+   '--rtems-archs=arm,sparc,i386' or
    '--rtems-bsps=arm/realview_pbx_a9_qemu,sparc/sis,i386/pc586' to build for
-   more than BSP at a time.
-
-   Note, you must provide the architecture and BSP as a pair. Providing just the
-   BSP name will fail.
+   more than BSP at a time.  Note, you must provide the architecture and BSP as
+   a pair. Providing just the BSP name will fail:
 
-8. Build and install:
+   $ cd "$sandbox"
+   $ cd rtems-libbsd
+   $ waf configure --prefix="$sandbox/rtems-4.12" \
+       --rtems-bsps=arm/realview_pbx_a9_qemu
 
-   The LibBSD package will be installed into the prefix provided to configure.
+8. Build and install.  The LibBSD package will be installed into the prefix
+   provided to configure:
 
+   $ cd "$sandbox"
+   $ cd rtems-libbsd
    $ waf
    $ waf install
 



More information about the vc mailing list