Patch 200809171-1 - Rational Apex Embedded (VxWorks/Tornado)
                    4.4 for Sun Solaris->PowerPC
-----------------------------------------------------------
To install this patch, download these 3 files and run the install script:
   install_sol_200809171_1
   sol.patch.200809171-1.inventory
   sol.patch.200809171-1.tar.Z


Description

----------------------------------------------------------
It is suggested that all users install this patch.

----------------------------------------------------------
This patch fixes the following:

Defect RATLC00389186:

The Rational Ada Embedded Developer for PowerPC VxWorks code
generator can take excessively long to process large array aggregates
(Ada) or const arrays (C/C++). A new sort algorithm has been
incorporated into the code generator to speed this up.

----------------------------------------------------------
The following were fixed in earlier patches. The fixes are
included in this patch as well.

Defect RATLC00143969:

This is an enhancement to the C preprocessor to preserve comments in the
output. The -E option preserves the output from the preprocessor. Adding
the -C option preserves the comments from the include files in the output.

Defect RATLC00150182:

Rational Ada Embedded Developer object files for Rational Exec and
VxWorks platforms contain a signature, or 'magic number', that
indicates that they object files and provides some information about
how they should be processed. A bad magic number can cause the linker
to fail with a constraint error, resulting in the general error
message:

XLINK: INTERNAL ERROR: while reading objects

Any unexpected exception in the embedded linker while reading object
files will result in the same error, and no indication of which file
caused the problem is provided.

This patch provides an embedded linker that indicates which file
caused the problem when a bad magic number results in a
Constraint_Error exception. The error message is now in the form:

XLINK: bad magic: /ned/rts/smoke_test.ss/power.vw_ppc.board.ada95.release.embedded.440.wrk/RATLC00150182/bad.o
XLINK: INTERNAL ERROR: while reading objects

Defect RATLC00389402:

This patch provides an embedded linker which implements the
STACK_TRACE linker option switch. This switch can be added to the
OPTIONS section of a linker description file, by default Link.des in
the current usr_conf.ss view. If the linker fails because of an
unexpected exception, it will produce a trace_dump file in the
presence of STACK_TRACE. This file can be used by IBM support to
pinpoint the cause of the problem. STACK_TRACE has no effect on a
successful link.

This patch requires a coordinated change to the Apex compiler
(Apex_Main_Duo). As of the creation of this patch the most recent
Solaris native patch contains a compatible compiler; that or a later
version must be installed to make use of this feature of the embedded
linker.

Defect RATLC00395906:

The db_iface deamon is used to implement Apex debugger commands on
the target on which an application is being debugged. The VxWorks
version of one of these interfaces, task stack usage (used to
implement the 'lt use' command), neglects to update an out parameter
on one possible execution path. The later use of this out parameter
is erroneous and therefore unpredictable. In previous versions of
Apex VxWorks 'lt use' was not seen to fail, but in Apex 4.4.0 it has
never been seen to succeed.
This patch provides corrected interface deamons.

Defect RATLC00397496:

The apex_convert utility in Rational Ada Embedded Developer 4.4.0 is
erroneous. It can overflow one of its internal buffers, with
unpredictable results. Frequently this involves corruption of the
underlying memory management heap structure (used by the system
malloc() utility), which in turn frequently results in apex_convert
terminating with a segmentation fault. Other observed effects are
apex_convert INTERNAL ERROR messages.

This patch provides corrected Solaris and Linux binaries for apex_convert.

----------------------------------------------------------
It is suggested that all users install this patch.