[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