Changeset 27bcdfb in rtems-docs


Ignore:
Timestamp:
Mar 22, 2016, 1:54:39 AM (4 years ago)
Author:
Chris Johns <chrisj@…>
Branches:
4.11, master
Children:
2151927
Parents:
024e040
git-author:
Chris Johns <chrisj@…> (03/22/16 01:54:39)
git-committer:
Amar Takhar <verm@…> (05/03/16 00:51:27)
Message:

Add a basics section to Getting Started. Rearrange the content.

Location:
user
Files:
1 added
7 edited

Legend:

Unmodified
Added
Removed
  • user/conf.py

    r024e040 r27bcdfb  
    1111exclude_patterns = ['config/build.rst',
    1212                    'config/runtime.rst',
     13                    'start/basics.rst',
    1314                    'start/depend.rst',
    1415                    'start/transition.rst',
  • user/start/depend.rst

    r024e040 r27bcdfb  
    22.. comment: All rights reserved.
    33
    4 Dependencies
    5 ============
    6 .. index:: Dependencies
     4.. _development-hosts:
     5
     6Development Hosts
     7=================
     8.. index:: Hosts
    79
    810RTEMS applications are developed using cross-development tools running on a
     
    3335RTEMS makes no demands on graphics.
    3436
     37If you are using a VM or your host computer that is not a fast current machine
     38do not be concerned. The tools may take longer to build than faster hardware
     39however building tools is something you do once. Once the tools and RTEMS is
     40built all your time can be spent writing and developing your application.
     41
    3542Host Software
    3643-------------
     
    5259Install and set up your host operating system. We recommend you maintain your
    5360operating system by installing any updates.
     61
     62POSIX Hosts
     63-----------
     64
     65.. sidebar:: *GDB and Python*
     66
     67   RTEMS uses Python in GDB to aid debugging which means GDB needs to be built
     68   with Python development libraries. Please check the RSB documentation and
     69   install the packages specified for your host. Make sure a python development
     70   package is included.
     71
     72POSIX hosts are most Unix operating systems such as Linux, FreeBSD and
     73NetBSD. RTEMS development works well on Unix and can scale from a single user
     74and a desktop machine to a team with decentralised or centralised development
     75infrastructure. The RTEMS project provides you with the development tools and
     76aids to help you create an environment that matches the project's needs. You
     77need to decide on the languages used in your project, which version control
     78system, and the build system for your application. The RTEMS Project's aims to
     79give complete freedom to decide what you use.
     80
     81The following are a few ways you can set up a suitable environment. You are not
     82limited to what is present here. A common factor that defines the final
     83location of tools and projects is the place you have suitable storage. The
     84following set ups assume suitable disk space and disk performance.
     85
     86Adminisrator Access
     87~~~~~~~~~~~~~~~~~~~
     88
     89You either have ``root`` access to your host development machine or you do
     90not. Some users are given hardware that is centrally managed. If you do not
     91have ``root`` access you can create your work environment in your home
     92directory. You could use a prefix of :file:`$HOME/development/rtems` or
     93:file:`$HOME/rtems`. Note, the ``$HOME`` environment variable can be
     94substituted with ``~``.
     95
     96RTEMS Tools and packages do not require ``root`` access
     97to be built and we encourage you do not build the tools as ``root``. If you
     98need to control write access then it is best to manage this with groups
     99assigned to users.
     100
     101If you have ``root`` you can decide to install the tools under any suitable
     102prefix. This may depend on the hardware in your host development machine. If
     103the machine is a centralised build server the prefix may be used to separate
     104production versions from the test versions and as just discussed the prefix
     105paths may have restricted access to only those who manage the configuration
     106control of the machine.
     107
     108Apple OS X
     109----------
     110
     111Apple's OS X is fully supported. You to download and install a recent version
     112of the free Apple developers application Xcode. Xocde is available in the App
     113Store. Make sure you install the Command Line Tools add on available for
     114download within Xcode and once installed open a Terminal shell and enter the
     115command ``cc`` and accept the license agreement.
     116
     117The normal prefix when working on OS X as a user is under your home directory.
     118Prefixes of :file:`$HOME/development/rtems` or :file:`$HOME/rtems` are
     119suitable.
     120
     121.. _microsoft-windows:
     122
     123Microsoft Windows
     124-----------------
     125
     126RTEMS supports Windows as a development host and the tools for most
     127architectures are available. The RTEMS Project relies on the GNU tools for
     128compilers and debuggers and we use the simulators that come with GDB and
     129QEMU. The Windows support for these tools varies and the RTEMS Project is
     130committed to helping the open source community improve the Windows
     131experience. If something is not working or supported please email the
     132:r:list:`users`.
     133
     134The RTEMS Project's Windows tools are native Windows executables giving the
     135user the best possible experience on Windows. Native Windows programs use the
     136standard Windows DLLs and paths. Integration with standard Windows integrated
     137development tools such as editors is straight forward. POSIX emulation
     138environments such as Cygwin and the MSYS2 shell have special executables that
     139require a POSIX emulation DLL and these emulation DLLs add an extra layer of
     140complexity as well as a performance over-head. The RTEMS Project uses these
     141POSIX emulation shells to run configure scripts that come with various open
     142source packages such as `gcc` so they form an important and valued part of the
     143environment we describe here. The output of this procedure forms the tools you
     144use during your application development and they do not depend the emulation
     145DLLs.
     146
     147The performance of the compiler is as good as you can have on Windows and the
     148performance compiling a single file will be similar to that on a host like
     149Linux or FreeBSD given the same hardware. Building the tools from source is
     150much slower on Windows because POSIX shells and related tools are used and the
     151POSIX emulation overhead it much much slower than a native POSIX operating
     152system like Linux and FreeBSD. This overhead is only during the building of the
     153tools and the RTEMS kernel and if you use a suitable build system that is
     154native to Windows your application development should be similar to other
     155operating systems.
     156
     157.. _windows-path-length:
     158
     159Path Length
     160~~~~~~~~~~~
     161
     162Windows path length is limited and can cause problems when building the
     163tools. The standard Windows API has a ``MAX_PATH`` length of 260
     164characters. This can effect some of the tools used by RTEMS. It is recommended
     165you keep the top level directories as short as possible when building the RTEMS
     166tools and you also keep an eye on the path length when developing your
     167application. The RTEMS built tools can handle much longer path lengths however
     168some of the GNU tools such as those in the ``binutils`` package cannot. The
     169release packages of the RSB are too big to build RTEMS so you need to change
     170that path to build.
     171
     172The MSYS2 GNU ``make`` has problems when using the `jobs` option. The RSB
     173defaults to automatically using as many cores as the host machine has. To get a
     174successful build on Windows it is recommended you add the ``--jobs=none``
     175option to all RSB build set commands.
     176
     177POSIX Support
     178~~~~~~~~~~~~~
     179
     180Building the RTEMS compilers, debugger, the RTEMS kernel and a number of other
     1813rd party packages requires a POSIX environment. On Windows you can use Cygwin
     182or MSYS2. This document focuses on MSYS2. It is smaller than Cygwin and comes
     183with the Arch Linux package manager ``pacman``.
     184
     185MSYS2 provides MinGW64 support as well as a POSIX shell called MSYS2. The
     186MinGW64 compiler and related tools produce 64bit native Windows
     187executables. The shell is a standard Bourne shell and the MSYS2 environment is
     188a stripped Cygwin shell with enough support to run the various ``configure``
     189scripts needed to build the RTEMS tools and the RTEMS kernel.
     190
     191MSYS2 is built around the ``pacman`` packing tool. This makes MSYS2 a
     192distribution and that is a welcome feature on Windows. You get a powerful tool
     193to manage your development environment on Windows.
     194
     195Python
     196~~~~~~
     197
     198We need Python to build the tools as the RSB is written in Python and we need
     199suitable Python libraries to link to GDB as RTEMS makes use of GDB's Python
     200support. This place specific demands on the Python we need installed and
     201available and MSYS2 provides suitable Python versions we can use. You need to
     202make sure you have the correct type and version of Python installed.
     203
     204We cannot use the Python executables created by the Python project (python.org)
     205as they are built by Microsoft's C (MSC) compiler. Linking the MSC Python
     206libraries with the MinGW64 executables is not easy and MSYS provided us with a
     207simple solution so we do not support this.
     208
     209MSYS2 provides two types and versions of Python executables, MinGW and MSYS and
     210Python version 2 and 3. For Windows we need the MinGW executable so we have
     211suitables libraries and we have to have Python version 2 because on Windows GDB
     212only builds with Python2.
     213
     214You also need to install the MSYS version of Python along with the MinGW64
     215Python2 package. The MSYS Python is version 3 and the RSB can support version 2
     216and 3 of Python and it helps handle some of the long paths building GCC can
     217generate.
     218
     219Installing MSYS2
     220~~~~~~~~~~~~~~~~
     221
     222MSYS2 is installed on a new machine using the MSYS2 installer found on
     223https://msys2.github.io/. Please select the ``x86_64`` variant for 64bit
     224support. Run the installer followin the 7 steps listed on the page.
     225
     226MSYS2 uses the ``pacman`` package manager. The Arch Linux project has detailed
     227documentation on how to use ``pacman``. What is shown here is a just few
     228examples of what you can do.
     229
     230Open a 64bit MSYS shell from the Start Menu:
     231
     232.. figure:: msys2-minw64-start-menu.png
     233   :width: 50%
     234   :align: center
     235   :alt: MSYS2 64bit Shell Start Menu
     236
     237The packages we require are:
     238
     239 * python
     240 * mingw-w64-x86_64-python2
     241 * mingw-w64-x86_64-gcc
     242 * git
     243 * bison
     244 * cvs
     245 * diffutils
     246 * make
     247 * patch
     248 * tar
     249 * texinfo
     250 * unzip
     251
     252.. note::
     253
     254   The actual output provided may vary due to changes in the dependent packages
     255   or newer package versions.
     256
     257Install the packages using ``pacman``:
     258
     259.. code-block:: shell
     260
     261   ~
     262  $ pacman -S python mingw-w64-x86_64-python2 mingw-w64-x86_64-gcc \
     263  >           bison cvs diffutils git make patch tar texinfo unzip
     264  resolving dependencies...
     265  looking for conflicting packages...
     266
     267  Packages (74) db-5.3.28-2  expat-2.1.0-2  gdbm-1.11-3  heimdal-1.5.3-8
     268                libgdbm-1.11-3  mingw-w64-x86_64-binutils-2.26-21
     269                mingw-w64-x86_64-bzip2-1.0.6-5
     270                mingw-w64-x86_64-ca-certificates-20150426-2
     271                mingw-w64-x86_64-crt-git-5.0.0.4627.03684c4-1
     272                mingw-w64-x86_64-expat-2.1.0-6  mingw-w64-x86_64-gcc-libs-5.3.0-2
     273                mingw-w64-x86_64-gdbm-1.11-3  mingw-w64-x86_64-gettext-0.19.6-2
     274                mingw-w64-x86_64-gmp-6.1.0-1
     275                mingw-w64-x86_64-headers-git-5.0.0.4627.53be55d-1
     276                mingw-w64-x86_64-isl-0.15-1  mingw-w64-x86_64-libffi-3.2.1-3
     277                mingw-w64-x86_64-libiconv-1.14-5
     278                mingw-w64-x86_64-libsystre-1.0.1-2
     279                mingw-w64-x86_64-libtasn1-4.7-1
     280                mingw-w64-x86_64-libtre-git-r122.c2f5d13-4
     281                mingw-w64-x86_64-libwinpthread-git-5.0.0.4573.628fdbf-1
     282                mingw-w64-x86_64-mpc-1.0.3-2  mingw-w64-x86_64-mpfr-3.1.3.p0-2
     283                mingw-w64-x86_64-ncurses-6.0.20160220-2
     284                mingw-w64-x86_64-openssl-1.0.2.g-1
     285                mingw-w64-x86_64-p11-kit-0.23.1-3
     286                mingw-w64-x86_64-readline-6.3.008-1  mingw-w64-x86_64-tcl-8.6.5-1
     287                mingw-w64-x86_64-termcap-1.3.1-2  mingw-w64-x86_64-tk-8.6.5-1
     288                mingw-w64-x86_64-windows-default-manifest-6.4-2
     289                mingw-w64-x86_64-winpthreads-git-5.0.0.4573.628fdbf-1
     290                mingw-w64-x86_64-zlib-1.2.8-9  openssh-7.1p2-1  perl-5.22.0-2
     291                perl-Authen-SASL-2.16-2  perl-Convert-BinHex-1.123-2
     292                perl-Encode-Locale-1.04-1  perl-Error-0.17024-1
     293                perl-File-Listing-6.04-2  perl-HTML-Parser-3.71-3
     294                perl-HTML-Tagset-3.20-2  perl-HTTP-Cookies-6.01-2
     295                perl-HTTP-Daemon-6.01-2  perl-HTTP-Date-6.02-2
     296                perl-HTTP-Message-6.06-2  perl-HTTP-Negotiate-6.01-2
     297                perl-IO-Socket-SSL-2.016-1  perl-IO-stringy-2.111-1
     298                perl-LWP-MediaTypes-6.02-2  perl-MIME-tools-5.506-1
     299                perl-MailTools-2.14-1  perl-Net-HTTP-6.09-1
     300                perl-Net-SMTP-SSL-1.02-1  perl-Net-SSLeay-1.70-1
     301                perl-TermReadKey-2.33-1  perl-TimeDate-2.30-2  perl-URI-1.68-1
     302                perl-WWW-RobotRules-6.02-2  perl-libwww-6.13-1  vim-7.4.1468-1
     303                bison-3.0.4-1  cvs-1.11.23-2  diffutils-3.3-3  git-2.7.2-1
     304                make-4.1-4  mingw-w64-x86_64-gcc-5.3.0-2
     305                mingw-w64-x86_64-python2-2.7.11-4  patch-2.7.5-1  python-3.4.3-3
     306                tar-1.28-3  texinfo-6.0-1  unzip-6.0-2
     307
     308  Total Download Size:   114.10 MiB
     309  Total Installed Size:  689.61 MiB
     310
     311  :: Proceed with installation? [Y/n] y
     312  :: Retrieving packages...
     313   mingw-w64-x86_64-gm...   477.1 KiB   681K/s 00:01 [#####################] 100%
     314   mingw-w64-x86_64-li...    24.2 KiB   755K/s 00:00 [#####################] 100%
     315   mingw-w64-x86_64-gc...   541.9 KiB   705K/s 00:01 [#####################] 100%
     316   mingw-w64-x86_64-ex...   106.7 KiB   702K/s 00:00 [#####################] 100%
     317   mingw-w64-x86_64-bz...    77.9 KiB   666K/s 00:00 [#####################] 100%
     318   mingw-w64-x86_64-li...   600.2 KiB   703K/s 00:01 [#####################] 100%
     319   mingw-w64-x86_64-ge...     3.0 MiB   700K/s 00:04 [#####################] 100%
     320   mingw-w64-x86_64-gd...   151.8 KiB   483K/s 00:00 [#####################] 100%
     321   mingw-w64-x86_64-li...    34.5 KiB   705K/s 00:00 [#####################] 100%
     322   mingw-w64-x86_64-li...    69.2 KiB   713K/s 00:00 [#####################] 100%
     323   mingw-w64-x86_64-li...     9.3 KiB   778K/s 00:00 [#####################] 100%
     324   mingw-w64-x86_64-nc...  1800.5 KiB   701K/s 00:03 [#####################] 100%
     325   mingw-w64-x86_64-li...   171.4 KiB   708K/s 00:00 [#####################] 100%
     326   mingw-w64-x86_64-p1...   193.5 KiB   709K/s 00:00 [#####################] 100%
     327   mingw-w64-x86_64-ca...   382.1 KiB   705K/s 00:01 [#####################] 100%
     328   mingw-w64-x86_64-zl...   148.6 KiB   704K/s 00:00 [#####################] 100%
     329   mingw-w64-x86_64-op...     3.3 MiB   624K/s 00:05 [#####################] 100%
     330   mingw-w64-x86_64-te...    12.6 KiB  76.7K/s 00:00 [#####################] 100%
     331   mingw-w64-x86_64-re...   327.4 KiB   277K/s 00:01 [#####################] 100%
     332   mingw-w64-x86_64-tc...     2.9 MiB   699K/s 00:04 [#####################] 100%
     333   mingw-w64-x86_64-tk...  1869.2 KiB   703K/s 00:03 [#####################] 100%
     334   mingw-w64-x86_64-py...    10.9 MiB   699K/s 00:16 [#####################] 100%
     335   mingw-w64-x86_64-bi...    12.7 MiB   688K/s 00:19 [#####################] 100%
     336   mingw-w64-x86_64-he...     5.0 MiB   645K/s 00:08 [#####################] 100%
     337   mingw-w64-x86_64-cr...     2.6 MiB   701K/s 00:04 [#####################] 100%
     338   mingw-w64-x86_64-is...   524.3 KiB   684K/s 00:01 [#####################] 100%
     339   mingw-w64-x86_64-mp...   265.2 KiB   705K/s 00:00 [#####################] 100%
     340   mingw-w64-x86_64-mp...    62.3 KiB  82.9K/s 00:01 [#####################] 100%
     341   mingw-w64-x86_64-wi...  1484.0   B  0.00B/s 00:00 [#####################] 100%
     342   mingw-w64-x86_64-wi...    33.2 KiB   346K/s 00:00 [#####################] 100%
     343   mingw-w64-x86_64-gc...    25.1 MiB   701K/s 00:37 [#####################] 100%
     344   python-3.4.3-3-x86_64     12.1 MiB   700K/s 00:18 [#####################] 100%
     345   bison-3.0.4-1-x86_64    1045.1 KiB   703K/s 00:01 [#####################] 100%
     346   heimdal-1.5.3-8-x86_64   543.7 KiB   703K/s 00:01 [#####################] 100%
     347   cvs-1.11.23-2-x86_64     508.2 KiB   388K/s 00:01 [#####################] 100%
     348   diffutils-3.3-3-x86_64   265.7 KiB   478K/s 00:01 [#####################] 100%
     349   expat-2.1.0-2-x86_64      13.1 KiB   817K/s 00:00 [#####################] 100%
     350   vim-7.4.1468-1-x86_64      6.1 MiB   700K/s 00:09 [#####################] 100%
     351   openssh-7.1p2-1-x86_64   653.4 KiB   703K/s 00:01 [#####################] 100%
     352   db-5.3.28-2-x86_64        41.7 KiB   719K/s 00:00 [#####################] 100%
     353   libgdbm-1.11-3-x86_64     20.4 KiB   754K/s 00:00 [#####################] 100%
     354   gdbm-1.11-3-x86_64       108.5 KiB   704K/s 00:00 [#####################] 100%
     355   perl-5.22.0-2-x86_64      12.4 MiB   702K/s 00:18 [#####################] 100%
     356   perl-Error-0.17024-...    17.1 KiB   742K/s 00:00 [#####################] 100%
     357   perl-Authen-SASL-2....    42.4 KiB   731K/s 00:00 [#####################] 100%
     358   perl-Encode-Locale-...     9.7 KiB   745K/s 00:00 [#####################] 100%
     359   perl-HTTP-Date-6.02...     8.6 KiB   784K/s 00:00 [#####################] 100%
     360   perl-File-Listing-6...     7.7 KiB   769K/s 00:00 [#####################] 100%
     361   perl-HTML-Tagset-3....    10.3 KiB   732K/s 00:00 [#####################] 100%
     362   perl-HTML-Parser-3....    76.9 KiB   516K/s 00:00 [#####################] 100%
     363   perl-LWP-MediaTypes...    18.0 KiB   752K/s 00:00 [#####################] 100%
     364   perl-URI-1.68-1-any       75.6 KiB   609K/s 00:00 [#####################] 100%
     365   perl-HTTP-Message-6...    71.3 KiB   625K/s 00:00 [#####################] 100%
     366   perl-HTTP-Cookies-6...    20.4 KiB   499K/s 00:00 [#####################] 100%
     367   perl-HTTP-Daemon-6....    14.2 KiB   749K/s 00:00 [#####################] 100%
     368   perl-HTTP-Negotiate...    11.4 KiB   817K/s 00:00 [#####################] 100%
     369   perl-Net-HTTP-6.09-...    19.8 KiB   732K/s 00:00 [#####################] 100%
     370   perl-WWW-RobotRules...    12.2 KiB   766K/s 00:00 [#####################] 100%
     371   perl-libwww-6.13-1-any   122.2 KiB   661K/s 00:00 [#####################] 100%
     372   perl-TimeDate-2.30-...    35.9 KiB   718K/s 00:00 [#####################] 100%
     373   perl-MailTools-2.14...    58.4 KiB   712K/s 00:00 [#####################] 100%
     374   perl-IO-stringy-2.1...    52.6 KiB   721K/s 00:00 [#####################] 100%
     375   perl-Convert-BinHex...    30.1 KiB   733K/s 00:00 [#####################] 100%
     376   perl-MIME-tools-5.5...   180.4 KiB   705K/s 00:00 [#####################] 100%
     377   perl-Net-SSLeay-1.7...   191.2 KiB   708K/s 00:00 [#####################] 100%
     378   perl-IO-Socket-SSL-...   112.5 KiB   703K/s 00:00 [#####################] 100%
     379   perl-Net-SMTP-SSL-1...     3.5 KiB   881K/s 00:00 [#####################] 100%
     380   perl-TermReadKey-2....    20.9 KiB   745K/s 00:00 [#####################] 100%
     381   git-2.7.2-1-x86_64         3.6 MiB   702K/s 00:05 [#####################] 100%
     382   make-4.1-4-x86_64        387.0 KiB   671K/s 00:01 [#####################] 100%
     383   patch-2.7.5-1-x86_64      75.9 KiB   684K/s 00:00 [#####################] 100%
     384   tar-1.28-3-x86_64        671.9 KiB   379K/s 00:02 [#####################] 100%
     385   texinfo-6.0-1-x86_64     992.7 KiB   625K/s 00:02 [#####################] 100%
     386   unzip-6.0-2-x86_64        93.1 KiB   705K/s 00:00 [#####################] 100%
     387  (74/74) checking keys in keyring                   [#####################] 100%
     388  (74/74) checking package integrity                 [#####################] 100%
     389  (74/74) loading package files                      [#####################] 100%
     390  (74/74) checking for file conflicts                [#####################] 100%
     391  (74/74) checking available disk space              [#####################] 100%
     392  :: Processing package changes...
     393  ( 1/74) installing python                          [#####################] 100%
     394  ( 2/74) installing mingw-w64-x86_64-gmp            [#####################] 100%
     395  ( 3/74) installing mingw-w64-x86_64-libwinpthr...  [#####################] 100%
     396  ( 4/74) installing mingw-w64-x86_64-gcc-libs       [#####################] 100%
     397  ( 5/74) installing mingw-w64-x86_64-expat          [#####################] 100%
     398  ( 6/74) installing mingw-w64-x86_64-bzip2          [#####################] 100%
     399  ( 7/74) installing mingw-w64-x86_64-libiconv       [#####################] 100%
     400  ( 8/74) installing mingw-w64-x86_64-gettext        [#####################] 100%
     401  ( 9/74) installing mingw-w64-x86_64-gdbm           [#####################] 100%
     402  (10/74) installing mingw-w64-x86_64-libffi         [#####################] 100%
     403  (11/74) installing mingw-w64-x86_64-libtre-git     [#####################] 100%
     404  (12/74) installing mingw-w64-x86_64-libsystre      [#####################] 100%
     405  (13/74) installing mingw-w64-x86_64-ncurses        [#####################] 100%
     406  (14/74) installing mingw-w64-x86_64-libtasn1       [#####################] 100%
     407  (15/74) installing mingw-w64-x86_64-p11-kit        [#####################] 100%
     408  (16/74) installing mingw-w64-x86_64-ca-certifi...  [#####################] 100%
     409  (17/74) installing mingw-w64-x86_64-zlib           [#####################] 100%
     410  (18/74) installing mingw-w64-x86_64-openssl        [#####################] 100%
     411  (19/74) installing mingw-w64-x86_64-termcap        [#####################] 100%
     412  (20/74) installing mingw-w64-x86_64-readline       [#####################] 100%
     413  (21/74) installing mingw-w64-x86_64-tcl            [#####################] 100%
     414  (22/74) installing mingw-w64-x86_64-tk             [#####################] 100%
     415  (23/74) installing mingw-w64-x86_64-python2        [#####################] 100%
     416  (24/74) installing mingw-w64-x86_64-binutils       [#####################] 100%
     417  (25/74) installing mingw-w64-x86_64-headers-git    [#####################] 100%
     418  (26/74) installing mingw-w64-x86_64-crt-git        [#####################] 100%
     419  (27/74) installing mingw-w64-x86_64-isl            [#####################] 100%
     420  (28/74) installing mingw-w64-x86_64-mpfr           [#####################] 100%
     421  (29/74) installing mingw-w64-x86_64-mpc            [#####################] 100%
     422  (30/74) installing mingw-w64-x86_64-windows-de...  [#####################] 100%
     423  (31/74) installing mingw-w64-x86_64-winpthread...  [#####################] 100%
     424  (32/74) installing mingw-w64-x86_64-gcc            [#####################] 100%
     425  (33/74) installing bison                           [#####################] 100%
     426  (34/74) installing heimdal                         [#####################] 100%
     427  (35/74) installing cvs                             [#####################] 100%
     428  (36/74) installing diffutils                       [#####################] 100%
     429  (37/74) installing expat                           [#####################] 100%
     430  (38/74) installing vim                             [#####################] 100%
     431  (39/74) installing openssh                         [#####################] 100%
     432  (40/74) installing db                              [#####################] 100%
     433  (41/74) installing libgdbm                         [#####################] 100%
     434  (42/74) installing gdbm                            [#####################] 100%
     435  (43/74) installing perl                            [#####################] 100%
     436  (44/74) installing perl-Error                      [#####################] 100%
     437  (45/74) installing perl-Authen-SASL                [#####################] 100%
     438  (46/74) installing perl-Encode-Locale              [#####################] 100%
     439  (47/74) installing perl-HTTP-Date                  [#####################] 100%
     440  (48/74) installing perl-File-Listing               [#####################] 100%
     441  (49/74) installing perl-HTML-Tagset                [#####################] 100%
     442  (50/74) installing perl-HTML-Parser                [#####################] 100%
     443  (51/74) installing perl-LWP-MediaTypes             [#####################] 100%
     444  (52/74) installing perl-URI                        [#####################] 100%
     445  (53/74) installing perl-HTTP-Message               [#####################] 100%
     446  (54/74) installing perl-HTTP-Cookies               [#####################] 100%
     447  (55/74) installing perl-HTTP-Daemon                [#####################] 100%
     448  (56/74) installing perl-HTTP-Negotiate             [#####################] 100%
     449  (57/74) installing perl-Net-HTTP                   [#####################] 100%
     450  (58/74) installing perl-WWW-RobotRules             [#####################] 100%
     451  (59/74) installing perl-libwww                     [#####################] 100%
     452  Optional dependencies for perl-libwww
     453      perl-LWP-Protocol-HTTPS: for https:// url schemes
     454  (60/74) installing perl-TimeDate                   [#####################] 100%
     455  (61/74) installing perl-MailTools                  [#####################] 100%
     456  (62/74) installing perl-IO-stringy                 [#####################] 100%
     457  (63/74) installing perl-Convert-BinHex             [#####################] 100%
     458  module test... pass.
     459  (64/74) installing perl-MIME-tools                 [#####################] 100%
     460  (65/74) installing perl-Net-SSLeay                 [#####################] 100%
     461  (66/74) installing perl-IO-Socket-SSL              [#####################] 100%
     462  (67/74) installing perl-Net-SMTP-SSL               [#####################] 100%
     463  (68/74) installing perl-TermReadKey                [#####################] 100%
     464  (69/74) installing git                             [#####################] 100%
     465  Optional dependencies for git
     466      python2: various helper scripts
     467      subversion: git svn
     468  (70/74) installing make                            [#####################] 100%
     469  (71/74) installing patch                           [#####################] 100%
     470  Optional dependencies for patch
     471      ed: for patch -e functionality
     472  (72/74) installing tar                             [#####################] 100%
     473  (73/74) installing texinfo                         [#####################] 100%
     474  (74/74) installing unzip                           [#####################] 100%
  • user/start/development.rst

    r024e040 r27bcdfb  
    55
    66Development Version
    7 -------------------
     7===================
    88.. index:: Git
    99
     
    1313when developing and maintaining RTEMS.
    1414
     15Please read :ref:`development-hosts` before continuing.
     16
    1517.. warning::
    1618
    1719   The development version is not for use in production and it can break from
    1820   time to time.
    19 
    20 .. sidebar:: *GDB and Python*
    21 
    22    RTEMS uses Python in GDB to aid debugging which means GDB needs to be built
    23    with Python development libraries. Please check the RSB documentation and
    24    install the packages specified for your host. Make sure a python development
    25    package is included.
    2621
    2722The following procedure assumes you have installed and configured your host
     
    5146
    5247RTEMS Tools Chain
    53 ~~~~~~~~~~~~~~~~~
     48-----------------
    5449
    5550Clone the RTEMS Source Builder (RSB) repository:
     
    206201
    207202RTEMS Kernel
    208 ~~~~~~~~~~~~
     203------------
    209204
    210205We need to set our path to include the RTEMS tools we built in the previous
     
    517512
    518513Contributing Patches
    519 ~~~~~~~~~~~~~~~~~~~~
     514--------------------
    520515
    521516RTEMS welcomes fixes to bugs and new features. The RTEMS Project likes to have
  • user/start/index.rst

    r024e040 r27bcdfb  
    1111source.
    1212
     13.. include:: basics.rst
    1314.. include:: depend.rst
    1415.. include:: installation.rst
     16.. include:: releases.rst
     17.. include:: development.rst
     18.. include:: windows.rst
  • user/start/installation.rst

    r024e040 r27bcdfb  
    2424assume Unix. Microsoft Windows is documented in a separate section
    2525:ref:`microsoft-windows-installation`.
    26 
    27 .. comments: Include the various installation parts.
    28 .. include:: releases.rst
    29 .. include:: development.rst
    30 .. include:: windows.rst
  • user/start/releases.rst

    r024e040 r27bcdfb  
    55
    66Released Version
    7 ----------------
     7================
    88.. index:: tarball
    99.. index:: release
     
    1313older releases is provided using the RTEMS support channels.
    1414
    15 .. sidebar:: *GDB and Python*
    16 
    17    RTEMS uses Python in GDB to aid debugging which means GDB needs to be built
    18    with Python development libraries. Please check the RSB documentation and
    19    install the packages specified for your host. Make sure a python development
    20    package is included.
     15Please read :ref:`development-hosts` before continuing.
    2116
    2217The following procedure assumes you have installed and configured your host
     
    5045   kernel add the ``--without-rtems`` option to the RSB command line.
    5146
    52    By default all the BSPs for an architecture are build. If you only wish to
     47   By default all the BSPs for an architecture are built. If you only wish to
    5348   have a specific BSP build you can specify the BSP list by providing to the
    5449   RSB the option ``--with-rtemsbsp``. For example to build two BSPs for the
     
    5853
    5954RTEMS Tools Chain
    60 ~~~~~~~~~~~~~~~~~
     55-----------------
    6156
    6257Set up a suitable workspace to build the release in. On Unix:
     
    9489 2016-03-21 10:50:11 (173 KB/s) - 'rtems-source-builder-4.11.0.tar.xz' saved [967056/967056]
    9590
    96 Unpack the RSB release tar file. On Unix:
     91On Unix unpack the RSB release tar file using:
    9792
    9893.. code-block:: shell
     
    10196 $ cd rtems-source-builder-4.11.0/rtems/
    10297
    103 When building on Windowss you need to shorten the path:
     98On Windows you need to shorten the path (See :ref:`windows-path-length`) after
     99you have unpacked the tar file:
    104100
    105101.. code-block:: shell
     
    111107Build a tool chain for the SPARC architecure. We are using the SPARC
    112108architecture in our example because GDB has a good simulator that lets us run
    113 and test the samples RTEMS builds by default:
     109and test the samples RTEMS builds by default
     110
     111If building on Windows add ``--jobs=none`` to avoid GNU make issues on Windows.
    114112
    115113.. code-block:: shell
  • user/start/windows.rst

    r024e040 r27bcdfb  
    1111Windows. The installation documented here is on `Windows 7 64bit Professional`.
    1212
    13 Developing on Windows
    14 ~~~~~~~~~~~~~~~~~~~~~
    15 
    16 RTEMS supports Windows as a development host and the tools for most
    17 architectures are available. The RTEMS Project relies on the GNU tools for
    18 compilers and debuggers and we use the simulators that come with GDB and
    19 QEMU. The Windows support for these tools varies and the RTEMS Project is
    20 committed to helping the open source community improve the Windows
    21 experience. If something is not working or supported please email the
    22 :r:list:`users`.
    23 
    24 The RTEMS Project's Windows tools are native Windows executables giving the
    25 user the best possible experience on Windows. Native Windows programs use the
    26 standard Windows DLLs and paths. Integration with standard Windows integrated
    27 development tools such as editors is straight forward. POSIX emulation
    28 environments such as Cygwin and the MSYS2 shell have special executables that
    29 require a POSIX emulation DLL and these emulation DLLs add an extra layer of
    30 complexity as well as a performance over-head. The RTEMS Project uses these
    31 POSIX emulation shells to run configure scripts that come with various open
    32 source packages such as `gcc` so they form an important and valued part of the
    33 environment we describe here. The output of this procedure forms the tools you
    34 use during your application development and they do not depend the emulation
    35 DLLs.
    36 
    37 The performance of the compiler is as good as you can have on Windows and the
    38 performance compiling a single file will be similar to that on a host like
    39 Linux or FreeBSD given the same hardware. Building the tools from source is
    40 much slower on Windows because POSIX shells and related tools are used and the
    41 POSIX emulation overhead it much much slower than a native POSIX operating
    42 system like Linux and FreeBSD. This overhead is only during the building of the
    43 tools and the RTEMS kernel and if you use a suitable build system that is
    44 native to Windows your application development should be similar to other
    45 operating systems.
    46 
    47 Windows path length is limited and can cause problems when building the
    48 tools. The standard Windows API has a ``MAX_PATH`` length of 260
    49 characters. This can effect some of the tools used by RTEMS. It is recommended
    50 you keep the top level directories as short as possible when building the RTEMS
    51 tools and you also keep an eye on the path length when developing your
    52 application. The RTEMS built tools can handle much longer path lengths however
    53 some of the GNU tools such as those in the ``binutils`` package cannot. The
    54 release packages of the RSB are too big to build RTEMS so you need to change
    55 that path to build.
    56 
    57 The MSYS2 GNU ``make`` has problems when using the `jobs` option. The RSB
    58 defaults to automatically using as many cores as the host machine has. To get a
    59 successful build on Windows it is recommended you add the ``--jobs=none``
    60 option to all RSB build set commands.
    61 
    62 POSIX Support
    63 ~~~~~~~~~~~~~
    64 
    65 Building the RTEMS compilers, debugger, the RTEMS kernel and a number of other
    66 3rd party packages requires a POSIX environment. On Windows you can use Cygwin
    67 or MSYS2. This document focuses on MSYS2. It is smaller than Cygwin and comes
    68 with the Arch Linux package manager ``pacman``.
    69 
    70 MSYS2 provides MinGW64 support as well as a POSIX shell called MSYS2. The
    71 MinGW64 compiler and related tools produce 64bit native Windows
    72 executables. The shell is a standard Bourne shell and the MSYS2 environment is
    73 a stripped Cygwin shell with enough support to run the various ``configure``
    74 scripts needed to build the RTEMS tools and the RTEMS kernel.
    75 
    76 MSYS2 is built around the ``pacman`` packing tool. This makes MSYS2 a
    77 distribution and that is a welcome feature on Windows. You get a powerful tool
    78 to manage your development environment on Windows.
    79 
    80 Python
    81 ~~~~~~
    82 
    83 We need Python to build the tools as the RSB is written in Python and we need
    84 suitable Python libraries to link to GDB as RTEMS makes use of GDB's Python
    85 support. This place specific demands on the Python we need installed and
    86 available and MSYS2 provides suitable Python versions we can use. You need to
    87 make sure you have the correct type and version of Python installed.
    88 
    89 We cannot use the Python executables created by the Python project (python.org)
    90 as they are built by Microsoft's C (MSC) compiler. Linking the MSC Python
    91 libraries with the MinGW64 executables is not easy and MSYS provided us with a
    92 simple solution so we do not support this.
    93 
    94 MSYS2 provides two types and versions of Python executables, MinGW and MSYS and
    95 Python version 2 and 3. For Windows we need the MinGW executable so we have
    96 suitables libraries and we have to have Python vrrsion 2 because on Windows GDB
    97 only builds with Python2.
    98 
    99 You also need to install the MSYS version of Python along with the MinGW64
    100 Python2 package. The MSYS Python is version 3 and the RSB can support version 2
    101 and 3 of Python and it helps handle some of the long paths building GCC can
    102 generate.
    103 
    104 Installing MSYS2
    105 ~~~~~~~~~~~~~~~~
    106 
    107 MSYS2 is installed on a new machine using the MSYS2 installer found on
    108 https://msys2.github.io/. Please select the ``x86_64`` variant for 64bit
    109 support. Run the installer followin the 7 steps listed on the page.
    110 
    111 MSYS2 uses the ``pacman`` package manager. The Arch Linux project has detailed
    112 documentation on how to use ``pacman``. What is shown here is a just few
    113 examples of what you can do.
    114 
    115 Open a 64bit MSYS shell from the Start Menu:
    116 
    117 .. figure:: msys2-minw64-start-menu.png
    118    :width: 50%
    119    :align: center
    120    :alt: MSYS2 64bit Shell Start Menu
    121 
    122 The packages we require are:
    123 
    124  * python
    125  * mingw-w64-x86_64-python2
    126  * mingw-w64-x86_64-gcc
    127  * git
    128  * bison
    129  * cvs
    130  * diffutils
    131  * make
    132  * patch
    133  * tar
    134  * texinfo
    135  * unzip
    136 
    137 .. note::
    138 
    139    The actual output provided may vary due to changes in the dependent packages
    140    or newer package versions.
    141 
    142 Install the packages using ``pacman``:
    143 
    144 .. code-block:: shell
    145 
    146    ~
    147   $ pacman -S python mingw-w64-x86_64-python2 mingw-w64-x86_64-gcc \
    148   >           bison cvs diffutils git make patch tar texinfo unzip
    149   resolving dependencies...
    150   looking for conflicting packages...
    151 
    152   Packages (74) db-5.3.28-2  expat-2.1.0-2  gdbm-1.11-3  heimdal-1.5.3-8
    153                 libgdbm-1.11-3  mingw-w64-x86_64-binutils-2.26-21
    154                 mingw-w64-x86_64-bzip2-1.0.6-5
    155                 mingw-w64-x86_64-ca-certificates-20150426-2
    156                 mingw-w64-x86_64-crt-git-5.0.0.4627.03684c4-1
    157                 mingw-w64-x86_64-expat-2.1.0-6  mingw-w64-x86_64-gcc-libs-5.3.0-2
    158                 mingw-w64-x86_64-gdbm-1.11-3  mingw-w64-x86_64-gettext-0.19.6-2
    159                 mingw-w64-x86_64-gmp-6.1.0-1
    160                 mingw-w64-x86_64-headers-git-5.0.0.4627.53be55d-1
    161                 mingw-w64-x86_64-isl-0.15-1  mingw-w64-x86_64-libffi-3.2.1-3
    162                 mingw-w64-x86_64-libiconv-1.14-5
    163                 mingw-w64-x86_64-libsystre-1.0.1-2
    164                 mingw-w64-x86_64-libtasn1-4.7-1
    165                 mingw-w64-x86_64-libtre-git-r122.c2f5d13-4
    166                 mingw-w64-x86_64-libwinpthread-git-5.0.0.4573.628fdbf-1
    167                 mingw-w64-x86_64-mpc-1.0.3-2  mingw-w64-x86_64-mpfr-3.1.3.p0-2
    168                 mingw-w64-x86_64-ncurses-6.0.20160220-2
    169                 mingw-w64-x86_64-openssl-1.0.2.g-1
    170                 mingw-w64-x86_64-p11-kit-0.23.1-3
    171                 mingw-w64-x86_64-readline-6.3.008-1  mingw-w64-x86_64-tcl-8.6.5-1
    172                 mingw-w64-x86_64-termcap-1.3.1-2  mingw-w64-x86_64-tk-8.6.5-1
    173                 mingw-w64-x86_64-windows-default-manifest-6.4-2
    174                 mingw-w64-x86_64-winpthreads-git-5.0.0.4573.628fdbf-1
    175                 mingw-w64-x86_64-zlib-1.2.8-9  openssh-7.1p2-1  perl-5.22.0-2
    176                 perl-Authen-SASL-2.16-2  perl-Convert-BinHex-1.123-2
    177                 perl-Encode-Locale-1.04-1  perl-Error-0.17024-1
    178                 perl-File-Listing-6.04-2  perl-HTML-Parser-3.71-3
    179                 perl-HTML-Tagset-3.20-2  perl-HTTP-Cookies-6.01-2
    180                 perl-HTTP-Daemon-6.01-2  perl-HTTP-Date-6.02-2
    181                 perl-HTTP-Message-6.06-2  perl-HTTP-Negotiate-6.01-2
    182                 perl-IO-Socket-SSL-2.016-1  perl-IO-stringy-2.111-1
    183                 perl-LWP-MediaTypes-6.02-2  perl-MIME-tools-5.506-1
    184                 perl-MailTools-2.14-1  perl-Net-HTTP-6.09-1
    185                 perl-Net-SMTP-SSL-1.02-1  perl-Net-SSLeay-1.70-1
    186                 perl-TermReadKey-2.33-1  perl-TimeDate-2.30-2  perl-URI-1.68-1
    187                 perl-WWW-RobotRules-6.02-2  perl-libwww-6.13-1  vim-7.4.1468-1
    188                 bison-3.0.4-1  cvs-1.11.23-2  diffutils-3.3-3  git-2.7.2-1
    189                 make-4.1-4  mingw-w64-x86_64-gcc-5.3.0-2
    190                 mingw-w64-x86_64-python2-2.7.11-4  patch-2.7.5-1  python-3.4.3-3
    191                 tar-1.28-3  texinfo-6.0-1  unzip-6.0-2
    192 
    193   Total Download Size:   114.10 MiB
    194   Total Installed Size:  689.61 MiB
    195 
    196   :: Proceed with installation? [Y/n] y
    197   :: Retrieving packages...
    198    mingw-w64-x86_64-gm...   477.1 KiB   681K/s 00:01 [#####################] 100%
    199    mingw-w64-x86_64-li...    24.2 KiB   755K/s 00:00 [#####################] 100%
    200    mingw-w64-x86_64-gc...   541.9 KiB   705K/s 00:01 [#####################] 100%
    201    mingw-w64-x86_64-ex...   106.7 KiB   702K/s 00:00 [#####################] 100%
    202    mingw-w64-x86_64-bz...    77.9 KiB   666K/s 00:00 [#####################] 100%
    203    mingw-w64-x86_64-li...   600.2 KiB   703K/s 00:01 [#####################] 100%
    204    mingw-w64-x86_64-ge...     3.0 MiB   700K/s 00:04 [#####################] 100%
    205    mingw-w64-x86_64-gd...   151.8 KiB   483K/s 00:00 [#####################] 100%
    206    mingw-w64-x86_64-li...    34.5 KiB   705K/s 00:00 [#####################] 100%
    207    mingw-w64-x86_64-li...    69.2 KiB   713K/s 00:00 [#####################] 100%
    208    mingw-w64-x86_64-li...     9.3 KiB   778K/s 00:00 [#####################] 100%
    209    mingw-w64-x86_64-nc...  1800.5 KiB   701K/s 00:03 [#####################] 100%
    210    mingw-w64-x86_64-li...   171.4 KiB   708K/s 00:00 [#####################] 100%
    211    mingw-w64-x86_64-p1...   193.5 KiB   709K/s 00:00 [#####################] 100%
    212    mingw-w64-x86_64-ca...   382.1 KiB   705K/s 00:01 [#####################] 100%
    213    mingw-w64-x86_64-zl...   148.6 KiB   704K/s 00:00 [#####################] 100%
    214    mingw-w64-x86_64-op...     3.3 MiB   624K/s 00:05 [#####################] 100%
    215    mingw-w64-x86_64-te...    12.6 KiB  76.7K/s 00:00 [#####################] 100%
    216    mingw-w64-x86_64-re...   327.4 KiB   277K/s 00:01 [#####################] 100%
    217    mingw-w64-x86_64-tc...     2.9 MiB   699K/s 00:04 [#####################] 100%
    218    mingw-w64-x86_64-tk...  1869.2 KiB   703K/s 00:03 [#####################] 100%
    219    mingw-w64-x86_64-py...    10.9 MiB   699K/s 00:16 [#####################] 100%
    220    mingw-w64-x86_64-bi...    12.7 MiB   688K/s 00:19 [#####################] 100%
    221    mingw-w64-x86_64-he...     5.0 MiB   645K/s 00:08 [#####################] 100%
    222    mingw-w64-x86_64-cr...     2.6 MiB   701K/s 00:04 [#####################] 100%
    223    mingw-w64-x86_64-is...   524.3 KiB   684K/s 00:01 [#####################] 100%
    224    mingw-w64-x86_64-mp...   265.2 KiB   705K/s 00:00 [#####################] 100%
    225    mingw-w64-x86_64-mp...    62.3 KiB  82.9K/s 00:01 [#####################] 100%
    226    mingw-w64-x86_64-wi...  1484.0   B  0.00B/s 00:00 [#####################] 100%
    227    mingw-w64-x86_64-wi...    33.2 KiB   346K/s 00:00 [#####################] 100%
    228    mingw-w64-x86_64-gc...    25.1 MiB   701K/s 00:37 [#####################] 100%
    229    python-3.4.3-3-x86_64     12.1 MiB   700K/s 00:18 [#####################] 100%
    230    bison-3.0.4-1-x86_64    1045.1 KiB   703K/s 00:01 [#####################] 100%
    231    heimdal-1.5.3-8-x86_64   543.7 KiB   703K/s 00:01 [#####################] 100%
    232    cvs-1.11.23-2-x86_64     508.2 KiB   388K/s 00:01 [#####################] 100%
    233    diffutils-3.3-3-x86_64   265.7 KiB   478K/s 00:01 [#####################] 100%
    234    expat-2.1.0-2-x86_64      13.1 KiB   817K/s 00:00 [#####################] 100%
    235    vim-7.4.1468-1-x86_64      6.1 MiB   700K/s 00:09 [#####################] 100%
    236    openssh-7.1p2-1-x86_64   653.4 KiB   703K/s 00:01 [#####################] 100%
    237    db-5.3.28-2-x86_64        41.7 KiB   719K/s 00:00 [#####################] 100%
    238    libgdbm-1.11-3-x86_64     20.4 KiB   754K/s 00:00 [#####################] 100%
    239    gdbm-1.11-3-x86_64       108.5 KiB   704K/s 00:00 [#####################] 100%
    240    perl-5.22.0-2-x86_64      12.4 MiB   702K/s 00:18 [#####################] 100%
    241    perl-Error-0.17024-...    17.1 KiB   742K/s 00:00 [#####################] 100%
    242    perl-Authen-SASL-2....    42.4 KiB   731K/s 00:00 [#####################] 100%
    243    perl-Encode-Locale-...     9.7 KiB   745K/s 00:00 [#####################] 100%
    244    perl-HTTP-Date-6.02...     8.6 KiB   784K/s 00:00 [#####################] 100%
    245    perl-File-Listing-6...     7.7 KiB   769K/s 00:00 [#####################] 100%
    246    perl-HTML-Tagset-3....    10.3 KiB   732K/s 00:00 [#####################] 100%
    247    perl-HTML-Parser-3....    76.9 KiB   516K/s 00:00 [#####################] 100%
    248    perl-LWP-MediaTypes...    18.0 KiB   752K/s 00:00 [#####################] 100%
    249    perl-URI-1.68-1-any       75.6 KiB   609K/s 00:00 [#####################] 100%
    250    perl-HTTP-Message-6...    71.3 KiB   625K/s 00:00 [#####################] 100%
    251    perl-HTTP-Cookies-6...    20.4 KiB   499K/s 00:00 [#####################] 100%
    252    perl-HTTP-Daemon-6....    14.2 KiB   749K/s 00:00 [#####################] 100%
    253    perl-HTTP-Negotiate...    11.4 KiB   817K/s 00:00 [#####################] 100%
    254    perl-Net-HTTP-6.09-...    19.8 KiB   732K/s 00:00 [#####################] 100%
    255    perl-WWW-RobotRules...    12.2 KiB   766K/s 00:00 [#####################] 100%
    256    perl-libwww-6.13-1-any   122.2 KiB   661K/s 00:00 [#####################] 100%
    257    perl-TimeDate-2.30-...    35.9 KiB   718K/s 00:00 [#####################] 100%
    258    perl-MailTools-2.14...    58.4 KiB   712K/s 00:00 [#####################] 100%
    259    perl-IO-stringy-2.1...    52.6 KiB   721K/s 00:00 [#####################] 100%
    260    perl-Convert-BinHex...    30.1 KiB   733K/s 00:00 [#####################] 100%
    261    perl-MIME-tools-5.5...   180.4 KiB   705K/s 00:00 [#####################] 100%
    262    perl-Net-SSLeay-1.7...   191.2 KiB   708K/s 00:00 [#####################] 100%
    263    perl-IO-Socket-SSL-...   112.5 KiB   703K/s 00:00 [#####################] 100%
    264    perl-Net-SMTP-SSL-1...     3.5 KiB   881K/s 00:00 [#####################] 100%
    265    perl-TermReadKey-2....    20.9 KiB   745K/s 00:00 [#####################] 100%
    266    git-2.7.2-1-x86_64         3.6 MiB   702K/s 00:05 [#####################] 100%
    267    make-4.1-4-x86_64        387.0 KiB   671K/s 00:01 [#####################] 100%
    268    patch-2.7.5-1-x86_64      75.9 KiB   684K/s 00:00 [#####################] 100%
    269    tar-1.28-3-x86_64        671.9 KiB   379K/s 00:02 [#####################] 100%
    270    texinfo-6.0-1-x86_64     992.7 KiB   625K/s 00:02 [#####################] 100%
    271    unzip-6.0-2-x86_64        93.1 KiB   705K/s 00:00 [#####################] 100%
    272   (74/74) checking keys in keyring                   [#####################] 100%
    273   (74/74) checking package integrity                 [#####################] 100%
    274   (74/74) loading package files                      [#####################] 100%
    275   (74/74) checking for file conflicts                [#####################] 100%
    276   (74/74) checking available disk space              [#####################] 100%
    277   :: Processing package changes...
    278   ( 1/74) installing python                          [#####################] 100%
    279   ( 2/74) installing mingw-w64-x86_64-gmp            [#####################] 100%
    280   ( 3/74) installing mingw-w64-x86_64-libwinpthr...  [#####################] 100%
    281   ( 4/74) installing mingw-w64-x86_64-gcc-libs       [#####################] 100%
    282   ( 5/74) installing mingw-w64-x86_64-expat          [#####################] 100%
    283   ( 6/74) installing mingw-w64-x86_64-bzip2          [#####################] 100%
    284   ( 7/74) installing mingw-w64-x86_64-libiconv       [#####################] 100%
    285   ( 8/74) installing mingw-w64-x86_64-gettext        [#####################] 100%
    286   ( 9/74) installing mingw-w64-x86_64-gdbm           [#####################] 100%
    287   (10/74) installing mingw-w64-x86_64-libffi         [#####################] 100%
    288   (11/74) installing mingw-w64-x86_64-libtre-git     [#####################] 100%
    289   (12/74) installing mingw-w64-x86_64-libsystre      [#####################] 100%
    290   (13/74) installing mingw-w64-x86_64-ncurses        [#####################] 100%
    291   (14/74) installing mingw-w64-x86_64-libtasn1       [#####################] 100%
    292   (15/74) installing mingw-w64-x86_64-p11-kit        [#####################] 100%
    293   (16/74) installing mingw-w64-x86_64-ca-certifi...  [#####################] 100%
    294   (17/74) installing mingw-w64-x86_64-zlib           [#####################] 100%
    295   (18/74) installing mingw-w64-x86_64-openssl        [#####################] 100%
    296   (19/74) installing mingw-w64-x86_64-termcap        [#####################] 100%
    297   (20/74) installing mingw-w64-x86_64-readline       [#####################] 100%
    298   (21/74) installing mingw-w64-x86_64-tcl            [#####################] 100%
    299   (22/74) installing mingw-w64-x86_64-tk             [#####################] 100%
    300   (23/74) installing mingw-w64-x86_64-python2        [#####################] 100%
    301   (24/74) installing mingw-w64-x86_64-binutils       [#####################] 100%
    302   (25/74) installing mingw-w64-x86_64-headers-git    [#####################] 100%
    303   (26/74) installing mingw-w64-x86_64-crt-git        [#####################] 100%
    304   (27/74) installing mingw-w64-x86_64-isl            [#####################] 100%
    305   (28/74) installing mingw-w64-x86_64-mpfr           [#####################] 100%
    306   (29/74) installing mingw-w64-x86_64-mpc            [#####################] 100%
    307   (30/74) installing mingw-w64-x86_64-windows-de...  [#####################] 100%
    308   (31/74) installing mingw-w64-x86_64-winpthread...  [#####################] 100%
    309   (32/74) installing mingw-w64-x86_64-gcc            [#####################] 100%
    310   (33/74) installing bison                           [#####################] 100%
    311   (34/74) installing heimdal                         [#####################] 100%
    312   (35/74) installing cvs                             [#####################] 100%
    313   (36/74) installing diffutils                       [#####################] 100%
    314   (37/74) installing expat                           [#####################] 100%
    315   (38/74) installing vim                             [#####################] 100%
    316   (39/74) installing openssh                         [#####################] 100%
    317   (40/74) installing db                              [#####################] 100%
    318   (41/74) installing libgdbm                         [#####################] 100%
    319   (42/74) installing gdbm                            [#####################] 100%
    320   (43/74) installing perl                            [#####################] 100%
    321   (44/74) installing perl-Error                      [#####################] 100%
    322   (45/74) installing perl-Authen-SASL                [#####################] 100%
    323   (46/74) installing perl-Encode-Locale              [#####################] 100%
    324   (47/74) installing perl-HTTP-Date                  [#####################] 100%
    325   (48/74) installing perl-File-Listing               [#####################] 100%
    326   (49/74) installing perl-HTML-Tagset                [#####################] 100%
    327   (50/74) installing perl-HTML-Parser                [#####################] 100%
    328   (51/74) installing perl-LWP-MediaTypes             [#####################] 100%
    329   (52/74) installing perl-URI                        [#####################] 100%
    330   (53/74) installing perl-HTTP-Message               [#####################] 100%
    331   (54/74) installing perl-HTTP-Cookies               [#####################] 100%
    332   (55/74) installing perl-HTTP-Daemon                [#####################] 100%
    333   (56/74) installing perl-HTTP-Negotiate             [#####################] 100%
    334   (57/74) installing perl-Net-HTTP                   [#####################] 100%
    335   (58/74) installing perl-WWW-RobotRules             [#####################] 100%
    336   (59/74) installing perl-libwww                     [#####################] 100%
    337   Optional dependencies for perl-libwww
    338       perl-LWP-Protocol-HTTPS: for https:// url schemes
    339   (60/74) installing perl-TimeDate                   [#####################] 100%
    340   (61/74) installing perl-MailTools                  [#####################] 100%
    341   (62/74) installing perl-IO-stringy                 [#####################] 100%
    342   (63/74) installing perl-Convert-BinHex             [#####################] 100%
    343   module test... pass.
    344   (64/74) installing perl-MIME-tools                 [#####################] 100%
    345   (65/74) installing perl-Net-SSLeay                 [#####################] 100%
    346   (66/74) installing perl-IO-Socket-SSL              [#####################] 100%
    347   (67/74) installing perl-Net-SMTP-SSL               [#####################] 100%
    348   (68/74) installing perl-TermReadKey                [#####################] 100%
    349   (69/74) installing git                             [#####################] 100%
    350   Optional dependencies for git
    351       python2: various helper scripts
    352       subversion: git svn
    353   (70/74) installing make                            [#####################] 100%
    354   (71/74) installing patch                           [#####################] 100%
    355   Optional dependencies for patch
    356       ed: for patch -e functionality
    357   (72/74) installing tar                             [#####################] 100%
    358   (73/74) installing texinfo                         [#####################] 100%
    359   (74/74) installing unzip                           [#####################] 100%
    360 
    361 Building the Tools
    362 ~~~~~~~~~~~~~~~~~~
     13Please see :ref:`microsoft-windows` before continuing.
     14
     15RTEMS Tools
     16~~~~~~~~~~~
    36317
    36418Create a workspace for RTEMS using the following shell command:
Note: See TracChangeset for help on using the changeset viewer.