Changeset e392fdb7 in rtems-libbsd for libbsd.txt
- Timestamp:
- 03/09/12 17:18:06 (12 years ago)
- Branches:
- 4.11, 5, 5-freebsd-12, 6-freebsd-12, freebsd-9.3, master
- Children:
- 455aa3a
- Parents:
- 8f5adbc
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
libbsd.txt
r8f5adbc re392fdb7 14 14 modifications to the FreeBSD source are permitted. 15 15 16 Goals of this effort are: 17 18 * Update TCP/IP and provide USB in RTEMS 19 * Ease updating to future FreeBSD versions 20 * Ease tracking changes in FreeBSD code 21 * Minimize manual changes in FreeBSD code 22 * Define stable kernel/device driver API which is implemented 23 by both RTEMS and FreeBSD. This is the foundation of the port. 24 25 We will work to push our changes upstream to the FreeBSD Project 26 and minimize changes required at each update point. 27 16 28 ************************************************************** 17 29 This is a work in progress and is very likely to be incomplete. … … 27 39 - BSP must be from an architecture with Programmable Interrupt Controller 28 40 interrupt model. 41 42 The FreeBSD 8.2 SVN checkout will generally be referred to as the 43 FreeBSD source in this document. 29 44 30 45 == To Do … … 79 94 currently working on. 80 95 81 82 96 === Organization 83 97 … … 93 107 * libbsd.txt - Documentation in Asciidoc 94 108 109 == Moving Code Between FreeBSD SVN and RTEMS libbsd 110 111 The script freebsd-to-rtems.py is used to copy code from FreeBSD to the 112 RTEMS libbsd tree and to reverse this process. This script attempts to 113 automate this process as much as possible and performs some transformations 114 on the FreeBSD code. Its command line arguments are shown below: 115 116 [listing] 117 ---- 118 freebsd-to-rtems.py [args] 119 -?|-h|--help print this and exit 120 -d|--dry-run run program but no modifications 121 -e|--early-exit evaluate arguments, print results, and exit 122 -m|--makefile just generate Makefile 123 -R|--reverse default FreeBSD -> RTEMS, reverse that 124 -r|--rtems RTEMS directory 125 -f|--freebsd FreeBSD directory 126 -v|--verbose enable verbose output mode 127 ---- 128 129 In its default mode of operation, freebsd-to-rtems.py is used to copy code 130 from FreeBSD to the RTEMS libbsd tree and perform transformations. In forward 131 mode, the script may be requested to just generate the Makefile. 132 133 In "reverse mode", this script undoes those transformations and copies 134 the source code back to the FreeBSD SVN tree. This allows us to do 135 'svn diff', evaluate changes made by the RTEMS Project, and report changes 136 back to FreeBSD upstream. 137 138 In either mode, the script may be asked to perform a dry-run or be verbose. 139 Also, in either mode, the script is also smart enough to avoid copying over 140 files which have not changed. This means that the timestamps of files are 141 not changed unless the contents change. The script will also report the 142 number of files which changed. In verbose mode, the script will print 143 the name of the files which are changed. 144 145 The following is an example forward run with no changes. 146 147 [listing] 148 ---- 149 $ ~/newbsd/git/libbsd-8.2/freebsd-to-rtems.py \ 150 -r /home/joel/newbsd/git/libbsd-8.2 \ 151 -f /home/joel/newbsd/libbsd/freebsd-8.2 -v 152 Verbose: yes 153 Dry Run: no 154 Only Generate Makefile: no 155 RTEMS Directory: /home/joel/newbsd/git/libbsd-8.2 156 FreeBSD Directory: /home/joel/newbsd/libbsd/freebsd-8.2 157 Direction: forward 158 Generating into /home/joel/newbsd/git/libbsd-8.2 159 0 files were changed. 160 ---- 161
Note: See TracChangeset
for help on using the changeset viewer.