Changeset 97c5024a in rtems-libbsd for libbsd.txt
- Timestamp:
- 04/18/16 00:53:20 (8 years ago)
- Branches:
- 5, 5-freebsd-12, 6-freebsd-12, freebsd-9.3, master
- Children:
- 00a7956
- Parents:
- 891a756
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
libbsd.txt
r891a756 r97c5024a 33 33 === Tool Chain === 34 34 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 35 You need a tool chain for RTEMS based on at least RSB 4.12 April 2016 or later. 45 36 === Installation Overview === 46 37 … … 48 39 the old network stack. Make sure no header files of the old network stack are 49 40 installed. 41 50 42 . Clone the Git repository +git clone git://git.rtems.org/rtems-libbsd.git+. 51 43 . 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 49 Refer to the README.waf for Waf building instructions. 50 51 Make sure the submodules have been initialised and are updated. If a 'git 52 status' says `rtems_waf` need updating run the submodule update command: 53 54 $ git submodule rtems_waf update 55 55 56 56 === Board Support Package Requirements === … … 116 116 === BSD Library Configuration and Build === 117 117 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 ===== 118 The build system based on the Waf build system. To build with Waf please refer 119 to the README.waf file. 120 121 ===== Example Configuration ===== 127 122 128 123 In the BSD library source directory edit the file `config.inc`. Continuing on … … 145 140 NET_CFG_GATEWAY_IP = 10.0.0.1 146 141 NET_TAP_INTERFACE = tap0 147 -------------------------------------------------------------------------------148 149 Now you can build the BSD library and run the tests:150 151 -------------------------------------------------------------------------------152 make clean153 make154 make run_tests155 -------------------------------------------------------------------------------156 157 You can only run the tests directly in case a test runner is available. The158 following tests run without an external network. It is strongly advised to run159 them.160 161 * commands01162 * init01163 * loopback01164 * rwlock01165 * selectpollkqueue01166 * sleep01167 * swi01168 * syscalls01169 * thread01170 * timeout01171 * unix01172 173 To install the BSD library use this:174 175 -------------------------------------------------------------------------------176 make install177 142 ------------------------------------------------------------------------------- 178 143 … … 557 522 558 523 There is a self-contained kit with FreeBSD and RTEMS components pre-merged. The 559 Makefilein this kit is automatically generated.524 Waf wscript in this kit is automatically generated. 560 525 561 526 Any changes to source in the `freebsd` directories will need to be merged … … 579 544 580 545 * `freebsd-to-rtems.py` - script to convert to and free FreeBSD and RTEMS trees, 581 * ` Makefile` - automatically generated,546 * `wscript` - automatically generated, 582 547 * `freebsd/` - from FreeBSD by script, 583 548 * `rtemsbsd/` - RTEMS specific implementations of FreeBSD kernel support routines, … … 594 559 ---- 595 560 freebsd-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 605 571 ---- 606 572 607 573 In its default mode of operation, freebsd-to-rtems.py is used to copy code 608 574 from FreeBSD to the rtems-libbsd tree and perform transformations. In forward 609 mode, the script may be requested to just generate the Makefile andWaf script.575 mode, the script may be requested to just generate the Waf script. 610 576 611 577 In "reverse mode", this script undoes those transformations and copies
Note: See TracChangeset
for help on using the changeset viewer.