[ac7d5ef0] | 1 | # |
---|
| 2 | # $Id$ |
---|
| 3 | # |
---|
| 4 | |
---|
[88d594a] | 5 | Between RTEMS 3.1.0 and 3.2.0, every RTEMS defined symbol made visible |
---|
| 6 | was renamed. This document describes the change and the tools provided |
---|
| 7 | to assist you in updating your RTEMS 3.1.0 application. |
---|
[ac7d5ef0] | 8 | |
---|
[88d594a] | 9 | [NOTE: This change was not included in snapshots prior to 3.1.15.] |
---|
| 10 | |
---|
| 11 | DESCRIPTION OF NAME CHANGES: |
---|
| 12 | ============================ |
---|
| 13 | |
---|
| 14 | The primary change was the addition of the prefix "rtems_" or "RTEMS_" to |
---|
| 15 | EVERY user visible RTEMS provided constant and routine. The primary |
---|
| 16 | factor in the decision to make such a sweeping change was conflicts |
---|
| 17 | between the the RTEMS and POSIX API's. |
---|
| 18 | |
---|
| 19 | |
---|
| 20 | TO UPDATE YOUR APPLICATION: |
---|
| 21 | =========================== |
---|
| 22 | |
---|
| 23 | The update script requires that Perl be installed on your computer. |
---|
| 24 | It has only been tested with Perl 5.x. |
---|
| 25 | |
---|
| 26 | After RTEMS has been built, in the directory "$r/<BSP>/update_tools", will |
---|
| 27 | be a set of tools to aid in making the application source changes necessary |
---|
| 28 | to address (hopefully) all of the name changes in the RTEMS API between |
---|
| 29 | releases 3.1.0 and 3.2.0. |
---|
| 30 | |
---|
| 31 | The update shell script is the only executable which is invoked by the |
---|
| 32 | user directly. The word-replace Perl script is invoked by the update |
---|
| 33 | shell script. |
---|
[ac7d5ef0] | 34 | |
---|
| 35 | WARNING: These tools modify the files IN PLACE!!! Backup your |
---|
[88d594a] | 36 | source before using these tools. |
---|
| 37 | |
---|
| 38 | To udpate your application, change directories to the top of your application |
---|
| 39 | source tree and execute the update script. It should be something similar |
---|
| 40 | to the following: |
---|
| 41 | |
---|
| 42 | cd MY_APP |
---|
| 43 | $r/<BSP>/update-tools/update |
---|
| 44 | |
---|
| 45 | The update script will ask if you have backed up your source code before |
---|
| 46 | beginning the update process. While operating on files, it will print |
---|
| 47 | the name of each file and a dot for each change made to the source file. |
---|
[ac7d5ef0] | 48 | |
---|
[88d594a] | 49 | NOTE: These scripts do not attempt to address changes in calling |
---|
| 50 | sequences. After the script has run, you will need to update |
---|
| 51 | calls to rtems_clock_get(), rtems_timer_fire_after(), and |
---|
| 52 | rtems_timer_fire_when() by hand. |
---|