Open System Services Shell and Utilities Reference Manual (G06.27+, H06.04+)

User Commands (c) c89(1)

• An executable ﬁle produced by the nld utility

• A module deﬁnition ﬁle created by the NonStop SQL/MX preprocessor.

When the -Wsql ﬂag is speciﬁed, C source ﬁles that contain embedded NonStop SQL/MP infor-

mation can have names sufﬁxed with .c or .ec. When the -Wsqlmx ﬂag is speciﬁed, c89 uses the

source ﬁle ﬁlename extension to determine the language mode (C or C++) and the names of the

source ﬁles created by the NonStop SQL/MX preprocessor.

The name of a created source ﬁle is the name of the primary source ﬁle plus one of the following

extension transformations:

• If the primary source ﬁle sufﬁxis.ec or .sql and the -Wcpluplus ﬂag is not speciﬁed, the

created source ﬁle has the sufﬁx .c and uses the C language mode.

• If the primary source ﬁle sufﬁxis.ec or .sql and the -Wcplusplus ﬂag is also speciﬁed,

the created source ﬁle has the sufﬁx .cpp and uses the C++ language mode.

• If the primary source ﬁle sufﬁxis.eC, .ecpp, .ec++, .ecc,or.ecxx, the created source ﬁle

has the sufﬁx .C, .cpp, .c++, .cc,or.cxx, resapectively, and uses the C++ language mode.

When c89 is passed a ﬁle name sufﬁxed with .C, .cpp, .c++, .cc,or.cxx, that ﬁle is not passed to

the NonStop SQL/MX preprocessor. Such ﬁles are assumed to contain only C or C++ statements

without embedded NonStop SQL/MX information.

Output Files

An output ﬁle can be a preprocessed source ﬁle, an object ﬁle, or an executable ﬁle.

Standard Output File

The standard output ﬁle is empty unless a -E, -WM,or-WP ﬂag is speciﬁed. If one of these

ﬂags is speciﬁed, preprocessed source code is sent to the standard output ﬁle. When -WH is

used, the standard output ﬁle contains a line indicating which ﬁle is currently being operated

upon.

Standard Error File

The standard error ﬁle contains diagnostic and informational messages from c89 and the compi-

lation components it calls. If more than one source ﬁle operand is speciﬁed, then for each such

ﬁle the format "%s: \n",ﬁle is used to print the name of the source ﬁle before it is processed.

Standard Libraries

The c89 utility recognizes the following -l operands for standard libraries.

-l c Contains all library functions provided by HP that are speciﬁed in the XPG4 Version 2

(X/Open UNIX) speciﬁcation, including those functions listed as residing in the

math.h header ﬁle.

-l C Contains the correct C++ run-time libraries, based on the value of the -Wversionn ﬂag.

If the -Wversionn ﬂag is omitted, the default version C++ library is used.

When you specify the -Wcplusplus and -Wversionn ﬂags, you need not specify -l C;

all needed libraries are automatically linked. For TNS/R programs, this includes the

cppinit[n].o and main function (_MAIN). When you specify the -Wversion2 ﬂag,

cppinit.o is linked for a nonPIC program or cppinit2.o is linked for a PIC program.

When you specify the -Wversion3 ﬂag, cppinit3.o is linked for a nonPIC program or

cppinit4.o is linked for a PIC program.

527188-004 Hewlett-Packard Company 2−23