-B

Pragma equivalent

None.

Purpose

Specifies substitute path names for XL C/C++ components such as the assembler, C preprocessor, and linker.

You can use this option if you want to keep multiple levels of some or all of the XL C/C++ executables and have the option of specifying which one you want to use. However, it is preferred that you use the -qpath option to accomplish this instead.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- -B--+--------+---------------------------------------------><
        '-prefix-'   

Defaults

The default paths for the compiler executables are defined in the compiler configuration file.

Parameters

prefix
Defines part of a path name for programs you can name with the -t option. You must add a slash (/). If you specify the -B option without the prefix, the default prefix is /lib/o.

Usage

The -t option specifies the programs to which the -B prefix name is to be appended; see -t for a list of these. If you use the -B option without -tprograms, the prefix you specify applies to all of the compiler executables.

The -B and -t options override the -F option.

Predefined macros

None.

Examples

In this example, an earlier level of the compiler components is installed in the default installation directory. To test the upgraded product before making it available to everyone, the system administrator restores the latest installation image under the directory /home/jim and then tries it out with commands similar to:
xlc -tcbI -B/home/jim/opt/ibm/xlC/13.1.2/bin/ test_suite.c

Once the upgrade meets the acceptance criteria, the system administrator installs it in the default installation directory.

Related information



Voice your opinion on getting help information Ask IBM compiler experts a technical question in the IBM XL compilers forum Reach out to us