Documentation errata for IBM XL C/C++ for Linux 12.1

Preventive Service Planning


Abstract

This page contains corrections and additions to the product documentation shipped with IBM XL C/C++ for Linux 12.1.

Content

Installation Guide

The following corrections and additions apply to the IBM XL C/C++ for Linux 12.1 Installation Guide:

Chapter: Before installing IBM XL C/C++ for Linux 12.1

Upgrading the evaluation copy of the XL C/C++ compiler

Install only the vac.lic RPM packages for the full product version of the XL C/C++ compiler and run vac_configure to re-configure the compiler.

should read:

  1. Install the vac.lic RPM packages.

  2. Install the vac.cmp and vacpp.cmp RPM packages using the --replacepkgs --replacefiles options.

    For example:
    rpm -ivh  vac.cmp-12.1.0.0-120323.ppc64.rpm --replacepkgs --replacefiles
    rpm -ivh  vacpp.cmp-12.1.0.0-120323.ppc64.rpm --replacepkgs --replacefiles

  3. Run new_install or vac_configure to re-configure the compiler.


Section: The installation image and packages

Table 2. Utilization reporting tool package 1.1

should read:

Table 2. Utilization reporting tool package 1.2

All references to the version of the utilization reporting tool (urt) in the Installation Guide should be changed to V1.2.


Compiler Reference
The following corrections and additions apply to the IBM XL C/C++ for Linux, V12.1 Compiler Reference:

Chapter: Tracking and reporting compiler usage

Section: Understanding the utilization reporting tool

The tool is located in the /opt/ibmurt/1.1/bin directory.

should read:

The tool is located in the /opt/ibmurt/1.2/bin directory.


A default configuration file ibmurt.cfg is provided in the /opt/ibmurt/1.1/config directory.

should read:

A default configuration file ibmurt.cfg is provided in the /opt/ibmurt/1.2/config directory.

All references to the version of the utilization reporting tool (urt) in the Compiler Reference should be changed to V1.2.


Chapter: Compiler options reference

Section: Individual option descriptions

Topic: -qdigraph

Purpose
Enables recognition of digraph key combinations or keywords to represent characters not found on some keyboards.

should read:

Enables recognition of digraph key combinations C++ onlyand operator keywords C++ only to represent characters that are not found on some keyboards. Digraph key combinations include <:,   <%, and so on. C++ onlyOperator keywords include and, or, and so on. C++ only

Topic: -qinline

Note that the -qinline- and -qinline+ options are supported only by the XL C compiler.

Defaults
  • -qnoinline
  • At optimization levels of -O2 and higher, the default is -qinline=noauto
  • -qinline=auto:level=5 is the default suboption of -qinline

Parameters
noauto | auto
Enables or disables automatic inlining. If you do not specify any -qinline suboptions, -qinline=auto is the default.
should read:

Defaults

If -qinline is not specified, the default option is -qnoinline at the -O0 or -qnoopt optimization level or -qinline=noauto:level=5:20 at the -O2 or higher optimization levels.

If -qinline is specified without any suboptions, the default option is -qinline=auto:level=5:20.

Parameters
noauto | auto
Enables or disables automatic inlining.

Topic: -qtune

The following rows in the Acceptable -qarch/-qtune combinations table:

-qarch option Default -qtune setting Available -qtune settings
pwr4 pwr4 auto | pwr4 | pwr5 | pwr7 | ppc970 | balanced
pwr5 pwr5 auto | pwr5 | pwr7 | balanced
pwr5x pwr5 auto | pwr5 | pwr7 | balanced

Should read:

-qarch option Default -qtune setting Available -qtune settings
pwr4 pwr4 auto | pwr4 | pwr5 | pwr6 | pwr7 | ppc970 | balanced
pwr5 pwr5 auto | pwr5 | pwr6 | pwr7 | balanced
pwr5x pwr5 auto | pwr5 | pwr6 | pwr7 | balanced

Chapter: Compiler pragmas reference

Section: Individual pragma descriptions

Topic: #pragma reg_killed_by

fs
    Floating-point and status control register

Should read:

fsr
    Floating-point and status control register


Chapter: Compiler built-in functions

Section: GCC atomic memory access built-in functions

The data types of the parameters that are supported in these functions include Boolean type and any integral scalar type of 1, 2, 4 or 8 bytes, listed as follows.

should read:

In the prototype of each function, the parameter types T, U, and V can be of pointer or integral type. U and V can also be of real floating-point type, but only when T is of integral type. The following tables list the integral and floating-point types that are supported by these built-in functions.

Table 1. Supported data types

should read:

Table 1. Supported integral data types

The following data types in Table 1. Supported integral data types

C++ only bool C++ onlywchar_t
C only _Bool

should read:

C++ only bool C only _Bool

The following table should be added:

Table 2. Supported floating-point data types
float
double
long double

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

XL C/C++ for Linux
Documentation

Software version:

12.1

Operating system(s):

Linux

Reference #:

1588552

Modified date:

2013-11-20

Translate my page

Machine Translation

Content navigation