Patch 200809172-1 - Rational Apex Embedded (Rational Exec)
                    4.4 for Sun Solaris->PowerPC
-----------------------------------------------------------
To install this patch, download these 3 files and run the install script:
   install_sol_200809172_1
   sol.patch.200809172-1.inventory
   sol.patch.200809172-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 Rational Exec 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 RATLC00379382:

This patch fixes a problem with handling cross I/O when running on Solaris 9
that would result in a seg fault or bus error.

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 RATLC00876949:

This patch fixes problems with multiple target debugging.

Defect RATLC00876972:

When debugging a single target, I/O can be redirected to/from files.
A customer asked for the same support when debugging multiple targets via
the '-program_file' option.
Added support for the directives program_input: and program_output: in the
program_file.
Use 'use_xterm: true' for xterm windows. Replace with 'program_output:' and/or
'program_input:' to specify file output and/or input.

Defect RATLC00878634:

When the debugger is used to debug 3 or more programs using the -program_file
option and output is to X11 terminal windows (xterms), the 3rd daemon's
initialization fails with a message
'[start_daemon] could not dup2(19, 8)' and the debugger exits.
This was due to use of an out of date file descriptor limit on Solaris and
Linux hosts.

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