Open System Services Shell and Utilities Reference Manual (G06.28+, H06.05+)

c89(1) OSS Shell and Utilities Reference Manual

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.

If -Wsystype=oss is set, the C and C++ compilers deﬁne the predeﬁned feature-test macros

_OSS_TARGET and _XOPEN_SOURCE.If-Wsystype=guardian is set, the C and C++ com-

pilers deﬁne the predeﬁned feature-test macros _GUARDIAN_TARGET and

_TANDEM_SOURCE. These macros are used in the standard header ﬁles to determine the exe-

cution environment of a program. The feature-test macros can also be deﬁned with a -D ﬂag.

Because these macros are deﬁned internally, not by c89, the macros are not deﬁned when

-Wdryrun or -Wv are used.

2−20 Hewlett-Packard Company 527188-007