[PATCH 3/3] Move duplicate host configuration information from RSB to Users Guide

Joel Sherrill joel at rtems.org
Fri Oct 12 19:28:57 UTC 2018


---
 rsb/index.rst                   |   1 -
 user/hosts/macos.rst            |  31 +++-
 user/hosts/posix.rst            | 132 ++++++++++++++
 user/hosts/windows.rst          | 384 ++++++++++++++++------------------------
 user/installation/developer.rst |  72 +++++++-
 5 files changed, 383 insertions(+), 237 deletions(-)

diff --git a/rsb/index.rst b/rsb/index.rst
index 36e0883..562db16 100644
--- a/rsb/index.rst
+++ b/rsb/index.rst
@@ -54,7 +54,6 @@ Table of Contents
 
         source-builder
         building-tools-and-rtems.rst
-	hosts
 	project-sets
 	cross-canadian-cross
 	third-party-packages
diff --git a/user/hosts/macos.rst b/user/hosts/macos.rst
index 057679b..885ad87 100644
--- a/user/hosts/macos.rst
+++ b/user/hosts/macos.rst
@@ -5,8 +5,8 @@
 
 .. _macos:
 
-Apple OS X
-==========
+Apple MacOS
+===========
 
 Apple's OS X is fully supported. You need to download and install a recent
 version of the Apple developer application Xcode. Xocde is available in the App
@@ -19,3 +19,30 @@ Prefixes of :file:`$HOME/development/rtems` or :file:`$HOME/rtems` are
 suitable.
 
 :ref:`prefixes` details using Prefixes to manage the installation.
+
+MacOS
+.. _Mavericks:
+
+Mavericks
+~~~~~~~~~
+
+The RSB works on Mavericks and the GNU tools can be built for RTEMS using the
+Mavericks clang LLVM tool chain. You will need to build and install a couple of
+packages to make the RSB pass the ``sb-check``. These are CVS and XZ. You can get
+these tools from a packaging tool for MacOS such as *MacPorts* or *HomeBrew*.
+
+I do not use 3rd party packaging on MacOS and prefer to build the packages from
+source using a prefix of ``/usr/local``. There are good 3rd party packages around
+however they sometimes bring in extra dependence and that complicates my build
+environment and I want to know the minimal requirements when building
+tools. The following are required:
+
+. The XZ package's home page is http://tukaani.org/xz/ and I use version
+  5.0.5. XZ builds and installs cleanly.
+
+Sierra
+~~~~~~
+
+The RSB works on Sierra with the latest Xcode.
+
+
diff --git a/user/hosts/posix.rst b/user/hosts/posix.rst
index 5906428..978ad37 100644
--- a/user/hosts/posix.rst
+++ b/user/hosts/posix.rst
@@ -37,3 +37,135 @@ separate production versions from the test versions and the prefix paths may
 have restricted access rights to only those who manage and have configuration
 control of the machine. We call this project sandboxing and
 :ref:`project-sandboxing` explains this in more detail.
+
+Linux
+-----
+
+A number of different Linux distrubutions are known to work. The following have
+been tested and report as working.
+
+.. _ArchLinux:
+
+ArchLinux
+~~~~~~~~~
+
+The following packages are required on a fresh Archlinux 64bit installation::
+
+    # pacman -S base-devel gdb xz unzip ncurses git zlib
+
+Archlinux, by default installs ``texinfo-5`` which is incompatible for building
+GCC 4.7 tree. You will have to obtain ``texinfo-legacy`` from ``AUR`` and
+provide a manual override::
+
+    # pacman -R texinfo
+    $ yaourt -S texinfo-legacy
+    # ln -s /usr/bin/makeinfo-4.13a /usr/bin/makeinfo
+
+.. _CentOS:
+
+CentOS
+~~~~~~
+
+The following packages are required on a minimal CentOS 6.3 64bit installation::
+
+    # yum install autoconf automake binutils gcc gcc-c++ gdb make patch \
+    bison flex xz unzip ncurses-devel texinfo zlib-devel python-devel git
+
+The minimal CentOS distribution is a specific DVD that installs a minimal
+system. If you use a full system some of these packages may have been
+installed.
+
+.. _Fedora:
+
+Fedora
+~~~~~~
+
+The RTEMS Source Builder has been tested on Fedora 19 64bit with the following
+packages::
+
+    # yum install ncurses-devel python-devel git bison gcc cvs gcc-c++ \
+         flex texinfo patch perl-Text-ParseWords zlib-devel
+
+.. _Raspbian:
+
+Raspbian
+~~~~~~~~
+
+The is the Debian distribution for the Raspberry Pi. The following packages are
+required::
+
+    $ sudo apt-get install autoconf automake bison flex binutils gcc g++ gdb \
+    texinfo unzip ncurses-dev python-dev git
+
+It is recommended you get Model B of the Pi with 512M of memory and to mount a
+remote disk over the network. The tools can be built on the network disk with a
+prefix under your home directory as recommended and end up on the SD card.
+
+.. _Ubuntu:
+.. _Xubuntu:
+
+Ubuntu
+~~~~~~
+
+The latest version is Ubuntu 16.04.1 LTS 64bit. This section also includes
+Xubuntu. A minimal installation was used and the following packages installed::
+
+    $ sudo apt-get build-dep binutils gcc g++ gdb unzip pax bison flex
+    $ sudo apt-get install python2.7-dev git libncurses5-dev zlib1g-dev
+
+.. _Linux Mint:
+
+Linux Mint
+~~~~~~~~~~
+
+zlib package is required on Linux Mint. It has a different name (other
+than the usual zlib-dev)::
+
+    # sudo apt-get install zlib1g-dev
+
+.. _openSUSE:
+
+openSUSE
+~~~~~~~~
+
+This has been reported to work but no instructions were provided. This is an
+opportunity to contribute. Please submit any guidance you can provide.
+
+.. _FreeBSD:
+
+FreeBSD
+-------
+
+The RTEMS Source Builder has been tested on FreeBSD 9.1, 10.3 and 11 64bit
+version. You need to install some ports. They are::
+
+    # cd /usr/ports
+    # portinstall --batch lang/python27
+
+If you wish to build Windows (mingw32) tools please install the following
+ports::
+
+    # cd /usr/ports
+    # portinstall --batch devel/mingw32-binutils devel/mingw32-gcc
+    # portinstall --batch devel/mingw32-zlib devel/mingw32-pthreads
+
+The +zlip+ and +pthreads+ ports for MinGW32 are used for builiding a Windows
+QEMU.
+
+If you are on FreeBSD 10.0 and you have pkgng installed you can use 'pkg
+install' rather than 'portinstall'.
+
+.. _NetBSD:
+
+NetBSD
+------
+
+The RTEMS Source Builder has been tested on NetBSD 6.1 i386. Packages to add
+are::
+
+    # pkg_add ftp://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.1/devel/gmake-3.82nb7.tgz
+    # pkg_add ftp://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.1/devel/bison-2.7.1.tgz
+    # pkg_add ftp://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.1/archivers/xz-5.0.4.tgz
+
+.. _MacOS:
+
diff --git a/user/hosts/windows.rst b/user/hosts/windows.rst
index 6a76e7c..52940a6 100644
--- a/user/hosts/windows.rst
+++ b/user/hosts/windows.rst
@@ -16,28 +16,28 @@ committed to helping the open source community improve the Windows
 experience. If something is not working or supported please email the
 :r:list:`users`.
 
-The RTEMS Project's Windows tools are native Windows executables giving the
-user the best possible experience on Windows. Native Windows programs use the
-standard Windows DLLs and paths. Integration with standard Windows integrated
-development tools such as editors is straight forward. POSIX emulation
-environments such as Cygwin and the MSYS2 shell have special executables that
-require a POSIX emulation DLL and these emulation DLLs add an extra layer of
-complexity as well as a performance over-head. The RTEMS Project uses these
-POSIX emulation shells to run configure scripts that come with various open
-source packages such as `gcc` so they form an important and valued part of the
-environment we describe here. The output of this procedure forms the tools you
-use during your application development and they do not depend on the emulation
-DLLs.
-
-The performance of the compiler is as good as you can have on Windows and the
-performance compiling a single file will be similar to that on a host like
-Linux or FreeBSD given the same hardware. Building the tools from source is
-much slower on Windows because POSIX shells and related tools are used and the
-POSIX emulation overhead it much much slower than a native POSIX operating
-system like Linux and FreeBSD. This overhead is only during the building of the
-tools and the RTEMS kernel and if you use a suitable build system that is
-native to Windows your application development should be similar to other
-operating systems.
+The RTEMS Project's Windows tools can be native Windows executables
+which give the user the best possible experience on Windows. Native
+Windows programs use the standard Windows DLLs and paths. Integration
+with standard Windows integrated development tools such as editors is
+straight forward. POSIX emulation environments such as Cygwin and the
+MSYS2 shell have special executables that require a POSIX emulation DLL
+and these emulation DLLs add an extra layer of complexity as well as a
+performance over-head. The RTEMS Project uses these POSIX emulation shells
+to run configure scripts that come with various open source packages such
+as `gcc` so they form an important and valued part of the environment we
+describe here. The output of this procedure forms the tools you use during
+your application development and they do not depend on the emulation DLLs.
+
+The performance of a native Windows compiler is as good as you can have
+on Windows and the performance compiling a single file will be similar to
+that on a host like Linux or FreeBSD given the same hardware. Building
+the tools from source is much slower on Windows because POSIX shells
+and related tools are used and the POSIX emulation overhead it much much
+slower than a native POSIX operating system like Linux and FreeBSD. This
+overhead is only during the building of the tools and the RTEMS kernel
+and if you use a suitable build system that is native to Windows your
+application development should be similar to other operating systems.
 
 Building is known to work on `Windows 7 64bit Professional` and `Windows 10`.
 
@@ -112,8 +112,8 @@ generate.
 
 .. _microsoft-windows-installation:
 
-Installing MSYS2
-----------------
+MSYS2
+-----
 
 MSYS2 is installed on a new machine using the MSYS2 installer found on
 https://msys2.github.io/. Please select the ``x86_64`` variant for 64bit
@@ -159,217 +159,135 @@ Install the packages using ``pacman``:
 
 .. code-block:: shell
 
-  ~
   $ pacman -S python mingw-w64-x86_64-python2 mingw-w64-x86_64-gcc \
   bison cvs diffutils git make patch tar texinfo unzip
   resolving dependencies...
   looking for conflicting packages...
+      .... output shortened for brevity ....
+
+.. _Cygwin:
+
+Cygwin
+~~~~~~
+
+Building on Windows is a little more complicated because the Cygwin shell is
+used rather than the MSYS2 shell. The MSYS2 shell is simpler because the
+detected host triple is MinGW so the build is a standard cross-compiler build.
+A Canadian cross-build using Cygwin is supported if you would like native
+tools or you can use a Cygwin built set of tools.
+
+Install a recent Cygwin version using the Cygwin setup tool. Select and install
+the groups and packages listed:
+
+.. table:: Cygwin Packages
+
+  ======= =========================
+  Group   Package
+  Archive bsdtar
+  Archive unzip
+  Archive xz
+  Devel   autoconf
+  Devel   autoconf2.1
+  Devel   autoconf2.5
+  Devel   automake
+  Devel   binutils
+  Devel   bison
+  Devel   flex
+  Devel   gcc4-core
+  Devel   gcc4-g++
+  Devel   git
+  Devel   make
+  Devel   mingw64-x86_64-binutils
+  Devel   mingw64-x86_64-gcc-core
+  Devel   mingw64-x86_64-g++
+  Devel   mingw64-x86_64-runtime
+  Devel   mingw64-x86_64-zlib
+  Devel   patch
+  Devel   zlib-devel
+  MinGW   mingw-zlib-devel
+  Python  python
+  ======= =========================
+
+The setup tool will add a number of dependent package and it is ok to accept
+them.
+
+Disabling Windows Defender improves performance if you have another up to date
+virus detection tool installed and enabled. The excellent ``Process Hacker 2``
+tool can monitor the performance and the Windows Defender service contributed a
+high load. In this case a 3rd party virus tool was installed so the Windows
+Defender service was not needed.
+
+To build a MinGW tool chain a Canadian cross-compile (Cxc) is required on
+Cygwin because the host is Cygwin therefore a traditional cross-compile will
+result in Cygiwn binaries. With a Canadian cross-compile a Cygwin
+cross-compiler is built as well as the MinGW RTEMS cross-compiler. The Cygwin
+cross-compiler is required to build the C runtime for the RTEMS target because
+we are building under Cygiwn. The build output for an RTEMS 4.10 ARM tool set
+is::
+
+    chris at cygthing ~/development/rtems/src/rtems-source-builder/rtems
+    $ ../source-builder/sb-set-builder --log=l-arm.txt --prefix=$HOME/development/rtems/4.10 4.10/rtems-arm
+    RTEMS Source Builder - Set Builder, v0.2
+    Build Set: 4.10/rtems-arm
+    config: expat-2.1.0-1.cfg
+    package: expat-2.1.0-x86_64-w64-mingw32-1
+    building: expat-2.1.0-x86_64-w64-mingw32-1
+    reporting: expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-w64-mingw32-1.html
+    config: tools/rtems-binutils-2.20.1-1.cfg
+    package: arm-rtems4.10-binutils-2.20.1-1   <1>
+    building: arm-rtems4.10-binutils-2.20.1-1
+    package: (Cxc) arm-rtems4.10-binutils-2.20.1-1   <2>
+    building: (Cxc) arm-rtems4.10-binutils-2.20.1-1
+    reporting: tools/rtems-binutils-2.20.1-1.cfg ->
+    arm-rtems4.10-binutils-2.20.1-1.html
+    config: tools/rtems-gcc-4.4.7-newlib-1.18.0-1.cfg
+    package: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
+    building: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
+    package: (Cxc) arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
+    building: (Cxc) arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
+    reporting: tools/rtems-gcc-4.4.7-newlib-1.18.0-1.cfg ->
+    arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1.html
+    config: tools/rtems-gdb-7.3.1-1.cfg
+    package: arm-rtems4.10-gdb-7.3.1-1
+    building: arm-rtems4.10-gdb-7.3.1-1
+    reporting: tools/rtems-gdb-7.3.1-1.cfg -> arm-rtems4.10-gdb-7.3.1-1.html
+    config: tools/rtems-kernel-4.10.2.cfg
+    package: arm-rtems4.10-kernel-4.10.2-1
+    building: arm-rtems4.10-kernel-4.10.2-1
+    reporting: tools/rtems-kernel-4.10.2.cfg -> arm-rtems4.10-kernel-4.10.2-1.html
+    installing: expat-2.1.0-x86_64-w64-mingw32-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
+    installing: arm-rtems4.10-binutils-2.20.1-1 -> /cygdrive/c/Users/chris/development/rtems/4.10 <3>
+    installing: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
+    installing: arm-rtems4.10-gdb-7.3.1-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
+    installing: arm-rtems4.10-kernel-4.10.2-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
+    cleaning: expat-2.1.0-x86_64-w64-mingw32-1
+    cleaning: arm-rtems4.10-binutils-2.20.1-1
+    cleaning: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
+    cleaning: arm-rtems4.10-gdb-7.3.1-1
+    cleaning: arm-rtems4.10-kernel-4.10.2-1
+    Build Set: Time 10:09:42.810547   <4>
+
+.. topic:: Items:
+
+  1. The Cygwin version of the ARM cross-binutils.
+
+  2. The +(Cxc)+ indicates this is the MinGW build of the package.
+
+  3. Only the MinGW version is installed.
+
+  4. Cygwin is slow so please be patient. This time was on an AMD Athlon 64bit
+     Dual Core 6000+ running at 3GHz with 4G RAM running Windows 7 64bit.
+
+.. warning::
+
+  Cygwin documents the 'Big List Of Dodgy Apps' or 'BLODA'. The link is
+  http://cygwin.com/faq/faq.html#faq.using.bloda and it is worth a look. You
+  will see a large number of common pieces of software found on Windows systems
+  that can cause problems. My testing has been performed with NOD32 running and
+  I have seen some failures. The list is for all of Cygwin so I am not sure
+  which of the listed programs effect the RTEMS Source Biulder. The following
+  FAQ item talks about *fork* failures and presents some technical reasons they
+  cannot be avoided in all cases. Cygwin and it's fork MSYS are fantastic
+  pieces of software in a difficult environment. I have found building a single
+  tool tends to work, building all at once is harder.
 
-  Packages (74) db-5.3.28-2  expat-2.1.0-2  gdbm-1.11-3  heimdal-1.5.3-8
-                libgdbm-1.11-3  mingw-w64-x86_64-binutils-2.26-21
-                mingw-w64-x86_64-bzip2-1.0.6-5
-                mingw-w64-x86_64-ca-certificates-20150426-2
-                mingw-w64-x86_64-crt-git-5.0.0.4627.03684c4-1
-                mingw-w64-x86_64-expat-2.1.0-6  mingw-w64-x86_64-gcc-libs-5.3.0-2
-                mingw-w64-x86_64-gdbm-1.11-3  mingw-w64-x86_64-gettext-0.19.6-2
-                mingw-w64-x86_64-gmp-6.1.0-1
-                mingw-w64-x86_64-headers-git-5.0.0.4627.53be55d-1
-                mingw-w64-x86_64-isl-0.15-1  mingw-w64-x86_64-libffi-3.2.1-3
-                mingw-w64-x86_64-libiconv-1.14-5
-                mingw-w64-x86_64-libsystre-1.0.1-2
-                mingw-w64-x86_64-libtasn1-4.7-1
-                mingw-w64-x86_64-libtre-git-r122.c2f5d13-4
-                mingw-w64-x86_64-libwinpthread-git-5.0.0.4573.628fdbf-1
-                mingw-w64-x86_64-mpc-1.0.3-2  mingw-w64-x86_64-mpfr-3.1.3.p0-2
-                mingw-w64-x86_64-ncurses-6.0.20160220-2
-                mingw-w64-x86_64-openssl-1.0.2.g-1
-                mingw-w64-x86_64-p11-kit-0.23.1-3
-                mingw-w64-x86_64-readline-6.3.008-1  mingw-w64-x86_64-tcl-8.6.5-1
-                mingw-w64-x86_64-termcap-1.3.1-2  mingw-w64-x86_64-tk-8.6.5-1
-                mingw-w64-x86_64-windows-default-manifest-6.4-2
-                mingw-w64-x86_64-winpthreads-git-5.0.0.4573.628fdbf-1
-                mingw-w64-x86_64-zlib-1.2.8-9  openssh-7.1p2-1  perl-5.22.0-2
-                perl-Authen-SASL-2.16-2  perl-Convert-BinHex-1.123-2
-                perl-Encode-Locale-1.04-1  perl-Error-0.17024-1
-                perl-File-Listing-6.04-2  perl-HTML-Parser-3.71-3
-                perl-HTML-Tagset-3.20-2  perl-HTTP-Cookies-6.01-2
-                perl-HTTP-Daemon-6.01-2  perl-HTTP-Date-6.02-2
-                perl-HTTP-Message-6.06-2  perl-HTTP-Negotiate-6.01-2
-                perl-IO-Socket-SSL-2.016-1  perl-IO-stringy-2.111-1
-                perl-LWP-MediaTypes-6.02-2  perl-MIME-tools-5.506-1
-                perl-MailTools-2.14-1  perl-Net-HTTP-6.09-1
-                perl-Net-SMTP-SSL-1.02-1  perl-Net-SSLeay-1.70-1
-                perl-TermReadKey-2.33-1  perl-TimeDate-2.30-2  perl-URI-1.68-1
-                perl-WWW-RobotRules-6.02-2  perl-libwww-6.13-1  vim-7.4.1468-1
-                bison-3.0.4-1  cvs-1.11.23-2  diffutils-3.3-3  git-2.7.2-1
-                make-4.1-4  mingw-w64-x86_64-gcc-5.3.0-2
-                mingw-w64-x86_64-python2-2.7.11-4  patch-2.7.5-1  python-3.4.3-3
-                tar-1.28-3  texinfo-6.0-1  unzip-6.0-2
-
-  Total Download Size:   114.10 MiB
-  Total Installed Size:  689.61 MiB
-
-  :: Proceed with installation? [Y/n] y
-  :: Retrieving packages...
-   mingw-w64-x86_64-gm...   477.1 KiB   681K/s 00:01 [#####################] 100%
-   mingw-w64-x86_64-li...    24.2 KiB   755K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-gc...   541.9 KiB   705K/s 00:01 [#####################] 100%
-   mingw-w64-x86_64-ex...   106.7 KiB   702K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-bz...    77.9 KiB   666K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-li...   600.2 KiB   703K/s 00:01 [#####################] 100%
-   mingw-w64-x86_64-ge...     3.0 MiB   700K/s 00:04 [#####################] 100%
-   mingw-w64-x86_64-gd...   151.8 KiB   483K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-li...    34.5 KiB   705K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-li...    69.2 KiB   713K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-li...     9.3 KiB   778K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-nc...  1800.5 KiB   701K/s 00:03 [#####################] 100%
-   mingw-w64-x86_64-li...   171.4 KiB   708K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-p1...   193.5 KiB   709K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-ca...   382.1 KiB   705K/s 00:01 [#####################] 100%
-   mingw-w64-x86_64-zl...   148.6 KiB   704K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-op...     3.3 MiB   624K/s 00:05 [#####################] 100%
-   mingw-w64-x86_64-te...    12.6 KiB  76.7K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-re...   327.4 KiB   277K/s 00:01 [#####################] 100%
-   mingw-w64-x86_64-tc...     2.9 MiB   699K/s 00:04 [#####################] 100%
-   mingw-w64-x86_64-tk...  1869.2 KiB   703K/s 00:03 [#####################] 100%
-   mingw-w64-x86_64-py...    10.9 MiB   699K/s 00:16 [#####################] 100%
-   mingw-w64-x86_64-bi...    12.7 MiB   688K/s 00:19 [#####################] 100%
-   mingw-w64-x86_64-he...     5.0 MiB   645K/s 00:08 [#####################] 100%
-   mingw-w64-x86_64-cr...     2.6 MiB   701K/s 00:04 [#####################] 100%
-   mingw-w64-x86_64-is...   524.3 KiB   684K/s 00:01 [#####################] 100%
-   mingw-w64-x86_64-mp...   265.2 KiB   705K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-mp...    62.3 KiB  82.9K/s 00:01 [#####################] 100%
-   mingw-w64-x86_64-wi...  1484.0   B  0.00B/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-wi...    33.2 KiB   346K/s 00:00 [#####################] 100%
-   mingw-w64-x86_64-gc...    25.1 MiB   701K/s 00:37 [#####################] 100%
-   python-3.4.3-3-x86_64     12.1 MiB   700K/s 00:18 [#####################] 100%
-   bison-3.0.4-1-x86_64    1045.1 KiB   703K/s 00:01 [#####################] 100%
-   heimdal-1.5.3-8-x86_64   543.7 KiB   703K/s 00:01 [#####################] 100%
-   cvs-1.11.23-2-x86_64     508.2 KiB   388K/s 00:01 [#####################] 100%
-   diffutils-3.3-3-x86_64   265.7 KiB   478K/s 00:01 [#####################] 100%
-   expat-2.1.0-2-x86_64      13.1 KiB   817K/s 00:00 [#####################] 100%
-   vim-7.4.1468-1-x86_64      6.1 MiB   700K/s 00:09 [#####################] 100%
-   openssh-7.1p2-1-x86_64   653.4 KiB   703K/s 00:01 [#####################] 100%
-   db-5.3.28-2-x86_64        41.7 KiB   719K/s 00:00 [#####################] 100%
-   libgdbm-1.11-3-x86_64     20.4 KiB   754K/s 00:00 [#####################] 100%
-   gdbm-1.11-3-x86_64       108.5 KiB   704K/s 00:00 [#####################] 100%
-   perl-5.22.0-2-x86_64      12.4 MiB   702K/s 00:18 [#####################] 100%
-   perl-Error-0.17024-...    17.1 KiB   742K/s 00:00 [#####################] 100%
-   perl-Authen-SASL-2....    42.4 KiB   731K/s 00:00 [#####################] 100%
-   perl-Encode-Locale-...     9.7 KiB   745K/s 00:00 [#####################] 100%
-   perl-HTTP-Date-6.02...     8.6 KiB   784K/s 00:00 [#####################] 100%
-   perl-File-Listing-6...     7.7 KiB   769K/s 00:00 [#####################] 100%
-   perl-HTML-Tagset-3....    10.3 KiB   732K/s 00:00 [#####################] 100%
-   perl-HTML-Parser-3....    76.9 KiB   516K/s 00:00 [#####################] 100%
-   perl-LWP-MediaTypes...    18.0 KiB   752K/s 00:00 [#####################] 100%
-   perl-URI-1.68-1-any       75.6 KiB   609K/s 00:00 [#####################] 100%
-   perl-HTTP-Message-6...    71.3 KiB   625K/s 00:00 [#####################] 100%
-   perl-HTTP-Cookies-6...    20.4 KiB   499K/s 00:00 [#####################] 100%
-   perl-HTTP-Daemon-6....    14.2 KiB   749K/s 00:00 [#####################] 100%
-   perl-HTTP-Negotiate...    11.4 KiB   817K/s 00:00 [#####################] 100%
-   perl-Net-HTTP-6.09-...    19.8 KiB   732K/s 00:00 [#####################] 100%
-   perl-WWW-RobotRules...    12.2 KiB   766K/s 00:00 [#####################] 100%
-   perl-libwww-6.13-1-any   122.2 KiB   661K/s 00:00 [#####################] 100%
-   perl-TimeDate-2.30-...    35.9 KiB   718K/s 00:00 [#####################] 100%
-   perl-MailTools-2.14...    58.4 KiB   712K/s 00:00 [#####################] 100%
-   perl-IO-stringy-2.1...    52.6 KiB   721K/s 00:00 [#####################] 100%
-   perl-Convert-BinHex...    30.1 KiB   733K/s 00:00 [#####################] 100%
-   perl-MIME-tools-5.5...   180.4 KiB   705K/s 00:00 [#####################] 100%
-   perl-Net-SSLeay-1.7...   191.2 KiB   708K/s 00:00 [#####################] 100%
-   perl-IO-Socket-SSL-...   112.5 KiB   703K/s 00:00 [#####################] 100%
-   perl-Net-SMTP-SSL-1...     3.5 KiB   881K/s 00:00 [#####################] 100%
-   perl-TermReadKey-2....    20.9 KiB   745K/s 00:00 [#####################] 100%
-   git-2.7.2-1-x86_64         3.6 MiB   702K/s 00:05 [#####################] 100%
-   make-4.1-4-x86_64        387.0 KiB   671K/s 00:01 [#####################] 100%
-   patch-2.7.5-1-x86_64      75.9 KiB   684K/s 00:00 [#####################] 100%
-   tar-1.28-3-x86_64        671.9 KiB   379K/s 00:02 [#####################] 100%
-   texinfo-6.0-1-x86_64     992.7 KiB   625K/s 00:02 [#####################] 100%
-   unzip-6.0-2-x86_64        93.1 KiB   705K/s 00:00 [#####################] 100%
-  (74/74) checking keys in keyring                   [#####################] 100%
-  (74/74) checking package integrity                 [#####################] 100%
-  (74/74) loading package files                      [#####################] 100%
-  (74/74) checking for file conflicts                [#####################] 100%
-  (74/74) checking available disk space              [#####################] 100%
-  :: Processing package changes...
-  ( 1/74) installing python                          [#####################] 100%
-  ( 2/74) installing mingw-w64-x86_64-gmp            [#####################] 100%
-  ( 3/74) installing mingw-w64-x86_64-libwinpthr...  [#####################] 100%
-  ( 4/74) installing mingw-w64-x86_64-gcc-libs       [#####################] 100%
-  ( 5/74) installing mingw-w64-x86_64-expat          [#####################] 100%
-  ( 6/74) installing mingw-w64-x86_64-bzip2          [#####################] 100%
-  ( 7/74) installing mingw-w64-x86_64-libiconv       [#####################] 100%
-  ( 8/74) installing mingw-w64-x86_64-gettext        [#####################] 100%
-  ( 9/74) installing mingw-w64-x86_64-gdbm           [#####################] 100%
-  (10/74) installing mingw-w64-x86_64-libffi         [#####################] 100%
-  (11/74) installing mingw-w64-x86_64-libtre-git     [#####################] 100%
-  (12/74) installing mingw-w64-x86_64-libsystre      [#####################] 100%
-  (13/74) installing mingw-w64-x86_64-ncurses        [#####################] 100%
-  (14/74) installing mingw-w64-x86_64-libtasn1       [#####################] 100%
-  (15/74) installing mingw-w64-x86_64-p11-kit        [#####################] 100%
-  (16/74) installing mingw-w64-x86_64-ca-certifi...  [#####################] 100%
-  (17/74) installing mingw-w64-x86_64-zlib           [#####################] 100%
-  (18/74) installing mingw-w64-x86_64-openssl        [#####################] 100%
-  (19/74) installing mingw-w64-x86_64-termcap        [#####################] 100%
-  (20/74) installing mingw-w64-x86_64-readline       [#####################] 100%
-  (21/74) installing mingw-w64-x86_64-tcl            [#####################] 100%
-  (22/74) installing mingw-w64-x86_64-tk             [#####################] 100%
-  (23/74) installing mingw-w64-x86_64-python2        [#####################] 100%
-  (24/74) installing mingw-w64-x86_64-binutils       [#####################] 100%
-  (25/74) installing mingw-w64-x86_64-headers-git    [#####################] 100%
-  (26/74) installing mingw-w64-x86_64-crt-git        [#####################] 100%
-  (27/74) installing mingw-w64-x86_64-isl            [#####################] 100%
-  (28/74) installing mingw-w64-x86_64-mpfr           [#####################] 100%
-  (29/74) installing mingw-w64-x86_64-mpc            [#####################] 100%
-  (30/74) installing mingw-w64-x86_64-windows-de...  [#####################] 100%
-  (31/74) installing mingw-w64-x86_64-winpthread...  [#####################] 100%
-  (32/74) installing mingw-w64-x86_64-gcc            [#####################] 100%
-  (33/74) installing bison                           [#####################] 100%
-  (34/74) installing heimdal                         [#####################] 100%
-  (35/74) installing cvs                             [#####################] 100%
-  (36/74) installing diffutils                       [#####################] 100%
-  (37/74) installing expat                           [#####################] 100%
-  (38/74) installing vim                             [#####################] 100%
-  (39/74) installing openssh                         [#####################] 100%
-  (40/74) installing db                              [#####################] 100%
-  (41/74) installing libgdbm                         [#####################] 100%
-  (42/74) installing gdbm                            [#####################] 100%
-  (43/74) installing perl                            [#####################] 100%
-  (44/74) installing perl-Error                      [#####################] 100%
-  (45/74) installing perl-Authen-SASL                [#####################] 100%
-  (46/74) installing perl-Encode-Locale              [#####################] 100%
-  (47/74) installing perl-HTTP-Date                  [#####################] 100%
-  (48/74) installing perl-File-Listing               [#####################] 100%
-  (49/74) installing perl-HTML-Tagset                [#####################] 100%
-  (50/74) installing perl-HTML-Parser                [#####################] 100%
-  (51/74) installing perl-LWP-MediaTypes             [#####################] 100%
-  (52/74) installing perl-URI                        [#####################] 100%
-  (53/74) installing perl-HTTP-Message               [#####################] 100%
-  (54/74) installing perl-HTTP-Cookies               [#####################] 100%
-  (55/74) installing perl-HTTP-Daemon                [#####################] 100%
-  (56/74) installing perl-HTTP-Negotiate             [#####################] 100%
-  (57/74) installing perl-Net-HTTP                   [#####################] 100%
-  (58/74) installing perl-WWW-RobotRules             [#####################] 100%
-  (59/74) installing perl-libwww                     [#####################] 100%
-  Optional dependencies for perl-libwww
-      perl-LWP-Protocol-HTTPS: for https:// url schemes
-  (60/74) installing perl-TimeDate                   [#####################] 100%
-  (61/74) installing perl-MailTools                  [#####################] 100%
-  (62/74) installing perl-IO-stringy                 [#####################] 100%
-  (63/74) installing perl-Convert-BinHex             [#####################] 100%
-  module test... pass.
-  (64/74) installing perl-MIME-tools                 [#####################] 100%
-  (65/74) installing perl-Net-SSLeay                 [#####################] 100%
-  (66/74) installing perl-IO-Socket-SSL              [#####################] 100%
-  (67/74) installing perl-Net-SMTP-SSL               [#####################] 100%
-  (68/74) installing perl-TermReadKey                [#####################] 100%
-  (69/74) installing git                             [#####################] 100%
-  Optional dependencies for git
-      python2: various helper scripts
-      subversion: git svn
-  (70/74) installing make                            [#####################] 100%
-  (71/74) installing patch                           [#####################] 100%
-  Optional dependencies for patch
-      ed: for patch -e functionality
-  (72/74) installing tar                             [#####################] 100%
-  (73/74) installing texinfo                         [#####################] 100%
-  (74/74) installing unzip                           [#####################] 100%
diff --git a/user/installation/developer.rst b/user/installation/developer.rst
index 0bd70f8..3110c96 100644
--- a/user/installation/developer.rst
+++ b/user/installation/developer.rst
@@ -88,6 +88,76 @@ requires:
   RTEMS Source Builder - Check, 5 (089327b5dcf9)
   Environment is ok
 
+If you are unsure how to specify the build set for the architecture you wish to
+build, just ask the tool:
+
+    $ ../source-builder/sb-set-builder --list-bsets   <1>
+    RTEMS Source Builder - Set Builder, v4.11.0
+    Examining: config
+    Examining: ../source-builder/config    <2>
+        4.10/rtems-all.bset      <3>
+        4.10/rtems-arm.bset      <4>
+        4.10/rtems-autotools.bset
+        4.10/rtems-avr.bset
+        4.10/rtems-bfin.bset
+        4.10/rtems-h8300.bset
+        4.10/rtems-i386.bset
+        4.10/rtems-lm32.bset
+        4.10/rtems-m32c.bset
+        4.10/rtems-m32r.bset
+        4.10/rtems-m68k.bset
+        4.10/rtems-mips.bset
+        4.10/rtems-nios2.bset
+        4.10/rtems-powerpc.bset
+        4.10/rtems-sh.bset
+        4.10/rtems-sparc.bset
+        4.11/rtems-all.bset
+        4.11/rtems-arm.bset
+        4.11/rtems-autotools.bset
+        4.11/rtems-avr.bset
+        4.11/rtems-bfin.bset
+        4.11/rtems-h8300.bset
+        4.11/rtems-i386.bset
+        4.11/rtems-lm32.bset
+        4.11/rtems-m32c.bset
+        4.11/rtems-m32r.bset
+        4.11/rtems-m68k.bset
+        4.11/rtems-microblaze.bset
+        4.11/rtems-mips.bset
+        4.11/rtems-moxie.bset
+        4.11/rtems-nios2.bset
+        4.11/rtems-powerpc.bset
+        4.11/rtems-sh.bset
+        4.11/rtems-sparc.bset
+        4.11/rtems-sparc64.bset
+        4.11/rtems-v850.bset
+        4.9/rtems-all.bset
+        4.9/rtems-arm.bset
+        4.9/rtems-autotools.bset
+        4.9/rtems-i386.bset
+        4.9/rtems-m68k.bset
+        4.9/rtems-mips.bset
+        4.9/rtems-powerpc.bset
+        4.9/rtems-sparc.bset
+        gnu-tools-4.6.bset
+        rtems-4.10-base.bset    <5>
+        rtems-4.11-base.bset
+        rtems-4.9-base.bset
+        rtems-base.bset         <5>
+
+.. topic:: Items:
+
+  1. Only option required is ``--list-bsets``
+
+  2. The paths inspected. See :ref:`Configuration`.
+
+  3. A build set to build all RTEMS 4.10 supported architectures.
+
+  4. The build set for the ARM architecture on RTEMS 4.10.
+
+  5. Support build set file with common functionality included by other build
+     set files.
+
 Build a tool chain for the SPARC architecture. We are using the SPARC
 architecture because GDB has a good simulator that lets us run and test the
 samples RTEMS builds by default. The current development version
@@ -637,7 +707,6 @@ Install the kernel to our prefix:
 
 .. code-block:: shell
 
-   /c/opt/rtems/kernel/pc686
   $ make install
   Making install in tools/build
   make[1]: Entering directory '/c/opt/rtems/kernel/pc686/tools/build'
@@ -682,3 +751,4 @@ Install the kernel to our prefix:
   make[1]: Leaving directory '/c/opt/rtems/kernel/pc686'
    /c/opt/rtems/kernel/pc686
   $
+
-- 
1.8.3.1




More information about the devel mailing list