Changeset 455aa3a in rtems-libbsd for libbsd.txt


Ignore:
Timestamp:
03/09/12 19:04:44 (12 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.11, 5, 5-freebsd-12, 6-freebsd-12, freebsd-9.3, master
Children:
9e3ba38
Parents:
e392fdb7
git-author:
Joel Sherrill <joel.sherrill@…> (03/09/12 19:04:44)
git-committer:
Joel Sherrill <joel.sherrill@…> (03/09/12 19:04:58)
Message:

Add more details to documentation.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • libbsd.txt

    re392fdb7 r455aa3a  
    6060
    6161The FreeBSD source tarball includes a file named Makefile.rtems which
    62 has stanzas to automatically generate some files.
    63 
    64 http://www.freebsd.org/cgi/man.cgi?query=kobj&apropos=0&sektion=0&manpath=FreeBSD+9.0-RELEASE&arch=default&format=html
     62has stanzas to automatically generate some files using awk. For details
     63on this, see http://www.freebsd.org/cgi/man.cgi?query=kobj&apropos=0&sektion=0&manpath=FreeBSD+9.0-RELEASE&arch=default&format=html
     64
     65XXX This needs more detail.
    6566
    6667=== Rules for Modifying FreeBSD Source
     
    7980be merged upstream into our master FreeBSD svn checkout.
    8081
    81 === Building git
    82 
    83 You need to configure RTEMS for the desired BSP and install it. Then edit
    84 the file config.inc to set RTEMS_MAKEFILE_PATH appropriately.
     82=== Building RTEMS libbsd source
     83
     84You need to configure RTEMS for the desired BSP and install it. The
     85following is the script used to build the powerpc/psim BSP for our
     86internal testing purposes:
     87
     88[listing]
     89----
     90#! /bin/sh
     91
     92cd ${HOME}/newbsd
     93rm -rf b-psim
     94mkdir b-psim
     95cd b-psim
     96../git/rtems/configure --target=powerpc-rtems4.11 \
     97  --enable-rtemsbsp=psim --disable-networking \
     98  --enable-tests=samples \
     99  --prefix=${HOME}/newbsd/bsp-install >c.log 2>&1 && \
     100  make >b.log 2>&1 && \
     101  make install >i.log 2>&1
     102echo $?
     103----
     104
     105Then edit the file config.inc to set RTEMS_MAKEFILE_PATH appropriately
     106to indicate the ${prefix}/${target}/${BSP}.  Continuing on the above,
     107the config.inc used to match the above is:
     108
     109[listing]
     110----
     111RTEMS_MAKEFILE_PATH = ${HOME}/newbsd/bsp-install/powerpc-rtems4.11/psim/
     112INSTALL_BASE = ${HOME}/newbsd/install
     113----
     114
     115The above installs the RTEMS libbsd kit into a separate place from
     116RTEMS and the BSP. The RTEMS libbsd tests are built against an installed
     117image of the RTEMS libbsd. By keeping it in a separate installation point
     118from RTEMS itself, this makes it easier to remove a libbsd installation
     119and have a clean test point.
    85120
    86121[listing]
     
    160195----
    161196
     197== Initialization of RTEMS Libbsd
     198
     199The initialization of the RTEMS Libbsd is based on the FreeBSD SYSINIT
     200infrastructure. This is simply because we are initializing a subset of
     201FreeBSD. For details refer to http://www.freebsd.org/cgi/man.cgi?query=SYSINIT&sektion=9&apropos=0&manpath=FreeBSD+9-current
     202
     203The key to initializing a system is to ensure that the desired device
     204drivers are explicitly pulled into the linked application. This plus
     205linking against the Libsd library will pull in the necessary FreeBSD
     206infrastructure. The SYSINIT structures are automatically built at link
     207time and the various initialization routines will thus be executed in'
     208the correct order.
     209
     210XXX This needs more details.
Note: See TracChangeset for help on using the changeset viewer.