Changeset b328e49 in rtems-source-builder


Ignore:
Timestamp:
Apr 23, 2013, 7:29:29 AM (6 years ago)
Author:
Chris Johns <chrisj@…>
Branches:
4.10, 4.11, 4.9, master
Children:
b30a539
Parents:
86b2b4f
Message:

Update the RTEMS Configurations to show how to build autotools if they are not valid.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/source-builder.txt

    r86b2b4f rb328e49  
    15931593specific to a specific version because of variations between Newlib and
    15941594RTEMS. Restructuring in RTEMS and Newlib sometimes moves _libc_ functionality
    1595 between them and this makes existing tool incompatible with RTEMS.
     1595between these two parts and this makes existing tools incompatible with RTEMS.
    15961596
    15971597RTEMS allows architectures to have different tool versions and patches. The
     
    16051605architectures.
    16061606
    1607 RTEMS supports _stable_ and _unstable_ configuration of tools. The stable build
    1608 sets are referenced as +<version>/rtems-<arch>+ and the unstable build sets are
    1609 references as +<version>/unstable/rtems-<arch>+.
     1607RTEMS supports _stable_ and _unstable_. Stable configurations are fixed while
     1608unstable configurations are supporting using snapshots of user macros and
     1609reference release candidates or source extracted directly from version
     1610control. The stable build sets are referenced as +<version>/rtems-<arch>+ and
     1611include `autoconf` and `automake`.
     1612
     1613If you are building a released version of RTEMS the release RTEMS tar file will
     1614be downloaded and built as part of the build process. If you are building a
     1615tool set for use with the development branch of RTEMS, the development branch
     1616will be cloned directly from the RTEMS GIT repository and built.
     1617
     1618When building RTEMS within the RTEMS Source Builder it needs a suitable working
     1619`autoconf` and `automake`. These packages need to built and installed in their
     1620prefix in order for them to work. The RTEMS Source Builder installs all
     1621packages only after they have been built so if you host does not have a
     1622recent enough version of `autoconf` and `automake` you first need to build them
     1623and install them then build your tool set. The commands are:
     1624
     1625-------------------------------------------------------------
     1626$ ../source-builder/sb-set-builder --log=l-4.11-at.txt \
     1627   --prefix=$HOME/development/rtems/4.11-at 4.11/rtems-autotools
     1628$ export PATH=~/development/rtems/4.11/bin:$PATH
     1629$ ../source-builder/sb-set-builder --log=l-4.11-sparc.txt \
     1630   --prefix=$HOME/development/rtems/4.11 4.11/rtems-sparc
     1631-------------------------------------------------------------
     1632
     1633To build snapshots for testing purposes you use the available macro maps
     1634passing them on the command line using the `--macros` option. For RTEMS these
     1635are held in `config/snapshots` directory. The following build _newlib_ from
     1636CVS:
     1637
     1638-------------------------------------------------------------
     1639$ ../source-builder/sb-set-builder --log=l-4.11-sparc.txt \
     1640   --prefix=$HOME/development/rtems/4.11 --macros=snapshots/newlib-head.mc
     1641   4.11/rtems-sparc
     1642-------------------------------------------------------------
    16101643
    16111644Commands
Note: See TracChangeset for help on using the changeset viewer.