Open System Services Shell and Utilities Reference Manual (G06.25+, H06.03+)

Table Of Contents

User Commands (c) c89(1)

The order of specifying the -I and -L ﬂags is signiﬁcant.

Quotation marks around string values in ﬂags are optional but recommended to avoid errors

caused by shell substitutions or deletions.

Refer to the C/C++ Programmer’s Guide for details.

DESCRIPTION

c89 is the driver program for the native C and C++ language compilation system. This reference

page describes using c89 in the OSS environment.

c89 performs simple validation of the ﬂags and operands from the arguments on its command

line and, depending on those arguments, invokes components of the language compilation sys-

tem. c89 does not verify the existence of ﬁles it passes to compilation system components. It

does verify that the operand sufﬁx identiﬁes a valid operand to pass to compilation system com-

ponents. c89 and the components it runs issue messages to the standard error ﬁle.

c89 performs the following steps:

1. If the corresponding -W ﬂag is speciﬁed, invokes an SQL preprocessor to process any

embedded SQL statements in C or C++ source ﬁles, creating C only, C++ only, or

module deﬁnition ﬁles as appropriate.

2. Compiles any speciﬁed C and C++ source ﬁles or source ﬁles produced by Step 1 into

object ﬁles.

3. If the -Wmxcmp ﬂag is speciﬁed, invokes the NonStop SQL/MX compiler to process

ﬁles created by Step 1 or speciﬁed as module deﬁnition ﬁles in the command.

4. Links the object ﬁles together with any libraries speciﬁed on the command line. (This

occurs if no ﬂags that prevent linking are speciﬁed and the source ﬁles are compiled

without errors.)

5. If the -Wsqlcomp ﬂag is speciﬁed, invokes the NonStop SQL/MP compiler to process

ﬁles created by Step 1 or speciﬁed in the command.

6. Writes an executable object ﬁle or library to the ﬁle speciﬁed by a -o ﬂag (if present) or

to the ﬁle a.out.

Libraries can be:

• Archives, with a sufﬁxof.a

• DLLs, with a sufﬁxof.so

• TNS/R native user libraries

• TNS/R native SRLs, with a sufﬁxof.srl

The default executable ﬁle in the Guardian ﬁle system is aout in the subvolume from which c89

is invoked.

If only a single source ﬁle is given and no ﬂags that suppress linking are speciﬁed, then the ﬁle is

compiled into an object ﬁle and linked into an executable object ﬁle. If the executable ﬁle is

created successfully, the object ﬁle is removed.

c89 places object ﬁles (loadﬁles) in the current working directory with the same base name as the

corresponding source ﬁle, but with a sufﬁxof.o.

c89 also names several temporary or intermediate ﬁles that are created during the compilation

process. Like the output object ﬁle, c89 places these ﬁles in the current working directory. c89

removes these temporary or intermediate ﬁles unless the -Wsavetemps ﬂag is speciﬁed.

527188-003 Hewlett-Packard Company 2−19