Options:

Link dynamically against any subsequent libraries on the command line.

-C

Preprocessor leaves comments.

-c

Compile only.

-Dname[=value]

Define the symbol name, optionally setting its value.

-E

Preprocess to stdout.

-EB or
-EL

Compile for big or little endian.

-g

Compile with debug.

-Ipath[:path ...]

Set the search path for #include directives.

-Lpath[:path ...]

Set the library search path.

The development tools have been designed to work out of their
processor directories (x86, ppcbe, etc.).
This means you can use the same tool set for any target platform.

If you have development libraries for a certain platform, put them
into the platform-specific library directory (e.g. /x86/lib),
which is where the compiler tools look by default.
Don't put the libraries in /lib or /usr/lib,
which are ignored.
Alternatively, use the -L option to specify the libraries'
location.

-llibrary

(el) Add library to the list of libraries to
link against.
Omit the lib prefix and any extension from the library's name.
For example, to link against libsocket, specify
-l socket.

You can specify more than one -l option.
The qcc configuration files might specify some libraries
for you; for example, qcc usually links against
libc.

-lang-c

Treat as C (the default for qcc).

-lang-c++

Treat as C++ (the default for QCC).

You need to link C++ programs with the -lang-c++ option in
order for exceptions to work.

-M

Generate a mapfile called output_file.map.

-Nstacksize[K]

Specify the stack size, in bytes or kilobytes.

-n

Don't execute.

-nopipe

Use temporary files rather than pipes between phases.

-nostartup

Don't use ld_startup_* sections.

-nostdinc

Don't include the standard C include paths.

-nostdinc++

Don't include the standard C++ include paths.

-nostdlib

Don't use the ld_stdlib section.

-nostdlib++

Don't use the ld_stdlib++ section.

-O

Do compile-phase optimization.

-ooutfile

Specify the name of the output file. The default is a.out.

Note that the make utility, when used with the default settings,
produces an output file with the same name as the input file. For example:

You must be root to use the
-set-default option. Note also that the option is
intended for use at the command line, not for makefiles.

-shared

When compiling, make the object position-independent so that it's
suitable for inclusion in a shared object. When linking, combine the
modules into a shared object.

-static

Link against static libraries only.

-Uname

Undefine the given symbol.

-V [[compiler/]version,][target]

The compiler name, version number, and the target name. If
you don't specify -V at all, qcc will
use the default compiler, version, and target.

If you specify the target, qcc looks
for the target configuration files in the following paths,
according to how compiler, version,
and target are specified:

If you specify:

qcc looks here:

-Vtarget

${QCC_CONF_PATH}/compiler/version
(where
compiler is inferred from target, and version is the default).

-Vversion,target

${QCC_CONF_PATH}/compiler/version
(where
compiler is inferred from target; if that path doesn't exist, or if version
contains a slash [/], then ${QCC_CONF_PATH}/version
is used).

-Vcompiler,target

${QCC_CONF_PATH}/compiler/version
(where
version is the specified compiler's default version).

-Vcompiler/version,target

${QCC_CONF_PATH}/compiler/version

For example, this command:

qcc -Vgcc,

lists all targets in all versions of gcc. See the Examples section below for more examples.

The targets include:

gcc_ntoarmle

gcc_ntomipsbe

gcc_ntomipsle

gcc_ntoppcbe

gcc_ntoshle

gcc_ntox86

For a list of supported targets, specify -V (or
-Vcompiler or
-Vcompiler/version or
-Vversion, provided there's a valid
${QCC_CONF_PATH}/version
directory).

-v[v]

Operate verbosely (the second v turns on verbosity in
the compiler).

-Wphase,arg[,arg ...]

Pass the specified option and its arguments through to a specific phase:

p — preprocessor

c — compiler

l — linker

a — assembler.

For example, if you want to pass the -MD option to the
compiler, specify -Wc,-MD on the command line for
qcc.

-w

Suppress all warnings (same as -w0).

If you specify -w along with multiple warning
options, all warnings are suppressed regardless of
the order of the options. In other words, -w
always wins.

-w[0-9]

Set the warning level (0=off).
The -w9 option is the same as gcc's
-W9 option. To generate warnings for
everything, include these options with -w9:

-Wcast-qual

-Wpointer-arith

-Wshadow

-Wwrite-strings

Note that using these options will produce warnings in the
standard C++ library headers, and possibly other system headers.

-xextension

Treat the files that follow as being of type extension.
The following values of extension are accepted:

c

c-header

c++

c++-header

cpp-output

assembler

assembler-with-cpp

as well as valid file extensions, such as .c,
.cc, .cpp, .C,
.i, .ii, .s, and
.S.

Use -xnone to go back to normal suffix typing.
For example, to compile myfile.h as if it were a
.c file:

qcc -xc myfile.h

-Ylib_type

Select the C++ library type to be used (if available), lib_type can be:

_gpp — GNU C++ lib (available only for x86)

_cpp — Dinkum C++ lib (default)

_cpp-ne — Dinkum C++ lib (no exceptions)

_acpp — Dinkum Abridged C++ lib

_acpp-ne — Dinkum Abridged C++ lib (no exceptions)

_ecpp — Embedded Dinkum C++ lib

_ecpp-ne — Embedded Dinkum C++ lib (no exceptions)

Even with exceptions disabled, the new() operator throws a
std::out_of_memory exception if there isn't enough memory.
If you want new() to return NULL instead of
throwing an exception, overload the new() operator with
your own.

Description:

QCC and qcc are the QNX compiler interface.
They're based on the POSIX c89 utility.
By default, QCC considers a program to be C++, while
qcc considers it to be C.

QCC and qcc take a list of source and object modules
on the command line and invoke the appropriate parser to compile
each file. Object modules are passed straight through to the linker.
The file suffix determines which parser is used, as follows:

Suffix

Parser

.s

Assembler

.S

Assembler with preprocessor directives

.c

C compiler

.i

Preprocessed C file

.C, .cc, .cpp

C++ compiler

.H, .HPP, .h++,
.h, .hh, .hpp,
.hxx

Precompiled header

.ii

Preprocessed C++ file

.o

Object file

.a

Library file

These utilities don't allow multiple options to be specified
after a dash character (-). For example, -gc
isn't valid; you must specify -g -c instead. Operands
(source and object files) and options may be mixed and specified in
any order. Some options, such as -I and -L, are
order-dependent—the order in which they appear in the command
line determines the order of the searches made. All command-line
arguments are processed before any compilation or linking begins.

The single-pass linker resolves symbols from left to
right: If a module refers to a symbol that is contained in a library,
make sure you specify the library to the right of the module.

When qcc encounters a compilation error that stops an
object file from being created, it writes a diagnostic to the standard
error and continues to compile other source files, but it bypasses
the link phase and returns a nonzero exit status.
If the link phase is entered and
is unsuccessful, a diagnostic is written and qcc exits
with a nonzero status.

The -c option suppresses the link phase. If you have
many separate source files that you must update and modify individually,
you'll probably use the -c option frequently.

You may occasionally wish to examine the assembly code produced by
the code generator. The -S option produces an assembly
file ending in .s.

If you need to specify a parameter to any of the language processors,
you may use the -Wc,option. Check the
documentation on each processor to determine its options.

The compiler defines various preprocessor symbols (or manifest constants)
that can help you make decisions
at compile time.
For more information, see the
Manifests
chapter of the QNX Neutrino C Library Reference.

Profiling

Here's how to profile your application, so you can see where it's spending
its time:

Compile and link your application with profiling by using the
-p option to qcc.
For example: