Changeset 5577cc0 in rtems-docs


Ignore:
Timestamp:
Oct 12, 2018, 7:26:16 PM (6 months ago)
Author:
Joel Sherrill <joel@…>
Branches:
master
Children:
969e60e
Parents:
c1809d6
git-author:
Joel Sherrill <joel@…> (10/12/18 19:26:16)
git-committer:
Joel Sherrill <joel@…> (10/14/18 01:06:50)
Message:

Move duplicate host configuration information from RSB to Users Guide

Files:
1 deleted
5 edited

Legend:

Unmodified
Added
Removed
  • rsb/index.rst

    rc1809d6 r5577cc0  
    5555        source-builder
    5656        building-tools-and-rtems.rst
    57         hosts
    5857        project-sets
    5958        cross-canadian-cross
  • user/hosts/macos.rst

    rc1809d6 r5577cc0  
    66.. _macos:
    77
    8 Apple OS X
    9 ==========
     8Apple MacOS
     9===========
    1010
    1111Apple's OS X is fully supported. You need to download and install a recent
     
    2020
    2121:ref:`prefixes` details using Prefixes to manage the installation.
     22
     23MacOS
     24.. _Mavericks:
     25
     26Mavericks
     27~~~~~~~~~
     28
     29The RSB works on Mavericks and the GNU tools can be built for RTEMS using the
     30Mavericks clang LLVM tool chain. You will need to build and install a couple of
     31packages to make the RSB pass the ``sb-check``. These are CVS and XZ. You can get
     32these tools from a packaging tool for MacOS such as *MacPorts* or *HomeBrew*.
     33
     34I do not use 3rd party packaging on MacOS and prefer to build the packages from
     35source using a prefix of ``/usr/local``. There are good 3rd party packages around
     36however they sometimes bring in extra dependence and that complicates my build
     37environment and I want to know the minimal requirements when building
     38tools. The following are required:
     39
     40. The XZ package's home page is http://tukaani.org/xz/ and I use version
     41  5.0.5. XZ builds and installs cleanly.
     42
     43Sierra
     44~~~~~~
     45
     46The RSB works on Sierra with the latest Xcode.
     47
     48
  • user/hosts/posix.rst

    rc1809d6 r5577cc0  
    3838control of the machine. We call this project sandboxing and
    3939:ref:`project-sandboxing` explains this in more detail.
     40
     41Linux
     42-----
     43
     44A number of different Linux distrubutions are known to work. The following have
     45been tested and report as working.
     46
     47.. _ArchLinux:
     48
     49ArchLinux
     50~~~~~~~~~
     51
     52The following packages are required on a fresh Archlinux 64bit installation::
     53
     54    # pacman -S base-devel gdb xz unzip ncurses git zlib
     55
     56Archlinux, by default installs ``texinfo-5`` which is incompatible for building
     57GCC 4.7 tree. You will have to obtain ``texinfo-legacy`` from ``AUR`` and
     58provide a manual override::
     59
     60    # pacman -R texinfo
     61    $ yaourt -S texinfo-legacy
     62    # ln -s /usr/bin/makeinfo-4.13a /usr/bin/makeinfo
     63
     64.. _CentOS:
     65
     66CentOS
     67~~~~~~
     68
     69The following packages are required on a minimal CentOS 6.3 64bit installation::
     70
     71    # yum install autoconf automake binutils gcc gcc-c++ gdb make patch \
     72    bison flex xz unzip ncurses-devel texinfo zlib-devel python-devel git
     73
     74The minimal CentOS distribution is a specific DVD that installs a minimal
     75system. If you use a full system some of these packages may have been
     76installed.
     77
     78.. _Fedora:
     79
     80Fedora
     81~~~~~~
     82
     83The RTEMS Source Builder has been tested on Fedora 19 64bit with the following
     84packages::
     85
     86    # yum install ncurses-devel python-devel git bison gcc cvs gcc-c++ \
     87         flex texinfo patch perl-Text-ParseWords zlib-devel
     88
     89.. _Raspbian:
     90
     91Raspbian
     92~~~~~~~~
     93
     94The is the Debian distribution for the Raspberry Pi. The following packages are
     95required::
     96
     97    $ sudo apt-get install autoconf automake bison flex binutils gcc g++ gdb \
     98    texinfo unzip ncurses-dev python-dev git
     99
     100It is recommended you get Model B of the Pi with 512M of memory and to mount a
     101remote disk over the network. The tools can be built on the network disk with a
     102prefix under your home directory as recommended and end up on the SD card.
     103
     104.. _Ubuntu:
     105.. _Xubuntu:
     106
     107Ubuntu
     108~~~~~~
     109
     110The latest version is Ubuntu 16.04.1 LTS 64bit. This section also includes
     111Xubuntu. A minimal installation was used and the following packages installed::
     112
     113    $ sudo apt-get build-dep binutils gcc g++ gdb unzip pax bison flex
     114    $ sudo apt-get install python2.7-dev git libncurses5-dev zlib1g-dev
     115
     116.. _Linux Mint:
     117
     118Linux Mint
     119~~~~~~~~~~
     120
     121zlib package is required on Linux Mint. It has a different name (other
     122than the usual zlib-dev)::
     123
     124    # sudo apt-get install zlib1g-dev
     125
     126.. _openSUSE:
     127
     128openSUSE
     129~~~~~~~~
     130
     131This has been reported to work but no instructions were provided. This is an
     132opportunity to contribute. Please submit any guidance you can provide.
     133
     134.. _FreeBSD:
     135
     136FreeBSD
     137-------
     138
     139The RTEMS Source Builder has been tested on FreeBSD 9.1, 10.3 and 11 64bit
     140version. You need to install some ports. They are::
     141
     142    # cd /usr/ports
     143    # portinstall --batch lang/python27
     144
     145If you wish to build Windows (mingw32) tools please install the following
     146ports::
     147
     148    # cd /usr/ports
     149    # portinstall --batch devel/mingw32-binutils devel/mingw32-gcc
     150    # portinstall --batch devel/mingw32-zlib devel/mingw32-pthreads
     151
     152The +zlip+ and +pthreads+ ports for MinGW32 are used for builiding a Windows
     153QEMU.
     154
     155If you are on FreeBSD 10.0 and you have pkgng installed you can use 'pkg
     156install' rather than 'portinstall'.
     157
     158.. _NetBSD:
     159
     160NetBSD
     161------
     162
     163The RTEMS Source Builder has been tested on NetBSD 6.1 i386. Packages to add
     164are::
     165
     166    # pkg_add ftp://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.1/devel/gmake-3.82nb7.tgz
     167    # pkg_add ftp://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.1/devel/bison-2.7.1.tgz
     168    # pkg_add ftp://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.1/archivers/xz-5.0.4.tgz
     169
     170.. _MacOS:
     171
  • user/hosts/windows.rst

    rc1809d6 r5577cc0  
    1717:r:list:`users`.
    1818
    19 The RTEMS Project's Windows tools are native Windows executables giving the
    20 user the best possible experience on Windows. Native Windows programs use the
    21 standard Windows DLLs and paths. Integration with standard Windows integrated
    22 development tools such as editors is straight forward. POSIX emulation
    23 environments such as Cygwin and the MSYS2 shell have special executables that
    24 require a POSIX emulation DLL and these emulation DLLs add an extra layer of
    25 complexity as well as a performance over-head. The RTEMS Project uses these
    26 POSIX emulation shells to run configure scripts that come with various open
    27 source packages such as `gcc` so they form an important and valued part of the
    28 environment we describe here. The output of this procedure forms the tools you
    29 use during your application development and they do not depend on the emulation
    30 DLLs.
    31 
    32 The performance of the compiler is as good as you can have on Windows and the
    33 performance compiling a single file will be similar to that on a host like
    34 Linux or FreeBSD given the same hardware. Building the tools from source is
    35 much slower on Windows because POSIX shells and related tools are used and the
    36 POSIX emulation overhead it much much slower than a native POSIX operating
    37 system like Linux and FreeBSD. This overhead is only during the building of the
    38 tools and the RTEMS kernel and if you use a suitable build system that is
    39 native to Windows your application development should be similar to other
    40 operating systems.
     19The RTEMS Project's Windows tools can be native Windows executables
     20which give the user the best possible experience on Windows. Native
     21Windows programs use the standard Windows DLLs and paths. Integration
     22with standard Windows integrated development tools such as editors is
     23straight forward. POSIX emulation environments such as Cygwin and the
     24MSYS2 shell have special executables that require a POSIX emulation DLL
     25and these emulation DLLs add an extra layer of complexity as well as a
     26performance over-head. The RTEMS Project uses these POSIX emulation shells
     27to run configure scripts that come with various open source packages such
     28as `gcc` so they form an important and valued part of the environment we
     29describe here. The output of this procedure forms the tools you use during
     30your application development and they do not depend on the emulation DLLs.
     31
     32The performance of a native Windows compiler is as good as you can have
     33on Windows and the performance compiling a single file will be similar to
     34that on a host like Linux or FreeBSD given the same hardware. Building
     35the tools from source is much slower on Windows because POSIX shells
     36and related tools are used and the POSIX emulation overhead it much much
     37slower than a native POSIX operating system like Linux and FreeBSD. This
     38overhead is only during the building of the tools and the RTEMS kernel
     39and if you use a suitable build system that is native to Windows your
     40application development should be similar to other operating systems.
    4141
    4242Building is known to work on `Windows 7 64bit Professional` and `Windows 10`.
     
    113113.. _microsoft-windows-installation:
    114114
    115 Installing MSYS2
    116 ----------------
     115MSYS2
     116-----
    117117
    118118MSYS2 is installed on a new machine using the MSYS2 installer found on
     
    160160.. code-block:: shell
    161161
    162   ~
    163162  $ pacman -S python mingw-w64-x86_64-python2 mingw-w64-x86_64-gcc \
    164163  bison cvs diffutils git make patch tar texinfo unzip
    165164  resolving dependencies...
    166165  looking for conflicting packages...
    167 
    168   Packages (74) db-5.3.28-2  expat-2.1.0-2  gdbm-1.11-3  heimdal-1.5.3-8
    169                 libgdbm-1.11-3  mingw-w64-x86_64-binutils-2.26-21
    170                 mingw-w64-x86_64-bzip2-1.0.6-5
    171                 mingw-w64-x86_64-ca-certificates-20150426-2
    172                 mingw-w64-x86_64-crt-git-5.0.0.4627.03684c4-1
    173                 mingw-w64-x86_64-expat-2.1.0-6  mingw-w64-x86_64-gcc-libs-5.3.0-2
    174                 mingw-w64-x86_64-gdbm-1.11-3  mingw-w64-x86_64-gettext-0.19.6-2
    175                 mingw-w64-x86_64-gmp-6.1.0-1
    176                 mingw-w64-x86_64-headers-git-5.0.0.4627.53be55d-1
    177                 mingw-w64-x86_64-isl-0.15-1  mingw-w64-x86_64-libffi-3.2.1-3
    178                 mingw-w64-x86_64-libiconv-1.14-5
    179                 mingw-w64-x86_64-libsystre-1.0.1-2
    180                 mingw-w64-x86_64-libtasn1-4.7-1
    181                 mingw-w64-x86_64-libtre-git-r122.c2f5d13-4
    182                 mingw-w64-x86_64-libwinpthread-git-5.0.0.4573.628fdbf-1
    183                 mingw-w64-x86_64-mpc-1.0.3-2  mingw-w64-x86_64-mpfr-3.1.3.p0-2
    184                 mingw-w64-x86_64-ncurses-6.0.20160220-2
    185                 mingw-w64-x86_64-openssl-1.0.2.g-1
    186                 mingw-w64-x86_64-p11-kit-0.23.1-3
    187                 mingw-w64-x86_64-readline-6.3.008-1  mingw-w64-x86_64-tcl-8.6.5-1
    188                 mingw-w64-x86_64-termcap-1.3.1-2  mingw-w64-x86_64-tk-8.6.5-1
    189                 mingw-w64-x86_64-windows-default-manifest-6.4-2
    190                 mingw-w64-x86_64-winpthreads-git-5.0.0.4573.628fdbf-1
    191                 mingw-w64-x86_64-zlib-1.2.8-9  openssh-7.1p2-1  perl-5.22.0-2
    192                 perl-Authen-SASL-2.16-2  perl-Convert-BinHex-1.123-2
    193                 perl-Encode-Locale-1.04-1  perl-Error-0.17024-1
    194                 perl-File-Listing-6.04-2  perl-HTML-Parser-3.71-3
    195                 perl-HTML-Tagset-3.20-2  perl-HTTP-Cookies-6.01-2
    196                 perl-HTTP-Daemon-6.01-2  perl-HTTP-Date-6.02-2
    197                 perl-HTTP-Message-6.06-2  perl-HTTP-Negotiate-6.01-2
    198                 perl-IO-Socket-SSL-2.016-1  perl-IO-stringy-2.111-1
    199                 perl-LWP-MediaTypes-6.02-2  perl-MIME-tools-5.506-1
    200                 perl-MailTools-2.14-1  perl-Net-HTTP-6.09-1
    201                 perl-Net-SMTP-SSL-1.02-1  perl-Net-SSLeay-1.70-1
    202                 perl-TermReadKey-2.33-1  perl-TimeDate-2.30-2  perl-URI-1.68-1
    203                 perl-WWW-RobotRules-6.02-2  perl-libwww-6.13-1  vim-7.4.1468-1
    204                 bison-3.0.4-1  cvs-1.11.23-2  diffutils-3.3-3  git-2.7.2-1
    205                 make-4.1-4  mingw-w64-x86_64-gcc-5.3.0-2
    206                 mingw-w64-x86_64-python2-2.7.11-4  patch-2.7.5-1  python-3.4.3-3
    207                 tar-1.28-3  texinfo-6.0-1  unzip-6.0-2
    208 
    209   Total Download Size:   114.10 MiB
    210   Total Installed Size:  689.61 MiB
    211 
    212   :: Proceed with installation? [Y/n] y
    213   :: Retrieving packages...
    214    mingw-w64-x86_64-gm...   477.1 KiB   681K/s 00:01 [#####################] 100%
    215    mingw-w64-x86_64-li...    24.2 KiB   755K/s 00:00 [#####################] 100%
    216    mingw-w64-x86_64-gc...   541.9 KiB   705K/s 00:01 [#####################] 100%
    217    mingw-w64-x86_64-ex...   106.7 KiB   702K/s 00:00 [#####################] 100%
    218    mingw-w64-x86_64-bz...    77.9 KiB   666K/s 00:00 [#####################] 100%
    219    mingw-w64-x86_64-li...   600.2 KiB   703K/s 00:01 [#####################] 100%
    220    mingw-w64-x86_64-ge...     3.0 MiB   700K/s 00:04 [#####################] 100%
    221    mingw-w64-x86_64-gd...   151.8 KiB   483K/s 00:00 [#####################] 100%
    222    mingw-w64-x86_64-li...    34.5 KiB   705K/s 00:00 [#####################] 100%
    223    mingw-w64-x86_64-li...    69.2 KiB   713K/s 00:00 [#####################] 100%
    224    mingw-w64-x86_64-li...     9.3 KiB   778K/s 00:00 [#####################] 100%
    225    mingw-w64-x86_64-nc...  1800.5 KiB   701K/s 00:03 [#####################] 100%
    226    mingw-w64-x86_64-li...   171.4 KiB   708K/s 00:00 [#####################] 100%
    227    mingw-w64-x86_64-p1...   193.5 KiB   709K/s 00:00 [#####################] 100%
    228    mingw-w64-x86_64-ca...   382.1 KiB   705K/s 00:01 [#####################] 100%
    229    mingw-w64-x86_64-zl...   148.6 KiB   704K/s 00:00 [#####################] 100%
    230    mingw-w64-x86_64-op...     3.3 MiB   624K/s 00:05 [#####################] 100%
    231    mingw-w64-x86_64-te...    12.6 KiB  76.7K/s 00:00 [#####################] 100%
    232    mingw-w64-x86_64-re...   327.4 KiB   277K/s 00:01 [#####################] 100%
    233    mingw-w64-x86_64-tc...     2.9 MiB   699K/s 00:04 [#####################] 100%
    234    mingw-w64-x86_64-tk...  1869.2 KiB   703K/s 00:03 [#####################] 100%
    235    mingw-w64-x86_64-py...    10.9 MiB   699K/s 00:16 [#####################] 100%
    236    mingw-w64-x86_64-bi...    12.7 MiB   688K/s 00:19 [#####################] 100%
    237    mingw-w64-x86_64-he...     5.0 MiB   645K/s 00:08 [#####################] 100%
    238    mingw-w64-x86_64-cr...     2.6 MiB   701K/s 00:04 [#####################] 100%
    239    mingw-w64-x86_64-is...   524.3 KiB   684K/s 00:01 [#####################] 100%
    240    mingw-w64-x86_64-mp...   265.2 KiB   705K/s 00:00 [#####################] 100%
    241    mingw-w64-x86_64-mp...    62.3 KiB  82.9K/s 00:01 [#####################] 100%
    242    mingw-w64-x86_64-wi...  1484.0   B  0.00B/s 00:00 [#####################] 100%
    243    mingw-w64-x86_64-wi...    33.2 KiB   346K/s 00:00 [#####################] 100%
    244    mingw-w64-x86_64-gc...    25.1 MiB   701K/s 00:37 [#####################] 100%
    245    python-3.4.3-3-x86_64     12.1 MiB   700K/s 00:18 [#####################] 100%
    246    bison-3.0.4-1-x86_64    1045.1 KiB   703K/s 00:01 [#####################] 100%
    247    heimdal-1.5.3-8-x86_64   543.7 KiB   703K/s 00:01 [#####################] 100%
    248    cvs-1.11.23-2-x86_64     508.2 KiB   388K/s 00:01 [#####################] 100%
    249    diffutils-3.3-3-x86_64   265.7 KiB   478K/s 00:01 [#####################] 100%
    250    expat-2.1.0-2-x86_64      13.1 KiB   817K/s 00:00 [#####################] 100%
    251    vim-7.4.1468-1-x86_64      6.1 MiB   700K/s 00:09 [#####################] 100%
    252    openssh-7.1p2-1-x86_64   653.4 KiB   703K/s 00:01 [#####################] 100%
    253    db-5.3.28-2-x86_64        41.7 KiB   719K/s 00:00 [#####################] 100%
    254    libgdbm-1.11-3-x86_64     20.4 KiB   754K/s 00:00 [#####################] 100%
    255    gdbm-1.11-3-x86_64       108.5 KiB   704K/s 00:00 [#####################] 100%
    256    perl-5.22.0-2-x86_64      12.4 MiB   702K/s 00:18 [#####################] 100%
    257    perl-Error-0.17024-...    17.1 KiB   742K/s 00:00 [#####################] 100%
    258    perl-Authen-SASL-2....    42.4 KiB   731K/s 00:00 [#####################] 100%
    259    perl-Encode-Locale-...     9.7 KiB   745K/s 00:00 [#####################] 100%
    260    perl-HTTP-Date-6.02...     8.6 KiB   784K/s 00:00 [#####################] 100%
    261    perl-File-Listing-6...     7.7 KiB   769K/s 00:00 [#####################] 100%
    262    perl-HTML-Tagset-3....    10.3 KiB   732K/s 00:00 [#####################] 100%
    263    perl-HTML-Parser-3....    76.9 KiB   516K/s 00:00 [#####################] 100%
    264    perl-LWP-MediaTypes...    18.0 KiB   752K/s 00:00 [#####################] 100%
    265    perl-URI-1.68-1-any       75.6 KiB   609K/s 00:00 [#####################] 100%
    266    perl-HTTP-Message-6...    71.3 KiB   625K/s 00:00 [#####################] 100%
    267    perl-HTTP-Cookies-6...    20.4 KiB   499K/s 00:00 [#####################] 100%
    268    perl-HTTP-Daemon-6....    14.2 KiB   749K/s 00:00 [#####################] 100%
    269    perl-HTTP-Negotiate...    11.4 KiB   817K/s 00:00 [#####################] 100%
    270    perl-Net-HTTP-6.09-...    19.8 KiB   732K/s 00:00 [#####################] 100%
    271    perl-WWW-RobotRules...    12.2 KiB   766K/s 00:00 [#####################] 100%
    272    perl-libwww-6.13-1-any   122.2 KiB   661K/s 00:00 [#####################] 100%
    273    perl-TimeDate-2.30-...    35.9 KiB   718K/s 00:00 [#####################] 100%
    274    perl-MailTools-2.14...    58.4 KiB   712K/s 00:00 [#####################] 100%
    275    perl-IO-stringy-2.1...    52.6 KiB   721K/s 00:00 [#####################] 100%
    276    perl-Convert-BinHex...    30.1 KiB   733K/s 00:00 [#####################] 100%
    277    perl-MIME-tools-5.5...   180.4 KiB   705K/s 00:00 [#####################] 100%
    278    perl-Net-SSLeay-1.7...   191.2 KiB   708K/s 00:00 [#####################] 100%
    279    perl-IO-Socket-SSL-...   112.5 KiB   703K/s 00:00 [#####################] 100%
    280    perl-Net-SMTP-SSL-1...     3.5 KiB   881K/s 00:00 [#####################] 100%
    281    perl-TermReadKey-2....    20.9 KiB   745K/s 00:00 [#####################] 100%
    282    git-2.7.2-1-x86_64         3.6 MiB   702K/s 00:05 [#####################] 100%
    283    make-4.1-4-x86_64        387.0 KiB   671K/s 00:01 [#####################] 100%
    284    patch-2.7.5-1-x86_64      75.9 KiB   684K/s 00:00 [#####################] 100%
    285    tar-1.28-3-x86_64        671.9 KiB   379K/s 00:02 [#####################] 100%
    286    texinfo-6.0-1-x86_64     992.7 KiB   625K/s 00:02 [#####################] 100%
    287    unzip-6.0-2-x86_64        93.1 KiB   705K/s 00:00 [#####################] 100%
    288   (74/74) checking keys in keyring                   [#####################] 100%
    289   (74/74) checking package integrity                 [#####################] 100%
    290   (74/74) loading package files                      [#####################] 100%
    291   (74/74) checking for file conflicts                [#####################] 100%
    292   (74/74) checking available disk space              [#####################] 100%
    293   :: Processing package changes...
    294   ( 1/74) installing python                          [#####################] 100%
    295   ( 2/74) installing mingw-w64-x86_64-gmp            [#####################] 100%
    296   ( 3/74) installing mingw-w64-x86_64-libwinpthr...  [#####################] 100%
    297   ( 4/74) installing mingw-w64-x86_64-gcc-libs       [#####################] 100%
    298   ( 5/74) installing mingw-w64-x86_64-expat          [#####################] 100%
    299   ( 6/74) installing mingw-w64-x86_64-bzip2          [#####################] 100%
    300   ( 7/74) installing mingw-w64-x86_64-libiconv       [#####################] 100%
    301   ( 8/74) installing mingw-w64-x86_64-gettext        [#####################] 100%
    302   ( 9/74) installing mingw-w64-x86_64-gdbm           [#####################] 100%
    303   (10/74) installing mingw-w64-x86_64-libffi         [#####################] 100%
    304   (11/74) installing mingw-w64-x86_64-libtre-git     [#####################] 100%
    305   (12/74) installing mingw-w64-x86_64-libsystre      [#####################] 100%
    306   (13/74) installing mingw-w64-x86_64-ncurses        [#####################] 100%
    307   (14/74) installing mingw-w64-x86_64-libtasn1       [#####################] 100%
    308   (15/74) installing mingw-w64-x86_64-p11-kit        [#####################] 100%
    309   (16/74) installing mingw-w64-x86_64-ca-certifi...  [#####################] 100%
    310   (17/74) installing mingw-w64-x86_64-zlib           [#####################] 100%
    311   (18/74) installing mingw-w64-x86_64-openssl        [#####################] 100%
    312   (19/74) installing mingw-w64-x86_64-termcap        [#####################] 100%
    313   (20/74) installing mingw-w64-x86_64-readline       [#####################] 100%
    314   (21/74) installing mingw-w64-x86_64-tcl            [#####################] 100%
    315   (22/74) installing mingw-w64-x86_64-tk             [#####################] 100%
    316   (23/74) installing mingw-w64-x86_64-python2        [#####################] 100%
    317   (24/74) installing mingw-w64-x86_64-binutils       [#####################] 100%
    318   (25/74) installing mingw-w64-x86_64-headers-git    [#####################] 100%
    319   (26/74) installing mingw-w64-x86_64-crt-git        [#####################] 100%
    320   (27/74) installing mingw-w64-x86_64-isl            [#####################] 100%
    321   (28/74) installing mingw-w64-x86_64-mpfr           [#####################] 100%
    322   (29/74) installing mingw-w64-x86_64-mpc            [#####################] 100%
    323   (30/74) installing mingw-w64-x86_64-windows-de...  [#####################] 100%
    324   (31/74) installing mingw-w64-x86_64-winpthread...  [#####################] 100%
    325   (32/74) installing mingw-w64-x86_64-gcc            [#####################] 100%
    326   (33/74) installing bison                           [#####################] 100%
    327   (34/74) installing heimdal                         [#####################] 100%
    328   (35/74) installing cvs                             [#####################] 100%
    329   (36/74) installing diffutils                       [#####################] 100%
    330   (37/74) installing expat                           [#####################] 100%
    331   (38/74) installing vim                             [#####################] 100%
    332   (39/74) installing openssh                         [#####################] 100%
    333   (40/74) installing db                              [#####################] 100%
    334   (41/74) installing libgdbm                         [#####################] 100%
    335   (42/74) installing gdbm                            [#####################] 100%
    336   (43/74) installing perl                            [#####################] 100%
    337   (44/74) installing perl-Error                      [#####################] 100%
    338   (45/74) installing perl-Authen-SASL                [#####################] 100%
    339   (46/74) installing perl-Encode-Locale              [#####################] 100%
    340   (47/74) installing perl-HTTP-Date                  [#####################] 100%
    341   (48/74) installing perl-File-Listing               [#####################] 100%
    342   (49/74) installing perl-HTML-Tagset                [#####################] 100%
    343   (50/74) installing perl-HTML-Parser                [#####################] 100%
    344   (51/74) installing perl-LWP-MediaTypes             [#####################] 100%
    345   (52/74) installing perl-URI                        [#####################] 100%
    346   (53/74) installing perl-HTTP-Message               [#####################] 100%
    347   (54/74) installing perl-HTTP-Cookies               [#####################] 100%
    348   (55/74) installing perl-HTTP-Daemon                [#####################] 100%
    349   (56/74) installing perl-HTTP-Negotiate             [#####################] 100%
    350   (57/74) installing perl-Net-HTTP                   [#####################] 100%
    351   (58/74) installing perl-WWW-RobotRules             [#####################] 100%
    352   (59/74) installing perl-libwww                     [#####################] 100%
    353   Optional dependencies for perl-libwww
    354       perl-LWP-Protocol-HTTPS: for https:// url schemes
    355   (60/74) installing perl-TimeDate                   [#####################] 100%
    356   (61/74) installing perl-MailTools                  [#####################] 100%
    357   (62/74) installing perl-IO-stringy                 [#####################] 100%
    358   (63/74) installing perl-Convert-BinHex             [#####################] 100%
    359   module test... pass.
    360   (64/74) installing perl-MIME-tools                 [#####################] 100%
    361   (65/74) installing perl-Net-SSLeay                 [#####################] 100%
    362   (66/74) installing perl-IO-Socket-SSL              [#####################] 100%
    363   (67/74) installing perl-Net-SMTP-SSL               [#####################] 100%
    364   (68/74) installing perl-TermReadKey                [#####################] 100%
    365   (69/74) installing git                             [#####################] 100%
    366   Optional dependencies for git
    367       python2: various helper scripts
    368       subversion: git svn
    369   (70/74) installing make                            [#####################] 100%
    370   (71/74) installing patch                           [#####################] 100%
    371   Optional dependencies for patch
    372       ed: for patch -e functionality
    373   (72/74) installing tar                             [#####################] 100%
    374   (73/74) installing texinfo                         [#####################] 100%
    375   (74/74) installing unzip                           [#####################] 100%
     166      .... output shortened for brevity ....
     167
     168.. _Cygwin:
     169
     170Cygwin
     171------
     172
     173Building on Windows is a little more complicated because the Cygwin shell is
     174used rather than the MSYS2 shell. The MSYS2 shell is simpler because the
     175detected host triple is MinGW so the build is a standard cross-compiler build.
     176A Canadian cross-build using Cygwin is supported if you would like native
     177tools or you can use a Cygwin built set of tools.
     178
     179Install a recent Cygwin version using the Cygwin setup tool. Select and install
     180the groups and packages listed:
     181
     182.. table:: Cygwin Packages
     183
     184  ======= =========================
     185  Group   Package
     186  Archive bsdtar
     187  Archive unzip
     188  Archive xz
     189  Devel   autoconf
     190  Devel   autoconf2.1
     191  Devel   autoconf2.5
     192  Devel   automake
     193  Devel   binutils
     194  Devel   bison
     195  Devel   flex
     196  Devel   gcc4-core
     197  Devel   gcc4-g++
     198  Devel   git
     199  Devel   make
     200  Devel   mingw64-x86_64-binutils
     201  Devel   mingw64-x86_64-gcc-core
     202  Devel   mingw64-x86_64-g++
     203  Devel   mingw64-x86_64-runtime
     204  Devel   mingw64-x86_64-zlib
     205  Devel   patch
     206  Devel   zlib-devel
     207  MinGW   mingw-zlib-devel
     208  Python  python
     209  ======= =========================
     210
     211The setup tool will add a number of dependent package and it is ok to accept
     212them.
     213
     214Disabling Windows Defender improves performance if you have another up to date
     215virus detection tool installed and enabled. The excellent ``Process Hacker 2``
     216tool can monitor the performance and the Windows Defender service contributed a
     217high load. In this case a 3rd party virus tool was installed so the Windows
     218Defender service was not needed.
     219
     220To build a MinGW tool chain a Canadian cross-compile (Cxc) is required on
     221Cygwin because the host is Cygwin therefore a traditional cross-compile will
     222result in Cygiwn binaries. With a Canadian cross-compile a Cygwin
     223cross-compiler is built as well as the MinGW RTEMS cross-compiler. The Cygwin
     224cross-compiler is required to build the C runtime for the RTEMS target because
     225we are building under Cygiwn. The build output for an RTEMS 4.10 ARM tool set
     226is::
     227
     228    chris@cygthing ~/development/rtems/src/rtems-source-builder/rtems
     229    $ ../source-builder/sb-set-builder --log=l-arm.txt --prefix=$HOME/development/rtems/4.10 4.10/rtems-arm
     230    RTEMS Source Builder - Set Builder, v0.2
     231    Build Set: 4.10/rtems-arm
     232    config: expat-2.1.0-1.cfg
     233    package: expat-2.1.0-x86_64-w64-mingw32-1
     234    building: expat-2.1.0-x86_64-w64-mingw32-1
     235    reporting: expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-w64-mingw32-1.html
     236    config: tools/rtems-binutils-2.20.1-1.cfg
     237    package: arm-rtems4.10-binutils-2.20.1-1   <1>
     238    building: arm-rtems4.10-binutils-2.20.1-1
     239    package: (Cxc) arm-rtems4.10-binutils-2.20.1-1   <2>
     240    building: (Cxc) arm-rtems4.10-binutils-2.20.1-1
     241    reporting: tools/rtems-binutils-2.20.1-1.cfg ->
     242    arm-rtems4.10-binutils-2.20.1-1.html
     243    config: tools/rtems-gcc-4.4.7-newlib-1.18.0-1.cfg
     244    package: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
     245    building: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
     246    package: (Cxc) arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
     247    building: (Cxc) arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
     248    reporting: tools/rtems-gcc-4.4.7-newlib-1.18.0-1.cfg ->
     249    arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1.html
     250    config: tools/rtems-gdb-7.3.1-1.cfg
     251    package: arm-rtems4.10-gdb-7.3.1-1
     252    building: arm-rtems4.10-gdb-7.3.1-1
     253    reporting: tools/rtems-gdb-7.3.1-1.cfg -> arm-rtems4.10-gdb-7.3.1-1.html
     254    config: tools/rtems-kernel-4.10.2.cfg
     255    package: arm-rtems4.10-kernel-4.10.2-1
     256    building: arm-rtems4.10-kernel-4.10.2-1
     257    reporting: tools/rtems-kernel-4.10.2.cfg -> arm-rtems4.10-kernel-4.10.2-1.html
     258    installing: expat-2.1.0-x86_64-w64-mingw32-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
     259    installing: arm-rtems4.10-binutils-2.20.1-1 -> /cygdrive/c/Users/chris/development/rtems/4.10 <3>
     260    installing: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
     261    installing: arm-rtems4.10-gdb-7.3.1-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
     262    installing: arm-rtems4.10-kernel-4.10.2-1 -> /cygdrive/c/Users/chris/development/rtems/4.10
     263    cleaning: expat-2.1.0-x86_64-w64-mingw32-1
     264    cleaning: arm-rtems4.10-binutils-2.20.1-1
     265    cleaning: arm-rtems4.10-gcc-4.4.7-newlib-1.18.0-1
     266    cleaning: arm-rtems4.10-gdb-7.3.1-1
     267    cleaning: arm-rtems4.10-kernel-4.10.2-1
     268    Build Set: Time 10:09:42.810547   <4>
     269
     270.. topic:: Items:
     271
     272  1. The Cygwin version of the ARM cross-binutils.
     273
     274  2. The +(Cxc)+ indicates this is the MinGW build of the package.
     275
     276  3. Only the MinGW version is installed.
     277
     278  4. Cygwin is slow so please be patient. This time was on an AMD Athlon 64bit
     279     Dual Core 6000+ running at 3GHz with 4G RAM running Windows 7 64bit.
     280
     281.. warning::
     282
     283  Cygwin documents the 'Big List Of Dodgy Apps' or 'BLODA'. The link is
     284  http://cygwin.com/faq/faq.html#faq.using.bloda and it is worth a look. You
     285  will see a large number of common pieces of software found on Windows systems
     286  that can cause problems. My testing has been performed with NOD32 running and
     287  I have seen some failures. The list is for all of Cygwin so I am not sure
     288  which of the listed programs effect the RTEMS Source Biulder. The following
     289  FAQ item talks about *fork* failures and presents some technical reasons they
     290  cannot be avoided in all cases. Cygwin and it's fork MSYS are fantastic
     291  pieces of software in a difficult environment. I have found building a single
     292  tool tends to work, building all at once is harder.
     293
  • user/installation/developer.rst

    rc1809d6 r5577cc0  
    8888  RTEMS Source Builder - Check, 5 (089327b5dcf9)
    8989  Environment is ok
     90
     91If you are unsure how to specify the build set for the architecture you wish to
     92build, just ask the tool:
     93
     94    $ ../source-builder/sb-set-builder --list-bsets   <1>
     95    RTEMS Source Builder - Set Builder, v4.11.0
     96    Examining: config
     97    Examining: ../source-builder/config    <2>
     98        4.10/rtems-all.bset      <3>
     99        4.10/rtems-arm.bset      <4>
     100        4.10/rtems-autotools.bset
     101        4.10/rtems-avr.bset
     102        4.10/rtems-bfin.bset
     103        4.10/rtems-h8300.bset
     104        4.10/rtems-i386.bset
     105        4.10/rtems-lm32.bset
     106        4.10/rtems-m32c.bset
     107        4.10/rtems-m32r.bset
     108        4.10/rtems-m68k.bset
     109        4.10/rtems-mips.bset
     110        4.10/rtems-nios2.bset
     111        4.10/rtems-powerpc.bset
     112        4.10/rtems-sh.bset
     113        4.10/rtems-sparc.bset
     114        4.11/rtems-all.bset
     115        4.11/rtems-arm.bset
     116        4.11/rtems-autotools.bset
     117        4.11/rtems-avr.bset
     118        4.11/rtems-bfin.bset
     119        4.11/rtems-h8300.bset
     120        4.11/rtems-i386.bset
     121        4.11/rtems-lm32.bset
     122        4.11/rtems-m32c.bset
     123        4.11/rtems-m32r.bset
     124        4.11/rtems-m68k.bset
     125        4.11/rtems-microblaze.bset
     126        4.11/rtems-mips.bset
     127        4.11/rtems-moxie.bset
     128        4.11/rtems-nios2.bset
     129        4.11/rtems-powerpc.bset
     130        4.11/rtems-sh.bset
     131        4.11/rtems-sparc.bset
     132        4.11/rtems-sparc64.bset
     133        4.11/rtems-v850.bset
     134        4.9/rtems-all.bset
     135        4.9/rtems-arm.bset
     136        4.9/rtems-autotools.bset
     137        4.9/rtems-i386.bset
     138        4.9/rtems-m68k.bset
     139        4.9/rtems-mips.bset
     140        4.9/rtems-powerpc.bset
     141        4.9/rtems-sparc.bset
     142        gnu-tools-4.6.bset
     143        rtems-4.10-base.bset    <5>
     144        rtems-4.11-base.bset
     145        rtems-4.9-base.bset
     146        rtems-base.bset         <5>
     147
     148.. topic:: Items:
     149
     150  1. Only option required is ``--list-bsets``
     151
     152  2. The paths inspected. See :ref:`Configuration`.
     153
     154  3. A build set to build all RTEMS 4.10 supported architectures.
     155
     156  4. The build set for the ARM architecture on RTEMS 4.10.
     157
     158  5. Support build set file with common functionality included by other build
     159     set files.
    90160
    91161Build a tool chain for the SPARC architecture. We are using the SPARC
     
    638708.. code-block:: shell
    639709
    640    /c/opt/rtems/kernel/pc686
    641710  $ make install
    642711  Making install in tools/build
     
    683752   /c/opt/rtems/kernel/pc686
    684753  $
     754
Note: See TracChangeset for help on using the changeset viewer.