Changeset 97c5024a in rtems-libbsd for libbsd.txt


Ignore:
Timestamp:
04/18/16 00:53:20 (8 years ago)
Author:
Chris Johns <chrisj@…>
Branches:
5, 5-freebsd-12, 6-freebsd-12, freebsd-9.3, master
Children:
00a7956
Parents:
891a756
Message:

Add RTEMS version support, update all python to 2 and 3.

Add support to force the RTEMS version. This remove the need for using
the --rtems-version command line option if the automatic detection fails.

Update all python code to support python 2 and 3.

Update rtems_waf to the latest version to support the RTEMS version,
check environment variables and to display the CC version.

Sort all tests. I think the unsorted list is dependent on the version
of python and so would result in repo noise as if it regenerted.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • libbsd.txt

    r891a756 r97c5024a  
    3333=== Tool Chain ===
    3434
    35 You need a tool chain for RTEMS based on at least
    36 
    37 * Binutils 2.24, and
    38 * Newlib 2.1.0.
    39 
    40 The Binutils version is required to ease the handling of linker command files.
    41 The Newlib version is required since some standard files like `<sys/types.h>`
    42 must be compatible enough for the files provided by the FreeBSD sources, e.g.
    43 `<sys/socket.h>`.
    44 
     35You need a tool chain for RTEMS based on at least RSB 4.12 April 2016 or later.
    4536=== Installation Overview ===
    4637
     
    4839the old network stack.  Make sure no header files of the old network stack are
    4940installed.
     41
    5042. Clone the Git repository +git clone git://git.rtems.org/rtems-libbsd.git+.
    5143. Change into the RTEMS BSD library root directory.
    52 . Edit the `config.inc` Makefile configuration file and adjust it to your environment.
    53 . Run +make clean+.
    54 . Run +make install+.
     44. Edit the `config.inc` configuration file and adjust it to your environment.
     45. Run +waf configure ...+.
     46. Run +waf+.
     47. Run +waf install+.
     48
     49Refer to the README.waf for Waf building instructions.
     50
     51Make sure the submodules have been initialised and are updated. If a 'git
     52status' says `rtems_waf` need updating run the submodule update command:
     53
     54 $ git submodule rtems_waf update
    5555
    5656=== Board Support Package Requirements ===
     
    116116=== BSD Library Configuration and Build ===
    117117
    118 There are currently 2 build systems supported. The first is based on the RTEMS
    119 Makefile support in RTEMS and installed with the BSP and the second is a stand
    120 alone environment based on the Waf build system. The Makefile build system will
    121 be removed when RTEMS moves away from its existing build system and Waf will
    122 be the preferred build environment.
    123 
    124 To build with Waf please refer to the README.waf file.
    125 
    126 ===== Makefile Building =====
     118The build system based on the Waf build system. To build with Waf please refer
     119to the README.waf file.
     120
     121===== Example Configuration =====
    127122
    128123In the BSD library source directory edit the file `config.inc`.  Continuing on
     
    145140NET_CFG_GATEWAY_IP = 10.0.0.1
    146141NET_TAP_INTERFACE = tap0
    147 -------------------------------------------------------------------------------
    148 
    149 Now you can build the BSD library and run the tests:
    150 
    151 -------------------------------------------------------------------------------
    152 make clean
    153 make
    154 make run_tests
    155 -------------------------------------------------------------------------------
    156 
    157 You can only run the tests directly in case a test runner is available.  The
    158 following tests run without an external network.  It is strongly advised to run
    159 them.
    160 
    161 * commands01
    162 * init01
    163 * loopback01
    164 * rwlock01
    165 * selectpollkqueue01
    166 * sleep01
    167 * swi01
    168 * syscalls01
    169 * thread01
    170 * timeout01
    171 * unix01
    172 
    173 To install the BSD library use this:
    174 
    175 -------------------------------------------------------------------------------
    176 make install
    177142-------------------------------------------------------------------------------
    178143
     
    557522
    558523There is a self-contained kit with FreeBSD and RTEMS components pre-merged. The
    559 Makefile in this kit is automatically generated.
     524Waf wscript in this kit is automatically generated.
    560525
    561526Any changes to source in the `freebsd` directories will need to be merged
     
    579544
    580545* `freebsd-to-rtems.py` - script to convert to and free FreeBSD and RTEMS trees,
    581 * `Makefile` - automatically generated,
     546* `wscript` - automatically generated,
    582547* `freebsd/` - from FreeBSD by script,
    583548* `rtemsbsd/` - RTEMS specific implementations of FreeBSD kernel support routines,
     
    594559----
    595560freebsd-to-rtems.py [args]
    596   -?|-h|--help     print this and exit
    597   -d|--dry-run     run program but no modifications
    598   -D|--diff        provide diff of files between trees
    599   -e|--early-exit  evaluate arguments, print results, and exit
    600   -m|--makefile    just generate Makefile
    601   -R|--reverse     default FreeBSD -> RTEMS, reverse that
    602   -r|--rtems       RTEMS directory
    603   -f|--freebsd     FreeBSD directory
    604   -v|--verbose     enable verbose output mode
     561  -?|-h|--help      print this and exit
     562  -d|--dry-run      run program but no modifications
     563  -D|--diff         provide diff of files between trees
     564  -e|--early-exit   evaluate arguments, print results, and exit
     565  -m|--makefile     Warning: depreciated and will be removed
     566  -b|--buildscripts just generate the build scripts
     567  -R|--reverse      default FreeBSD -> RTEMS, reverse that
     568  -r|--rtems        RTEMS directory
     569  -f|--freebsd      FreeBSD directory
     570  -v|--verbose      enable verbose output mode
    605571----
    606572
    607573In its default mode of operation, freebsd-to-rtems.py is used to copy code
    608574from FreeBSD to the rtems-libbsd tree and perform transformations.  In forward
    609 mode, the script may be requested to just generate the Makefile and Waf script.
     575mode, the script may be requested to just generate the Waf script.
    610576
    611577In "reverse mode", this script undoes those transformations and copies
Note: See TracChangeset for help on using the changeset viewer.