1 CC
Online Help for VSI C Version 7.4
The CC command invokes the VSI C compiler to compile C source
programs. The syntax is:
CC file-spec,... +library-file-spec/LIBRARY...
2 Command_Parameters
file-spec,...
One or more VSI C source files separated by plus signs or
commas. If plus signs are used, the input files are
concatenated into a single object file. If commas are used,
each file is compiled separately to create separate object
files. If no input file extension is specified, VSI C assumes
the .C default file extension.
library-file-spec
A text library containing #include modules referenced in one or
more of the source files. A library file specification must be
concatenated with a file specification with a plus sign and
qualified using the /LIBRARY qualifier. If the input file
extension is not specified, VSI C assumes the .TLB default file
extension.
2 Qualifiers
Indicate special actions to be performed by the compiler or special
input file properties. Compiler qualifiers can apply to either the
CC command or to the specification of the file being compiled.
When a qualifier follows the CC command, it applies to all the
files listed. When a qualifier follows the file specification, it
applies only to the file immediately preceding it.
The following list shows all the qualifiers available with the CC
command:
o /ACCEPT(option[,...])
o /[NO]ANALYSIS_DATA[=file-spec]
o /[NO]ANNOTATIONS[=(option,...)]
o /[NO]ANSI_ALIAS
o /ARCHITECTURE=option
o /ASSUME=(option[,...])
o /[NO]CHECK[=(option[,...])]
o /COMMENTS={AS_IS | SPACE}
o /[NO]CROSS_REFERENCE
o /[NO]DEBUG[=(option[,...])]
o /DECC
o /[NO]DEFINE=(identifier[=definition][,...])
o /[NO]DIAGNOSTICS[=file-spec]
o /ENDIAN=option
o /ERROR_LIMIT[=number]
o /EXTERN_MODEL=option
o /[NO]FIRST_INCLUDE=(file[,...])
o /FLOAT=option
o /GRANULARITY
o /IEEE_MODE=option
o /[NO]INCLUDE_DIRECTORY=(pathname[,...])
o /L_DOUBLE_SIZE=option
o /LIBRARY
o /[NO]LINE_DIRECTIVES
o /[NO]LIST[=file-spec]
o /[NO]MACHINE_CODE
o /[NO]MEMBER_ALIGNMENT
o /[NO]MMS_DEPENDENCIES[=(option[,option])]
o /NAMES=(option1,option2)
o /NESTED_INCLUDE_DIRECTORY[=option]
o /[NO]OBJECT[=file-spec]
o /[NO]OPTIMIZE[=option]
o /PDSC_MASK=option
o /[NO]PLUS_LIST_OPTIMIZE
o /[NO]POINTER_SIZE=option
o /PRECISION={SINGLE | DOUBLE}
o /[NO]PREFIX_LIBRARY_ENTRIES
o /[NO]PREPROCESS_ONLY[=filename]
o /[NO]PROTOTYPE[=(option[,...])]
o /PSECT_MODEL=[NO]MULTILANGUAGE
o /REENTRANCY=option
o /REPOSITORY=option
o /ROUNDING_MODE=option
o /[NO]SHARE_GLOBALS
o /SHOW[=(option[,...])]
o /[NO]STANDARD=(option)
o /[NO]TIE
o /[NO]UNDEFINE=(identifier[,...])
o /[NO]UNSIGNED_CHAR
o /[NO]VERSION
o /[NO]WARNINGS[=(option[,...])]
2 /ACCEPT
/ACCEPT=(option[,option])
Allows the compiler to accept C language syntax that it might not
normally accept.
VSI C accepts slightly different syntax depending upon the
compilation mode specified with the /STANDARD qualifier. The
/ACCEPT qualifier can fine tune the language syntax accepted by
each /STANDARD mode.
Specify one of the following qualifier options:
[NO]C99_KEYWORDS Controls whether or not the C99 Standard
keywords inline and restrict (which are are
in the C89 namespace for user identifiers)
are accepted without double leading
underscores. The spelling with two leading
underscores (__inline, __restrict) is in the
namespace reserved to the compiler
implementation and is always recognized as a
keyword regardless of this option.
In /STANDARD=RELAXED mode, the default is
C99_KEYWORDS. In all other compiler modes,
the default is NOC99_KEYWORDS.
[NO]GCCINLINE The gcc compiler implements an inline
function qualifier for functions with
external linkage that gives similar
capabilites as the C9x extern inline feature
for functions, but the usage details are
somewhat different: the combination of
extern and inline keywords makes an inline
definition, instead of the exlusive use of
the inline keyword without the extern
keyword. This option controls which
variation of the feature is implemented.
In all compiler modes, the default is
NOGCCINLINE.
[NO]TRIGRAPHS Turns trigraph support on or off. In
COMMON and VAXC compiler modes, trigraphs
are disabled by default. In all other
modes, they are enabled by default.
[NO]VAXC_KEYWORDS Controls whether or not the compiler
recognizes the VAX C keywords (such as
"readonly") regardless of the /STANDARD mode
used.
[NO]RESTRICT_KEYWORD Controls whether or not the compiler
recognizes the C9x standard restrict keyword
regardless of the /STANDARD mode used.
This only affects recognition of the
spelling of the keyword as proposed for
inclusion in the C9x standard. The spelling
with two leading underscores, __restrict, is
in the namespace reserved to the compiler
implementation, and it is always recognized
as a keyword regardless of this option.
Note that [NO]RESTRICT_KEYWORD is a subset
of [NO]C99_KEYWORDS. They have the same
compiler-mode defaults.
The default values are based upon the settings of the /STANDARD
qualifier:
For /STANDARD=RELAXED the default is:
/ACCEPT=(VAXC_KEYWORDS,C99_KEYWORDS,NOGCCINLINE,TRIGRAPHS)
For /STANDARD=VAXC, the default is:
/ACCEPT=(VAXC_KEYWORDS,NOC99_KEYWORDS,NOGCCINLINE,NOTRIGRAPHS)
For /STANDARD=COMMON, the default is:
/ACCEPT=(NOVAXC_KEYWORDS,NOC99_KEYWORDS,NOGCCINLINE,NOTRIGRAPHS)
For /STANDARD=C99 or /STANDARD=LATEST, the default is:
/ACCEPT=(NOVAXC_KEYWORDS,C99_KEYWORDS,NOGCCINLINE,TRIGRAPHS)
In all other modes, the default is:
/ACCEPT=(NOVAXC_KEYWORDS,NOC99_KEYWORDS,NOGCCINLINE,TRIGRAPHS)
2 /ANALYSIS_DATA
/ANALYSIS_DATA[=file-spec]
/NOANALYSIS_DATA (D)
Controls whether the compiler generates a file of source code
analysis information. The default file name is the file name of
the primary source file; the default file type is .ANA.
2 /ANNOTATIONS
/ANNOTATIONS[=(option,...)]
/NOANNOTATIONS (D)
Controls whether or not the source listing file is annotated with
indications of specific optimizations performed or, in some cases,
not performed. These annotations can be helpful in understanding
the optimization process.
Select one or more of the following /ANNOTATIONS qualifier options:
ALL
Selects all annotations. This output can be quite verbose
because it includes detailed output for all annotations. For
more concise output for each kind of annotation, use
/ANNOTATIONS=(ALL,NODETAIL), or just /ANNOTATIONS with no
qualifier options.
[NO]CODE
Annotates the machine-code listing with descriptions of
special instructions used for prefetching, alignment, and so
on. The /MACHINE_CODE qualifier must also be specified for
/ANNOTATION=CODE to have any visible effect.
[NO]DETAIL
Provides additional level of annotation detail, where
available.
[NO]FEEDBACK
Indicates use of profile-directed feedback optimizations.
Feedback optimizations are not implemented on OpenVMS
systems, so this keyword has no visible effect.
[NO]INLINING
Indicates where code for a called procedure was expanded
inline.
[NO]LOOP_TRANSFORMS
Indicates optimizations such as loop reordering and code
hoisting.
[NO]LOOP_UNROLLING
Indicates where advanced loop nest optimizations have been
applied to improve cache performance (unroll and jam, loop
fusion, loop interchange, and so on).
[NO]PREFETCHING
Indicates where special instructions were used to reduce
memory latency.
[NO]SHRINKWRAPPING
Indicates removal of code establishing routine context when
it is not needed.
[NO]SOFTWARE_PIPELINING
Indicates where loops have been scheduled to hide functional
unit latency.
[NO]TAIL_CALLS
Indicates an optimization where a call from routine A to B
can be replaced by a jump.
[NO]TAIL_RECURSION
Indicates an optimization that eliminates unnecessary routine
context for a recursive call.
NONE
Same as /NOANNOTATIONS.
The default is /NOANNOTATIONS.
Specifying /ANNOTATIONS with no keywords is the same as specifying
/ANNOTATIONS=(ALL,NODETAIL).
2 /ANSI_ALIAS
/ANSI_ALIAS
/NOANSI_ALIAS (D)
Directs the compiler to assume the ANSI C aliasing rules, thus
giving it the freedom to generate better optimized code.
The aliasing rules are explained in Section 3.3, paragraphs 20 and
25 of the ANSI C Standard.
The default is /NOANSI_ALIAS for the /STANDARD=VAXC and
/STANDARD=COMMON compiler modes. The default is /ANSI_ALIAS for
all other modes.
2 /ARCHITECTURE
/ARCHITECTURE=options
/ARCHITECTURE=GENERIC (D)
Determines the Intel processor instruction set to be used by the
compiler. The /ARCHITECTURE qualifier uses the same keyword options
(keywords) as the /OPTIMIZE=TUNE qualifier.
Where the /OPTIMIZE=TUNE qualifier is primarily used by certain
higher-level optimizations for instruction scheduling purposes,
the /ARCHITECTURE qualifier determines the type of code instructions
generated for the program unit being compiled.
OpenVMS Version 7.1 and subsequent releases provide an operating
system kernel that includes an instruction emulator. This emulator
allows new instructions, not implemented on the host processor chip,
to execute and produce correct results. Applications using emulated
instructions will run correctly, but may incur significant software
emulation overhead at runtime.
The following /ARCHITECTURE option is supported:
ITANIUM2 Generates code for the Intel Itanium 2 processor.
2 /ASSUME
/ASSUME=(option[,...])
Controls compiler assumptions. You may select the following
options:
[NO]ACCURACY_SENSITIVE
Specifies whether certain code transformations that affect
floating-point operations are allowed. These changes may or
may not affect the accuracy of the program's results.
If you specify NOACCURACY_SENSITIVE, the compiler is free to
reorder floating-point operations, based on algebraic
identities (inverses, associativity, and distribution). This
allows the compiler to move divide operations outside of
loops, improving performance.
The default, ACCURACY_SENSITIVE, directs the compiler to use
only certain scalar rules for calculations. This setting can
prevent some optimization.
[NO]ALIGNED_OBJECTS
Controls an optimization for dereferencing pointers.
On OpenVMS Alpha systems, dereferencing a pointer to a
longword- or quadword-aligned object is more efficient than
dereferencing a pointer to a byte- or word-aligned object.
Therefore, the compiler can generate more optimized code if
it makes the assumption that a pointer object of an aligned
pointer type does point to an aligned object.
Since the compiler determines the alignment of the
dereferenced object from the type of the pointer, and the
program is allowed to compute a pointer that references an
unaligned object (even though the pointer type indicates that
it references an aligned object), the compiler must assume
that the dereferenced object's alignment matches or exceeds
the alignment indicated by the pointer type.
The default, /ASSUME=ALIGNED_OBJECTS, allows the compiler to
make such an assumption. With this assumption made, the
compiler can generate more efficient code for pointer
dereferences of aligned pointer types.
To prevent the compiler from assuming the pointer type's
alignment for objects that it points to, use the
/ASSUME=NOALIGNED_OBJECTS qualifier.
[NO]CLEAN_PARAMETERS
Controls compiler assumptions about short-integer formal
parameters.
The Alpha Calling Standard requires integers less than 64
bits long that are passed by value to have their upper bits
either zeroed or sign-extended to make full 64-bit values.
These are referred to as clean parameters. Some old code
does not follow this convention. This can cause problems if
the called program assumes that the caller followed the
Calling Standard by passing only clean parameters.
Specifying /ASSUME=NOCLEAN_PARAMETERS allows a program to be
called by old code that might pass unclean integer
parameters. It directs the compiler to generate run-time
code to clean the short integers so they comply with the
Calling Standard.
The default is /ASSUME=CLEAN_PARAMETERS.
[NO]EXACT_CDD_OFFSETS
Controls the alignment of Control Data Dictionary records.
If /ASSUME=EXACT_CDD_OFFSETS is specified, the records input
from the CDD are given the exact alignment (relative to the
start of the record) specified by the CDD definition. This
alignment is independent of the current compiler
member-alignment setting.
If /ASSUME=NOEXACT_CDD_OFFSETS is specified, the compiler may
modify the offsets specified in a CDD record according to the
current member-alignment setting.
The default is /ASSUME=NOEXACT_CDD_OFFSETS.
[NO]HEADER_TYPE_DEFAULT
Specifies whether the default file-type mechanism (.h) for
header files is enabled (HEADER_TYPE_DEFAULT) or disabled
(NOHEADER_TYPE_DEFAULT).
The default is /ASSUME=HEADER_TYPE_DEFAULT.
[NO]MATH_ERRNO
Controls whether or not intrinsic code is generated for math
functions that set the errno variable.
The default is /ASSUME=MATH_ERRNO, which does not allow
intrinsic code for such math functions to be generated, even
if /OPTIMIZE=INTRINSICS is in effect. Their prototypes and
call formats, however, are still checked.
[NO]POINTERS_TO_GLOBALS
Controls whether or not the compiler can safely assume that
global variables have not had their addresses taken in code
that is not visible to the current compilation.
The default, /ASSUME=POINTERS_TO_GLOBALS, assumes that global
variables have had their addresses taken in separately
compiled modules and that, in general, any pointer
dereference could be accessing the same memory as any global
variable. This is often a significant barrier to
optimization.
The /ANSI_ALIAS qualifier allows some resolution based on
data type, but /ASSUME=NOPOINTER_TO_GLOBALS provides
significant additional resolution and improved optimization
in many cases.
[NO]WEAK_VOLATILE
Affects the generation of code for assignments to objects
that are less than or equal to 16 bits in size (for example:
char, short) that have been declared as volatile.
Specifying /ASSUME=WEAK_VOLATILE directs the compiler to
generate code for volatile assignments to single bytes or
words without using the load-locked store-conditional
sequences that, in general, are required to assure volatile
data integrity when direct byte or word memory-access
instructions are not being used.
This option is intended for use in special I/O hardware
access situations, and should not generally be used.
The default is /ASSUME=NOWEAK_VOLATILE, which uses
interlocked instructions for sub-longword volatile accesses
when byte or word instructions are not enabled.
[NO]WHOLE_PROGRAM
Asserts to the compiler that except for "well-behaved library
routines," the whole program consists only of the single
object module being produced by this compilation. The
optimizations enabled by /ASSUME=WHOLE_PROGRAM include all
those enabled by /ASSUME=NOPOINTER_TO_GLOBALS, and possibly
additional optimizations as well.
The default is /ASSUME=NOWHOLE_PROGRAM.
[NO]WRITABLE_STRING_LITERALS
Stores string constants in a writable psect. Otherwise, such
constants will be placed in non-writable psect.
For /STANDARD=VAXC or /STANDARD=COMMON, the default is
/ASSUME=WRITABLE_STRING_LITERALS. For all other compiler
modes, the default is /ASSUME=NOWRITABLE_STRING_LITERALS.
2 /CHECK
/CHECK[=ALL|NONE|([NO]UNINITIALIZED_VARIABLES, [NO]BOUNDS,
[NO]POINTER_SIZE[=(option,...)], [NO]FP_MODE, [NO]ARG_INFO)]
/NOCHECK (D)
This qualifier is for use only as a debugging aid. It should not be used
to build production code without carefully assessing its performance impact
on the application in question for each platform on which the application
runs. For example, the I64-only FP_MODE check can add significant overhead
to every function in the compilation, even if the application uses little
or no floating point.
/CHECK=NONE is equivalent to /NOCHECK.
/CHECK=ALL is equivalent to
/CHECK=(UNINITIALIZED_VARIABLES,BOUNDS,POINTER_SIZE=ALL,FP_MODE,ARG_INFO).
/CHECK=UNINITIALIZED_VARIABLES initializes all automatic variables to the
value 0x7ff580057ff58005. This value is a double signaling NaN and, if
used as a floating-point value in certain double operations, causes a
floating-point trap if traps are enabled. Traps are not enabled if the
program is compiled /FLOAT=IEEE and the /IEEE value is something other than
FAST.
On I64 systems:
o Traps are not caused when values are converted to an integer type.
o The float type does not trap.
/CHECK=BOUNDS enables run-time checking of array bounds. Array-bounds
processing is performed in the following way:
o Checks are done only when accessing an array.
o Checks are not done when accessing a pointer, even if that access is
done using the subscript operator. This means that checks are not done
on arrays declared as formal parameters because they are considered
pointers in the C language. If a formal parameter is a multi-dimension
array, all bounds except the first are checked.
o If an array is accessed using the subscript operator (as either the
left or right operand), and the subscript operator is not the operand
of an address-of operator, the check is for the index to be between 0
and the number of array elements minus one, inclusive.
o If an array is accessed using the subscript operator (as either the
left or right operand), and the subscript operator is the operand of
the address-of operator, the check is for the index to be between 0 and
the number of elements in the array, inclusive.
The reason for treating the address-of case differently is that it is
common programming practice to have a loop such as:
int a[10];
int *b;
for (b = a ; b < &a[10] ; b++) { .... }
In this case, access to &a[10] is allowed even though it is outside the
range of the array.
o If the array is being accessed using pointer addition, the check is for
the value being added to be between 0 and the number of elements in the
array, inclusive.
o If the array is being accessed using pointer subtraction (that is, the
subraction of an integer value from a pointer, not the subtraction of
one pointer from another), the check is for the value being subtracted
to be between the negation of the number of elements in the array and
0, inclusive.
o In the previous three cases, an optional compile-time message (ident
SUBSCRBOUNDS2) can be enabled to detect the case where an array has
been accessed using either a constant subscript or constant pointer
arithmetic, and the element accessed is exactly one past the end of the
array.
o Bounds checking is not done for arrays declared with one element.
(Because ANSI C does not allow arrays without dimensions inside
structs, it is common practice to declare such arrays with a bounds
specifier of 1.)
In this case, an optional compile-time message (ident SUBSCRBOUNDS1)
can be enabled to detect the case where an array declared with a single
element is accessed using either a constant subscript or constant
pointer arithmetic, and the element accessed is not part of the array.
o VSI C emits run-time checks for arrays indexed by constants, even
though the compiler can and does detect this situation at compile-time.
An exeption is that no run-time check is made if the compiler can
determine that the access is valid.
o If a multi-dimension array is accessed, the compiler performs checks on
each of the subscript expressions, making sure each is within the
corresponding bound. So for the following code, the compiler checks
that both x and y are between 0 and 9. It does not check that 10 * x +
y is between 0 and 99:
int a[10][10];
int x,y,z;
x = a[x][y];
/CHECK=POINTER_SIZE directs the compiler to check 32-bit pointer values to
make sure they will fit in a 32-bit pointer. If such a value cannot be
represented by a 32-bit pointer, the run-time code signals a range error
(SS$_RANGEERR).
Use one or more of the following POINTER_SIZE option keywords to determine
the pointer-size checks you want made:
[NO]ASSIGNMENT Check whenever a 64-bit pointer is assigned to a
32-bit pointer (including use as an actual argument).
[NO]CAST Check whenever a 64-bit pointer is cast to a 32-bit
pointer.
[NO]INTEGER_CAST Check whenever a long pointer is cast to a 32-bit
integer.
[NO]PARAMETER Check all formal parameters at function startup to
make sure that all formal parameters declared to be
32-bit pointers are 32-bit values.
ALL Do all checks.
NONE Do no checks.
/CHECK=FP_MODE generates code in the prologue of every function defined in
the compilation to compare the current values of certain fields in the
processor's floating-point status register (FPSR) with the values expected
in those fields based on the command-line qualifiers with which the
function was compiled.
The values checked are the rounding mode and the trap-enable bits:
o If the rounding mode is not consistent with the value of the
/ROUNDING_MODE qualifier specified at compile time, an informational
message SYSTEM-I-FPMODERC is issued at runtime, citing the current mode
and the compile-time specified mode (Note that /ROUNDING_MODE=DYNAMIC
is treated the same as /ROUNDING_MODE=NEAREST for this purpose).
o If the trap-enable flags are not consistent with the setting of the
/IEEE qualifier (for /FLOAT=IEEE_FLOAT compilations) or with the
setting used to implement VAX floating types (for /FLOAT=G_FLOAT or
/FLOAT=D_FLOAT compilations), an informational message
SYSTEM-I-FPMODECTL is issued at run time, citing the current
trap-enable flags as well as the trap-enable flags expected by the
compilation. To identify the point of failure, you need to rerun the
program under DEBUG and issue "SET BREAK/EXCEPTION".
Note that the checking code generated for /CHECK=FP_MODE includes a
standard call to OTS$CHECK_FP_MODE within the prologue of each function,
and OTS$CHECK_FP_MODE itself assumes the standard calling conventions
(described in the OpenVMS Calling Standard). Because of this, it is not
possible to use this checking option when compiling function definitions
that have a nonstandard linkage (see #pragma linkage and #pragma
use_linkage) specifying conventional scratch registers with the PRESERVED
or NOTUSED attribute. Doing so will cause the compiler to issue the
"REGCONFLICT" E-level diagnostic at the opening brace of such function
definitions. To compile such functions successfully, the FP_MODE keyword
must be removed from the list of /CHECK= keywords.
/CHECK=ARG_INFO generates code to verify the input parameters to functions
defined in the compiled source. This code checks for datatype consistency
between the caller and its called function.
When the runtime does parameter-type checking, it categorizes the actual
type information into one of six possibilities:
VAX single-precision floating-point
VAX double-precision floating-point - D_floating
VAX double-precision floating-point - G_floating
IEEE single-precision floating-point
IEEE double-precision floating-point
none-of-the-above "bucket"
It is only a mismatch of these types that is considered. So while the
run-time code will catch a case of a VAX D_floating number passed to a
function that expects a VAX single-precision number, it will not detect the
case of an int passed to a function that expects a long double type
(because both int and long double are viewed as the same type; that is,
they both fall into the none-of-the-above bucket).
When a mismatch is found, a %SYSTEM-I-ARGTYP1 is output at runtime for each
argument slot whose type does not match the expected type.
This checking applies only to arguments passed in the first eight argument
slots, and will not check that the number of arguments passed matches the
number expected.
If the /CHECK qualifier is omitted, the default is /NOCHECK, which equates
to /CHECK=(NOUNINITIALIZED_VARIABLE, NOBOUNDS, NOPOINTER_SIZE, NOFP_MODE,
NOARGINFO).
If you specify /CHECK, the default is /CHECK=(UNINITIALIZED_VARIABLES,
BOUNDS, POINTER_SIZE=(ASSIGNMENT,PARAMETER), FP_MODE, ARG_INFO).
2 /COMMENTS
/COMMENTS={AS_IS | SPACE}
/COMMENTS=SPACE (D) (ANSI89, RELAXED, and MIA compiler modes)
/NOCOMMENTS (D) (all other compiler modes)
Governs whether or not comments appear in preprocess output files
and, if they are to appear, whether they appear themselves or are
replaced by a single space. Specify one of the following qualifier
options:
AS_IS Specifies that the comment appears in the output file.
SPACE Specifies that a single space replaces the comment in
the output file.
NOCOMMENTS specifies that nothing replaces the comment in the output
file. This can result in inadvertent token pasting.
The VSI C preprocessor might replace a comment at the end of a line
or on a line by itself with nothing, even if /COMMENTS=SPACE is
specified. Doing so does not change the meaning of the program.
The default is /COMMENTS=SPACE for the ANSI89, RELAXED, and MIA
compiler modes. The default is /NOCOMMENTS for all other compiler
modes.
Specifying just /COMMENTS defaults to /COMMENTS=AS_IS.
2 /CROSS_REFERENCE
/NOCROSS_REFERENCE (D)
Specifies whether the compiler generates cross-references. If you
specify /CROSS_REFERENCE, the compiler lists, for each variable
referenced in the procedure, the line numbers of the lines on which
the variable is referenced. You must use the /CROSS_REFERENCE
qualifier with either the /SHOW=SYMBOLS or the /SHOW=BRIEF
qualifiers. To obtain any type of listing, you must specify /LIST.
2 /DEBUG
/DEBUG[=(option[,...])]
/DEBUG=(TRACEBACK,NOSYMBOLS) (D)
/NODEBUG
Includes information in the object module for use by the OpenVMS
Debugger. You can select the following options:
ALL Includes all possible debugging information.
On Alpha systems, /DEBUG=ALL is equivalent to
/DEBUG=(TRACEBACK,SYMBOLS).
On VAX systems, /DEBUG=ALL is equivalent to
/DEBUG=(TRACEBACK,SYMBOLS,INLINE).
NONE Excludes any debugging information.
NOSYMBOLS Suppresses generation of symbol table records.
SYMBOLS Generates symbol table records.
NOTRACEBACK Suppresses generation of traceback records.
TRACEBACK Generates traceback records.
Specifying /DEBUG with no options is equivalent to specifying
/DEBUG=ALL.
If the /DEBUG qualifier is not specified, the default is
/DEBUG=(TRACEBACK,NOSYMBOLS).
2 /DECC
The /DECC qualifier is provided for compatibility with HP C on
OpenVMS VAX systems. On OpenVMS Alpha systems, CC and CC/DECC are
always equivalent.
2 /DEFINE
/DEFINE=(identifier[=definition][,...])
/NODEFINE (D)
Performs the same function as the #define preprocessor directive.
That is, /DEFINE defines a token string or macro to be substituted
for every occurrence of a given identifier in the program.
DCL converts all input to uppercase unless it is enclosed in
quotation marks.
The simplest form of a /DEFINE definition is:
/DEFINE=true
This results in a definition like the one that would result from
the following definition:
#define TRUE 1
Macro definitions must be enclosed in quotation marks as shown in
the following definition:
/DEFINE="funct(a)=a+sin(a)"
This definition produces the same results as the following
definition:
#define funct(a) a+sin(a)
When more than one /DEFINE is present on the CC command line or in
a single compilation unit, only the last /DEFINE is used.
When both /DEFINE and /UNDEFINE are present in a command line,
/DEFINE is evaluated before /UNDEFINE.
The default is /NODEFINE.
2 /DIAGNOSTICS
/DIAGNOSTICS[=file-spec]
/NODIAGNOSTICS (D)
Creates a file containing compiler diagnostic messages. The
default file extension for a diagnostics file is .DIA. The
diagnostics file is used with the DEC Language-Sensitive Editor
(LSE). To display a diagnostics file, enter the command
REVIEW/FILE=file-spec while in LSE.
2 /ENDIAN
/ENDIAN={BIG | LITTLE}
/ENDIAN=LITTLE (D)
Controls whether big or little endian ordering of bytes is carried
out in character constants.
2 /ERROR_LIMIT
/ERROR_LIMIT[=number]
/NOERROR_LIMIT
Limits the number of Error-level diagnostic messages that are
acceptable during program compilation. Compilation terminates when
the limit (number) is exceeded. /NOERROR_LIMIT specifies that
there is no limit on error messages.
The default is /ERROR_LIMIT=30, which specifies that compilation
terminates after 31 error messages.
2 /EXTERN_MODEL
/EXTERN_MODEL=option
/EXTERN_MODEL=RELAXED_REFDEF (D)
In conjunction with the /SHARE_GLOBALS qualifier, controls the
initial extern model of the compiler. Conceptually, the compiler
behaves as if the first line of the program being compiled was a
#pragma extern_model directive with the model and psect name, if
any, specified by the /EXTERN_MODEL qualifier and with the shr or
noshr keyword specified by the /SHARE_GLOBALS qualifier.
For example, assume the command line contains the following
qualifier:
/EXTERN_MODEL=STRICT_REFDEF="MYDATA"/NOSHARE
The compiler will act as if the program began with the following
line:
#pragma extern_model strict_refdef "MYDATA" noshr
See also #pragma extern_model.
The /EXTERN_MODEL qualifier takes the following options, which have
the same meaning as for the #pragma extern_model directive:
COMMON_BLOCK
RELAXED_REFDEF
STRICT_REFDEF
STRICT_REFDEF="NAME"
GLOBALVALUE
The default model on VSI C is relaxed/refdef with the noshare
attribute. This is different from the model used by VAX C, which
is common block, share.
2 /FIRST_INCLUDE
FIRST_INCLUDE=(file[,...])
NOFIRST_INCLUDE (D)
Includes the specified files before any source files. This
qualifier corresponds to the Tru64 UNIX -FI switch.
This qualifier is useful if you have command lines to pass to the C
compiler that are exceeding the DCL command-line length limit.
Using the /FIRST_INCLUDE qualifier can help solve this problem by
replacing lengthy /DEFINE and /WARNINGS qualifiers with #define and
#pragma message directives placed in a /FIRST_INCLUDE file.
The default is NOFIRST_INCLUDE.
2 /FLOAT
/FLOAT=option
Controls the format of floating-point variables.
Options:
D_FLOAT Double variables are represented in D_FLOAT
format. The __D_FLOAT macro is predefined.
G_FLOAT Double variables are represented in G_FLOAT
format. The __G_FLOAT macro is predefined.
IEEE_FLOAT Float and double variables are represented in IEEE
floating-point format (S_FLOAT and T_FLOAT,
respectively). The __IEEE_FLOAT macro or _IEEE_FP
macro (if/IEEE_MODE=DENORM_RESULTS) is predefined.
See also the /IEEE_MODE qualifier for selecting an
IEEE floating-point mode.
If /IEEE_MODE is not specified, the default
behavior is /IEEE_MODE=FAST for Alpha systems and
DENORM_RESULTS for I64 systems.
On OpenVMS I64 systems, /FLOAT=IEEE_FLOAT is the default
floating-point representation. The _IEEE_FP macro is predefined by
default, IEEE format data is assumed, and IEEE floating-point
instructions are used. There is no hardware support for
floating-point representations other than IEEE, although you can
specify the /FLOAT=D_FLOAT or /FLOAT=G_FLOAT compiler option.
These VAX floating-point formats are supported in the I64 compiler
by generating run-time code that converts VAX floating-point
formats to IEEE format to perform arithmetic operations, and then
converts the IEEE result back to the appropriate VAX floating-point
format. This imposes additional run-time overhead and some loss of
accuracy compared to performing the operations in hardware on Alpha
and VAX systems. The software support for the VAX formats is
provided to meet an important functional compatibility requirement
for certain applications that need to deal with on-disk binary
floating-point data.
On I64 systems, the default for /IEEE_MODE is DENORM_RESULTS. This
is a change from the default of /IEEE_MODE=FAST on Alpha systems.
This means that by default, floating-point operations may silently
generate values that print as Infinity or Nan (the
industry-standard behavior), instead of issuing a fatal run-time
error as they would when using VAX floating-point format or
/IEEE_MODE=FAST. Also, the smallest-magnitude nonzero value in
this mode is much smaller because results are allowed to enter the
denormal range instead of being flushed to zero as soon as the
value is too small to represent with normalization.
The conversion of VAX floating-point formats to IEEE single and
IEEE double floating-point types on the Intel Itanium architecture
is a transparent process that will not impact most applications.
All you need to do is recompile your application. Because IEEE
floating-point format is the default, unless your build explicitly
specifies VAX floating-point format options, a simple rebuild for
I64 systems will use the native IEEE formats directly. For the
large class of programs that do not directly depend on the VAX
formats for correct operation, this is the most desirable way to
build for I64 systems.
When you compile an OpenVMS application that specifies an option to
use VAX floating-point on the Itanium architecture, the compiler
automatically generates code for converting floating-point formats.
Whenever the application performs a sequence of arithmetic
operations, this code does the following:
o Converts VAX floating-point formats to either IEEE single or
IEEE double floating-point formats.
o Performs arithmetic operations in IEEE floating-point
arithmetic.
o Converts the resulting data from IEEE formats back to VAX
formats.
Where no arithmetic operations are performed (VAX float fetches
followed by stores), no conversion will occur. The code handles
such situations as moves.
VAX floating-point formats have the same number of bits and
precision as their equivalent IEEE floating-point formats. For
most applications the conversion process will be transparent and
thus a non-issue.
In a few cases, arithmetic calculations might have different
results because of the following differences between VAX and IEEE
formats:
o Values of numbers represented
o Rounding rules
o Exception behavior
These differences might cause problems for applications that do any
of the following:
o Depend on exception behavior
o Measure the limits of floating-point behaviors
o Implement algorithms at maximal processor-specific accuracy
o Perform low-level emulations of other floating-point processors
o Use direct equality comparisons between floating-point values,
instead of appropriately ranged comparisons (a practice that is
extremely vulnerable to changes in compiler version or compiler
options, as well as architecture)
You can test an application's behavior with IEEE floating-point
values by compiling it on an OpenVMS Alpha system using
/FLOAT=IEEE_FLOAT/IEEE_MODE=DENORM. If that produces acceptable
results, simply build the application on the I64 system using the
same qualifier.
If you determine that simply recompiling with an /IEEE_MODE
qualifier is not sufficient because your application depends on the
binary representation of floating-point values, then first try
building for your I64 system by specifying the VAX floating-point
option that was in effect for your VAX or Alpha build. This causes
the representation seen by your code and on disk to remain
unchanged, with some additional runtime cost for the conversions
generated by the compiler. If this is not an efficient approach
for your application, you can convert VAX floating-point binary
data in disk files to IEEE floating-point formats before moving the
application to an I64 system.
2 /GRANULARITY
/GRANULARITY=option
/GRANULARITY=QUADWORD (D)
Determines how much memory to effectively cache for memory
reference by the combination of the compiler and the underlying
system. For example, quadword granularity may require that the
system cache quadword values in registers. If access to data in
the same granularity unit occurs simultaneously, corruption (by
storing back stale values) can occur.
Granularity has two aspects: references inside a particular data
segment and references between data segments.
The options are:
o BYTE
o LONGWORD
o QUADWORD
The default is /GRANULARITY=QUADWORD.
2 /IEEE_MODE
/IEEE_MODE=option
/IEEE_MODE=DENORM_RESULTS (D)
Selects the IEEE floating-point mode to be used.
Options:
FAST During program execution, only finite values (no
infinities, NaNs, or denorms) are created.
Exceptional conditions, such as floating point
overflow and divide by zero, are fatal.
UNDERFLOW_TO_ZERO Generate infinities and NaNs. Flush
denormalized results and underflow to zero
without exceptions.
DENORM_RESULTS Same as UNDERFLOW_TO_ZERO, except that denorms
are generated. This is the default for I64
systems.
INEXACT Same as DENORM_RESULTS, except that inexact
values are trapped. This is the slowest mode.
On Alpha sytems, the /IEEE_MODE qualifier generally has its
greatest effect on the generated code of a compilation. When calls
are made between functions compiled with different /IEEE_MODE
qualifiers, each function produces the /IEEE_MODE behavior with
which it was compiled.
On I64 systems, the /IEEE_MODE qualifier primarily affects only the
setting of a hardware register at program startup. In general, the
/IEEE_MODE behavior for a given function is controlled by the
/IEEE_MODE option specified on the compilation that produced the
main program: the startup code for the main program sets the
hardware register according the command-line qualifiers used to
compile the main program.
When applied to a compilation that does not contain a main program,
the /IEEE_MODE qualifier does have some effect: it might affect
the evaluation of floating-point constant expressions, and it is
used to set the EXCEPTION_MODE used by the math library for calls
from that compilation. But the qualifier has no effect on the
exceptional behavior of floating-point calculations generated as
inline code for that compilation. Therefore, if floating-point
exceptional behavior is important to an application, all of its
compilations, including the one containing the main program, should
be compiled with the same /IEEE_MODE setting.
Even on Alpha systems, the particular setting of
/IEEE_MODE=UNDERFLOW_TO_ZERO has this characteristic: its primary
effect requires the setting of a runtime status register, and so it
needs to be specified on the compilation containing the main
program in order to be effective in other compilations.
2 /INCLUDE_DIRECTORY
/INCLUDE_DIRECTORY=(place[,...])
/NOINCLUDE_DIRECTORY (D)
Provides similar functionality to the -I option of the cc command
on DIGITAL UNIX systems. This qualifier allows you to specify
additional places to search for include files. A place can be one
of the following:
o OpenVMS file-spec to be used as a default file-spec to RMS file
services (example: DISK$:[directory])
o UNIX style pathname in quotation marks (example: "/sys")
o Empty string ("")
If one of the places is specified as an empty string, the compiler
is not to search any of its conventionally-named places
(DECC$USER_INCLUDE, DECC$SYSTEM_INCLUDE, DECC$LIBRARY_INCLUDE,
SYS$COMMON:[DECC$LIB.INCLUDE.*], DECC$TEXT_LIBRARY,
DECC$RTLDEF.TLB, SYS$STARLET_C.TLB). It searches only places
specified explicitly on the command line by the /INCLUDE_DIRECTORY
and /LIBRARY qualifiers (or by the location of the primary source
file, depending on the /NESTED_INCLUDE_DIRECTORY qualifier).
The basic search order depends on the form of the header-file name
(after macro expansion). Additional aspects of the search order
are controlled by other command-line qualifiers and the presence or
absence of logical name definitions.
All forms of header-file inclusion are affected:
o In quotes (example: "stdio.h")
o In angle brackets (example: <stdio.h>)
o An identifier to be treated as a text-module name (example:
stdio)
Except where otherwise specified, searching a "place" means that
the string designating the place is used as the default file-spec
in a call to an RMS system service (for example, $SEARCH/$PARSE),
with a file-spec consisting of the name in the #include directive
without enclosing delimiters. The search terminates successfully
as soon as a file can be opened for reading.
For the quoted form, the search order is:
1. One of the following:
o If /NESTED_INCLUDE_DIRECTORY=INCLUDE_FILE (the default) is
in effect, search the directory containing the file in
which the #include directive itself occurred. The meaning
of "directory containing" is: the RMS "resultant string"
obtained when the file in which the #include occurred was
opened, except that the filename and subsequent components
are replaced by the default file type for headers (".H", or
just "." if /ASSUME=NOHEADER_TYPE_DEFAULT is in effect).
The "resultant string" will not have translated any
concealed device logical.
o If /NESTED_INCLUDE_DIRECTORY=PRIMARY_FILE is in effect,
search the default file type for headers using the context
of the primary source file. This means that just the file
type (".H" or ".") is used for the default file-spec but,
in addition, the chain of "related file-specs" used to
maintain the sticky defaults for processing the next
top-level source file is applied when searching for the
include file.
o If /NESTED_INCLUDE_DIRECTORY=NONE is in effect, this entire
step (Step 1) is bypassed.
2. Search the places specified in the /INCLUDE_DIRECTORY
qualifier, if any. A place that can be parsed successfuly as
an OpenVMS file-spec and that does not contain an explicit file
type or version specification is edited to append the default
header file type specification (".H" or ".").
A place containing a "/" character is considered to be a
UNIX-style name. If the name in the #include directive also
contains a "/" character that is not the first character and is
not preceded by a "!" character (that is, it is not an absolute
UNIX-style pathname), then the name in the #include directive
is appended to the named place, separated by a "/" character,
before applying the decc$to_vms pathname translation function.
3. If "DECC$USER_INCLUDE" is defined as a logical name, search
"DECC$USER_INCLUDE:.H", or just "DECC$USER_INCLUDE:." if
/ASSUME=NOHEADER_TYPE_DEFAULT is in effect.
4. If the file is not found, follow the steps for the
angle-bracketed form of inclusion.
For the angle-bracketed form, the search order is:
1. Search the place "/". This is a UNIX-style name that can
combine only with UNIX names specified explicitly in the
#include directive. It causes a specification like
<sys/types.h> to be considered first as /sys/types.h, which is
translated to SYS:TYPES.H.
2. Search the places specified in the /INCLUDE_DIRECTORY
qualifier, exactly as in Step 2 for the quoted form of
inclusion.
3. If "DECC$SYSTEM_INCLUDE" is defined as a logical name, search
"DECC$SYSTEM_INCLUDE:.H", or just "DECC$SYSTEM_INCLUDE:." if
/ASSUME=NOHEADER_TYPE_DEFAULT is in effect.
4. If "DECC$LIBRARY_INCLUDE" is defined as a logical name and
"DECC$SYSTEM_INCLUDE" is NOT defined as a logical name, search
"DECC$LIBRARY_INCLUDE:.H", or just "DECC$LIBRARY_INCLUDE:." if
/ASSUME=NOHEADER_TYPE_DEFAULT is in effect.
5. If neither "DECC$LIBRARY_INCLUDE" nor "DECC$SYSTEM_INCLUDE" are
defined as logical names, then search the default list of
places for plain text-file copies of compiler header files as
follows:
SYS$COMMON:[DECC$LIB.INCLUDE.DECC$RTLDEF]*.H
SYS$COMMON:[DECC$LIB.INCLUDE.SYS$STARLET_C]*.H
If the file is not found, perform the text library search
described in the next step.
6. Extract the simple filename and file type from the #include
specification and use the filename as the module name to search
a list of text libraries associated with that file type.
For any file type, the initial text libraries searched consist
of those named on the command line with /LIBRARY qualifiers.
If the /INCLUDE_DIRECTORY qualifier contained an empty string,
no further text libraries are searched. Otherwise,
DECC$TEXT_LIBRARY is searched for all file types.
If "DECC$LIBRARY_INCLUDE" is defined as a logical name, then no
further text libraries are searched. Otherwise, the subsequent
libraries searched for each file type are:
For ".H" or ".":
SYS$LIBRARY:DECC$RTLDEF.TLB
SYS$LIBRARY:SYS$STARLET_C.TLB
For any file type other then ".H" or ".":
SYS$LIBRARY:SYS$STARLET_C.TLB
7. If the previous step fails, search:
SYS$LIBRARY:.H
Under /ASSUME=NOHEADER_TYPE_DEFAULT, the default file type is
modified as usual.
For the text-module (non-portable) form of #include:
The name can only be an identifier. It, therefore, has no
associated "file type". The identifier is used as a module name to
search the following:
1. The text libraries named on the command line with /LIBRARY
qualifiers, in left-to-right order.
2. The following list of text libraries in the order shown
(unless the /INCLUDE_DIRECTORY qualifier contains an empty
string, in which case no further text libraries are
searched):
DECC$TEXT_LIBRARY
SYS$LIBRARY:DECC$RTLDEF.TLB
SYS$LIBRARY:SYS$STARLET_C.TLB
2 /L_DOUBLE_SIZE
/L_DOUBLE_SIZE=option
/L_DOUBLE_SIZE=128 (D)
Determines how the compiler interprets the long double type. The
qualifier options are 64 and 128.
/L_DOUBLE_SIZE=64 treats all long double references as G_FLOAT,
D_FLOAT, or T_FLOAT, depending on the value of the /FLOAT
qualifier.
/L_DOUBLE_SIZE=128 treats all long double references as X_FLOAT.
2 /LIBRARY
Indicates that the associated input file is a library containing
source text modules specified in #include directives. The compiler
searches the specified library for all #include module names that
are not enclosed in angle brackets or quotation marks. The name of
the library must be concatenated with the file specification using
a plus sign. For example:
CC DATAB/LIBRARY+APPLIC
2 /LINE_DIRECTIVES
/LINE_DIRECTIVES (D)
/NOLINE_DIRECTIVES
Controls whether or not #line directives appear in preprocess
output files.
2 /LIST
/LIST[=file-spec] (Batch default)
/NOLIST (Interactive default)
Controls whether a listing file is produced. The default output
file extension is .LIS.
2 /MACHINE_CODE
/MACHINE_CODE
/NOMACHINE_CODE (D)
Controls whether the listing produced by the compiler includes the
machine language code generated during the compilation. If you use
this qualifier you also need to use the /LIST qualifier.
2 /MAIN=POSIX_EXIT
/MAIN
/NOMAIN (D)
Directs the compiler to call __posix_exit instead of exit when
returning from main.
2 /MEMBER_ALIGNMENT
/MEMBER_ALIGNMENT (D)
/NOMEMBER_ALIGNMENT
Directs the compiler to naturally align data structure members.
This means that data structure members are aligned on the next
boundary appropriate to the type of the member, rather than on the
next byte. For instance, a long variable member is aligned on the
next longword boundary; a short variable member is aligned on the
next word boundary.
Any use of the #pragma member_alignment or #pragma
nomember_alignment directives within the source code overrides the
setting established by this qualifier. Specifying
/NOMEMBER_ALIGNMENT causes data structure members to be
byte-aligned (with the exception of bit-field members).
For 64-bit systems, the default is /MEMBER_ALIGNMENT.
For OpenVMS VAX systems, the default is /NOMEMBER_ALIGNMENT.
2 /MMS_DEPENDENCIES
/MMS_DEPENDENCIES[=(option[,option)]]
/NOMMS_DEPENDENCIES (D)
Directs the compiler to produce a dependency file. Dependency
files list all source files and included files for each object
module. Note that the /OBJECT qualifier has no impact on the
dependency file. The dependency file format is:
object_file_name :<tab><source file name>
object_file_name :<tab><full path to first include file>
object_file_name :<tab><full path to second include file>
You can specify none, one, or all of the following qualifier
options:
FILE[=filespec] Specifies where to save the dependency
file. The default file extension for a
dependency file is .mms. Other than using
a different default extension, this
qualifier uses the same procedure that
/OBJECT and /LIST use for determining the
name of the output file.
SYSTEM_INCLUDE_FILES Specifies whether or not to include
dependency information about system include
files (that is, those included with
#include <filename>). The default is to
include dependency information about system
include files.
Note that the /OBJECT qualifier has no
impact on the dependency file.
TARGET=string Specifies the target that appears in the
output .mms file. The default is TARGET=""
in which case the target is the source file
name with an .OBJ extension, as in previous
versions of the compiler. If you specify
any string other than .OBJ, that string is
used as the target. For the special case
of .OBJ, the compiler uses the name of the
object file, stripped of any version number
and path, for the MMS target.
2 /NAMES
/NAMES=(option1,option2)
/NAMES=(UPPERCASE,TRUNCATED) (D)
Option1 converts all definitions and references of external symbols
and psects to the specified case:
o /NAMES=UPPERCASE (default) converts to uppercase.
o /NAMES=AS_IS leaves the case unchanged.
Option2 controls whether or not long external names greater than 31
characters get truncated or shortened:
o /NAMES=TRUNCATED (default) truncates long external names
o /NAMES=SHORTENED shortens long external names.
A shortened name consists of the first 23 characters of the
name followed by a 7-character Cyclic Redundancy Check (CRC)
computed by looking at the full name, and then a "$".
The CRC is generated by calling lib$crc as follows:
long initial_crc = -1;
crc_result = lib$crc(good_crc_table,
&initial_crc,
<descriptor of string to CRC>);
where good_crc_table is:
/*
** Default CRC table:
**
** This table was taken from Ada's generalized name generation
** algorithm. It represents a commonly used CRC polynomial
** known as AUTODIN-II. For more information see the VAX
** Macro OpenVMS documentation under the CRC VAX instruction.
*/
static const unsigned int good_crc_table[16] =
{0x00000000, 0x1DB71064, 0x3B6E20C8, 0x26D930AC,
0x76DC4190, 0x6B6B51F4, 0x4DB26158, 0x5005713C,
0xEDB88320, 0xF00F9344, 0xD6D6A3E8, 0xCB61B38C,
0x9B64C2B0, 0x86D3D2D4, 0xA00AE278, 0xBDBDF21C};
By default, the compiler issues a warning and truncates the name to
31 characters.
The /NAMES qualifier does not affect the names of the $ABS$, $BSS$,
$CODE$, $DATA$, $LINK$, $LITERAL$, and $READONLY$ psects.
2 /NESTED_INCLUDE_DIRECTORY
/NESTED_INCLUDE_DIRECTORY[=option]
/NESTED_INCLUDE_DIRECTORY=INCLUDE_FILE (D)
Controls the first step in the search algorithm the compiler uses
when looking for files included using the quoted form of the
#include preprocessing directive: #include "file-spec"
/NESTED_INCLUDE_DIRECTORY has the following options:
PRIMARY_FILE Directs the compiler to search the default file type
for headers using the context of the primary source
file (the .C file). This means that just the file
type (".H" or ".") is used for the default file-spec
but, in addition, the chain of "related file-specs"
used to maintain the sticky defaults for processing
the next top-level source file is applied when
searching for the include file.
INCLUDE_FILE Directs the compiler to search the directory
containing the file in which the #include directive
itself occurred. The meaning of "directory
containing" is: the RMS "resultant string" obtained
when the file in which the #include occurred was
opened, except that the filename and subsequent
components are replaced by the default file type for
headers (".H", or just "." if
/ASSUME=NOHEADER_TYPE_DEFAULT is in effect). The
"resultant string" will not have translated any
concealed device logical.
NONE Directs the compiler to skip the first step of
processing #include "file.h" directives. The
compiler starts its search for the include file in
the /INCLUDE_DIRECTORY directories.
See also /INCLUDE_DIRECTORY.
2 /OBJECT
/OBJECT[=file-spec] (D)
/NOOBJECT
Controls whether the compiler produces an output object module.
The default output file extension is .OBJ.
Note that the /OBJECT qualifier has no impact on the output file of
the /MMS_DEPENDENCIES qualifier.
2 /OPTIMIZE
/OPTIMIZE[=option] (D)
/NOOPTIMIZE
Controls the level of code optimization that the compiler performs.
/OPTIMIZE has the following options:
LEVEL=n Selects the level of optimization. Specify an
integer from 0 (no optimization) to 5 (full
optimization, including pipelining).
[NO]INLINE[=keyword] Provides inline expansion of functions that
yield optimized code when they are expanded. You
can specify one of the following keywords:
NONE No inlining is done, even if requested
by the language syntax.
/OPTIMIZE=INLINE=NONE is equivalent to
/OPTIMIZE=NOINLINE.
MANUAL Inlines only those function calls for
which the program explicitly requests
inlining.
AUTOMATIC Inlines all of the function calls in
the MANUAL category, plus additional
calls that the compiler determines are
appropriate on this platform. On
Alpha systems, this is the same as
SIZE; on I64 systems, this is the same
as SPEED. AUTOMATIC is the default.
SIZE Inlines all of the function calls in
the MANUAL category plus any
additional calls that the compiler
determines would improve run-time
performance without significantly
increasing the size of the program.
SPEED Performs more aggressive inlining for
run-time performance, even when it
might significantly increase the size
of the program.
ALL Inlines every call that can be inlined
while still generating correct code.
Recursive routines, however, will not
cause an infinite loop at compile
time.
Note that /OPT=INLINE=ALL is not
recommended for general use, because
it performs very aggressive inlining
and can cause the compiler to exhaust
virtual memory or take an unacceptably
long time to compile
[NO]INTRINSICS Controls whether or not certain functions are
handled as intrinsic functions without explicitly
enabling each of them as an intrinsic through the
#pragma intrinsic preprocessor directive.
Functions that can be handled as intrinsics are:
Main Group - ANSI:
abs atanl atan2l ceill cosl floorf memcpy sinf
atan atan2 ceil cos fabs floorl memmove sinl
atanf atan2f ceilf cosf floor labs memset strcpy
sin strlen
Main Group - Non-ANSI:
alloca atand2 bzero sind
atand bcopy cosd
Printf functions:
fprintf printf sprintf
Printf non-ANSI:
snprintf
ANSI math functions that set errno,
thereby requiring /ASSUME=NOMATH_ERRNO:
acos asinf coshl log log10f powl sqrt tanf
acosf asinl exp logf log10l sinh sqrtf tanl
acosl cosh expf logl pow sinhf sqrtl tanh
asin coshf expl log10 powf sinhl tan tanhf
tanhl
Non-ANSI math functions that set errno,
thereby requiring /ASSUME=NOMATH_ERRNO:
log2
tand
The /OPTIMZE=INTRINSICS qualifier works together
with /OPTIMIZE=LEVEL=n and some other qualifiers
to determine how intrinsics are handled:
o If the optimization level specified is less
than 4, the intrinsic-function prototypes and
call formats are checked, but normal run-time
calls are still made.
o If the optimization level is 4 or higher,
intrinsic code is generated.
o If /STANDARD=ANSI89 is specified,
non-ANSI-Standard functions are not
automatically intrinsic and do not even have
their prototypes checked. They are only
checked if the non-ANSI-Standard functions
are made intrinsic through #pragma intrinsic.
o Intrinsic code is not generated for math
functions that set the errno variable unless
/ASSUME=NOMATH_ERRNO is specified. Such math
functions, however, do have their prototypes
and call formats checked.
The default is /OPTIMIZE=INTRINSICS, which turns
on this handling.
To turn it off, specify /NOOPTIMIZE or
/OPTIMIZE=NOINTRINSICS.
[NO]PIPELINE Controls Activation of the software pipelining
optimization. The software pipelining
optimization applies instruction scheduling to
certain innermost loops, allowing instructions
within a loop to "wrap around" and execute in a
different iteration of the loop. This can reduce
the impact of long-latency operations, resulting
in faster loop execution.
Software pipelining can be more effective when
you combine /OPTIMIZE=PIPELINE with the
appropriate /OPTIMIZE=TUNE keyword for the target
Alpha processor generation.
Software pipelining also enables the prefetching
of data to reduce the impact of cache misses.
Software pipelining is a subset of the
optimizations activated by optimization level 5.
To determine whether using /OPTIMIZE=PIPELINE
benefits your particular program, you should time
program execution for the same program (or
subprogram) compiled with and without software
pipelining.
For programs that contain loops that exhaust
available registers, longer execution times can
result with optimization level 5, requiring use
of /OPTIMIZE=UNROLL=n to limit loop unrolling.
UNROLL=n Controls loop unrolling done by the optimizer.
UNROLL=n means to unroll loop bodies n times.
The default is UNROLL=0, which means the
optimizer will use its own default unroll amount.
TUNE=keyword Selects processor-specific instruction tuning for
implementations of the Alpha or Itanium
architecture. Regardless of the setting of the
/OPTIMIZE=TUNE flag, the generated code will run
correctly on all implementations of the Alpha
architecture. Tuning for a specific
implementation can provide improvements in
run-time performance. Code tuned for a specific
target might run slower on another target.
For Itanium systems, you can specify the
following keyword:
ITANIUM2 Generates code for the Intel Itanium 2 processor.
The default is /OPTIMIZE, which is equivalent to
/OPTIMIZE=(INLINE=AUTOMATIC,LEVEL=4,UNROLL=0,TUNE=GENERIC).
2 /PDSC_MASK
/PDSC_MASK=option
Forces the compiler to set the PDSC$V_EXCEPTION_MODE field of the
procedure descriptor for each function in the compilation unit to
the specified value, regardless of the setting of any other
qualifiers.
Ordinarily the PDSC$V_EXCEPTION_MODE field gets set automatically
by the compiler, depending on which /IEEE mode is specified on the
command line. The /PDSC_MASK qualifier overrides the /IEEE_MODE
qualifer setting of this field.
NOTE:
The /PDSC_MASK qualifier is a low-level systems-programming
feature that is seldom necessary. Its usage can produce object
modules that do not conform to the OpenVMS common language
environment and, within C, it can produce non-standard and
seemingly incorrect floating-point behaviors at runtime.
The qualifier option keywords are exactly the allowed values
defined in the OpenVMS Calling Standard for this field, stripped of
the PDSC$V_EXCEPTION_MODE prefix (for example, /PDSC_MASK=SIGNAL
sets the field to PDSC$V_EXCEPTION_MODE_SIGNAL).
The qualifier options are:
SIGNAL Maps to PDSC$K_EXCEPTION_MODE_SIGNAL. Raise
exceptions for all except underflow (which
equals 0).
SIGNAL_ALL Maps to PDSC$K_EXCEPTION_MODE_SIGNAL_ALL.
Raise exceptions for all.
SILENT Maps to PDSC$K_EXCEPTION_MODE_SILENT. Raise
no exceptions. Create only finite values:
no infinities, no denorms, no NaNs. The
function result or errno needs to be
examined.)
FULL_IEEE Maps to PDSC$K_EXCEPTION_MODE_FULL_IEEE.
Raise no exceptions except as controlled by
separate IEEE exception-enabling bits.
Create exceptional values according to the
IEEE standard.
CALLER Maps to PDSC$K_EXCEPTION_MODE_CALLER.
Emulate the same mode as the caller.
In the absence the /PDSC_MASK qualifier, the compiler sets the
PDSC$V_EXCEPTION_MODE field automatically, depending on the
/IEEE_MODE qualifier setting:
o If /IEEE_MODE is specified with UNDERFLOW_TO_ZERO,
DENORM_RESULTS, or INEXACT, then /PDSC_MASK is set to
FULL_IEEE.
o In all other cases, /PDSC_MASK is set to SILENT. This setting
differs from the calling-standard-specified default of SIGNAL
used by Fortran, and is largly responsible for the ANSI C
conforming behavior of the math library when called from C or
C++ programs.
2 /PLUS_LIST_OPTIMIZE
/PLUS_LIST_OPTIMIZE
/NOPLUS_LIST_OPTIMIZE (D)
Provides improved optimization and code generation across file
boundaries that would not be available if the files were compiled
seperately.
When you specify /PLUS_LIST_OPTIMIZE on the command line in
conjunction with a series of file specifications separated by plus
signs, the compiler does not concatenate each of the specified
source files together. Instead, each file is treated separately
for purposes of parsing, except that the compiler will issue
diagnostics about conflicting external declarations and function
definitions that occur in different files. For purposes of code
generation, the compiler treats the files as one application.
The default is /NOPLUS_LIST_OPTIMIZE.
2 /POINTER_SIZE
/POINTER_SIZE=option
/NOPOINTER_SIZE (D)
Controls whether or not pointer-size features are enabled, and
whether pointers are 32 bits or 64 bits long.
The default is /NOPOINTER_SIZE, which disables pointer-size
features, such as the ability to use #pragma pointer_size, and
directs the compiler to assume that all pointers are 32-bit
pointers. This default represents no change over previous versions
of the compiler.
You must specify one of the following options:
SHORT The compiler assumes 32-bit pointers.
32 Same as SHORT.
LONG[=ARGV] The compiler assumes 64-bit pointers. If the ARGV option to
LONG or 64 is present, the main argument argv will be an
array of long pointers instead of an array of short pointers.
64[=ARGV] Same as LONG.
Specifying /POINTER_SIZE=32 directs the compiler to assume that all
pointers are 32-bit pointers. But unlike the default of
/NOPOINTER_SIZE, /POINTER_SIZE=32 enables use of the #pragma
pointer_size long and #pragma pointer_size short preprocessor
directives to control pointer size throughout your program.
Specifying /POINTER_SIZE=64 directs the compiler to assume that all
pointers are 64-bit pointers, and also enables use of the #pragma
pointer_size directives.
2 /PRECISION
/PRECISION={SINGLE | DOUBLE}
Controls whether floating-point operations on float variables are
performed in single or double precision.
The default is /PRECISION=DOUBLE for /STANDARD=VAXC and
/STANDARD=COMMON modes.
The default is /PRECISION=SINGLE for /STANDARD=ANSI89 and
/STANDARD=RELAXED modes.
2 /PREFIX_LIBRARY_ENTRIES
Controls the VSI C RTL name prefixing.
The VSI C Run-Time Library (RTL) shareable image (DECC$SHR.EXE)
resides in IMAGELIB.OLB with a DECC$ prefix for its entry points.
Every external name in IMAGELIB.OLB has a DECC$ prefix, and,
therefore, has an OpenVMS conformant name space (a requirement for
inclusion in IMAGELIB). The /[NO]PREFIX_LIBRARY_ENTRIES qualifier
lets you control the VSI C RTL name prefixing.
The qualifier options are:
EXCEPT=(name,...) The names specified are not prefixed.
ALL_ENTRIES All C RTL names, as well as C99 names not
supported by the underlying C RTL, are
prefixed.
ANSI_C89_ENTRIES Only ANSI library names are prefixed.
C99_ENTRIES Only ISO C Standard 99 (C99) library names
are prefixed. These are a superset of the
external names prefixed under
/PREFIX=ANSI_C89_ENTRIES and a subset of
those prefixed under /PREFIX=ALL_ENTRIES.
Note: The compiler prefixes C99 entries
based on their inclusion in the standard, not
on the availability of their implementations
in the run-time library. So calling
functions introduced in C99 that are not yet
implemented in the VSI C RTL will produce
unresolved references to symbols prefixed by
DECC$ when the program is linked. In
addition, the compiler issues a
CC-W-NOTINCRTL message when it prefixes a
name that is not in the current C RTL.
RTL="name" Generates references to the C RTL indicated
by the "name" keyword. If no keyword is
specified, then references to the VSI C RTL
are generated by default. To use an
alternate RTL, see its documentation for the
name to use.
If you want no names prefixed, specify /NOPREFIX_LIBRARY_ENTRIES.
For /STANDARD=ANSI89, the default is /PREFIX=ANSI_C89_ENTRIES.
For /STANDARD=C99, the default is /PREFIX=C99_ENTRIES.
For all other compiler modes, the default is /PREFIX=ALL.
2 /PREPROCESS_ONLY
/PREPROCESS_ONLY[=filename]
/NOPREPROCESS_ONLY (D)
Causes the compiler to perform only the actions of the preprocessor
phase and write the resulting processed text out to a file.
Furthermore, no object file or analysis file can be produced.
2 /PROTOTYPE
/PROTOTYPE[=(option[,...])]
/NOPROTOTYPE (D)
Creates an output file containing function prototypes for all
global functions defined in the module being compiled.
The qualifier options are:
[NO]IDENTIFIERS Indicates that identifier names are to be
included in the prototype declarations that
appear in the output file. The default is
NOIDENTIFIERS.
[NO]STATIC_FUNCTIONS Indicates that prototypes for static function
definitions are to be included in the output
file. The default is NOSTATIC_FUNCTIONS.
FILE=filename Specifies the output file name. When not
specified, the output file name has the same
defaults as the listing file, except that the
file extension is .CH instead of .LIS.
The default is /NOPROTOTYPES.
2 /PSECT_MODEL
/PSECT_MODEL=MULTILANGUAGE
/PSECT_MODEL=NOMULTILANGUAGE (D)
Controls whether the compiler allocates the size of overlaid psects
to ensure compatibility when the psect is shared by code created by
other HP compilers.
The problem this switch solves can occur when a psect generated by
a Fortran COMMON block is overlaid with a psect consisting of a C
struct. Because Fortran COMMON blocks are not padded, if the C
struct is padded, the inconsistent psect sizes can cause linker
error messages.
Compiling with /PSECT_MODEL=MULTILANGUAGE ensures that VSI C uses a
consistent psect size allocation scheme. The corresponding Fortran
switch is /ALIGN=COMMON=[NO]MULTILANGUAGE.
The default is /PSECT=NOMULTILANGUAGE, which is the old default
behavior of the compiler, and is sufficient for most applications.
2 /REENTRANCY
/REENTRANCY=option
/REENTRANCY=TOLERANT (D)
Controls the type of reentrancy that reentrant VSI C RTL routines
will exhibit.
(See also the decc$set_reentrancy RTL routine.)
This qualifier is for use only with a module containing the main
routine.
The reentrancy level is set at run time according to the
/REENTRANCY qualifier specified while compiling the module
containing the main routine.
You can specify one of the following options:
AST Uses the __TESTBITSSI builtin to perform simple
locking around critical sections of RTL code, and
may additionally disable asynchronous system
traps (ASTs) in locked region of codes. This
type of locking should be used when AST code
contains calls to VSI C RTL I/O routines.
MULTITHREAD Designed to be used in conjunction with the
DECthreads product. It performs DECthreads
locking and never disables ASTs.
NONE Gives optimal performance in the RTL, but does
absolutely no locking around critical sections of
RTL code. It should only be used in a single
threaded environment when there is no chance that
the thread of execution will be interrupted by an
AST that would call the VSI C RTL.
TOLERANT Uses the __TESTBITSSI builtin to perform simple
locking around critical sections of RTL code, but
ASTs are not disabled. This type of locking
should be used when ASTs are used and must be
delivered immediately. This is also the default
reentrancy type.
2 /REPOSITORY
Specifies a repository for the compiler to store shortened external
name information. When /NAMES=SHORTENED is specified, the compiler
stores to the repository any external names that were shortened.
The demangler utility can then be used to map the shortened names
back to the names used in the original C program.
By default, the qualifier is not active unless /NAMES=SHORTENED has
been specified, in which case the default is
/REPOSITORY=[.CXX_REPOSITORY].
Note that the default name of the repository is the same as that
used by the HP C++ compiler for decoding mangled names. This is
intentional. A C++ mangled name cannot match a shortened name, so
a single repository can be used by both the VSI C and HP C++
compilers.
2 /ROUNDING_MODE
/ROUNDING_MODE=option
/ROUNDING_MODE=NEAREST (D)
For /FLOAT=IEEE_MODE, the /ROUNDING_MODE qualifier lets you select
one of the following IEEE rounding modes:
o NEAREST (default)
o DYNAMIC
o MINUS_INFINITY
o CHOPPED
For /FLOAT=G_FLOAT or /FLOAT=D_FLOAT, rounding defaults to
/ROUNDING_MODE=NEAREST, with no other choice of rounding mode.
2 /SHARE_GLOBALS
/NOSHARE_GLOBALS (D)
Performs two functions:
o Controls whether the compiler treats declarations of objects
with the globaldef keyword as shared or not shared.
o Controls whether the initial extern_model is shared or not
shared (for those extern_models where it is allowed). The
initial extern_model of the compiler is a fictitious pragma
constructed from the settings of the /EXTERN_MODEL and
/SHARE_GLOBALS.
The default value is /NOSHARE_GLOBALS. This default value is
different from VAX C (which treated externs as SHR by default), and
has the following impact:
1. When linking old object files or object libraries with newly
produced object files, you might get "conflicting attributes
for psect" messages, which can be safely ignored as long as you
are not building shareable libraries.
2. The /NOSHARE_GLOBALS default makes building shareable libraries
easier.
2 /SHOW
/SHOW=(option[,...])
/SHOW=SOURCE (D)
Used with the /LIST qualifier to set or cancel specific listing
options. You can select the following options:
ALL Print all listing information.
[NO]BRIEF Print a brief symbol table, listing only those
identifiers that are referenced in the program.
[NO]CROSS_REFERENCE
Specifies whether the compiler generates
cross-references. If you specify
/SHOW=CROSS_REFERENCE, the compiler lists, for
each variable referenced in the procedure, the
line numbers of the lines on which the variable
is referenced.
You may use /SHOW=CROSS_REFERENCE with
/SHOW=SYMBOLS. Otherwise, specifying
/SHOW=CROSS_REFERENCE also gives you /SHOW=BRIEF.
To obtain any type of listing, you must specify
/LIST. /SHOW=CROSS_REFERENCE is the same as
specifying /[NO]CROSS_REFERENCE. (D =
NOCROSS_REFERENCE)
[NO]DICTIONARY Print/do not print Common Data Dictionary
definitions. (D = NODICTIONARY)
[NO]EXPANSION Print/do not print macro expansions.
(D = NOEXPANSION)
[NO]HEADER Print/do not print header lines at the top of
each page. (D = HEADER)
[NO]INCLUDE Print/do not print contents of #include files.
(D = NOINCLUDE)
[NO]MESSAGES Print/do not print a list of all messages that
are in effect at compilation (based on the
settings of /STANDARD, /WARNINGS, and #pragma
message). (D = NOMESSAGES)
NONE Print no listing information.
[NO]SOURCE Print/do not print source file statements.
(D = SOURCE)
[NO]STATISTICS Print/do not print compiler performance
statistics. (D = NOSTATISTICS)
[NO]SYMBOLS Print/do not print symbol table information in
the listing file. (D = NOSYMBOLS)
2 /STANDARD
/STANDARD=(option)
/STANDARD=RELAXED (equivalent to /NOSTANDARD) (D)
/NOSTANDARD (D)
Defines the compilation mode. You can select the following
options:
ANSI89 Places the compiler in strict ANSI C Standard 89
(C89) mode. This mode compiles the C language as
defined by the American National Standard for C,
along with any extensions not prohibited by that
standard.
C99 On OpenVMS Alpha and I64 systems, places the
compiler in strict ISO/IEC C Standard 99 (C99)
mode. This mode accepts just the C99 language
without extensions, and diagnoses violations of
the C99 standard. /STANDARD=C99 defines the
__STDC_VERSION__ macro to the C99-specified value
of 199901L, because C99 is a superset of
Amendment 1 to the C89 standard, and the default
mode of RELAXED is a superset of C99.
On OpenVMS VAX systems, produces a warning and
places the compiler in /STANDARD=RELAXED ANSI89
mode.
LATEST On OpenVMS Alpha and I64 systems, places the
compiler in the latest ISO C standard dialect.
/STANDARD=LATEST is currently equivalent to
/STANDARD=C99, but is subject to change when
newer versions of the ISO C standard are
released.
RELAXED Places the compiler in relaxed ANSI C Standard
mode. The compiler accepts ANSI/ISO C Standard
C89 and C99 features, as well as nearly all
language extensions (such as additional VSI C
keywords and predefined macros that do not begin
with an underscore). It excludes only K&R
(COMMON mode), VAX C, and Microsoft features that
conflict with standard C.
This is the default mode of the compiler, and is
equivalent to /NOSTANDARD.
MS Places the compiler in Microsoft compatibility
mode, which interprets source programs according
to certain language rules followed by the C
compiler provided with the Microsoft Visual C++
compiler product.
ISOC94 Places the compiler in ISO C 94 mode, which
enables digraph processing. It also defines the
predefined macro __STDC_VERSION__=199409 when
specified alone or in combination with the
ANSI89, MIA, RELAXED, MS, COMMON, or PORTABLE
keywords.
This option can be specified alone or with any
other /STANDARD option except VAXC. If it is
specified alone, the default major mode is
RELAXED.
COMMON Places the compiler in K & R language mode; that
is, compatibility with older UNIX compilers such
as pcc and gcc. This mode is close to a subset
of /STANDARD=VAXC mode.
VAXC Places the compiler in VAX C mode. There are
differences in the C language as implemented in
previous versions of VAX C and the C language as
defined by ANSI (the differences are primarily
concerned with how the preprocessor works). This
mode provides compatibility for programs that
depend on old VAX C behavior.
PORTABLE Places the compiler in RELAXED mode, and enables
the issuance of diagnostics that warn of any
nonportable usages encountered.
Note that /STANDARD=PORTABLE is supported for
VAX C compatibility only. It is equivalent to
the recommended combination of qualifiers
/STANDARD=RELAXED /WARNINGS=ENABLE=PORTABLE.
MIA Places the compiler in strict ANSI C mode with
the following behavior differences to conform to
the Multivendor Integration Architecture (MIA)
standard:
o On OpenVMS VAX systems, G_FLOAT becomes the
default floating-point format for double
variables. (On OpenVMS Alpha systems, G_FLOAT
is already the default.)
o In structures, zero-length bit fields cause
the next bit field to start on an integer
boundary, rather than on a character boundary.
If the /STANDARD qualifier is not specified, the default is
/NOSTANDARD, which is equivalent to /STANDARD=RELAXED.
If you specify the /STANDARD qualifier, you must supply an option.
With one exception, the /STANDARD qualifier options are mutually
exclusive. Do not combine them. The exception is that you can
specify /STANDARD=ISOC94 with any other option except VAXC.
VSI C modules compiled in different modes can be linked and
executed together.
2 /TIE
/NOTIE (D)
Enables the compiled code to be used in combination with translated
images, either because the code might call into a translated image
or might be called from a translated image.
2 /UNDEFINE
/UNDEFINE=(identifier[,...])
/NOUNDEFINE (D)
Performs the same function as the #undef preprocessor directive:
it cancels a macro definition.
The /UNDEFINE qualifier is useful for undefining the predefined VSI
C preprocessor constants. For example, if you use a preprocessor
constant (such as vaxc, VAXC, VAX11C, or vms) to conditionally
compile segments of code specific to VSI C for OpenVMS Systems, you
can undefine constants to see how the portable sections of your
program execute. For example:
/UNDEFINE="vaxc"
When both /DEFINE and /UNDEFINE are present on the CC command line,
/DEFINE is evaluated before /UNDEFINE.
The default is /NOUNDEFINE.
2 /UNSIGNED_CHAR
/NOUNSIGNED_CHAR (D)
Changes the default for all char types from signed to unsigned.
This qualifier causes all plain char declarations to have the same
representation and set of values as signed char declarations. The
default is /NOUNSIGNED_CHAR.
2 /VERSION
/VERSION
/NOVERSION (D)
Directs the compiler to print out the compiler version and
platform. The compiler version is the same as in the listing file.
This qualifier helps you to report what compiler you are using.
When this qualifier is specified, the compiler just prints its
version and exits. No other qualifiers are processed, no source
file is read, and no object module is produced.
The syntax for using this qualifier is:
CC/VERSION
The default is /NOVERSION.
2 /WARNINGS
/WARNINGS[=(option[,...])]
/WARNINGS (D)
/NOWARNINGS
Controls the issuance of compiler diagnostic messages, or groups of
messages. The default qualifier, /WARNINGS, enables all warning
and informational messages for the compiler mode you are using.
The /NOWARNINGS qualifier suppresses the informational and warning
messages. Also see the #pragma message preprocessor directive.
The options are:
DISABLE=msg-list Suppresses the issuance of the indicated
messages.
Only messages of severity Warning (W) or
Information (I) can be disabled. If the
message has severity of Error (E) or
Fatal (F), it is issued regardless of any
attempt to disable it.
ENABLE=msg-list Enables the issuance of the indicated
messages.
NOINFORMATIONALS Suppresses informational messages.
EMIT_ONCE=msg-list Emits the specified messages only once
per compilation. Errors and Fatals are
always emitted. You cannot set them to
EMIT_ONCE.
EMIT_ALWAYS=msg-list Emits the specified messages at every
occurrence of the condition.
ERRORS=msg-list Sets the severity of each message in the
message-list to Error.
Note that supplied Error messages and
Fatal messages cannot be made less
severe. (Exception: A message can be
upgraded from Error to Fatal, then later
downgraded to Error again, but it can
never be downgraded from Error.)
Warnings and Informationals can be made
any severity.
FATALS=msg-list Sets the severity of each message on the
message-list to Fatal.
INFORMATIONALS=msg-list Sets the severity of each message in the
message-list to Informational. Note that
Fatal and Error messages cannot be made
less severe.
WARNINGS=msg-list Sets the severity of each message in the
message-list to Warning. Note that Fatal
and Error messages cannot be made less
severe.
VERBOSE Displays the full message information for
every compiler message encountered. This
information includes the message
description and user action, as well as
the identifier, severity, and message
text.
When /WARNINGS=VERBOSE is used with
/LIST/SHOW=MESSAGES, a list of all
messages in effect at compilation are
added to the listing file, showing the
full information for each message.
The msg-list can be any one of the following:
o A single message identifier (within parentheses, or not). The
message identifier is the name following the severity at the
start of a line when a message is issued. For example, in the
following message, the message identifier is GLOBALEXT:
%CC-W-GLOBALEXT, a storage class of globaldef,
globalref, or globalvalue is a language extension.
o A single message-group name (within parentheses, or not).
Message-group names are:
ALL All the messages in the compiler
ALIGNMENT Messages about unusual or inefficient data
alignment.
C_TO_CXX Messages reporting the use of C features
that would be invalid or have a different
meaning if compiled by a C++ compiler.
CDD Messages about CDD (Common Data
Dictionary) support.
CHECK Messages reporting code or practices that,
although correct and perhaps portable, are
sometimes considered ill-advised because
they can be confusing or fragile to
maintain. For example, assignment as the
test expression in an "if" statement.
NOTE: The check group gets defined by
enabling LEVEL5 messages.
DEFUNCT Messages reporting the use of obsolete
features: ones that were commonly
accepted by early C compilers but were
subsequently removed from the language.
NEWC99 Messages reporting the use of the new C99
Standard features.
NOANSI This is a deprecated message group. It is
an obsolete synonym for NOC89. Also see
message groups NEWC99, NOC89, NOC99.
NOC89 Messages reporting the use of non-C89
Standard features.
NOC99 Messages reporting the use of non-C99
Standard features.
OBSOLESCENT Messages reporting the use of features
that are valid in ANSI Standard C, but
which were identified in the standard as
being obsolescent and likely to be removed
from the language in a future version of
the standard.
OVERFLOW Messages that report assignments and/or
casts that can cause overflow or other
loss of data significance.
PERFORMANCE Messages reporting code that might result
in poor run-time performance.
PORTABLE Messages reporting the use of language
extensions or other constructs that might
not be portable to other compilers or
platforms.
PREPROCESSOR Messages reporting questionable or
non-portable use of preprocessing
constructs.
QUESTCODE Messages reporting questionable coding
practices. Similar to the CHECK group,
but messages in this group are more likely
to indicate a programming error rather
than just a non-robust style.
Enabling the QUESTCODE group provides
lint-like checking.
RETURNCHECKS Messages related to function return
values.
UNINIT Messages related to using uninitialized
variables.
UNUSED Messages reporting expressions,
declarations, header files, CDD records,
static functions, and code paths that are
not used.
o A single message-level name (within parentheses, or not).
Note: There is a core of very important compiler messages that
are enabled by default, regardless of what you specify with
/WARNINGS or #pragma message. Referred to as message level 0,
it includes all messages issued in header files, and comprises
what is known as the nostandard group. All other message
levels add additional messages to this core of enabled
messages.
You cannot modify level 0 (You cannot disable it, enable it,
change its severity, or change its EMIT_ONCE characteristic).
However, you can modify individual messages in level 0,
provided such modification is allowed by the action. For
example, you can disable a warning or informational in level 0,
or you can change an error in level 0 to a fatal, and so on.
(See above restrictions on modifying individual messages.)
Message-level names are:
LEVEL1 Important messages. These are less
important than the level 0 core messages,
because messages in this group are not
displayed if #pragma nostandard is active.
LEVEL2 Moderately important messages.
LEVEL3 Less important messages. LEVEL3 is the
default message level.
LEVEL4 Useful check/portable messages.
LEVEL5 Not so useful check/portable messages.
LEVEL6 Additional "noisy" messages.
Enabling a level also enables all the messages in the levels
below it. So enabling LEVEL3 messages also enables messages
in LEVEL2 and LEVEL1.
Disabling a level also disables all the messages in the
levels above it. So disabling LEVEL4 messages also disables
messages in LEVEL5 and LEVEL6.
o A comma-separated list of message identifiers, group names, and
messages levels, freely mixed, enclosed in parentheses.
The default is /WARNINGS. This enables all diagnostic messages for
the selected compiler mode.
Notes:
o If a message is on both the enabled and disabled list, it is
disabled.
o If a message is on both the EMIT_ONCE and the EMIT_ALWAYS list,
it is considered to be on the EMIT_ONCE list.
o If a message is on more than one of the FATALS, ERRORS,
WARNINGS, or INFORMATIONALS lists, the message is given the
least severe level.
o The NOINFORMATIONALS option is not the negation of
INFORMATIONALS=msg-list. It is valid to say:
/WARN=(INFORMATIONALS=message_list,NOINFORMATIONALS)
This has the effect of making the messages on the message_list
informationals, and causing the compiler to suppress any
informational messages.
2 Message_Groups
VSI C compiler message groups
The following tables list all compiler messages by message group.
For a description of each compiler message, see the Messages section
of this online help.
3 64BIT
CVTU32TO64 FUNCMIXPTR LONGLONGSUFX
LONGLONGTYPE POINTERINTCAST PRAGIGNORE
PTRINTTOLONG PTRLONGTOINT TRUNCLONGCAST
TRUNCLONGINT
3 64BITPOINTERS
POINTERINTCAST
3 ALIGNMENT
ALIGNCONFLICT ALIGNCONFLICT1 ALIGNCONST
ALIGNEXT MISALGNDMEM MISALGNDSTRCT
NONMULTALIGN UNALIGNEXT
3 C_TO_CXX
CLASSNOINIT CONSTNOINIT CONSTSTOCLS
CXXKEYWORD INTIMPLIED KNRFUNC
NESTEDENUM NESTEDTYPE NONEWTYPE
NONULINIT NOPARMLIST STORCLSDCL
STORMODDCL TENTREDEF
3 CDD
CDDEXT TEXTARRAY TEXTARRAYN
TEXTCHAR
3 DEFUNCT
DEFPARMTYPE DUPENUM EMBEDCOMMENT
LONGFLOATEXT MAINPROGEXT READONLYEXT
3 NEWC99
ADDRCONSTEXT ARRNOTLVALUE BOOLEXT
COMPLEXEXT CXXCOMMENT DECLAFTERSTMT
DECLINFOR DEFRETURNTYPE DESIGNATORUSE
DOLLARID DUPTYPQUAL FUTUREKEYWD2
FUTUREKEYWORD IMPLICITFUNC INCOMPARRY2
INTCONSTSIGNED LONGLONGSUFX LONGLONGTYPE
NEEDCONSTEXT RESTRICTEXT2 TRAILCOMMA
TYPQUALNOT2 UCNUNSUPP UCNUSED
VLAEXTENSION WCHARCAT XTRALARGE
3 NOC89
ADDRCONSTEXT ADDRSUBCONST ALIGNEXT
ARGADDR ARRNOTLVALUE ASSIGNEXT
BADCMMNTPSTNG BADREGISTER BITNOTINT
BOOLEXT CDDEXT CMPPTRFUNVOID
COMPLEXEXT CONSTCOMPLIT CONSTFUNC
CONVARASLIT CXXCOMMENT DECLAFTERSTMT
DECLINFOR DECLSPECEXT DESIGNATORUSE
DOLLARID DUPENUM DUPTYPEDEF
DUPTYPQUAL ELLIPSEARG ELLIPSEPARM
EMPTYCHARCONST ENUMSNOTCOMPAT EXPANDEDDEFINED
EXTENDTYPE FLEXARRAYELEM FLEXARRAYMEM
FUNCREDECL FUTUREKEYWD2 FUTUREKEYWORD
GLOBALEXT HEXOCTSIGN IDINPARENSEXT
INCARRAYPARM1 INCOMPARRY INCOMPARRY1
INCOMPARRY2 INCOMPDEREF INLINESTOCLSMOD
INTCONSTTOOBIG LABELWOSTMT LONGFLOATEXT
LONGLONGSUFX LONGLONGTYPE LVALUECAST
MACROREDEF MAINNOTINT MAINPROGEXT
MISMATPARAM MISPARAMCOUNT MIXFUNCVOID
NEEDCONSTEXT NODCL NONAMEMEMBERS
NONINTENUM NONOCTAL NONPORTLINEDIR
NONSTANDCAST NOSEMISTRUCT NOSHAREEXT
NOTADDRCAST OKCPPINARGS PARENLITERAL
PRAGMAIDENT PRAGMAMOD PTRMISMATCH1
READONLYEXT RESTRICTEXT RESTRICTEXT1
RESTRICTEXT2 SAMEASTYPEDEF TEXTMODULE
TRAILCOMMA TYPEDEFNA TYPEOFEXT
TYPQUALNOT2 UCNUNSUPP UCNUSED
UNALIGNEXT UNDEFENUM UNSIGNEDPRES
UNSTRUCTMEM VARIANTEXT VLAEXTENSION
VOLATILEFUNC WCHARCAT XTRALARGE
3 NOC99
ADDRSUBCONST ALIGNEXT ARGADDR
ASSIGNEXT BADCMMNTPSTNG BADREGISTER
BITNOTINT CDDEXT CMPPTRFUNVOID
CONSTCOMPLIT CONSTFUNC CONVARASLIT
DECLSPECEXT DUPENUM DUPTYPEDEF
ELLIPSEARG ELLIPSEPARM EMPTYCHARCONST
ENUMSNOTCOMPAT EXPANDEDDEFINED EXTENDTYPE
FLEXARRAYELEM FLEXARRAYMEM FUNCREDECL
GLOBALEXT HEXOCTSIGN IDINPARENSEXT
INCARRAYPARM1 INCOMPARRY INCOMPARRY1
INCOMPDEREF INLINESTOCLSMOD INTCONSTTOOBIG
INTCONSTUNSIGN LABELWOSTMT LONGFLOATEXT
LVALUECAST MACROREDEF MAINNOTINT
MAINPROGEXT MISMATPARAM MISPARAMCOUNT
MIXFUNCVOID NODCL NONAMEMEMBERS
NONINTENUM NONOCTAL NONPORTLINEDIR
NONSTANDCAST NOSEMISTRUCT NOSHAREEXT
NOTADDRCAST OKCPPINARGS PARENLITERAL
PRAGMAIDENT PRAGMAMOD PTRMISMATCH1
READONLYEXT RESTRICTEXT RESTRICTEXT1
SAMEASTYPEDEF TEXTMODULE TYPEDEFNA
TYPEOFEXT UNALIGNEXT UNDEFENUM
UNSIGNEDPRES UNSTRUCTMEM VARIANTEXT
VOLATILEFUNC
3 OBSOLESCENT
DEFRETURNTYPE INTIMPLIED KNRFUNC
STONOTFIRST
3 OVERFLOW
BITCONSTSIGN INPTRTYPE INTCONCASTSGN
INTCONCASTTRU INTCONSTSIGN INTCONSTTRUNC
MAYHIDELOSS NONOCTAL OUTSTRINGTYPE
OUTTYPELEN RIGHTSHIFTOVR TRUNCFLTASN
TRUNCFLTINT TRUNCINTASN TRUNCINTCAST
3 PERFORMANCE
ALIGNCONFLICT ALIGNCONFLICT1 BLTINIMPLRET
MISALGNDMEM MISALGNDSTRCT NONMULTALIGN
3 PORTABLE
ADDRARRAY ADDRCONSTEXT ADDRSUBCONST
ALIGNCONST ALIGNEXT ARGADDR
ARRNOTLVALUE ASSIGNEXT BADCMMNTPSTNG
BADREGISTER BITNOTINT BOOLEXT
CDDEXT CMPPTRFUNVOID COMPLEXEXT
CONSTCOMPLIT CONSTFUNC CONVARASLIT
CXXCOMMENT DECLAFTERSTMT DECLINFOR
DECLSPECEXT DESIGNATORUSE DOLLARID
DUPENUM DUPSTORCLS DUPTYPEDEF
DUPTYPQUAL ELLIPSEARG ELLIPSEPARM
EMBEDCOMMENT EMPTYCHARCONST ENUMSANDINT
ENUMSNOTCOMPAT EXPANDEDDEFINED EXTENDTYPE
FLEXARRAYELEM FLEXARRAYMEM FUNCREDECL
FUTUREKEYWD2 FUTUREKEYWORD GLOBALEXT
HEXOCTSIGN HEXOCTUNSIGN IDINPARENSEXT
INCARRAYPARM INCARRAYPARM1 INCOMPARRY
INCOMPARRY1 INCOMPARRY2 INCOMPDEREF
INCOMPELMNT INLINESTOCLSMOD INTCONSTSIGNED
INTCONSTTOOBIG INTCONSTUNSIGN LABELWOSTMT
LONGFLOATEXT LONGLONGSUFX LONGLONGTYPE
LVALUECAST MACROREDEF MAINNOTINT
MAINPROGEXT MISMATPARAM MISPARAMCOUNT
MIXFUNCVOID MULTICHAR NAMESHORTENED
NEEDCONSTEXT NONAMEMEMBERS NONINTENUM
NONOCTAL NONPORTLINEDIR NONSTANDCAST
NOSEMISTRUCT NOSHAREEXT NOTADDRCAST
OKCPPINARGS PARENLITERAL PRAGMA
PRAGMAIDENT PRAGMAMOD QUALNA
READONLYEXT RESTRICTEXT RESTRICTEXT1
RESTRICTEXT2 SAMEASTYPEDEF SWITCHLONG
TEXTMODULE TRAILCOMMA TYPEDEFNA
TYPEOFEXT TYPQUALNOT2 UCNUNSUPP
UCNUSED UNALIGNEXT UNDEFENUM
UNSTRUCTMEM VALUEPRES VARIANTEXT
VLAEXTENSION VOLATILEFUNC WCHARCAT
3 PREPROCESSOR
BADCMMNTPSTNG CDDEXT EMBEDCOMMENT
EXPANDEDDEFINED MACROREDEF NESTINCL
NONPORTLINEDIR OKCPPINARGS PRAGMAIDENT
PRAGMAMOD TEXTMODULE UNKNOWNMACRO
UNNECCDD UNNECINCL UNUSEDCDD
UNUSEDINCL UNUSEDTOP VAARGSBODY
XTRALARGE
3 QUESTCODE
BADCMMNTPSTNG BADREGISTER BITCONSTSIGN
CONSTFUNC CONSTNOINIT CONTROLASSIGN
DUPENUM ELLIPSEARG ELLIPSEPARM
EMPTYCHARCONST ENUMCALC ENVIRSTKDIRTY
EXPRNOTUSED FALLOFFEND FUNCMIXPTR
FUNCREDECL IMPFNCFALLOFF IMPFNCMSSNGRET
INCOMPDEREF INTCONCASTSGN INTCONCASTTRU
INTCONSTSIGN INTCONSTTRUNC INTIMPLIED
LVALUECAST MACROREDEF MISSPELLDEF
MULTICHAR NESTEDCOMMENT NODCL
NONOCTAL NONULINIT NORETURNVAL1
OKCPPINARGS PTRMISMATCH1 QUALFUNCRET
QUESTCOMPARE QUESTCOMPARE1 QUESTCOMPARE2
RIGHTSHIFTOVR SAMEASTYPEDEF SHORTCIRCUIT
SUBSCRBOUNDS1 SUBSCRBOUNDS2 TYPEDEFNA
UNDEFENUM UNDEFESCAP UNINIT2
UNINIT3 UNINIT4 UNINIT5
UNKNOWNMACRO UNREACHCODE USELESSTYPEQUAL
VOLATILEFUNC
3 RETURNCHECKS
DEFRETURNTYPE FALLOFFEND IGNORECALLVAL
IMPFNCFALLOFF IMPFNCMSSNGRET NORETURNVAL1
QUALFUNCRET
3 UNINIT
UNINIT2 UNINIT3 UNINIT4
UNINIT5
3 UNUSED
CONSTFUNC EXPNOTRES EXPRNOTUSED
MISSPELLDEF NESTEDCOMMENT NESTINCL
PRAGIGNORE QUALFUNCRET QUALNA
SHORTCIRCUIT UNCALLED UNNECCDD
UNNECINCL UNREACHCODE UNREFADECL
UNREFDECL UNREFLABEL UNREFSDECL
UNREFSFUNC UNREFTYP UNUSEDCDD
UNUSEDINCL UNUSEDTOP VOLATILEFUNC
2 Messages
Compiler messages - HP C V7.1
Some compiler messages substitute information from the program into
the message text. In this online help, the portion of the text to
be substituted is shown in angle brackets (<>).
Often, the same message is issued in different contexts within a
program. In this online help, the message context is indicated by
the word <context> within the message. The actual message issued by
the compiler will contain one of the following phrases substituted
for <context>:
In this declaration,
In the initializer for
In the declaration of "<name>",
In the definition of the function "<name>",
In the declaration of an unnamed object,
In this statement,
You can control the messages issued with the /[NO]WARNINGS command
line qualifier or the #pragma message preprocessor directive. Note
that some messages are not produced directly by the compiler; they
are produced by other software that the compiler uses. Messages not
produced directly by the compiler are not included in this list and
can not be controlled by /[NO]WARNINGS or #pragma message.
3 ABSTRACTDCL
Message Invalid abstract declarator.
Description An identifier was encountered in an abstract
declarator. An abstract declarator is used to
specify a type only and must not contain an
identifier that specifies a declarator.
User Action Correct the abstract declarator.
3 ADDRARRAY
Message <Context> & before array "<expression>" is ignored.
Description In certain modes, HP C will ignore an address-of
operator used on an entire array. This is for
compatibility with other compilers that have this
behavior.
User Action Remove the address-of operator.
3 ADDRCONSTEXT
Message <Context> "<name>" does not have a constant address,
but occurs in a context that requires an address
constant. This is an extension of the language.
Description The C89 standard requires that an initializer for a
pointer-type member of an automatic aggregate or
union-type object have an initializer that is an
address constant. Other C compilers might not
successfully compile a program that uses this
extension.
User Action Be aware of this if you wish to port the program.
3 ADDRESSOFVOID
Message <Context> taking the address of a void type is a
language extension.
Description The HP C compiler will allow taking the address of a
void type for compatibility with other compilers.
This is an extension to the standard. Other
compilers may reject this.
User Action Be aware of this if you plan to port this source to
another compiler.
3 ADDRSUBCONST
Message <Context> accepting the expression "<expr>" as a
constant is a language extension.
Description In many cases HP C accepts the subtraction of two
addresses within the same array or struct/union as a
constant. The C standard does not consider such an
expression to be a constant. Therefore, this program
does not conform to the standard and may be rejected
by other compilers.
User Action Change the expression to be a constant.
3 ALIGNCONFLICT
Message <Context> the address "<expr>" has alignment of
<align> which is less than the alignment requirements
of the destination pointer. Dereferencing the
destination pointer may cause an alignment fault.
Description The compiler has detected a situation where a pointer
to an aligned data type is being assigned an address
that may not be properly aligned. A later
dereference of this pointer could cause an alignment
fault.
User Action There are a number of possible actions. The best is
to correct the condition that is causing the source
to have the wrong alignment, as access to an
unaligned data structure involves additional run-time
overhead. Other options would be to modify the
declaration of the destination pointer such that its
referenced type has the __unaligned type qualifier,
or use the compiler option that tells the compiler to
assume all pointer references are unaligned. It is
also possible to cast the source to the destination
type to silence this message. However, that solution
will not correct any unaligned access.
3 ALIGNCONFLICT1
Message <Context> the address "<expr>" has alignment of
<align> which is less than the alignment requirements
of the pointer type it is cast to. Dereferencing the
resulting pointer may cause an alignment fault.
Description The compiler has detected a situation where an
address is being cast to a pointer type with a
greater alignment requirement than the type of the
address expression implies. A later dereference of
this pointer type value could cause an alignment
fault.
User Action There are a number of possible actions. The best is
to correct the condition that is causing the source
to have the wrong alignment, as access to an
unaligned data structure involves additional run-time
overhead. Other options would be to change the type
of the pointer used in the cast such that its
referenced type has the __unaligned type qualifier,
or use the compiler option that tells the compiler to
assume all pointer references are unaligned. It is
also possible to cast the address expression to (void
*) before casting it to the specified type to silence
this message. However, that solution will not
correct any unaligned access.
3 ALIGNCONST
Message Integer constant alignment <number> is not
necessarily supported on all platforms.
Description Although the specified alignment value is valid on
this system, it might not be valid on other systems.
For example, 16 is a valid alignment value on Alpha
systems but would not be valid on VAX systems.
User Action Be aware of this potential portability issue.
3 ALIGNEXT
Message _align is a language extension.
Description The _align storage class modifier is a language
extension of HP C. Other C compilers might not
successfully compile a program that uses the
extension.
User Action Be aware of this extension if you wish to port the
code.
3 ALIGNPOP
Message This "restore" has underflowed the member alignment's
stack. No corresponding "save" was found.
Description The member_alignment stack, managed by the #pragma
member_alignment and #pragma environment directives,
contains more restores than saves. This could
signify a coding or logic error in the program.
User Action Make sure each restore has a corresponding save.
3 ALREADYTLS
Message The identifier "<name>" has already appeared in an
omp threadprivate directive.
Description The same identifier appears more than once in a
single omp threadprivate directive, or appears in
more than one omp threadprivate clause.
User Action Remove the duplicate identifiers
3 ANSIALIASCAST
Message <Context> a pointer to <type1> is being cast to a
pointer to <type2>. Using ANSI aliasing rules, the
compiler may subsequently assume that the two pointer
types are pointing to different storage locations.
Description The C standard allows a compiler to assume that these
two pointer types will point to different storage
locations. The compiler will make this assumption
whenever ansi aliasing is enabled on the command
line, either directly or via another switch. The
cast in itself does not violate aliasing rules, e.g.
you might cast the pointer value back to an allowed
type before you use it to access memory. But the
compiler cannot generally determine whether or not
you do that. If your code accesses the memory
designated by this pointer value using both of these
pointer types, you may get unexpected results when
ansi aliasing is enabled.
User Action Casting through pointer to void will silence this
message. But if the end result is that the same
memory still gets accessed through different types
that are not permitted under the aliasing rules, you
may still get unexpected results. If compiling
without ansi aliasing corrects the behavior of your
program, your code almost certainly violates the
aliasing rules in a way that the compiler cannot
detect.
3 ARGADDR
Message <Context> taking the address of the constant
expression "<expression>" in an argument list is a
language extension.
Description The HP C compiler will allow the address of a
constant to be passed as an argument to a function
call. This is an extension to standard C. Other C
compilers might not successfully compile a program
that uses this extension.
User Action Assign the constant to a variable, and pass the
address of the variable.
3 ARGLISGTR255
Message <Context> the function call specifies an argument
list whose length exceeds maximum specified by the
calling standard. Any use of va_count by the called
function will be wrong.
Description The OpenVMS calling standard uses a byte-sized field
to specify the size of the argument list. The
argument list to this function call requires more
storage than can be represented in this size. As a
result, any use of va_count in the called function
will return inaccurate information.
User Action Either reduce the size of the argument list, or do
not use va_count in the called function.
3 ARGLISTOOLONG
Message <Context> the function call specifies an argument
list whose length exceeds the VAX architecture limit.
This call allocates stack space that is never
deallocated by the called program.
Description The OpenVMS VAX Calling Standard requires that the
called program deallocate the storage allocated for
its arguments. This is done by looking at the
byte-size value that holds the argument list size.
However, the argument list to this function call
requires more storage than can be represented in a
byte. As a result, the called function will not
deallocate the proper amount of storage. This could
result in unpredictable behavior.
User Action Reduce the size of the argument list.
3 ARGSIZE
Message <Context> the argument being passed to this function
is too small.
Description A function parameter of array type has been declared
with the keyword "static" in its outermost bound to
indicate that the function may generate code that
assumes that when it is called the actual argument
will have at least as many elements as specified in
the parameter declaration. The argument provided in
this call has fewer array elements than specified in
the parameter declaration with static bound.
User Action Check the size of the argument passed to the function
and/or modify or remove the static bound on the
function parameter.
3 ARRAYBRACE
Message <Context> a required set of braces is missing.
Description The initializer for this array was not enclosed in
braces. While some compilers allow this, standard C
requires braces around the initializer.
User Action Enclose the initializer in braces.
3 ARRAYLIMITSUP
Message <Context> HP C provides only limited support for
array types larger than <n> bytes.
Description This array type is larger than can be represented by
size_t. While HP C will allow a type declared to be
this size, uses of the type are not fully supported
and may cause unpredictable behavior.
User Action Reduce the size of the array type. It may be
possible to use a pointer type instead of a large
array. The storage can still be accessed using array
syntax.
3 ARRAYOVERFLOW
Message Integer overflow occurred when computing the size of
an array type.
Description An array type is larger than allowed on this
platform.
User Action Reduce the size of the array type. It may be
possible to use a pointer type instead of a large
array. The storage can still be accessed using array
syntax.
3 ARRNOTLVALUE
Message <Context> accepting a non-lvalue array in a subscript
operator is an extension to the C89 standard.
Description The C89 standard states that one of the operands to
the subscript operator must be a pointer. However,
the array used in this operator could not be
converted to a pointer because it is not an lvalue.
Therefore this code does not conform to the C89
standard and may not be accepted by other compilers.
Note that the C99 standard allows this because all
arrays are converted to pointers, not just lvalue
arrays.
User Action Be aware of this difference if you plan to port this
source to another compiler.
3 ASMCOMEXP
Message Comma expected while processing <text> instruction
Description The asm directive parser was expecting a comma, but
one was not found.
User Action Correct the asm directive.
3 ASMENDEXP
Message Semicolon or asm end expected while processing <text>
instruction
Description The asm directive parser was expecting a semicolon to
end an instruction, but one was not found.
User Action Correct the asm directive.
3 ASMFIMMDOTS
Message Floating point load-immediate instructions require a
.s file
Description Using a floating point load immediate instruction in
this asm directive will require the compiler to
produce an .s file and invoke the assembler to
process this source.
User Action Do not use floating point load immediate instructions
in asm directives.
3 ASMFREGEXP
Message Float register expected while processing <text>
instruction
Description The asm directive parser was expecting a valid
floating register, but one was not found.
User Action Correct the asm directive.
3 ASMHINTDOTS
Message Hint on <text> instruction requires a .s file
Description Using a hint in a transfer instruction in this asm
directive will require the compiler to produce an .s
file and invoke the assembler to process this source.
User Action Do not use hints in asm directives.
3 ASMICONEXP
Message Integer constant expected while processing <text>
instruction
Description The asm directive parser was expecting a valid
integer constant, but one was not found.
User Action Correct the asm directive.
3 ASMIDEXP
Message Identifier expected while processing <text>
instruction
Description The asm directive parser was expecting an identifier,
but one was not found.
User Action Correct the asm directive.
3 ASMINSTEXP
Message Instruction mnemonic expected (found <text>)
Description The asm directive parser was expecting an instruction
mnemonic, but one was not found.
User Action Correct the asm directive.
3 ASMLABEXP
Message Label expected while processing <text> instruction
Description The asm directive parser was expecting a label, but
one was not found.
User Action Correct the asm directive.
3 ASMLABMULDEF
Message Multiple definitions of label in asm (<text>)
Description The asm directive parser has detected the same label
defined more than once.
User Action Change one of the label names.
3 ASMLABUNDEF
Message Reference to undefined label in asm (<text>)
Description The asm directive parser has detected a reference to
an undefined label.
User Action Correct the asm directive.
3 ASMLDGPDOTS
Message Unusual ldgp requires a .s file
Description This indicates that a ldgp pseudo-instruction was
encountered in an unusual place or with unusual
arguments. The assembler will be invoked on the .s
file.
User Action Correct the asm directive.
3 ASMLPAREXP
Message Left paren expected while processing <text>
instruction
Description The asm directive parser was expecting a left paren,
but one was not found.
User Action Correct the asm directive.
3 ASMNOTAVAIL
Message In-line assembly code directive <name> is not
available on this platform.
Description In-line assembly code is not available on the IA64
platform.
User Action See documentation for alternatives.
3 ASMNOTINST
Message <text> instruction is not supported in asms on <text>
Description The asm directive parser does not recognizes a
pseudo-opcode on this platform.
User Action Correct the asm directive.
3 ASMNOTREG
Message <text> is not a register name on <text>
Description The asm directive parser has noticed that a special
register used in the directive is not valid on this
platform.
User Action Correct the asm directive.
3 ASMNOTSUP
Message Support for <text> (<text>) in asms is not
implemented on <text>
Description The asm directive parser does not support the feature
in question on this platform.
User Action Rewrite the asm so that the feature is not used.
3 ASMPALTRUNC
Message PALcode function has been truncated to <number>
Description The asm directive call_pal instruction is followed by
an integer beyond the range of call_pal values
expected by the compiler.
User Action Use a valid call_pal argument.
3 ASMRAWREG
Message <text> uses <text> before it is defined
Description The asm directive parser has noticed that an
instruction uses a register as a source before it is
given a value.
User Action Correct the asm directive.
3 ASMREGEXP
Message Fixed register expected while processing <text>
instruction
Description The asm directive parser was expecting a valid
integer register, but one was not found.
User Action Correct the asm directive.
3 ASMREGOVRLAPSC
Message Destination register overlaps input for <text>
(software completion) instruction
Description An asm directive contains an instruction that may
require a software completion routine in case of a
runtime exception. Such an instruction requires that
the result register be different than any input
register.
User Action Modify the asm so that the destination register is
different than the sources.
3 ASMRPAREXP
Message Right paren expected while processing <text>
instruction
Description The asm directive parser was expecting a right paren,
but one was not found.
User Action Correct the asm directive.
3 ASMSYMDOTS
Message Use of symbolic addresses with <text> instruction
requires a .s file
Description Using a symbolic operand in this asm directive will
require the compiler to produce an .s file and invoke
the assembler to process this source.
User Action Do not use symbolic operands in asm directives.
3 ASMUNKNOWNARCH
Message Unknown architecture (<text>) specified in <text>
assembler directive
Description The asm directive parser has detected an unexpected
argument to a .tune or .arch directive.
User Action Correct the asm directive.
3 ASMUNKSETOPT
Message Unsupported or illegal .set option (<text>)
Description The asm directive parser has detected an unexpected
argument to a .set directive.
User Action Correct the asm directive.
3 ASSERTFAIL
Message The assertion "<assertion>" was not true, <reason>.
Description The expression in a #pragma assert
non_zero(expression) directive was found to be zero.
User Action Correct the condition that caused the expression to
be zero.
3 ASSERTION
Message <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 ASSIGNEXT
Message <Context> relaxed struct or union type compatibility
is a language extension.
Description In certain modes, the compiler will allow assignments
or comparisons between structs or unions of different
types if their sizes are the same. This is an
extension to standard C. Other C compilers might not
successfully compile a program that uses this
extension.
User Action Recode the operation to use one of the memxxx
run-time library functions.
3 ASSUMEONEELEM
Message The type of the tentatively-defined array "<name>" is
incomplete at the end of the compilation unit. The
compiler will assume one array element.
Description The C standard requires that the type of all
tentative definitions must be completed before the
end of the compilation unit. For compatibility with
some other C compilers, HP C will give the array one
element.
User Action Complete the type.
3 AUTOALIGN
Message The alignment boundary of an automatic cannot be
greater than longword.
Description For automatic variables, the storage class modifier
_align cannot specify an alignment greater than
longword on VAX systems. The alignment will be set
to longword.
User Action Decrease the alignment. If a larger alignment is
required, declare the variable with static storage
class.
3 AUTOEXTERNAL
Message <Context> a storage class of "auto" or "register" is
illegal at file scope.
Description The storage classes auto and register can only be
used in a declaration that appears inside a function.
They cannot be used in a declaration at file scope.
User Action Remove the storage class specifier or move the
declaration inside a function body.
3 BADALIAS
Message Reference through restricted pointer <text> uses a
pointer value based on different restricted pointer,
<text>
Description The C language requires that restricted pointers
always point to different storage. The compiler has
detected a case where an access using a restricted
pointer is referencing memory pointed to a different
restricted pointer. This may cause unexpected
behavior.
User Action Make sure restricted pointers point at unique
storage.
3 BADALIGN
Message Invalid alignment boundary.
Description The _align storage class modifier was given an
invalid value. See documentation for valid values on
each platform.
User Action Supply a correct value or remove the _align storage
class modifier.
3 BADANSIALIAS
Message This statement accesses an object <frag1>. The
statement at <loc> accesses the same storage location
<frag2>.
Description The standard allows a compiler to assume that since
these two statements use different types, these two
statements reference different storage locations.
The HP C compiler does so whenever ansi aliasing is
enabled. Since your code relies on these two
statements accessing the same storage location you
should disable ansi aliasing. If you do not do so,
optimization may cause your program to behave
unexpectedly.
User Action Specify noansi_alias on the command line.
3 BADBOUNDCHK
Message <Context> pointer arithmetic was performed more than
once in computing an array element. The bounds
checking code output by the compiler will only verify
the "<expr>" expression.
Description When an array is accessed using pointer arithmetic
and run-time array bounds checking is enabled, the HP
C compiler is only able to output the checking code
for the first pointer arithmetic operation performed
on the array. This can result in an incorrect check
if the resulting pointer value is again operated on
by pointer arithmetic. Consider the expression a = b
+ c - d; where a is a pointer, b an array, and c and
d integers. When bounds checking is enabled the
compiler will output a check to verify that c within
the bounds of the array. This will lead to an
incorrect runtime trap in cases where c is outside
the bounds of the array and c - d is not.
User Action Recode the pointer expression so that the integer
part is in parenthesis. This way the expression will
contain only one pointer arithmetic operation. In
the earlier example the expression would be changed
to a = b + (c - d);
3 BADBOUNDS
Message <Context> the array bounds are incorrectly specified.
Description A multi-dimensional array declaration contains a
missing dimension specifier in a dimension other than
the first.
User Action Correct the declaration.
3 BADBREAK
Message This break statement is not within a for, while, do,
or switch statement.
Description A break statement can only appear inside a for,
while, do, or switch statement.
User Action Remove the break statement, or replace it with a goto
statement.
3 BADC99PRAGOP
Message Invalid syntax for the C99 _Pragma operator, its
operands cannot be recognized.
Description After macro expansion and whitespace has been
removed, the C99 _Pragma keyword must be followed by
exactly three tokens: left-parenthesis,
string-literal (or wide-string), right-parenthesis.
Any other sequence cannot be processed, and will
likely produce other spurious compile-time
diagnostics.
User Action Correct the syntax, or compile in a language mode
that does not recognize the C99_Pragma operator (e.g.
if your code has used this reserved identifier for
some other purpose).
3 BADCHARSINHDR
Message Illegal characters after header name.
Description While processing an #include directive whose argument
did not start with either a '<' or '"' character, the
compiler encountered a character it did not expect.
This most often occurs when the directive argument is
a macro and there is an error during the expansion of
that macro.
User Action Correct the argument to the #include directive.
3 BADCMMNTPSTNG
Message Token concatenation with comments might not be
portable -- use ## operator.
Description A macro body contains a comment between two tokens
with no white space either before or after the
comment. Older C compilers allowed this as a form of
token pasting. This type of token pasting might not
give the desired results with newer compilers.
User Action Use the standard C form of token pasting by replacing
the comment with the ## token pasting operator.
3 BADCOMLITTYPE
Message <Context> the type "<type>" cannot be used to specify
the type of a compound literal.
Description The type of a compound literal must be an object type
or an array of unknown size.
User Action Use a valid type.
3 BADCOMPLEXTYPE
Message <Context> "<spelling>" is an invalid complex type
specifier.
Description The valid complex type specifiers are float _Complex,
double _Complex, and long double _Complex.
User Action Use on of the valid complex type specifiers.
3 BADCONDIT
Message <Context> a common type could not be determined for
the 2nd and 3rd operands ("<true expression>" and
"<false expression>") of a conditional operator.
Description The types of the second and third operands of the
conditional operator must conform to a set of rules
that define what the type of the result of the
conditional operator itself will be. If the types of
these operands do not conform to those rules, the
compiler cannot determine the type of the result,
which is an error. Refer to the language
documentation for a complete list of valid
combinations of types for the second and third
operands of the conditional operator.
User Action Modify the conditional expression so that the types
of the second and third operands conform to the
language rules.
3 BADCONSTEXPR
Message Syntax error in constant expression.
Description A preprocessing constant expression contained a
syntax error. The preprocessor was expecting to find
a constant value or a left parenthesis. The
preprocessor will assume a value of zero was
encountered.
User Action Correct the preprocessing constant expression.
3 BADCONTINUE
Message This continue statement is not within a for, while,
or do statement.
Description A continue statement can only appear inside a for,
while, or do statement.
User Action Remove the continue statement, or replace it with a
goto statement.
3 BADCONVSPEC
Message <Context> this argument to <function name> contains a
bad conversion specification "<incorrect conversion>"
that will cause unpredictable behavior.
Description The compiler has detected an illformed conversion
specification (flags, width, precision, length
modifier) or an unknown conversion specifier (not
diouxefgcspn...) that will cause unpredictable
behavior. This might not have been what you
intended.
User Action Review the documentation for this function and modify
the conversion specification as appropriate.
3 BADDCL
Message The name "<name>" cannot be undefined.
Description The code has tried to #undef a macro that is
predefined by the C standard. This is not allowed.
The #undef will be ignored.
User Action Remove the #undef directive.
3 BADDECLSPEC
Message Invalid argument to __declspec. Valid arguments are
"thread" or "__thread".
Description The only valid arguments to the __declspec storage
class modifier are "thread" or "__thread".
User Action Either use one of the valid arguments, or remove the
storage class modifier.
3 BADDEFARG
Message Bad argument for "defined" operator.
Description The defined preprocessing operator was given an
invalid argument. The operator expects an identifier
optionally enclosed in parenthesis. The value of the
operator is undefined.
User Action Supply a valid argument to the preprocessing
operator.
3 BADENUM
Message Invalid enumerator.
Description While processing an enumerator list, the compiler was
expecting to encounter an identifier, but it found
something else instead.
User Action Correct the program syntax.
3 BADENUMREDECL
Message <Context> the enum "<tag>" cannot be given a type
other than signed int because the tag was declared
earlier at <where>.
Description This enum tag would normally be given a type other
than signed int because the enumeration constants
used in the declaration exceed the range of signed
int. The compiler cannot use the extended type
because the enum tag was declared earlier, and given
signed int type at that point.
User Action Remove the earlier tag declaration.
3 BADEXPR
Message Invalid expression.
Description An invalid expression was encountered.
User Action Correct the program syntax.
3 BADFATCOMMENT
Message The compiler cannot recover.
Description In certain cases, the compiler cannot proceed after
an unterminated comment. In these cases this message
will be issued. Note that this message is always
output after the opencomment error has been output.
User Action Terminate the comment before the end-of-file.
3 BADFBDAT
Message <text> contains invalid feedback data
Description A feedback file contains data, but it was corrupt and
could not be used.
User Action Create a new feedback file.
3 BADFBFILE
Message Invalid feedback file: <text>
Description The compiler was unable to read information from the
specified feedback file.
User Action Make sure the feedback file contains valid feedback
information.
3 BADFBTYP
Message Unexpected file type for feedback file <text>
Description The file specified in the -feedback option does not
have the file type expected by the compiler.
User Action Use a valid feedback file.
3 BADFLOATTYPE
Message <Context> this floating point type "<type>" is not
supported on this platform.
Description The IEEE floating types __s_float and __t_float are
not supported on the VAX platform.
User Action Change the type to a floating type that is supported
on VAX, or compile the application on a platform that
does support IEEE floating.
3 BADFORMALPARM
Message This token may not appear in a formal parameter list.
Description While processing the formal parameter list of a macro
definition, the compiler encountered an invalid
formal parameter specifier. The macro will be be
defined and this token will ignored, but that may not
have been what you intended.
User Action Correct the formal parameter list so that it consists
of a comma separated list of identifiers.
3 BADFORSTOCLS
Message The declaration in a for loop can only have storage
class auto or register.
Description The declaration in a for loop contains a storage
class specifier other than auto or register. This is
not allowed.
User Action Correct the storage class.
3 BADFUNCSTOCLS
Message The storage class of function <name> cannot be
<storage_class>. This storage class has been changed
to 'extern'.
Description The globalref storage class cannot be used with a
function declaration. The compiler will use the
storage class extern.
User Action Remove the globalref storage class from the function
declaration.
3 BADGLOBALTYPE
Message This declaration has type "<type>", which is invalid
for a globalvalue. The extern_model strict_refdef
will be used instead.
Description An object with globalvalue storage class can only
have a type of integer, enum, or pointer type. In
other cases, the compiler will change the storage
class from globalvalue to strict_refdef.
User Action Change the data type to be one that is valid for a
globalvalue.
3 BADHEADERNM
Message Invalid include file or header name specification.
Description An #include directive was not followed by a valid
argument. The directive will be ignored. The
#include directive should be followed by either a
file specification enclosed in angle brackets, a file
specification enclosed in quotes, or an identifier
that specifies a text module (OpenVMS only), or a
macro to be expanded.
User Action Supply a valid argument to the #include directive.
3 BADHEXCONST
Message Hex constant value too large.
Description A hex constant used in a preprocessor directive is
too large. The value of the constant will be
undefined.
User Action Decrease the value of the constant.
3 BADIDENTUCN
Message Invalid UCN encountered in an identifier.
Description An identifier contained a Universal Character Name
(UCN) that did not conform to the requirements of C99
Annex D for use of UCNs in identifiers.
User Action Specify a valid UCN sequence.
3 BADIFDEF
Message An #ifdef or #ifndef is not followed by an
identifier.
Description An #ifdef or #ifndef preprocessing directive was not
followed by an identifier. The compiler will
consider the preprocessor argument to be an
identifier that is not defined. Therefore, in these
cases an #ifdef will always be FALSE, and an #ifndef
will always be TRUE.
User Action Supply a valid identifier to the directive.
3 BADIFNDEFARG
Message #ifndef argument is not an identifier.
Description An #ifndef preprocessing directive was not followed
by an identifier. The compiler will consider this to
be a TRUE condition.
User Action Supply a valid identifier to the directive.
3 BADINCLDIR
Message The #pragma include_directory must not appear after
an #include directive or in a /FIRST_INCLUDE file
after the first /FIRST_INCLUDE file has been
processed. The directive will be ignored.
Description There are several restrictions on the placement of
the #pragma include_directory directive. It must not
appear after any #include directive has been
encountered. Also, if /FIRST_INCLUDE is specified on
the command line, all #pragma include_directory
directives must be placed in the first file in the
/FIRST_INCLUDE list (if there is more than one in the
list) or in the the main source before any #include
directives (if there is only one file in the
/FIRST_INCLUDE list).
User Action Place the directive in a valid location.
3 BADINCLDIRSIZE
Message The include_directory string length must be at least
one and must be less than <max>. The directive will
be ignored.
Description The #pragma include_directory directive does not
support an empty string argument. Also the directory
must not exceed the longest directory specification
supported on this platform.
User Action Specify a valid length string.
3 BADINCLUDE
Message An #include directive has illegal syntax.
Description An #include directive was not followed by a valid
argument. This message occurs when the argument
starts with a '<' or '"' character, but does not end
with a matching delimiter. In this case the compiler
will add the matching delimiter to the end of the
argument and process the directive normally.
User Action Correct the argument to the #include directive.
3 BADLINEDIR
Message Missing argument for #line directive.
Description An argument was not supplied to a #line preprocessing
directive. This directive must be followed by a
digit sequence that specifies the line number or a
macro that expands to a digit sequence. The
directive will be ignored.
User Action Supply a valid argument to the directive.
3 BADLINEDIRTV
Message Illegal token in #line directive.
Description A #line directive was followed by an invalid
argument. The #line directive should be followed by
either a digit sequence or a digit sequence followed
by a string literal. The #line directive will be
ignored.
User Action Supply a valid argument to the #line directive.
3 BADLINKREG
Message Invalid register "<register>" for linkage pragma.
Pragma is ignored.
Description The compiler encountered bad register specifier in a
#pragma linkage directive. The message should point
at the offending specifier. The compiler will ignore
the entire pragma.
User Action Correct the directive.
3 BADLINNUM
Message Ignoring the line number for the #line directive --
too small.
Description A #line preprocessing directive specified a line
value that is either zero or less than zero. This is
not valid. The directive will be ignored.
User Action Either remove the directive or supply a positive
value to the line specifier.
3 BADLOCALE
Message The compiler could not set its locale to either the
locale-specific native environment or the "C" locale.
Description During start-up, the compiler was unable to set its
locale. As part of its initialization, the compiler
will issue the call setlocale(LC_ALL, ""). If this
call fails, the compiler will try to issue the call
setlocale(LC_ALL, "C"). If this call also fails, the
compiler will issue this message and abort.
User Action The best way to determine why the compiler is failing
is to write a small program that contains the same
library calls the compiler is making and then examine
the return values.
3 BADMACROINLN
Message Illegal token from macro call in #line directive.
Description A #line directive was followed by a macro whose
expansion did not form a valid argument to the
directive. The #line directive should be followed by
either a digit sequence or a digit sequence followed
by a string literal. The #line directive will be
ignored.
User Action Supply a valid argument to the #line directive.
3 BADMACRONAME
Message "<directive>" directive is not followed by an
identifier and is being ignored.
Description A #define or #undef preprocessing directive was not
followed by an identifier. The first argument to
these directives must be an identifier that specifies
the macro to define or undefine. The compiler will
ignore the directive.
User Action Correct the argument to the preprocessing directive.
3 BADMBCOMMENT
Message An invalid multibyte character was encountered in a
comment.
Description An invalid multibyte character was found in a
comment. While this will not affect the program
execution, it might not have been what you intended.
User Action Correct the multibyte character.
3 BADMCRORECURS
Message Recursive expansion of macro "<name>" exceeded <num>
levels and was terminated.
Description In certain cases, the compiler will allow a macro to
be recursively expanded. In these cases, the
compiler limits the level of the recursion to prevent
the compiler from looping to the point where it
consumes all available memory. When this level has
been reached, this message is output.
User Action Rewrite either the macro definition or the macro
invocation so that the recursion ends before the
compiler limit is reached. Note that the use of
recursive macros is not a feature of the C standard,
and most other C compilers will not support this.
3 BADMEMBER
Message Invalid member declaration.
Description A struct or union contains an invalid member
declaration. In most cases this error occurs when a
semi-colon was omitted from the previous member
declaration.
User Action Correct the declaration.
3 BADMEMOFF
Message <Context> multiple definitions of member "<name>"
found with different offsets.
Description In certain modes, the compiler will allow a struct or
union reference whose right operand is not a member
of the struct or union type of the left operand.
This is allowed for compatibility with other
compilers. However, in these cases the right operand
must specify a member name that is declared with the
same type and at the same offset in every struct or
union type that declares it. This message is issued
when the compiler finds member name it is looking for
declared with a different offset in more than one
struct or union type.
User Action HP recommends that the left operand or a struct or
union reference specify a member that is a member of
the type of the struct or union specified by the
right operand. If this modification cannot be made
then the member specified by the left operand must be
declared at the same offset and with the same data
type in all struct or union declarations that declare
that member.
3 BADMEMTYP
Message <Context> multiple definitions of member "<name>"
found with different types.
Description In certain modes, the compiler will allow a struct or
union reference whose right operand is not a member
of the struct or union type of the left operand.
This is allowed for compatibility with other
compilers. However, in these cases the right operand
must specify a member name that is declared with the
same type and at the same offset in every struct or
union type that declares it. This message is issued
when the compiler finds a member name it is looking
for declared at the same offset but with different
types in more than one struct or union type.
User Action HP recommends that the left operand or a struct or
union reference specify a member that is a member of
the type of the struct or union specified by the
right operand. If this modification cannot be made
then the member specified by the left operand must be
declared at the same offset and with the same data
type in all struct or union declarations that declare
that member.
3 BADMODULEID
Message Invalid identifier found immediately following
"#pragma module" or "#module" directive.
Description The #pragma module or #module directive must be
followed by an identifier that specifies the module
name used by the linker.
User Action Correct the directive.
3 BADMULTIBYTE
Message An invalid multibyte character was encountered <in
type of construction>.
Description An invalid multibyte character was encountered. The
message will provide additional information about the
location and attempted use of the character.
User Action Correct the multibyte character.
3 BADNUM
Message <text> Qualifier value '<text>' is not an integer
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 BADOCTCONST
Message Octal constant value too large.
Description An octal constant used in a preprocessor directive is
too large. The value of the constant will be
undefined.
User Action Decrease the value of the constant.
3 BADOPCCAP
Message <text> instruction used is not in the selected
instruction set
Description The compiler has output an instruction that is not in
the instruction set selected on the command line.
One way this can happen is to compile a program which
contains a floating point operation and specifying
that no floating point instructions should be
generated.
User Action Either modify the source so the instruction will not
be necessary, or use a different instruction set.
3 BADOPENBRACE
Message This open brace may be missing a close brace and
causing the syntax error at <location>.
Description This message is always output to the terminal after
another syntax error. It is intended to provide the
programmer with additional information that may
identify the cause of the syntax error. This message
may, or may not, provide useful information. In
general, the more consistent the coding style in the
source function, the more likely this message will be
accurate.
User Action Correct the program syntax.
3 BADPARSEDECL
Message In this declaration, "<id>" must specify a type.
Description In processing a declaration, the type of the
declarator has not been declared as a typedef.
User Action Either declare the type as a typedef, or correct the
spelling of the type specifier in this declaration.
3 BADPARSEPARAM
Message In this parameter list, "<param>" must either be a
type or must be followed by a ",".
Description In processing a function declaration, the compiler
has found a case where the parameter list begins with
two identifiers not separated by a comma and where
the first identifier is not a type specifier. If
this is an old-style declaration the two identifiers
must be separated by a comma. If this is a prototype
declaration, the first identifier must specify a
type.
User Action Correct the function parameter specifiers.
3 BADPPDIR
Message File ends in an unfinished pp directive.
Description An unexpected end-of-file was encountered during a
preprocessing directive.
User Action Correct the directive.
3 BADPRAGMAARG
Message Unexpected or missing argument to #pragma <pragma
name>. Pragma is ignored.
Description An argument to a #pragma preprocessing directive is
either missing or is not correct. The compiler will
ignore the directive.
User Action Correct the directive.
3 BADPRAGMAARG1
Message Unexpected token encountered in pragma. Found
"<found>" when expecting <expecting>. The pragma
will be ignored.
Description While parsing a #pragma directive, the compiler has
encountered something unexpected. The message will
contain information about what the compiler was
expecting as well as what it found.
User Action Correct the offending directive.
3 BADPRAGMALINK
Message A bad linkage pragma was specified. Pragma is
ignored.
Description The compiler encountered a bad #pragma linkage
directive. The error message should point to the
place in the pragma that the compiler considers bad.
The compiler will ignore the entire pragma.
User Action Correct the directive.
3 BADPRAGNAMES
Message Invalid argument to the pragma names directive.
Pragma is ignored.
Description An invalid argument has been specified for the
#pragma names preprocessing directive.
User Action Correct the argument to the pragma.
3 BADPREFIX
Message Argument to extern_prefix is not a recognized keyword
or a quoted string. Pragma is ignored.
Description An invalid argument has been specified for the
#pragma extern_prefix preprocessing directive. The
directive expects either the identifiers "save",
"__save", "restore", "__restore", or a string
constant that specifies the external prefix to use.
The compiler will ignore the pragma.
User Action Correct the argument to the pragma.
3 BADPROTYP
Message Unexpected file type for profile file <text>
Description The file specified in the -feedback option does not
have the file type expected by the compiler.
User Action Use a valid feedback file.
3 BADPTRARITH
Message <Context> performing pointer arithmetic on a pointer
to void or a pointer to function is not allowed. The
compiler will treat the type as if it were pointer to
char.
Description Pointer arithmetic is not allowed on pointers to
function or void types For compatibility with some
other compilers, an output file is still created.
The result produced will be the same as if the
pointer were a pointer to char. This may or may not
be compatible with other compilers that accept this
syntax.
User Action Cast the pointer type to a pointer to object type
before performing the arithmetic.
3 BADREGISTER
Message <Context> "<name>" has register storage class, but
occurs in a context that precludes register storage.
The storage class has been changed to auto.
Description An object that was declared with register storage
class has been referenced in a way that is not valid
for a register. The most common example is taking
the address of an object declared with register
storage class. As certain array accesses also
require taking the address of an array, this message
can also be output for accessing the element of an
array declared with register storage class. The
compiler will change the storage class from register
to auto.
User Action Either remove the register storage class from the
declaration, or change the reference to be one that
is valid for objects with register storage class.
3 BADRETURNTYPE
Message <Context> a function cannot return <type> type.
Description A function return type cannot be an array or function
type.
User Action Correct the function declaration so that the return
type is valid.
3 BADSEVERITY
Message The severity of message id <name> cannot be made less
severe. The severity for this message was not
changed.
Description The severities of the compiler's error and fatal
messages cannot be changed to a severity that is less
severe. The compiler's fatal messages cannot be
changed to any other severity. The compiler's error
messages can only be changed to fatals.
User Action Remove the pragma or compiler option that tried to
change the severity.
3 BADSTATICCVT
Message <Context> the address cannot be converted to the
destination type.
Description A static initialization tried to convert a link-time
address to another type. However, the linker on this
platform will not support such a conversion.
User Action Rewrite the static initialization, or perform the
initialization using runtime code.
3 BADSTDLINKAGE
Message If standard_linkage is used, it must be the only
characteristic specified.
Description The standard_linkage characteristic cannot be used
with any other linkage characteristic.
User Action Correct the pragma.
3 BADSTMT
Message Invalid statement.
Description An invalid statement was encountered. The most
common cause of this error is when a declaration
appears after the first statement in a compound
statement.
User Action Correct the program syntax.
3 BADSTMT1
Message Invalid statement. This condition may have been
caused by an open brace without a matching close
brace. The compiler will attempt to identify open
braces that might be missing a close brace.
Description An invalid statement was encountered. This condition
may have been caused missing close brace. This
message is followed by some number of additional
messages that attempt to identify
User Action Correct the program syntax.
3 BADSUBSCRIPT
Message <Context> an array subscript expression is either
less than zero or greater than the largest value that
can be represented by the size_t type.
Description The compiler has detected an array subscript
expression that is outside the bounds of any valid
array. The array access might cause unpredictable
behavior.
User Action Specify a valid array subscript.
3 BADTARGMACRO
Message The target macro "<name>" does not match the
compiler's target. This will likely cause incorrect
code paths to be taken.
Description On OpenVMS I64, some users have tried defining the
macro __ALPHA explicitly using /DEFINE or a #define
in a /FIRST_INCLUDE file as a quick way to deal with
source code conditionals that assume that if __ALPHA
is not defined then the target must be a VAX.
Defining __ALPHA will cause many of the CRTL and
other OpenVMS headers to take the wrong path for I64.
User Action Remove any definitions of Alpha target macros, and if
necessary correct the preprocessor conditionals that
seemed to require an Alpha target macro to get the
desired effect. E.g. change "#ifdef __ALPHA" to
"#ifndef __VAX" or "#if defined(__ALPHA) ||
defined(__ia64)".
3 BADTKEN
Message Lexically invalid token.
Description An invalid token was encountered in a preprocessing
directive.
User Action Correct the preprocessing directive.
3 BADUNKNOWNVLA
Message <Context> a "*" bounds specifier is invalid. Using a
"*" to specify a variable-length array of unknown
size is only valid in declarations with function
prototype scope.
Description Using a "*" as a bounds specifier to designate a
variable-length array with unknown size is only valid
in declarations with function prototype scope.
User Action Supply a valid bound specifier.
3 BADUNROLLVAL
Message The #pragma unroll directive takes a value from zero
to 255. The value "<val>" is outside that range.
The directive will be ignored.
Description The value supplied to a #pragma unroll is outside the
range allowed for the directive. The #pragma
directive will be ignored.
User Action Use a valid value for the unroll count.
3 BADUSELINK
Message A bad use_linkage pragma was specified. Pragma is
ignored.
Description The compiler encountered a bad #pragma use_linkage
directive. The error message should point to the
place in the pragma that the compiler considers bad.
The compiler will ignore the entire pragma.
User Action Correct the directive.
3 BADUSERMACRO
Message The name "<name>" cannot be a user-defined macro.
Description The code has tried to #define either a macro that is
predefined by the C standard or the DEFINED
preprocessing keyword. This is not allowed. The
#define will be ignored.
User Action Remove the #define directive.
3 BADVASTART
Message <Context> old-style parameter "<name>", with type
that requires default argument promotion, cannot be
used with va_start.
Description It is invalid for the parameter specified in va_start
to be one that requires default argument promotion.
User Action The recommended fix is to recode the function
definition to use a prototype-format definition. It
is also possible to change the parameter declaration
to use one of the default types, for example double.
3 BIFENABLED
Message The function "<routine name>" is a builtin function
reserved to the compiler, and does not require a
#pragma intrinsic. The function will continue to be
treated as a builtin.
Description A function identifier specified in a #pragma function
intrinsic is the name of a builtin function. These
functions cannot be explicitly enabled, they are
always handled as builtin functions.
User Action Remove the inappropriate use of the pragma.
3 BIFNEEDSSTD
Message <Context> use of "<function>" is not allowed in a
function with a non-standard linkage. This function
was given the linkage "<name>" by a #pragma
use_linkage directive.
Description Certain built-ins that return information about a
function call require that the function be called
with standard linkage. Because this function appears
in a #pragma use_linkage directive naming a linkage
that specifies attributes other than
standard_linkage, these builtins cannot be called
from this function.
User Action Use a standard linkage on this function, remove the
calls to the builtins, or move them to a different
function that is called with standard linkage.
3 BIFNOTAVAIL
Message Built-in function <name> is not available on this
platform.
Description This Alpha built-in function is not available on the
IA64 platform.
User Action See documentation for alternatives.
3 BIFPROTO
Message <Context> the built-in function, "<name>", requires a
prototype declaration from <filename>.
Description Invoking a built-in function requires that the
function be declared before it is invoked. This
should be done by including the header file noted in
the message.
User Action Include the header file before the function is
invoked.
3 BITARRAY
Message The CDD description for <name> specifies that it is
an array of bitfields; It has been converted to a
scalar bitfield.
Description HP C does not allow arrays of bitfields. The
resulting C declaration will be a bitfield of the
same total size as that specified in the CDD
description.
User Action If a bitfield type is acceptable, then no user
action is necessary. If, however, the bitfield type
is not acceptable, then the CDD description should be
altered.
3 BITBADREP
Message <Context> the bitfield type is not an integral type.
Description A bitfield has been declared with a non-integral
type. Standard C requires that all bitfields be
declared with either int, unsigned int, or signed int
type.
User Action Change the type of the bitfield.
3 BITCONSTSIGN
Message <Context> the integer constant "<constant>" does not
have the same sign as the 1-bit bitfield it is being
converted to.
Description Either an unsigned 1-bit bitfield was assigned -1, or
a signed 1-bit bitfield was assigned 1. This may not
be what you intended.
User Action Change the constant to be the appropriate sign.
3 BITFIELDSIZE
Message The CDD description for bitfield <name> specifies a
size greater than 32; The excess is declared
separately.
Description HP C does not allow individual bitfields larger than
32. As a result, a series of bitfields have been
declared whose total size matches that of the CDD
definition.
User Action If the generated definitions are acceptable, then no
user action is necessary. If, however, the generated
definitions are not acceptable, then the CDD
description should be altered.
3 BITNOTINT
Message <Context> the bitfield type is not an int, signed
int, unsigned int or _Bool.
Description A bitfield has been declared with a type other than
int, signed int, unsigned int or _Bool. This is not
allowed by the C standard.
User Action Change the declaration to use one of the allowed
types or compile with a standard mode that allows
this behavior.
3 BITWIDTH
Message <Context> the bitfield width expression
"<expression>" is outside the range <lower> to
<upper>.
Description A bitfield width specifier was either less than zero,
or is greater than the number of bits in an int. In
some modes, the compiler will assume a width
specifier equal to the number of bits in an int.
User Action Use a valid bitfield width specifier.
3 BITWIDTHTYP
Message <Context> the bitfield width expression
"<expression>" does not have an integral type.
Description A bitfield width specifier does not have an integral
type. A bitfield width specifier must be an integral
constant expression.
User Action Correct the width specifier.
3 BLOCKEXTVLA
Message <Context> the block scope identifier "<name>" cannot
be declared with a variably modified type because it
has extern storage class.
Description Only ordinary identifiers with block scope and
without storage class extern, or ordinary identifiers
with function prototype scope can be declared with a
variably modified type.
User Action Correct the declaration.
3 BLOCKINL
Message Block level declarations of inline functions are not
allowed.
Description In C99 standard, block level declaration of inline
functions are prohibited.
User Action Move the inline function declaration to file scope.
3 BLTINARGCNT
Message <Context> an incorrect number of arguments were
passed to the builtin function, "<function
expression>".
Description This message is output on OpenVMS systems when the
number of arguments passed to the builtin function is
not one.
User Action Correct the call to the builtin function.
3 BLTINIMPLRET
Message <Context> for the function "<name>", the implicit
return type of "<type>" is not consistent with the
expected type of "<type>". It will be treated as an
ordinary implicitly defined external function.
Description A function that could be handled internally by the
compiler has not been declared, so an implicit
declaration has been created for the function. The
return value for the function is being used, and the
implicit return type does not agree with what the
compiler expected to see. In such cases, the
function will not be handled internally, but will
instead be called at run time in the usual manner.
This could result in a performance loss, or possibly
incorrect results if the implicit return type is
incorrect.
User Action If the function is intended to refer to the runtime
library routine, the appropriate header file should
be included in the source. Alternatively, a correct
prototype could be provided privately in the source
file. If the function is intended to be a
replacement for the runtime library routine, disable
the intrinsic version by specifying "#pragma
function(function_name)" in the source file.
3 BOOLEXT
Message The _Bool data type is a new feature in the C99
standard. Other C compilers may not support this
feature.
Description This is a new language feature in C99. While having
a standard specification for portability, the feature
may not yet be available in all of the compilers you
use.
User Action Determine whether or not the use of this feature will
cause portability problems for this code.
3 BOOLNA
Message The _Bool keyword is not supported in this language
mode. It will be treated as an identifier in this
compilation.
Description Support for the _Bool keyword is only available in
certain language modes. Support is not present when
the compiler is in VAX C, K & R (common), or strict
ANSI89 standard modes. In these language modes _Bool
will be treated as an identifier.
User Action Compile using one of the other compilation modes.
3 BOUNDADJ
Message The CDD description for <name> specifies
non-zero-origin dimension bound(s); The bound(s) are
adjusted to zero-origin.
Description The CDD description specifies lower bounds(s) for an
array that is non-zero. The resulting C definition
will have the upper bound(s) adjusted for lower
bound(s) of zero.
User Action Verify that all subscript expressions are referencing
the correct array element(s).
3 BOUNDNOTINT
Message <Context> the array bound "<expression>" does not
have an integral type.
Description The compiler has encountered an array-bounds
specifier that is not an integral type. Array-bounds
specifiers must be positive integer constants.
User Action Correct the array-bounds specifier
3 BUGCHECK
Message Compiler bugcheck. Submit a problem report with a
problem description.
Description An unexpected condition occurred in the compiler.
This is most likely caused by a compiler bug.
User Action Reduce the program that is causing the failure as
much as possible. This often leads to a small test
case. Please submit a problem report containing
enough information for Engineering to reproduce the
problem. The problem report should include the small
test case.
3 CALLNEEDSFUNC
Message <Context> "<expression>" is not a function.
Description In what appears to be a function call, the expression
denoting the the function to call is neither the
identifier for a function nor an expression of type
pointer to function.
User Action Correct the expression denoting the function. If the
expression is a simple identifier, perhaps a
function-like macro definition is missing.
3 CANNOTREDEF
Message Cannot #define a macro that is currently expanding.
Description The program is trying to #define the same macro it is
currently expanding. The #define will be ignored.
User Action Remove the #define, or move it after the expansion of
the macro.
3 CANNOTUNDEF
Message Cannot #undef a macro that is currently expanding.
Description The program is trying to #undef the same macro it is
currently expanding. The #undef will be ignored.
User Action Remove the #undef, or move it after the expansion of
the macro.
3 CANTDISABLE
Message The message id <name> cannot be disabled.
Description The compiler's error and fatal messages cannot be
disabled.
User Action Remove this message id from the list of messages
being disabled on the command line or in the #pragma
message line.
3 CANTMKRPSTORY
Message Attempt to create repository "<string>" for shortend
names failed; OpenVMS status: <reason>.
Description A compilation that used the /NAMES=SHORTENED
qualifier could not open the repository used to store
the shortened names. This could be because an
invalid name was specified in the /REPOSITORY
qualifier. The message will give additional
information about the failure.
User Action Correct whatever caused the failure.
3 CDDATTR
Message One or more field descriptions in this CDD record
specify an attribute that is being ignored.
Description The CDD description specifies an attribute that is
not supported in HP C. The attribute is ignored.
User Action No action is required.
3 CDDBADID
Message An invalid identifier, <name>, is being ignored in
the dictionary directive.
Description An unexpected identifier follows the dictionary
pathname in a dictionary preprocessing directive.
The identifier is ignored.
User Action Remove the invalid identifier(s) in the dictionary
directive.
3 CDDEXT
Message #dictionary is a language extension.
Description The #dictionary directive is an extension of HP C on
OpenVMS. The program might not compile with other
compilers or on other platforms.
User Action Be aware of this if you wish to port the program.
3 CDDPATH
Message A valid CDD pathname was not found. The CDD
directive has been ignored.
Description The #dictionary preprocessing directive was not
followed by an argument. The directive must be
followed by a character string that gives the path
name of a CDD record, or a macro that expands to the
path name of the record.
User Action Supply a valid argument to #dictionary. HP also
recommends that the #dictionary preprocessing
directive be replaced by the #pragma dictionary
operator.
3 CDDTOODEEP
Message The attributes for the Common Data Dictionary record
description <name> exceed the implementation's limit
for record complexity.
Description The CDD description specifies more attributes than
the interface between the CDD and the compiler can
handle.
User Action Simplify the record description.
3 CHARCONST
Message Ill-formed character constant.
Description An invalid character constant was encountered.
User Action Correct the character constant.
3 CHAROVERFL
Message A character constant value requires more than
sizeof(int) bytes of storage.
Description A character constant is too long to fit in an int.
The compiler will ignore the extra characters.
User Action Remove the extra characters from the character
constant.
3 CHKEXPAND
Message <number> integrity check error(s) after IL expansion
of routine <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 CHKINIT
Message <number> integrity check error(s) in initial IL & ST
for module <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 CHKOPT
Message <number> integrity check error(s) after <text>
optimization phase for routine <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 CLASSNOINIT
Message <Context> the struct or union object "<name>" is
uninitialized and has a const member.
Description An object of struct or union type has a const member
and has not been initialized. This might not have
been what you intended. HP recommends that you
initialize all objects with the const attribute. The
missing initializer will make this an invalid
declaration in C++.
User Action Initialize the struct or union object.
3 CLOSBRACKET
Message Missing "]".
Description The compiler was expecting a closing bracket, but one
was not found.
User Action Correct the program syntax.
3 CLOSEBRACE
Message Missing "}".
Description The compiler was expecting a closing brace, but one
was not found.
User Action Correct the program syntax.
3 CLOSECOMMENT
Message This unmatched comment delimiter is ignored.
Description An unmatched comment delimiter (*/) is an illegal
combination of unary indirection and binary division
operators that would have caused your compilation to
fail.
User Action Remove the comment delimiter.
3 CLOSEPAREN
Message Missing ")".
Description The compiler was expecting a closing parenthesis, but
one was not found.
User Action Correct the program syntax.
3 CMPPTRFUNVOID
Message <Context> accepting the [in]equality comparison of a
pointer to void and a pointer to function type is a
language extension.
Description Under the C standard, it is a constraint violation to
perform an [in]equality comparison between a pointer
to void and a pointer to function type. Therefore
this code may not be accepted by other compilers.
User Action Cast one of the pointers to the type of the other.
3 COLMAJOR
Message The CDD description for <name> specifies that it is a
column-major array; It has been converted to a
one-dimensional array.
Description The HP C compiler supports only row-major arrays.
Therefore the column-major array description in the
CDD has been converted to a one-dimensional array of
the same total size and with the same total number of
elements.
User Action Verify that all subscript references to the array
reference the correct array element.
3 COMMANDMACRO
Message Extraneous text "<text>" at the end of the command
line macro "<macro>" is ignored.
Description A command line macro define contains an invalid macro
name. The compiler will define the macro name listed
in the message.
User Action Correct the command line invocation.
3 COMPILERBUG
Message Bug found in compiler: <bug>.
Description This message indicates that the compiler detected a
bug within itself.
User Action Please report the compiler bug and include an example
program that reproduces the problem.
3 COMPLEXEXT
Message The complex data type is a new feature in the C99
standard. Other C compilers may not support this
extension.
Description This is a new language feature in the C99 revision of
the standard. While having a standard specification
for portability, the feature may not yet be available
in all of the compilers you use.
User Action Determine whether or not the use of this feature will
cause portability problems for this code.
3 COMPLEXNA
Message The complex data types are not supported in this
language mode. This will be treated as an identifier
in this compilation.
Description Support for the complex data types is only available
in certain language modes. Support is not present
when the compiler is in VAX C, K & R (common), or
strict ANSI89 standard modes. In these language
modes _Complex and _Complex_I will be treated as
identifiers.
User Action Compile using one of the other compilation modes.
3 COMPLEXNA1
Message The complex data types are not supported on this
platform. This will be treated as an identifier in
this compilation.
Description The complex data type is not supported on the VAX
platform.
User Action Remove use of the complex types or compile the
application on a platform that does support the
complex data types.
3 CONFLICTHINTS
Message <Context> this hint value contridicts a related hint
at <where>. The hints will be ignored.
Description This program has supplied hints for either both
branches of an if/else or both the second and third
operand of a conditional operator. In these cases
the two hint values must add to one.
User Action Correct the hints.
3 CONLINKREG
Message Conflicting register usage between "<first set>" and
"<second set>". Pragma is ignored.
Description The same register was specified in two different
register lists of a #pragma linkage directive. The
compiler will ignore the entire pragma.
User Action Correct the directive.
3 CONPSECTATTR
Message Conflicting psect attribute overrides previous
attribute.
Description A psect attribute specified in a #pragma extern_model
directive contradicts an attribute specified earlier
in the directive. This attribute will override the
one specified earlier.
User Action Remove one of the contradictory psect attributes.
3 CONSTCOMPLIT
Message <Context> accepting a compound literal as a constant
is a language extension. The compound literal will
be treated as a cast expression.
Description A compound literal appears in a context where a
constant expression is required. The C standard does
not list compound literals as a form of operand that
is allowed in a constant expression, so using a
compound literal in this context is not maximally
portable. The compiler will treat the compound
literal as if it were a cast expression, which is a
form of operand that the standard lists as being
allowed in constant expressions.
User Action For maximum portability, replace the compound literal
with a cast expression.
3 CONSTFOLDNS
Message <Context> the libraries on this platform do not yet
support compile-time evaluation of the constant
expression "<expression>".
Description Compile-time evaluation of constant expressions
requires underlying support in the libraries
available to the compiler at compile-time, and this
expression contains an operator that is not yet
implemented in those libraries.
User Action If possible, replace part of the constant expression
with a variable of the same value.
3 CONSTFUNC
Message Ignoring const type qualifier in declaration of
<name>.
Description The const type qualifier cannot be used with a
function type. The compiler will ignore the type
qualifier.
User Action Remove the type qualifier.
3 CONSTINWRT
Message Const variable resides in wrt extern model.
Description The current extern model places all external objects
in a modifiable section. Placing an object with a
const type qualifier in such a section means that
there is no run-time protection against writing to
the object. This might not have been what you
intended.
User Action Place const objects in sections that cannot be
modified.
3 CONSTNOINIT
Message <Context> the const object "<name>" is uninitialized.
Description A defined or tentatively-defined const object has not
been initialized. This would not be valid in C++.
It is also considered good programming practice to
initialize all const objects with their value.
User Action Either remove the const type modifier, or supply an
initializer for the object.
3 CONSTSTOCLS
Message <Context> the const object "<name>" has no explicit
storage class. In C, its storage class defaults to
"extern"; in C++, it defaults to "static". Add an
explicit "extern" or "static" keyword.
Description One of the more signifcant and confusing differences
between C and C++ is their treatment of file scope
const objects declared without a storage class. C
will give the object extern storage class, making the
object visible in other compilation units. C++ will
give the object static storage class. This can cause
an undefined symbol error when other compilation
units try to reference the symbol.
User Action Add an explicit "extern" or "static" keyword to the
declaration.
3 CONTFILE
Message A file ends with a continuation character.
Description All source files, even those included via the
#include preprocessing directive, must not end with a
backslash continuation character.
User Action Either remove the continuation character or add an
additional line to the source program that does not
end in a continuation character.
3 CONTROLASSIGN
Message <Context> the assignment expression "<expression>" is
used as the controlling expression of an if, while or
for statement.
Description A common user mistake is to accidentally use
assignment operator "=" instead of the equality
operator "==" in an expression that controls a
transfer. For example saying if (a = b) instead of
if (a == b). While using the assignment operator is
valid, it is often not what was intended. When this
message is enabled, the compiler will detect these
cases at compile-time. This can often avoid long
debugging sessions needed to find the bug in the
user's program.
User Action Make sure that the assignment operator is what is
expected.
3 CONVARASLIT
Message <Context> the use of the const variable "<name>" in
place of a literal constant is a language extension.
Description HP C will allow a non-volatile const variable that
has been initialized to be used in contexts where a
constant is required. For example, as the bounds
specifier to a file scope array. This is an
extension to standard C. Other C compilers might not
successfully compile a program that uses this
extension.
User Action Use the constant value instead of the variable.
3 CRXCOND
Message Common Data Dictionary description extraction
condition.
Description Something went wrong while trying to get the CDD
record description from the CDD. The error message
that follows gives more information about the nature
of the problem.
User Action If necessary, correct the indicated condition in the
CDD record description or with the user environment.
3 CVIDXOVFL
Message module uses more than 65536 CodeView type indices
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 CVTDIFTYPES
Message <Context> "<expression>" of type "<type>", is being
converted to "<target type>".
Description In certain modes, the compiler will allow assignments
or comparisons between pointer and integer types.
This is an extension to standard C. Other C
compilers might not successfully compile a program
that uses this extension.
User Action Use a cast operator to convert one operand to the
other.
3 CVTU32TO64
Message <Context> an unsigned 32-bit integer constant that
has its high-order bit set has been converted to a
signed 64-bit type. The conversion will not
sign-extend.
Description This message indicates a conversion that may produce
unexpected results on this platform because the
destination type is a 64-bit type instead of a 32-bit
type.
User Action If this is the intended behavior, first cast the
constant to an unsigned 64-bit type.
3 CXXCOMMENT
Message C++ style comments (//) may not be portable.
Description C++ style comments have been detected on this line.
Although they have been accepted by HP C in this
language mode, they will not be accepted by all
compilers or by HP C in strict C89 standard mode.
User Action Replace C++ style line comments (//) with equivalent
C comments (/* ... */) if portability is a concern.
3 CXXKEYWORD
Message "<C++ keyword>" is a keyword in C++. Using it as an
identifier in your C program will prevent porting
your program to C++.
Description This identifier is a keyword in C++. The program is,
therefore, not a valid C++ program.
User Action Choose a different name for the identifier.
3 CXXPRAGMANA
Message The HP C++ pragma "<pragma name>" is not supported by
HP C. The pragma will be ignored.
Description The compiler has encountered a pragma that is
supported by HP C++ but is not supported by HP C.
The compiler will ignore the pragma.
User Action Remove the pragma or compile the program with HP C++.
3 DCLMISMATLNK
Message The declaration of "<name>" has <number> parameter(s)
but its linkage "<name>" has <number>. Standard
linkage will be used.
Description The number of parameters specified in a declaration
does not match the number of parameters specified by
the special linkage associated with this function or
typedef. The special linkage was specified via the
#pragma use_linkage directive. Because of this
mismatch, the compiler will ignore the special
linkage and use the standard linkage instead.
User Action Make sure the number of parameters specified by the
special linkage match the number of parameters in the
function.
3 DCLMISMATLNK0
Message The declaration of "<name>" has an unknown number of
parameters and cannot be used with the linkage
"<name>". Standard linkage will be used.
Description If a special linkage specifies parameter information,
the declaration must not specify an unknown or
variable number of parameters. The special linkage
was specified via the #pragma use_linkage directive.
Because of this mismatch, the compiler will ignore
the special linkage and use the standard linkage
instead.
User Action Make sure the number of parameters specified by the
special linkage match the number of parameters in the
function type.
3 DCLMISMATLNK1
Message <where> "<name>" <modifier>has a floating type but
its linkage "<name>" specifies an integer register.
Standard linkage will be used.
Description A parameter or return value of a function type is a
floating type, but the corresponding parameter or
return value in the special linkage specifies an
integer register. The special linkage was specified
via the #pragma use_linkage directive. Because of
this mismatch, the compiler will ignore the special
linkage and use the standard linkage instead.
User Action Make sure the register specified by the special
linkage matches the type of of the corresponding
parameter and return value of the function type.
3 DCLMISMATLNK2
Message <where> "<name>" <modifier>requires an integer
register but its linkage "<name>" specifies a
floating register. Standard linkage will be used.
Description A parameter or return value of a function type is an
integer type, but the corresponding parameter or
return value in the special linkage specifies a
floating register. The special linkage was specified
via the #pragma use_linkage directive. Because of
this mismatch, the compiler will ignore the special
linkage and use the standard linkage instead.
User Action Make sure the register specified by the special
linkage matches the type of of the corresponding
parameter and return value of the function type.
3 DCLMISMATLNK3
Message <where> "<name>" has a size that is incompatible with
the number of registers specified by its linkage
"<name>". Standard linkage will be used.
Description The size of a parameter or return value of a function
type is incompatible with the size specified by the
special linkage. The special linkage was specified
via the #pragma use_linkage directive. Because of
this mismatch, the compiler will ignore the special
linkage and use the standard linkage instead.
User Action Make sure the number of registers specified by the
special linkage match the type of the corresponding
parameter and return value.
3 DCLMISMATLNK4
Message <where> "<name>" <modifier>has a type that is not
allowed because the it has the linkage "<name>".
Standard linkage will be used.
Description Using a special linkage places certain restrictions
on the type of a function's parameters and return
value. In general, the type must be a scalar type
that can be represented by a register or registers on
this platform. In cases where some other type is
used, the compiler will ignore the special linkage
and use the standard linkage instead.
User Action Either remove the name from the #pragma use_linkage
directive that specified the special linkage, or
modify the type to be acceptable to the special
linkage.
3 DCLMISMATLNK5
Message "<name>" has a void return type but its linkage
"<name>" specifies a return location. Standard
linkage will be used.
Description If a special linkage specifies return value
information, the declaration must not specify a void
return type. The special linkage was specified via
the #pragma use_linkage directive. Because of this
mismatch, the compiler will ignore the special
linkage and use the standard linkage instead.
User Action Make sure the return value specified by the special
linkage matches the return type.
3 DCLMISMATLNK6
Message <where> "<name>" <modifier>has float _Complex or
double _Complex type. The corresponding floating
point registers in linkage "<name>" must be
consecutive. Standard linkage will be used.
Description Using a special linkage places certain restrictions
on the type of a function's parameters and return
value. Whenever float _Complex or double _Complex
types are used, they linkage must specify two
consecutive floating point registers. The compiler
will ignore the special linkage and use the standard
linkage instead.
User Action Either remove the name from the #pragma use_linkage
directive that specified the special linkage, or
modify the linkage to use consecutive floating point
registers.
3 DECCONSTLARGE
Message Decimal constant value too large.
Description A decimal constant used in a preprocessor directive
is too large. The value of the constant will be
undefined.
User Action Decrease the value of the constant.
3 DECLAFTERSTMT
Message Placing a declaration after a statement is a new
feature in the C99 standard. Other C compilers may
not support this feature.
Description This is a new language feature in the C99 revision of
the standard. While having a standard specification
for portability, the feature may not yet be available
in all of the compilers you use.
User Action Determine whether or not the use of this feature will
cause portability problems for this code.
3 DECLARATOR
Message Invalid declarator.
Description A declaration did not contain an identifier that
specifies the item to be declared.
User Action Specify a declarator in the declaration.
3 DECLINFOR
Message Placing a declaration in a for loop is a new feature
in the C99 standard. Other C compilers may not
support this extension.
Description This is a new language feature in the C99 revision of
the standard. While having a standard specification
for portability, the feature may not yet be available
in all of the compilers you use.
User Action Determine whether or not the use of this feature will
cause portability problems for this code.
3 DECLSPECEXT
Message __declspec is a language extension.
Description The __declspec storage class modifier is a language
extension of HP C. Other C compilers might not
successfully compile a program that uses the
extension.
User Action Be aware of this extension if you wish to port the
code.
3 DEFINOTHER
Message Another file in this compilation contains an external
definition of a function named "<name>", or declares
it as a variable with external linkage, at <where>.
Description In a compilation where interfile optimization has
been selected (-ifo on UNIX, /PLUS_LIST_OPTIMIZE on
OpenVMS), the compiler has detected more than one
definition of a function using the same external
name, or has found that a function and a variable
have the same external name. An external function
can have only a single definition. And a given
identifier with external linkage can refer either to
a function or to a variable, but not both.
User Action Remove or rename one of the names.
3 DEFINOTHER1
Message The external variable "<name>" was defined as an
external function in another module of this
compilation at <where>.
Description In a compilation where interfile optimization has
been selected (-ifo on UNIX, /PLUS_LIST_OPTIMIZE on
OpenVMS), the compiler has detected a name with
external linkage defined as a variable in one
compilation unit and a function in another.
User Action Remove or rename one of the definitions.
3 DEFINOTHER2
Message This declaration of "<name>" specifies a different
type than the declaration in another module of this
compilation at <where>.
Description In a compilation where interfile optimization has
been selected (-ifo on UNIX, /PLUS_LIST_OPTIMIZE on
OpenVMS), the compiler has detected a name with
external linkage declared with different types in two
different modules. Although the runtime behavior may
be as intended and match the behavior when the
modules are separately compiled without interfile
optimization, the behavior is not well defined unless
the types are compatible.
User Action Modify one or more of the declarations to make the
types compatible.
3 DEFINOTHER3
Message This declaration of "<name>" specifies a different
thread-local attribute than a declaration in another
module of this compilation at <where>.
Description In a compilation where interfile optimization has
been selected (-ifo on UNIX, /PLUS_LIST_OPTIMIZE on
OpenVMS), the compiler has detected a name with
external linkage declared thread-local in one module
and not thread-local in another. This can lead to
unexpected results at runtime.
User Action Modify one the declarations to make the thread-local
attributes match.
3 DEFPARMTYPE
Message There is no declaration for the old-style function
parameter "<name>". Type defaulted to int. This is
a violation of the C99 standard.
Description The parameter of an old-style function definition was
not declared. It will default to int type. Omitting
the type specifier is not valid in C99, and is often
considered poor programming practice.
User Action Declare the parameter. HP also recommends that
old-style function definitions be replaced by
prototype-format definitions.
3 DEFRETURNTYPE
Message The type of the function <name> defaults to "int".
Description A function definition did not include a type
specifier for the function's return value. It will
default to int. This might not be what you intend.
This is also a violation of the C99 Standard.
User Action It is a good programming practice to give all
function definitions explicit return types.
3 DESIGBADARR
Message <Context> , a struct/union designator cannot be used
with an object of array type.
Description An initialization designator must match the type of
the object being initialized. In this
initialization, the current object is an array so a
struct/union designator is not allowed.
User Action Correct the initialization.
3 DESIGBADCOMP
Message <Context> , an array designator cannot be used with
an object of struct or union type.
Description An initialization designator must match the type of
the object being initialized. In this
initialization, the current object is a struct or
union, so an array designator is not allowed.
User Action Correct the initialization.
3 DESIGBADIND
Message <Context> , the constant expression "<expression>" in
an array element designator is not a positive
integer.
Description An array-element designator must be an constant
expression that yields a positive integer value.
User Action Correct the element designator.
3 DESIGBADIND1
Message <Context> , the array element designator
"[<expression>]" specifies an element beyond the end
of the array.
Description An array element designator must specify a valid
array element.
User Action Correct the element designator.
3 DESIGNATIONNA
Message The use of a designation in an initializer list is
not supported in this compilation mode.
Description Initializer lists that contain designations are a new
feature in the C99 revision of the C standard. HP C
will only support this extension in relaxed mode and
strict c99 mode.
User Action Use a compilation mode that supports the use of
designations.
3 DESIGNATORUSE
Message The use of a designation in an initializer list is a
new feature in the C99 standard.
Description Initializer lists that contain designations are a new
feature in the C99 revision of the C standard. Other
compilers may not support this feature.
User Action Be aware of this portablility issue.
3 DESIGNOMEMB
Message <Context> , the component designator "<name>" is not
a member of the current structure or union object
being initialized.
Description An initialization designator specifies a struct or
union member that is not a member of the current
struct or union object.
User Action Correct the initialization.
3 DESIGSCALAR
Message <Context> , a designator cannot be used with an
object of scalar type.
Description An initialization designator can only be used on
objects of array, structure, or union type. In this
initialization, the current object being initialized
is a scalar type so a designator is not allowed.
User Action Correct the initialization.
3 DIFFEXMODEL
Message This redeclaration of "<name>" specifies a different
extern model than a previous declaration of the
variable at <location>.
Description Two declarations of the same variable use different
extern models. The extern model is specified by a
#pragma extern_model directive that appears before
the declaration in the source. This redeclaration
may cause unexpected behavior.
User Action All declarations of a variable should use the same
extern model.
3 DIFFTYPEQUALS
Message <Context> the type of "<name>" has different type
qualifiers than the previous declaration at
<location>. The resulting type will be the composite
of the two types.
Description The C standard permits redeclaration and formation of
a composite type only when the two types being
considered are compatible, and types with different
type qualifiers are not compatible. HP C allows this
redeclaration for consistency with some other C
compilers, and will form a composite type with all of
the type qualifiers from both declarations. Be aware
that these declarations may not be accepted by other
C compilers.
User Action Modify the declarations so that they use identically
qualified types.
3 DIRECTVNOCPP
Message "<Directive text>" is not recognized as a
preprocessing directive in nopreprocessing mode, and
is being ignored.
Description An invalid preprocessing directive was encountered in
a compilation performed with the -nocpp option. When
using the -nocpp option, only a limited number of
preprocessing directives, such as #pragma and #line,
can appear in the program. The compiler will ignore
the rest of the line.
User Action Either remove the directive or compile without the
-nocpp option.
3 DISREDECL
Message <Context> the type of the external "<name>" is not
compatible with the type of a declaration of "<name>"
in another name scope at <location>.
Description The same external identifier has been declared in
different scopes with incompatible types. This might
not have been what you intended.
User Action Change all declarations of the same external
identifier to use the same type.
3 DOLLARID
Message Extension: A '$' was encountered in an identifier.
Description Accepting a "$" character in an identifier is an
extension of HP C. The program might not compile
with other C compilers.
User Action Be aware of this if you wish to port the program.
3 DONOTAPPLY
Message linkage, assert or hint information for built-in
function <name> is ignored.
Description A built-in function is always handled specially.
There is no actual function call to which linkage,
assert or hint information could be applied.
User Action Remove the name of the built-in function from this
pragma.
3 DUPCASE
Message The switch statement containing this case label
already has a case label for "<number>".
Description A switch statement contains more than one case label
for the same case value.
User Action Remove the duplicate case label.
3 DUPDEFAULT
Message The switch statement containing this default label
already has a default label.
Description A switch statement can contain only one default
label.
User Action Remove the duplicate default label.
3 DUPENUM
Message <Context> the enumerator "<name>" is not unique.
Description An enumerator constant is declared more than once
with the same value. While this is accepted by HP C,
it is not allowed by the C standard.
User Action Either use a different enumerator name or remove the
previous declaration of the name.
3 DUPEXTERN
Message The declaration of "<name1>" will map to the same
external name as the declaration of "<name2>" at
<where>.
Description The compiler has detected a case where two different
names in a program will map to the same external name
in the output object file. This can cause
unpredictable results at runtime. This will most
often happen when the /NAMES=UPPERCASE or
/NAMES=LOWERCASE qualifier causes two names with
different case spellings to map to the same external
name.
User Action Either use the /NAMES=AS_IS qualifier, or modify one
of the names.
3 DUPLABEL
Message The label "<name>" is already defined in this
procedure at <location>.
Description A label has already been defined. Each function can
define each label only once.
User Action Remove the duplicate label definition.
3 DUPLINK
Message Duplicate linkage pragmas for linkage name "<linkage
name>".
Description The same linkage specifier has been defined in more
than one #pragma linkage directive.
User Action Declare each linkage only once.
3 DUPLPRAGASS
Message #pragma assert directive specified for the function
name <name> while different #pragma assert was
specified for its type.
Description Duplicate assertion can't be specified for a
function. Check whether #pragma assert was
mistakenly specified for the same function more than
once, or function's type is declared in a typedef
which in turn has its own #pragma assert directive.
User Action Either remove duplicate #pragma assert directive, or
change assertions, or fix spelling of the function
name or typedef.
3 DUPPARM
Message <Context> "<name>" is a duplicate parameter name.
Description The parameter identifier list of an old-style
function definition uses the same identifier more
than once.
User Action Each identifier in the parameter list must be unique.
HP also recommends that old-style function
definitions be replaced by prototype-format
definitions.
3 DUPSTATIC
Message There is a redundant use of the keyword "static" in
this array declaration.
Description In C99 the keyword "static" may appear at most once
in the outermost array-bounds specifier of a function
parameter in a function prototype.
User Action Remove redundant occurrences(s) of "static" from the
array declaration
3 DUPSTORCLS
Message <Context> the same storage class modifier occurs more
than once.
Description This declaration specifies the same storage class
modifier more than once.
User Action Remove the extra uses of the storage class modifier.
3 DUPTYPEDEF
Message <Context> "<name>" has a duplicate typedef at
<where>. This might not be portable.
Description The same typedef has been declared to the same type
more than once. Standard C does not allow this and
other compilers might not accept it.
User Action Remove the redundant declaration.
3 DUPTYPESPEC
Message <Context> the same type specifier occurs more than
once.
Description The same type specifier appears more than once in the
same declaration. The redundant specifier will be
ignored.
User Action Remove the duplicate type specifier.
3 DUPTYPQUAL
Message <Context> there is a redundant use of type qualifier
"<const or volatile>".
Description The same type qualifier appears more than once in a
type specifier. This violates the C89 standard.
Other compilers may not accept this program. Note
that C99 will allow redundant qualifiers.
User Action Remove the redundant type qualifier.
3 ELIFIGNORED
Message Out of place #elif directive ignored.
Description An #elif preprocessing directive was encountered
outside of an #if/#endif body. The directive will be
ignored.
User Action Remove the directive.
3 ELLIPSEARG
Message Standard C does not permit the use of an ellipsis as
an only argument.
Description Standard C requires at least one formal parameter be
declared before the ellipses. This declaration might
not be portable to other C compilers.
User Action Recode the function declaration to contain at least
one formal parameter.
3 ELLIPSEPARM
Message <Context> a parameter with type "<type>" matches an
ellipsis in previous declaration at <location>.
Description A function that has been previously declared as
taking variable arguments is now redeclared as using
a different number of formal parameters before the
start of the variable argument list. This
redeclaration might not be portable to other C
compilers.
User Action Recode the function declarations to match each other.
3 ELLIPSISEND
Message No tokens may follow ... in a formal parameter list.
Description The ellipsis may only appear at the end of a formal
parameter list. Everything after that is being
ignored.
User Action Remove the unexpected token.
3 ELSEIGNORED
Message Out of place #else directive ignored.
Description An #else preprocessing directive was encountered
outside of an #if/#endif body. The directive will be
ignored.
User Action Remove the directive.
3 EMBEDCOMMENT
Message A comment is neither preceded nor followed by white
space.
Description A comment is neither preceded nor followed by white
space. In certain modes the compiler will paste the
tokens before and after the comment together to form
a single token. This behavior is not valid in
standard C. Writing programs that rely on this
behavior might prevent the program from being
compiled on other platforms.
User Action Add white space before or after the comment, or use
the ## operator to paste tokens together.
3 EMPTYCHARCONST
Message Empty character constant.
Description In some modes the HP C compiler will allow a null
character constant. The compiler will give this
constant a value of zero. Accepting an empty
character constant is a language extension. Empty
character constants are not valid in standard C.
Writing programs that rely on this behavior might
prevent the program from being compiled on other
platforms.
User Action Replace the empty character constant with '\0'.
3 EMPTYFILE
Message Source file does not contain any declarations.
Description This source file contains no declarations. This
might not have been what you intended. For example,
perhaps a necessary macro was not defined.
User Action Every source program should contain at least one
declaration.
3 EMPTYINIT
Message An initializer list without an expression is not
valid. The compiler will replace the empty
expression with the constant 0.
Description The C standard requires that an initializer list
contain an expression. The compiler has encountered
one without an expression. The compiler will treat
the empty list ({}) as if it contained a single zero
({0}). This is for compatibility with some other C
compilers. Be aware that this syntax may not be
accepted by other C compilers.
User Action Supply an expression to the initializer.
3 EMPTYOBJ
Message Empty object file due to errors.
Description An earlier condition will cause an empty object
module to be created.
User Action Correct the condition that was reported earlier.
3 EMPTYSTRUCT
Message Allowing struct/union type with no members is a
language extension.
Description The C standard requires that a struct/union type have
at least one member. The HP C compiler will accept
this for compatibility with older compilers. The
struct/union type will be treated as if it were
declared { : 0; }
User Action Provide at least one member for the struct/union.
3 ENUM16BIT
Message <Context> the enumeration constant <name> is out of
the range -32768 to 32767. This might not be
portable.
Description An enum constant is larger than can be represented in
16 bits. This would not be portable to a system with
an int size of 16 bits.
User Action Be aware of this if you wish to port to a system with
an int size of 16 bits.
3 ENUMCALC
Message <Context> the enum variable "<expression>" is used in
an arithmetic operation.
Description An enumerated type variable was used in an arithmetic
operation. While this is valid in C, it might not
have been what you intended.
User Action Verify the use of the enum variable.
3 ENUMINIT
Message <Context> the enumerator "<name>" is initialized to
the nonintegral value "<expression>".
Description An enum declaration contains an enumeration constant
initializer that does not have an integer type. The
initializer for an enumeration constant must be an
integral constant expression.
User Action Correct the initializer.
3 ENUMRANGE
Message <Context> the enumeration constant "<name>" is out of
range INT_MIN to INT_MAX and will be truncated.
Description An enumeration constant must be representable as an
int type. The specified value is outside the range
of an int. In modes where this is a warning, the
compiler will use the low-order bits to form the int
value.
User Action Use a valid constant value.
3 ENUMSANDINT
Message <Context> allowing an enumeration type and a signed
int to be compatible may not be portable.
Description The standard states that enumeration types shall be
compatible with an integer type. HP C, along with
most other C compilers, has chosen the signed int
type to be compatible with enumeration types. Other
compilers may chose another type such as unsigned int
(the C standard even allows an implementation to
choose different integer types depending on the
values of the enumeration constants defined for the
type). Therefore this program may not be accepted by
other C compilers.
User Action Insert a cast to make the types the same.
3 ENUMSNOTCOMPAT
Message <Context> allowing two different enumeration types to
be compatible is a language extension.
Description The HP C compiler allows two objects of different
enumeration types to be compatible. The C standard
specifies that enumeration types are distinct types.
Therefore this program is not standard compliant and
other C compilers may not accept it.
User Action Use the same enumeration type or cast one type to the
other.
3 ENUMUSED
Message <Context> the enumerator name "<name>" has been used
previously.
Description The specified enumerator name has been previously
declared as something other than an enumerator.
User Action Either use a different enumerator name or remove the
previous declaration of the name.
3 ENVIRSTKDIRTY
Message At the end of the compilation the pragma <name> stack
was not empty. This may indicate a coding error.
Description The program being compiled has saved the named pragma
state more often than it has restored it. Good
coding practice calls for the pragma state to be
restored some point after it has been saved. This
condition may indicate the accidental failure to
restore the state.
User Action Make sure each pragma save has a corresponding pragma
restore.
3 ERRORLIM
Message diagnostic message limit exceeded
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 ERRORMESSAGE
Message #error<errormsg>
Description An #error directive was encountered. This message
will include the text that follows the directive in
the source program.
User Action Remove the #error directive, or supply the proper
macro definitions so that the compiler will skip the
directive.
3 ESCOVERFL
Message Invalid escape sequence encountered.
Description An escape sequence in a character or string literal
specifies a value outside the range of a character or
wide character.
User Action Specify a valid escape sequence.
3 EXPANDEDDEFINED
Message Macro expansion includes the token "defined", which
will be treated as an operator. This might not be
portable.
Description A macro expanded during the processing of a
preprocessor #if directive included the token
"defined". The HP C compiler will treat this as the
defined preprocessing operator. Other compilers
might treat this differently.
User Action Rewrite the macro not to use the "defined" operator.
3 EXPNOTRES
Message expression does not contribute to result
Description The compiler has detected a source expression that
does not contribute to the result. This may not be
what you expected.
User Action Verify the expression is what you intend.
3 EXPRCVTINT
Message The expression "<expression>" has been converted to
integer.
Description In certain modes, HP C will allow switch expressions
or case constants to be non-integer types. The
expression or constant will be converted to int. In
one of these cases, this warning will be issued.
User Action Cast the switch expression to an integer type or use
an integer case constant.
3 EXPRNOTINT
Message The expression "<expression>" has <type> type, which
is not integral.
Description An expression that is required to have an integer
type had a type that is not integral. This is not
valid. An example of a situation where an integer is
required is that in most modes HP C requires that the
switch control expression have integer type.
User Action Modify or cast the expression so that it has integer
type.
3 EXPRNOTUSED
Message <Context> the expression "<expr>" is never used.
Description The compiler has detected an expression that is not
used, and might not have a side-effect. This might
not have been what you intended.
User Action If the expression has a desired side-effect, the
message can be ignored. Otherwise, you might want to
consider removing the expression.
3 EXTENDTYPE
Message This platform specific type is a language extension.
Description The use of the types __int8, __int16, __int32,
__int64, or other type specifiers beginning with
leading double underscores might not be portable to
other platforms or to other C compilers.
User Action Be aware of this portability concern.
3 EXTERNINIT
Message HP C allows the initialization of a variable with
extern storage class. This differs from the VAX C
behavior.
Description VAX C does not allow a variable with extern storage
class to be initialized. HP C will allow this, even
in vaxc mode.
User Action Be aware of this difference if you plan to compile
the source with VAX C.
3 EXTERNPOP
Message This "restore" has underflowed the extern model's
stack. No corresponding "save" was found.
Description The extern_model stack, managed by the #pragma
extern_model and #pragma environment directives,
contains more restores than saves. This could
signify a coding or logic error in the program.
User Action Make sure each restore has a corresponding save.
3 EXTPREAFTER
Message This directive will not set the extern_prefix of
"<name>" because there is a previous declaration of
the identifer with external linkage at <where>.
Description When an identifier is specified in a #pragma
extern_prefix, the declaration of that identifier
must appear after the #pragma.
User Action Reorder the declaration and the #pragma so that the
#pragma comes first.
3 EXTPREAGAIN
Message This directive overrides the extern_prefix for
"<name>" specified by an earlier #pragma
extern_prefix at <where>.
Description Two #pragma extern_prefix directives have specified
different non-empty extern_prefixes for the same
identifier. In such cases the later directive will
set the extern_prefix for the identifier.
User Action If it is necessary to respecify the extern_prefix for
an identifier, first remove the prefix (by setting it
to an empty string) and then specify the new prefix
in a subsequent #pragma.
3 EXTPRENODECL
Message There is no identifier named "<name>" with external
linkage declared in this compilation unit.
Description A #pragma extern_prefix directive specifies an extern
prefix for an identifier that is not declared with
external linkage in the compilation unit. This may
not have been what you intented.
User Action Remove the identifier from the #pragma extern_prefix,
or declare it with external linkage, or set the
prefix for this identifier to an empty string.
3 EXTRABRACES
Message <Context> , the value is enclosed within too many
pairs of braces.
Description An initializer contains too many open braces for the
object being initialized.
User Action Reduce the number of braces.
3 EXTRAMODULE
Message Redundant "#pragma module" or "#module" directive
ignored.
Description A compilation unit can contain only one #pragma
module or #module directive. All subsequent
directives will be ignored.
User Action Remove the extra directives.
3 EXTRAPRAGARGS
Message Extra pragma arguments to #pragma <pragma> were
found. Pragma is ignored.
Description Unexpected arguments were found at the end of a
#pragma directive. The directive will be ignored.
User Action Remove the extra arguments.
3 EXTRASEMI
Message Extraneous semicolon.
Description An extra semicolon was found at the end of a
declaration. It will be ignored.
User Action Remove the extra semicolon.
3 FALLOFFEND
Message The last statement in non-void function "<name>" is
not a return statement.
Description A function that returns a value does not end with a
return statement. If function execution reaches the
end of the function, the implied return statement
that executes will return an undefined value. This
might not have been what you intended.
User Action End the function with a return statement that
specifies a return value.
3 FBFILENOTFOUND
Message Feedback file not found: <text>
Description The specified feedback file could not be found by the
compiler.
User Action Specify the correct file name.
3 FILECLOSE
Message An error occurred while attempting to close a source
file: <problem>.
Description An unexpected error occurred while closing a source
file. The message text will contain additional
information about the failure.
User Action Correct the condition that caused the failure.
3 FILENOTFOUND
Message File not found: <text>
Description The specified file could not be found by the
compiler.
User Action Specify the correct file name.
3 FILEREAD
Message An error occurred while attempting to read a source
file: <problem>.
Description An unexpected error occurred while reading a source
file. The message text will contain additional
information about the failure.
User Action Correct the condition that caused the failure.
3 FILESCOPEVLA
Message <Context> the file-scope identifier "<name>" cannot
be declared with a variably modified type.
Description Only ordinary identifiers with block scope and
without storage class extern, or ordinary identifiers
with function prototype scope can be declared with a
variably modified type.
User Action Correct the declaration.
3 FINBRANCH
Message A goto to the label "<label>" branches into a finally
handler.
Description A goto statement tried to transfer into a finally
handler. This is illegal.
User Action Modify the goto or move the label outside the
handler.
3 FLEXARRAYELEM
Message <Context> allowing an array element to be a struct
with a flexible array member is a language extension.
Description The C99 standard allows the final element of a struct
with more than one named member to have incomplete
array type. Such a member is called a flexible array
member. The standard does not allow such a struct
(and any union containing, possibly recursively, a
member that is such a struct) to be an array element.
Other C compilers may not support this extension.
User Action Be aware of this extension if you wish to port the
code.
3 FLEXARRAYMEM
Message <Context> allowing the struct member, "<name>" to be
a struct with a flexible array member is a language
extension.
Description The C99 standard allows the final element of a struct
with more than one named member to have incomplete
array type. Such a member is called a flexible array
member. The standard does not allow such a struct
(and any union containing, possibly recursively, a
member that is such a struct) to be a member of
another structure. Other C compilers may not support
this extension.
User Action Be aware of this extension if you wish to port the
code.
3 FLOATCONSQUAL
Message The <float_const_qual> is not valid in strict ANSI
mode and will be ignored.
Description The -float_const option cannot be used in strict ANSI
mode. The option will be ignored.
User Action Either remove the -float_const option or use a
different mode.
3 FLOATCONST
Message Ill-formed floating constant.
Description An invalid floating constant was encountered.
User Action Correct the floating constant.
3 FLOATERR
Message <Context> a floating point error occurs in evaluating
the expression "<expression>".
Description A floating-point error occurred while evaluating a
constant expression. This is often caused by an
invalid floating-point number. The value of the
expression is undefined.
User Action Correct the floating-point constant expression.
3 FLOATOVERFL
Message <Context> floating-point overflow occurs in
evaluating the expression "<expression>".
Description A floating-point overflow occurred while evaluating a
constant expression. The value of the expression is
undefined.
User Action Correct the floating-point constant expression.
3 FLOATTOINT
Message <Context> "<expr>" is being converted from <type>
type to int type.
Description The C language requires that this expression be of
integer type. In most cases the compiler will emit
an error for this case. In VAX C mode, the compiler
emits this warning and converts the expression to int
type. This matches the behavior of VAX C.
User Action If the VAX C behavior is what you intended, cast the
expression to int to silence the diagnostic.
Otherwise, recode the expression to reflect your
intent.
3 FMTNOTSTR
Message argument <number> of this function is not of type
char * but corresponds to the format string specified
by the #pragma assert directive at <location>. The
format func_attr will be ignored.
Description The format attribute causes the format string to be
checked if it is a string constant. The format
parameter can't be a format string because it is not
declared as a char * type. The format attribute will
be ignored.
User Action Either remove the format assertion from the
directive, correct the position of the format
argument in the assertion, or declare the format
argument as a "char *" in the proper position in the
function prototype.
3 FNAMETOOLONG
Message The file name "<name>" in this directive is too long.
Description A preprocessing directive has specified a file name
that is too long for this platform.
User Action Supply a valid file name
3 FORMATATTR
Message <Context> the arguments to <function name> do not
match the assertions of its format attribute. The
format argument or the argument preceeding the first
argument to check is missing.
Description The format attribute of this function asserts that
the format argument exists and will be checked if it
is a string constant. The first argument to check,
if non-zero, identifies the argument corresponding to
the ellipsis in the function declaration and asserts
that the argument preceeding it exists.
User Action Modify either the function call or the format
attribute so that they match.
3 FOUNDCR
Message A carriage-return character was encountered; it is
being treated as white space.
Description The compiler encountered a carriage-return character
some place other than inside a character or string
constant. The compiler will treat the
carriage-return as white space.
User Action The source might have been created by some
non-standard means. If possible, replace all
carriage-return characters outside of character or
string constants with white space.
3 FREGNEEDSIEEE
Message Use of the floating register "<regnum>" in a #pragma
linkage directive requires the /FLOAT=IEEE_FLOAT
qualifier.
Description On IA64, VAX floating-point data is passed in general
registers. HP C requires that any program that uses
a floating point register in a linkage directive must
be compiled with IEEE floating-point.
User Action Compile with IEEE floating-point. Another option
would be to remove the floating point registers from
the linkage.
3 FUNCELEMENT
Message <Context> the element type of an array type is a
function type.
Description The compiler has encountered an array with an element
type of function. An array element must be an object
type.
User Action Change the type of the array element.
3 FUNCIDLIS
Message <Context> the identifier "<id>" is not the name of a
type. All parameter information in this declaration
will be ignored.
Description The declaration is most likely a malformed
prototype-style function declaration. In a
prototype-style declaration, each parameter must have
a type. The identifier named in the message might be
intended to be the (optional) name of a formal
parameter and the type specification was mistakenly
omitted, or it might be intended to be the name of a
type but no typedef declaration for it is visible.
Alternatively, the declaration might be intended to
correspond to an old-style function definition, and
mistakenly contains a formal parameter name in the
declaration. Old-style function definitions list the
names of formal parameters (without types) inside the
parentheses, but old-style function declarations
contain nothing inside the parentheses.
User Action Correct the declaration.
3 FUNCINIT
Message The declaration of the function "<name>" includes an
initializer.
Description A function declaration cannot contain an initializer.
User Action Remove the initializer from the declaration.
3 FUNCMEM
Message The member <name> has a function type.
Description A struct or union member is declared with function
type. This is not valid.
User Action Correct the member declaration.
3 FUNCMIXPTR
Message <Context> function types differ because this
declaration specifies "<type1>" and a previous
declaration specifies "<type2>".
Description A function redeclaration differs from an earlier
declaration of the same function because the pointer
size of one of the arguments or the return result is
different.
User Action Use the same pointer size for all declarations of the
function.
3 FUNCNOTDEF
Message The function "<name>" has non-extern storage class,
occurs in a context that requires its definition, and
has no definition. The storage class has been
changed to extern.
Description In certain modes, the compiler will allow a static
function to be declared within the scope of another
function. If this function is referenced, then it
must also be defined in the compilation unit. If the
function is not defined, this message will be output,
and the earlier static declaration will be changed to
extern.
User Action Define the static function with compilation unit.
3 FUNCNOTFUNC
Message In this function definition, "<name>" has <type> type
instead of a function type.
Description A function definition does not have a function type.
This can occur if the definition did not contain an
open/close parenthesis pair.
User Action Change the definition to specify a function type.
3 FUNCREDECL
Message <Context> function types differ because one has no
argument information and the other has an ellipsis.
Description Two function types, used in an operation or a
redeclaration of a function, are different because
one uses ellipses and the other does not. Older
compilers will accept this, but it is not valid
standard C.
User Action If used in an operation, a cast should be inserted.
If used in a redeclaration, the redeclaration should
be removed or modified.
3 FUNCSTORCLS
Message <Context> a function has an explicit storage class
other than "static" or "extern".
Description This declaration specifies a storage class that is
not valid for a function. If an explicit storage
class is used in a function declaration, it must be
either static or extern.
User Action Either remove the storage class specifier, or use one
of the valid storage classes.
3 FUNCSTORMOD
Message <Context> a function cannot have this storage class
modifier. Modifier ignored.
Description A function cannot be declared with this storage class
modifier. The only valid storage class modifier for
a function declaration is __inline. The modifier is
ignored by the compiler.
User Action Remove the storage class modifier from the function
declaration.
3 FUNCSTRCLS
Message The block-level declaration of the function "<name>"
specifies an explicit storage class other than
extern.
Description A block-level declaration of a function has specified
an explicit storage class other than extern. HP C
will change the storage class to extern.
User Action Either remove the storage-class specifier, or change
it to extern.
3 FUTUREKEYWD2
Message "inline" is a keyword in the C99 revision of the C
standard. Using it as an identifier will prevent
your program from conforming to that standard.
Description The token inline has been selected as a keyword in
the C99 release of the C standard. Because the
program uses it as an identifier, the program will
not conform to that standard.
User Action Change the name of the identifier.
3 FUTUREKEYWORD
Message "restrict" is a keyword in the C99 revision of the C
standard. Using it as an identifier will prevent
your program from conforming to that standard.
Description The token restrict has been selected as a keyword in
the C99 release of the C standard. Because the
program uses it as an identifier, the program will
not conform to that standard.
User Action Change the name of the identifier.
3 GBLOUTSIDEINT
Message <Context> the globalvalue constant <value> is outside
the range of type int. This may cause unexpected
results.
Description The C compiler does not support globalvalue constants
larger than int. The compiler preserves only the
low-order 32 bits of the value, which will be
sign-extended by the linker if the symbol is used in
a certain contexts requiring a 64-bit value. This
may cause unexpected results.
User Action Use constants within the range of type int to
initialize globalvalues, or use more portable
constructs such as macro definitions or global
const-qualified variables to share constant values
among compilation units.
3 GBLREFINIT
Message The declaration of "<name>" specifies the globalref
storage class and includes an initializer.
Description A declaration with storage class globalref cannot
include an initializer.
User Action Either remove the initializer or use a storage class
that will allow an initializer.
3 GCCINLINE
Message The inline and __inline keywords will be interpreted
with GCC style semantics. To get C99 semantics,
please specify -accept nogccinline.
Description The C99 standard has a slightly different
interpretation of the keyword inline than in GCC.
The GCC __inline keyword also differs from the HP C
__inline keyword.
User Action Use the command line specifier -accept nogccinline.
3 GEMARGSIZE
Message <Context> the size of "<expression>" exceeds the
implementation's limit of 2147483647 bytes on the
size of a function argument.
Description The size of a function argument exceeds the HP C
implementation limit.
User Action Either reduce the size of the argument or consider
passing it by reference.
3 GLOBALEXT
Message A storage class of globaldef, globalref, or
globalvalue is a language extension.
Description These storage classes are language extensions of HP
C. Other C compilers might not successfully compile
a program that uses the extension.
User Action These storage classes can be recoded using the more
portable #pragma extern model. <code_example>
globaldef int var1; globalref int var2; globalvalue
int var3; <endcode_example> Can be written as:
<code_example> #pragma extern_model save #pragma
extern_model strict_refdef int var1; extern int var2;
#pragma extern_model globalvalue extern int var3;
#pragma extern_model restore <endcode_example> For
more information, consult the #pragma extern_model
documentation.
3 GOTSZOVFL
Message GOT table overflow for module <text>
Description The object file required for this module is too
complex.
User Action Break the source program into several pieces so the
individual objects will be simpler.
3 HEXOCTSIGN
Message In VAX C mode, the compiler will give this constant a
signed type for compatibility with VAX C. This
differs from the behavior specified in the C
standard, which would give this constant an unsigned
type.
Description The C standard specifies that an octal or hexadecimal
integer constant has an unsigned type when its value
cannot be represented in a signed integer type, but
can be represented in the corresponding unsigned
integer type. Some older compilers, such as VAX C,
will treat this constant as having a signed type. In
VAX C mode, the compiler matches the behavior of VAX
C. In other modes the compiler matches the behavior
specified in the standard.
User Action Be aware that this difference may cause porting
problems if this program is compiled in a mode other
than VAX C mode, or with a compiler that does not
support this old behavior.
3 HEXOCTUNSIGN
Message The HP C compiler conforms to the C standard and will
give this constant an unsigned type. Some older
compilers may give this constant a signed type.
Description The C standard specifies that an octal or hexadecimal
integer constant has an unsigned type when its value
cannot be represented in a signed integer type, but
can be represented in the corresponding unsigned
integer type. Some older compilers will treat this
constant as having a signed type.
User Action Be aware of this difference if you plan to port this
source to an older compiler.
3 HINTNOTFUNC
Message The identifier "<ident>" is not a declared function.
It will be ignored in this #pragma hint func_attrs
list.
Description The identifiers in a #pragma hint func_attrs must be
declared functions.
User Action Either declare the function prior to the pragma or
remove the identifier from the pragma.
3 HINTTOOBIG
Message <Context> this hint value must not be greater than
one. The hint will be ignored.
Description This #pragma hint directives must take positive
floating point values which is not greater than one.
User Action Correct the hint.
3 IDEXPECTED
Message Identifier expected but not found.
Description The compiler was expecting an identifier, but one was
not found.
User Action Correct the program syntax.
3 IDINPARENSEXT
Message <Context> accepting an identifier enclosed in
parentheses as the second argument to va_start is a
language extension.
Description The C standard states that the second argument to
va_start must be an identifier. For compatibility
with other C compilers, HP C will accept an
identifier enclosed in parentheses. Be aware that
this program does not conform to the standard and may
be rejected by other compilers.
User Action Remove the parentheses.
3 IDPACKPOPPRAG
Message The identifier <name> from the pragma pack pop
directive was not found on the top of the pragma pack
stack.
Description The identifier specified in the #pragma pack (pop,
<identifier>) directive was not found on the top of
the pragma pack stack. A previous #pragma pack pop
or #pragma member_alignment restore may have already
popped this identifier off the stack, the identifier
may not have been previously pushed onto the stack,
or extra elements are pushed on the stack on the top
of element with the identifier, or the identifer may
be spelled incorrectly.
User Action Check the spelling of the identifier. Verify that
the identifier was previously pushed onto the pack
stack and not popped off by another #pragma pack pop
or #pragma member_alignment restore, and all elements
pushed on the top of the identifier are popped.
Correct the directive(s).
3 IEEEASSUMED
Message Use of /ROUNDING_MODE qualifier implies /FLOAT=IEEE.
Compilation will be performed as if /FLOAT=IEEE were
specified on the command line.
Description This compilation has specified an IEEE floating-point
rounding mode without specifying /FLOAT=IEEE on the
command line. The compiler will set the
floating-point type to IEEE floating.
User Action Specify /FLOAT=IEEE on the command line.
3 IEEEASSUMED1
Message Use of /IEEE_MODE qualifier implies /FLOAT=IEEE.
Compilation will be performed as if /FLOAT=IEEE were
specified on the command line.
Description This compilation has specified an IEEE floating-point
mode without specifying /FLOAT=IEEE on the command
line. The compiler will set the floating-point type
to IEEE floating.
User Action Specify /FLOAT=IEEE on the command line.
3 IGNORECALLVAL
Message <Context> the value returned from the function
"<expression>" is not used - if this is intended, it
should be cast to "void".
Description A function that returns a value has been invoked, yet
the value was not used. This might not have been
what you intended.
User Action Cast the function to void to suppress the message.
3 IGNOREEXTRA
Message Spurious token(s) ignored on preprocessor directive
line.
Description A preprocessing directive was supplied more arguments
than it expects. The extra arguments will be
ignored.
User Action Remove the extra arguments.
3 IGNORETAG
Message <Context> the tag "<name>" is redeclared, but will be
ignored.
Description The "struct" or "union" before the tag used in this
declaration does not match that in the declaration of
the tag. The "struct" or "union" at the earlier
declaration of the tag will be used in this
declaration.
User Action Either change the current declaration to match the
declaration of the tag, or create a new tag
containing the different type.
3 IGNORETOKENS
Message # not in column 1 is ignored, skipping to end of
line.
Description In K & R mode, white space is not allowed before a
preprocessing directive. The compiler will ignore
this source line.
User Action Either remove the white space or compile in a mode
other than K & R.
3 IGNORSYSREG
Message Ignoring system register specified in routine's
linkage.
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 IMAGINARYNA
Message The _Imaginary keyword is not supported by HP C. It
will be treated as an identifier in this compilation.
Description Support for the _Imaginary keyword is an optional
extension to the C standard. HP C does not support
this extension. All occurrences of _Imaginary will
be treated as an identifier.
User Action Do not use the _Imaginary type.
3 IMPFNCFALLOFF
Message The last statement in non-void function "<name>" is
not a return statement.
Description This message indicates that a function with an
implicit return type of it does not end with a return
statement. If function execution reaches the end of
the function, the implied return statement that
executes will return an undefined value. This might
not have been what you intended.
User Action Consider declaring the function to be a void
function. If it is supposed to return a value, add a
return statement with the value the function is to
return.
3 IMPFNCMSSNGRET
Message Non-void function "<name>" with implicit return type
int does not contain a return statement.
Description This message indicates that a function with an
implicit return type of int does not contain a return
statement. This message is not issued for functions
with an explicit return type. See message
MISSINGRETURN.
User Action Consider declaring the function to be a void
function. If it is supposed to return a value, add a
return statement with the value the function is to
return.
3 IMPLICITFUNC
Message <Context> the identifier "<name>" is implicitly
declared as a function.
Description A expression contained a reference to a function that
has not been declared. The C99 standard requires
that all referenced functions must be declared before
they are referenced.
User Action Declare the function before it is referenced.
3 INCARGTYP
Message Type of actual argument inconsistent with formal
parameter declaration in <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 INCARRAYPARM
Message <Context> using array syntax to declare a parameter
that is a pointer to an incomplete array type may not
be portable.
Description Although this array parameter declaration conforms to
the C standard (since it is equivalent to a pointer
to the inner array), other C compilers may not accept
it.
User Action Be aware of this difference if you plan to port this
source to another compiler.
3 INCARRAYPARM1
Message <Context> allowing an array parameter that has more
than two unspecified element counts is a language
extension.
Description Because this parameter declaration will cause an
array of incomplete types to be created, it does not
conform to the C standard. Although some other C
compilers will accept this declaration, many
compilers will reject it.
User Action Be aware of this difference if you plan to port this
source to another compiler.
3 INCLUDENOPEA
Message A non-default pointer size or member alignment is
specified, and the header files in <directory> are
not protected. This might yield unpredictable
results. The protect_headers_setup script can help.
See the protect_headers_setup(8) man page for
details.
Description Using a non-default pointer size or member alignment
can cause unpredictable results for system header
files that are not protected and that rely on the
default pointer size or alignment.
User Action Examine the man page referenced in the message for
more information.
3 INCLUDEOPEN
Message An error occurred while attempting to open the
include file <name>: <problem>.
Description An unexpected error occurred during the opening of an
include file. The message text will contain
additional information about the failure.
User Action Correct the condition that caused the failure.
3 INCLUDEPROEPI
Message Cannot include files in a prologue or epilogue file.
Description It is not possible for a prologue or epilogue file to
perform an #include directive. This might lead to
nested inclusion.
User Action Remove the #include directive from the
prologue/epilogue file.
3 INCOMPARRY
Message <Context> the member <name> has incomplete array
type. This is not strictly conformant with the C
standard and might not be portable.
Description The compiler has detected an array without a bounds
specifier to be part of a struct or union type. The
C89 standard does not allow members of this type.
The C99 standard will allow only the final member of
a struct with more than one named member to be of
this type. Other C compilers might not successfully
compile a program that uses this extension.
User Action Specify the bounds if possible.
3 INCOMPARRY1
Message <Context> the last member of a union, or a struct
with only one named member, <name>, has incomplete
array type. This is not strictly conformant with the
C standard and might not be portable.
Description The compiler has detected an array without a bounds
specifier to be part of a struct or union type. The
C89 standard does not allow members of this type.
The C99 standard will allow only the final member of
a struct with more than one named member to be of
this type. Other C compilers might not successfully
compile a program that uses this
User Action Be aware of this extension if you wish to port the
code.
3 INCOMPARRY2
Message <Context> the last member of a struct with more than
one named member, <name>, has incomplete array type.
This does not conform to the C89 standard.
Description The C89 standard does not allow struct members to be
an array without a bounds specifier. The C99
standard will allow the final member of a struct with
more than one named member to be an incompete type.
Other C compilers may not support this C99 extension.
User Action Be aware of this if you wish to port the code to a
compiler that does not support C99.
3 INCOMPCALL
Message <Context> the return type of "<expression>" is
incomplete.
Description A function with an incomplete return type other than
void cannot be invoked.
User Action Complete the function return type before the function
is invoked.
3 INCOMPDEREF
Message <Context> "<expression>" is a pointer to an
incomplete struct or union and should not be used as
the left operand of a member dereference.
Description In certain modes, HP C will allow the struct or union
specifier of a member dereference operator (->) to
specify a struct or union that does not contain the
element specified by the right operand. While this
is considered poor programming practice, it was
common with older C compilers. In cases where the
left operand is a pointer to an incomplete type, the
practice is considered even worse. While HP C will
accept the construct in certain modes, the code
should be modified. Further, this program does not
conform to the C standard and might not be accepted
by other C compilers.
User Action Be aware of this if you wish to port the program.
3 INCOMPELINIT
Message <Context> , an array's element type is incomplete,
which precludes its initialization.
Description In order to initialize an array, the array element
type must not be incomplete.
User Action Either remove the initializer or complete the array
element type before this point in the program.
3 INCOMPELMNT
Message <Context> the element type of an array type is
incomplete.
Description The element type of an array type is incomplete at
the point in the program where the array is declared.
While HP C will allow this if the element type is
completed later, other compilers might require the
type to be complete at this point in the program.
User Action Either complete the type before the array
declaration, or be aware of this if you wish to port
the program.
3 INCOMPMEM
Message The member "<name>" has an incomplete type.
Description A struct or union member must not have an incomplete
type. An exception is that HP C will accept a member
that is an array with unspecified bounds, although
warnings are often generated for this case.
User Action Complete the type before it is used in as a member of
a struct or union.
3 INCOMPNOLINK
Message In this declaration, "<name>" has no linkage and is
of an incomplete type.
Description A declaration with no linkage cannot specify an
incomplete type. Incomplete types can only be used
for identifiers with external or internal linkage.
User Action Either complete the type before the declaration or
modify the declaration to specify an external or
internal linkage.
3 INCOMPPARM
Message In the definition of the function "<function name>",
the parameter "<parameter name>" has an incomplete
type.
Description This function definition contains a parameter with an
incomplete type other than an array whose bounds are
not specified. This is not valid.
User Action Complete the type before the function definition.
3 INCOMPRETURN
Message In the definition of the function "<name>", the
return type is an incomplete type other than void.
Description A function definition cannot specify a return type
that is an incomplete type except for the void type.
User Action Complete the type before the function definition.
3 INCOMPSTAT
Message The static declaration of "<name>" is a tentative
definition and specifies an incomplete type.
Description This file scope static declaration declares an
identifier with incomplete type. This is not valid
because a static declaration will allocate storage
for the object, but the object's size is not known at
this point in the compilation.
User Action Complete the type before the static declaration.
3 INCOMPSTATARR
Message Allowing the declaration of a static array with an
incomplete type is a language extension.
Description The HP C compiler will allow an incomplete array type
to appear in a static file scope declaration for
compatibility with other compilers. This is an
extension to the standard. Other compilers may
reject this declaration.
User Action Either use a complete type in this declaration, or
change the storage class to extern.
3 INCOMPTENT
Message The type of the tentatively-defined variable "<name>"
is incomplete at the end of the compilation unit.
Description This file-scope declaration with no storage-class
specifier declares an identifier with incomplete
type. The type must be completed before the end of
the compilation unit.
User Action Complete the type.
3 INCOMPVALUE
Message <Context> "<expression>" has incomplete type, and so
cannot be used as an rvalue.
Description It is not possible to get the value of an expression
with incomplete type.
User Action Complete the type before its value is used.
3 INCOMPVOID
Message <Context> the element type of an array type is
incomplete. The void type cannot be completed.
Description The compiler has encountered an array with an element
type of void. An array element must be an object
type.
User Action Change the type of the array element.
3 INCONSASSFUN
Message A function "<name>" appeared in more than one #pragma
assert/hint func_attrs specifying the same
assertion/hints.
Description A function can appear on more than one #pragma assert
or #pragma hint func_attrs as long as each #pragma
specifies a different assertion/hint about the
function. The assertion will be ignored.
User Action Either remove the #pragma, or remove the function
name from the pragma, or correct its spelling.
3 INITCONFLICT
Message Overlapping static storage initializations detected
at Psect <text> + <number>
Description The compiler back-end as detected a case where the
same storage location has been initialized to more
than one value. This can occur when inter-file
optimization has been enabled.
User Action Remove one of the initializers.
3 INITOVERLAP1
Message <Context> , this initializer list will provide a
value for a subobject that was initialized by the
earlier initializer "<init>".
Description This initializer list will provide a value for a
subobject that has already been initialized. While
this is valid, it might not have been what was
intended.
User Action Initialize each subobject only once.
3 INITVLA
Message A variable-length array declaration cannot contain an
initializer. The initializer will be ignored.
Description A variable-length array declaration cannot contain an
initializer.
User Action Initialize the array using assignment statements
after the declaration.
3 INLINEIG
Message An inline specifier may only be used to declare an
identifier for a function. The inline keyword will
be ignored.
Description The inline, __inline or __forceinline keywords have
been used on a non-function type. Or a non-function
type has been listed in a #pragma inline or #pragma
forceinline directive
User Action Remove the keyword or remove the identifier from the
pragma.
3 INLINESTOCLSMOD
Message The <__inline or __forceinline> storage class
modifier is a language extension and might not be
portable.
Description The __inline and __forceinline storage class
modifiers are an extension of HP C. Other C
compilers might not successfully compile a program
that uses the extension.
User Action Be aware of this extension if you wish to port the
code.
3 INPTRTYPE
Message <Context> this argument to <function name> is of
"<type name>" type and is not appropriate for the
conversion specifier "<incorrect conversion>". The
value may overwrite other data or produce unexpected
results.
Description The compiler has detected an input conversion
specifier that does not match its corresponding
argument. The corresponding argument may not be a
pointer or may point to data that is wider or
narrower than that specified by the conversion
specifier. This might not have been what you
intended.
User Action Modify either the argument or the conversion
specifier so that they match.
3 INSUFALN
Message Alignment specified for extern model is insufficient
for variable. Extern model alignment updated.
Description The current extern model places all external objects
in a section whose alignment is not sufficient for
the alignment of an object being placed in that
section. The compiler will update the alignment of
the section so that it is adequate for the object.
User Action Either increase the alignment of the section or move
the object to another section.
3 INTBADLINKAGE
Message #pragma use_linkage was applied to the intrinsic
function "<routine name>". The function will be
treated as an ordinary external function.
Description Trying to optimize a pointer argument passed to an
intrinsic function, the compiler discovered that
#pragma use_linkage had been applied to the function
declaration. The intrinsic function of this name
that is understood by the compiler does not allow you
specify a linkage. Therefore the compiler must
assume that you are supplying your own function
definition, and treat this as a call to an external
function with no special properties.
User Action If you want to call the intrinsic function, remove
the #pragma use_linkage directive. If you are
supplying your own function definition, you may want
to rename the function or add a #pragma function
directive for it.
3 INTCONCASTSGN
Message <Context> casting of the constant "<constant>" to
<type> type will cause a change in sign.
Description Either a negative constant value has been cast to an
unsigned type, or a positive value has been cast to a
signed type and will be treated as a negative number
after the cast.
User Action Change the constant so that the sign will match the
type of the cast.
3 INTCONCASTTRU
Message <Context> casting of the constant "<constant>" to
<type> type will cause data loss.
Description A constant is cast to a type that is too small to
hold the constant value. Data will be lost in the
conversion.
User Action Remove the cast, or use a smaller constant.
3 INTCONST
Message Ill-formed integer constant.
Description An invalid integer constant was encountered.
User Action Correct the integer constant.
3 INTCONSTSIGN
Message <Context> conversion of the constant "<constant>" to
<type> type will cause a change in sign.
Description Either an unsigned type was assigned a negative
constant value, or a signed type was assigned a
positive contant value which will be evalated as a
negative number after the assignment. Note that this
message is not output for assignments to 1-bit
bitfields. The message bitconstsign is generated in
that case.
User Action If this is what you intended, cast the constant to
the desired type. You might also want to change the
constant to the correct signed or unsigned value in
order to avoid the optional message intconcastsgn,
which reports sign changes caused by casts.
3 INTCONSTSIGNED
Message This integer constant value will be given the type
long long int. This is compatible with the C99
standard. Older versions of the compiler would have
given this unsigned long int type.
Description With the introduction of the long long int type, the
C99 standard changed the rules for how the type of
certain integer constants are determined. Unsuffixed
decimal constants which are too large for long int,
but could fit in an unsigned long int are given the
type long long int in C99. Prior to C99 these would
be given unsigned long int type.
User Action Be aware of this difference.
3 INTCONSTTOOBIG
Message This integer constant is too large for the long long
type. It will be given the unsigned long long type.
Description The C99 standard specifies that a decimal constant
must fit in a signed type. This constant is too
large for the long long int type. For compatibility
with older versions of the compiler, the constant
will be given the unsigned long long type.
User Action Append a 'U' suffix to the constant. This will force
it to be unsigned.
3 INTCONSTTRUNC
Message <Context> conversion of the constant "<constant>" to
<type> type will cause data loss.
Description A constant is converted to a type that is too small
to hold the constant value. Data will be lost in the
conversion.
User Action If this is what you intended, cast the constant to
the desired type. You might also want to mask off
the high-order bits before casting in order to avoid
optional message intconcasttru, which reports data
loss caused by casts.
3 INTCONSTUNSIGN
Message This integer constant value will be given the type
unsigned long int. This is compatible with the C89
standard and older compilers. The C99 standard
requires this to be a signed long long int.
Description With the introduction of the long long int type, the
C99 standard changed the rules for how the type of
certain integer constants are determined. Unsuffixed
decimal constants which are too large for long int,
but could fit in an unsigned long int are given the
type long long int in C99. Prior to C99 these would
be given unsigned long int type.
User Action Be aware of this difference.
3 INTERNALPRAGMA
Message This is an internal pragma which should only be used
by the compiler development team. It should not
appear in user programs as it may cause unexpected
behavior.
Description This pragma exists only to allow the compiler
developers to test certain functionality of the
compiler. Its use outside the development team is
unsupported.
User Action Remove the pragma.
3 INTIMPLIED
Message In the declaration of "<name>", no type was
specified. Type defaulted to int. This is a
violation of the C99 standard.
Description The declaration contains a storage-class specifier,
but no type was specified. The compiler will assume
a type of int. Omitting the type specifier is not
valid in C++ or in C99, and is often considered poor
programming practice.
User Action Add a type specifier to the declaration.
3 INTOVERFL
Message <Context> integer overflow occurs in evaluating the
expression "<expression>".
Description An integer overflow occurred while evaluating a
constant expression. The value of the expression is
undefined.
User Action Correct the constant expression so that it does not
overflow.
3 INTRINSICCALL
Message <Context> an apparent invocation of intrinsic
function "<name>", <problem>. It will be treated as
an ordinary external call.
Description A function that could be handled internally by the
compiler has been called in a manner that is
inconsistent with expected usage. In such a case,
the compiler will generate a run-time call to the
function. This could result in performance loss.
User Action If the function is intended to refer to the runtime
library routine, the appropriate header file should
be included in the source to provide the full
function prototype and allow certain types of
argument conversions. Alternatively, call arguments
could be type cast as specified in the error message,
or the function prototype could be added by hand. If
the function is not intended to refer to the runtime
library routine, the intrinsic version can be
disabled by means of the "#pragma function
(function_name)" directive.
3 INTRINSICDECL
Message <Context> the declaration for intrinsic function
"<name>" referenced at <location>, <problem>. It
will be treated as an ordinary external function.
Description A function that could be handled internally by the
compiler has been declared with a prototype that does
not agree with what the compiler expected to see, or
has been declared at block scope instead of file
scope. The function might in fact be a
similarly-named replacement for the expected
function, or the prototype might be incorrect or
misplaced. In such cases, the function will not be
handled internally, but will instead be called at run
time in the usual manner. This could result in a
performance loss.
User Action If the function is intended to refer to the runtime
library routine, the appropriate header file should
be included in the source (note that it is not
portable to include standard headers at other than
file scope). Alternatively, the prototype could be
modified as specified in the error message. If the
function is intended to be a replacement for the
runtime library routine, disable the intrinsic
version by specifying "#pragma
function(function_name)" in the source file.
3 INTRINSICDECLER
Message <Context> the declaration for the prototyped
intrinsic function "<name>" is incorrect: <problem>.
Description A function that could be handled internally by the
compiler and requires a prototype, has been declared
with a prototype that does not agree with what the
compiler expected to see. The function might be
intended as a similarly-named replacement for the
compiler-known function, or the prototype might be
incorrect. The source must be modified to specify
the intended behavior.
User Action If the function is intended to refer to the
compiler-known routine, the appropriate header file
should be included in the source. Alternatively, the
prototype could be modified as specified in the error
message. If the function is intended to be a
replacement for the compiler-known routine, disable
the intrinsic version by specifying "#pragma
function(function_name)" in the source file.
3 INTRINSICINT
Message <Context> the <place> type for intrinsic "<name>" is
being changed from "size_t" to "int".
Description A function that is handled internally by the compiler
expects an argument type or return type of "size_t",
but the prototype for the function uses "int". The
compiler will use "int" in this case.
User Action Declare the function by including the appropriate
header file. Alternatively, provide a private
declaration (or modify an existing private
declaration) with "size_t" in the appropriate
location(s), and with "size_t" defined as it is in
the standard system header files. If the function is
not intended to refer to the runtime library routine,
the intrinsic version can be disabled by means of the
"#pragma function (function_name)" directive.
3 INTUNDFUN
Message There is no function declaration visible for the
identifier "<name>" at the point of this #pragma
<pragma type>.
Description An identifier specified in a #pragma intrinsic or
#pragma function directive must refer to a function
declaration visible at the point of the pragma. The
identifier will be ignored.
User Action Either remove the identifer from the pragma, correct
its spelling, or reorder the source to ensure that a
declaration of the identifier as a function is
visible at the point of the pragma.
3 INVALIDARG
Message Invalid argument to <pragma> pragma. Pragma is
ignored.
Description An invalid argument has been specified for a pragma
directive. The compiler will ignore the directive.
User Action Correct the directive.
3 INVALIDSTR
Message The # operator produced an invalid string.
Description During the expansion of a macro, the # stringize
operator produced a token that is not a valid string.
The operand to the stringize operator must contain
characters that form a valid string.
User Action Correct the operand to the stringize operator.
3 INVALTOKEN
Message Invalid token discarded.
Description An unexpected token was encountered by the compiler.
The token has been ignored. An example is the
preprocessing operator "#" appearing outside a macro
body (int #a;).
User Action Remove the unexpected token.
3 INVCPPINARGS
Message Possible directive "#<directive>" within a macro
argument list. The directive is treated as part of
the argument list, and not as a preprocessing
directive.
Description The compiler has encountered a directive as part of
the argument list of a macro invocation. This
directive will be treated as part of the argument
list, and not as a preprocessing directive. The
behavior might be different than other compilers.
User Action Rewrite the macro invocation so that it does not
include the directive.
3 INVDUPENUM
Message <Context> the value of the enumerator "<name>"
conflicts with a previous declaration.
Description The specified enumerator name has been previously
declared with a different value.
User Action Either use a different enumerator name or remove the
previous declaration of the name.
3 INVNOMEMPRAG
Message Invalid argument to nomember_alignment pragma.
Pragma is ignored.
Description The compiler was unable to parse a #pragma
nomember_alignment directive. The directive will be
ignored.
User Action Correct the directive.
3 INVPACKPRAG
Message Invalid pack pragma. Pragma is ignored.
Description The compiler was unable to parse a #pragma pack
directive. The directive will be ignored.
User Action Correct the directive.
3 INVPPDIRPEA
Message The preprocessor directive <name> is not allowed in a
prologue or epilogue file. The directive is ignored.
Description It is not possible for a prologue or epilogue file to
have this preprocessor directive in it.
User Action Remove the offending preprocessor directive from the
prologue/epilogue file.
3 INVSTATIC1
Message <Context> the keyword "static" and/or type qualifiers
may appear only in the outermost array-bounds
specifier of a function parameter. Keyword/qualifier
ignored.
Description The keyword "static" or a type specifier appeared in
an array-bound specifier that was either not part of
the declarator for a function parameter or it was not
the outermost array-bound specifier of a function
parameter.
User Action Remove the keywords or confine them to use in the
outermost array-bound specifier of a function
parameter.
3 INVSTATIC3
Message The keyword "static" may not appear in an array-bound
specifier for a declaration of an array of unknown
size. Keyword ignored.
Description The keyword "static" appeared in the declaration of
an array whose size was not known, either because
array has in incomplete type or because the array has
a star bounds specifier.
User Action Remove the keyword.
3 INVSTATIC4
Message An expression specifying the bound is required when
the keyword "static" is used in an array-bounds
specifer. Keyword ignored.
Description The keyword "static" appeared in an array-bounds
specifier that did not have an expression describing
the array bound. The keyword tells the compiler that
actual arguments passed to this parameter will always
have at least as many elements as specified in the
formal parameter. It is inconsistent to specify the
keyword without also supplying a value for the bound.
User Action Remove the keyword or supply a value for the bound.
3 INVSTATIC5
Message <Context> the static bound value differs from the
static bound value in another declaration at
<location>. The smaller static bound value will be
used.
Description In a previous declaration of a function one or more
parameters with array type were declared with a
different static bound value than in the current
declaration. This can occur if one of the sizes of
the corresponding static arrays differ between the
two declarations.
User Action Remove the keyword "static" from the declarations, or
give all function declarations the same static bound
value.
3 INVSTATIC6
Message <Context> neither the keyword "static" nor a type
qualifier may be used in array-bounds for old-style
function parameters. Keyword/qualifiers ignored.
Description Use of the keyword "static" or a type specifier
within the outermost array bound specifier of a
formal parameter is a new feature in the C99
statndard. It cannot be used in old-style function
definitions.
User Action Remove the keywords or convert the code to use
prototype-style function declarations and
definitions.
3 IVDEPNOFOR
Message This #pragma directive was not followed by a for
statement. The directive will be ignored.
Description The #pragma ivdep and #pragma unroll directives
modify the for loop which follows them. The compile
has encoutered one of the directives without a
following for loop. The directive will be ignored.
User Action Remove the directive.
3 KEYCOMB
Message Illegal combination of keywords.
Description An invalid combination of Microsoft keywords was
encountered during a declaration. In most cases this
is because the keywords contradict each other. One
example would be using the __fastcall and __stdcall
modifiers in the same function declaration. This
message is only output when the compiler is in
Microsoft mode.
User Action Remove one of the contradictory modifiers.
3 KNRFUNC
Message The function "<name>" is defined using the old style
K&R syntax. The C standard has marked this syntax as
obsolescent, and it is not supported in C++.
Consider using the standard C prototype syntax.
Description The function uses an old style function definition.
HP recommends that old style function definitions be
replaced by prototype-format definitions.
User Action Recode the function definition to use the recommended
prototype-format definition.
3 LABELWOSTMT
Message Accepting a label without a following statement is a
language extension.
Description The C standard states that a label must be followed
by a statement. For compatibility with other C
compilers, HP C will accept a label without a
statement. Be aware that this program does not
conform to the standard and may be rejected by other
compilers.
User Action Add a semicolon after the label to create a null
statement.
3 LCRXCOND
Message Common Data Dictionary description extraction
condition. <msg>.
Description Something went wrong while trying to get the CDD
record description from the CDD. The error message
that follows gives more information about the nature
of the problem.
User Action If necessary, correct the indicated condition in the
CDD record description or with the user environment.
3 LDCOMPLEXNYI
Message <Context> the type long double _Complex is not fully
supported on this platform. The type is only
accepted when the compilation specifies the option to
make the long double type 64-bits in size.
Description On some platforms HP C does not support the long
double _Complex type where the real and imaginary
component are 128-bits in size. As HP C requires
that each component of a long double _Complex be the
same size as a long double, this compilation must
specify the option to treat long double as 64-bits.
User Action Either specify the correct compiler option or use the
double _Complex type instead of the long double
_Complex type.
3 LEXNESTPAR
Message Lexically nested parallel at scope <text> is not
supported
Description Nested parallel directives are not supported.
User Action Remove the nested parallel directive.
3 LISTOPEN
Message An error occurred while attempting to open the
listing file: <reason>.
Description An unexpected error occurred during the creation of
the listing file. The message text will contain
additional information about the failure.
User Action Correct the condition that caused the failure.
3 LOCALEXTINI
Message The block-level declaration of "<name>" includes an
initializer and specifies storage class extern.
Description A block-level declaration with extern storage class
cannot contain an initializer.
User Action Remove the initializer from the declaration or move
the declaration to file scope.
3 LONGDEBUG
Message The identifier name exceeds <number> characters; name
passed to the debugger will be truncated to
"<truncated spelling>".
Description On some platforms, the name length supported by the
compiler is greater than the length supported by the
debugger. In this case the compiler must truncate
the name when it is output to the debugger symbol
table for this compilation.
User Action Reduce the size of the name.
3 LONGDOUBLENY1
Message <Context> type long double has the same
representation as type double on this platform and is
treated as a synonym for type double in this
compilation mode.
Description HP C does not support the long double type on this
platform. In this compilation mode, the compiler
will treat the long double type as a synonym for the
double type.
User Action Be aware of this.
3 LONGDOUBLENYI
Message <Context> type long double has the same
representation as type double on this platform.
Description Although HP C will recognize the long double type as
a different type than double in this compilation
mode, on this platform they will both use the same
representation. Using long double will not provide
any additional precision or range.
User Action Be aware of this.
3 LONGEXTERN
Message The external identifier name exceeds <number>
characters; truncated to "<truncated spelling>".
Description The length of an identifier with external linkage
exceeds the maximum allowed on this platform. The
name used in an output object file will be truncated
to meet the platform restrictions. Note that the
debugger name will be unchanged.
User Action Reduce the size of the name. On OpenVMS platforms
the /NAMES=SHORTENED qualifier can also be used.
When the qualifier is specified, the compiler will
encode long external names instead of truncating
them.
3 LONGFLOATEXT
Message <Context> long float as a synonym for double is a
language extension.
Description Certain standard modes allow the use of the long
float type as a synonym for double. This is not
allowed by the C standard. This message indicates
this use of long float as a potential portability
problem.
User Action Change long float to double.
3 LONGLINE
Message A <type> source line longer than <number> characters
was encountered.
Description The length of a source line has exceeded the maximum
length supported by the HP C compiler.
User Action Reduce the size of the line.
3 LONGLONGSUFX
Message The integer constant is of type "<type>", which is a
new feature of C99 might not be portable.
Description The use of the suffix ULL or LL on an integer
constant does not conform to the C89 standard and
might not be accepted by other C compilers.
User Action Be aware of this if you wish to port the program.
3 LONGLONGTYPE
Message <Context> type "<type>" is a new feature in C99.
Description On some platforms, HP C will accept the [unsigned]
long long type as a way to declare [unsigned] 64-bit
integers. The long long int type is a new feature of
C99 and other compilers might not accept this
declaration.
User Action Be aware of this portability concern.
3 LONGMODULEID
Message Identifier "<name>" in a #pragma module or #module
directive exceeds 31 characters.
Description A module or identification name specified in the
#pragma module or #module directive must be less than
32 characters. The compiler will truncate the name
to the first 31 characters specified.
User Action Shorten the module or identification name.
3 LONGMODULESTR
Message The identification string <string> in a #pragma
module or #module directive exceeds 31 characters.
The compiler will ignore the directive.
Description An identification string specified in the #pragma
module or #module directive must be less than 32
characters. The compiler will ignore the directive.
User Action Shorten the identification string.
3 LONGPREFIX
Message Prefix string too long. Truncated to "<newprefix>".
Description The specified prefix to the #pragma extern_prefix
directive is too large for this platform. The prefix
will be truncated.
User Action Reduce the size of the specified extern prefix.
3 LONGPSECT
Message Psect name is too long (maximum is 31 characters).
Description The psect name specified in a globaldef declaration
was longer than 31 characters. This exceeds the
maximum allowed length.
User Action Either reduce the psect name to 31 characters or
remove the psect specifier.
3 LONGTOKEN
Message An individual token longer than <number> characters
was encountered.
Description The length of an individual token has exceeded the
maximum length supported by the HP C compiler.
User Action Reduce the size of the token; perhaps it can be
converted into two or more smaller tokens.
3 LVALUECAST
Message <Context> the result of the cast "<cast>" is used as
an lvalue.
Description The result of a cast has been used as an lvalue.
This is a language extension of HP C. The program
does not conform to the C standard, and might not be
accepted by other compilers.
User Action Remove the cast.
3 MACROREDEF
Message The redefinition of the macro "<name>" conflicts with
a current definition because <reason>. The
redefinition is now in effect.
Description A macro has been redefined with either different
formal parameters and/or a different body than a
previous definition of the macro.
User Action Either make all definitions of the same macro
identical, or undefine the macro using the #undef
preprocessing directive before it is redefined.
3 MACROREDEFIN
Message Macro redefined.
Description A #define preprocessing directive has redefined a
macro whose previous definition contained an error or
warning. Normally, the compiler will issue a warning
if a macro is redefined to something other than the
previous definition. However, if the previous
definition caused a warning or error to be generated,
this informational message is output instead.
User Action Do not redefine a macro without first undefining it.
3 MAINNOTINT
Message Strict standard C extension: The declaration of the
"main" function has a return type other than int.
Description Standard C requires that the "main" function be
defined with a return type of int. HP C will accept
other return types, but the program does not conform
to the C standard. The status value returned to the
environment may not be what you expect, and other C
compilers may not accept the definition as written.
User Action Define the "main" function with a return type of int
for maximal portability.
3 MAINPARM
Message Strict standard C extension: The declaration of the
"main" function has more than two parameters.
Description Standard C requires that the "main" function takes no
more than two parameters. HP C will accept more, but
the program does not conform to the C standard.
User Action Modify the declaration if you want the program to be
standard conformant.
3 MAINPROGEXT
Message MAIN_PROGRAM is a language extension.
Description The use of MAIN_PROGRAM to designate a function as
the main program is a language extension of HP C.
Other C compilers might not successfully compile a
program that uses the extension.
User Action The main program should be declared by naming the
function main.
3 MAPREGIGNORED
Message The linkage register "<registers>" has no effect on
Alpha and will not be mapped to any register on IA64.
This condition may cause the SHOWMAPLINKAGE message
output for this directive to be incorrect.
Description The use of an Alpha argument register (R16-R21) in a
linkage characteristic other than "parameters" or
"results" has no effect on Alpha. No mapping to an
IA64 register will be done for this register. This
may cause the mapped linkage shown in the
showmaplinkage message to be incorrect.
User Action Remove the register from the characteristic.
3 MATHERRNO
Message <Context> function <name> is defined to set errno
when a domain error or range error occurs. As an
intrinsic, it may not be able to do so.
Description Any code that tests the value of errno set by this
function may not work properly due to the
optimizations that are possible when this function is
an intrinsic.
User Action If the value of errno set by this function is
ignored, tell the compiler via its command line
qualifiers to assume nomath_errno. Otherwise,
disable the intrinsic by using a #pragma
function(func-name).
3 MAYHIDELOSS
Message <Context> "<expression>" has a larger data size than
"<target type>". The use of a cast operator can
suppress the message that this assignment might
result in data loss.
Description In a cast of a pointer to one of the integer types,
or a cast of one of the integer types to a pointer,
or a cast of one pointer type to another, the size of
the source is greater than the size of the type being
cast to. This cast could result in a loss of data if
it is used as the source of an assignment. This
potential loss of data can be verified by removing
the cast and seeing if the compiler emits a loss of
data message on the assignment.
User Action If the cast cannot lose precision, it is safe to
ignore this warning.
3 MAYLOSEDATA
Message <Context> "<expression>" has a larger data size than
"<target type>". Assignment can result in data loss.
Description In an assignment of a pointer to one of the integer
types, or one of the integer types to a pointer, the
size of the source is greater than the size of the
destination. The assignment can result in a loss of
data. This might not have been what you intended.
User Action If this was the intended operation, cast the source
to the type of the destination before the assignment.
3 MAYLOSEDATA2
Message <Context> "<expression>" has a larger data size than
"<target type>". Assignment can result in data loss.
Description In an assignment of two pointers, the size of the
source is greater than the size of the destination.
The assignment can result in a loss of data. This
might not have been what you intended.
User Action If this was the intended operation, cast the source
to the type of the destination before the assignment.
3 MECHMISMATCH
Message Argument passing mechanism does not match formal
parameter mechanism for <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 MEMBERVLA
Message <Context> the struct or union member "<name>" cannot
be declared with a variably modified type.
Description Only ordinary identifiers with block scope and
without storage class extern, or ordinary identifiers
with function prototype scope can be declared with a
variably modified type.
User Action Correct the declaration.
3 MISALGNDMEM
Message This member is at offset <offset>, which is not a
multiple of the member's alignment of <align>.
Consider padding before this member, rearranging the
order of member declarations, or using #pragma
member_alignment.
Description A member of a struct or union requires an alignment
for efficient access but will be allocated at an
offset that is not a multiple of that alignment.
User Action Use one of the suggestions made in the message.
3 MISALGNDSTRCT
Message This member requires <align1> alignment for efficient
access, but is contained in a struct containing
<align2> alignment. Consider using #pragma
nomember_alignment <align1>.
Description A member of a struct or union requires an alignment
for efficient access that is more strict than the
alignment of the enclosing struct or union. Even
though this member is correctly aligned within the
struct or union, if the struct or union is enclosed
within another type, the member in question might be
placed at a position with incorrect alignment for its
type.
User Action Use either the #pragma member_alignment directive or
#pragma nomember_alignment directive with an argument
equal to or greater than the alignment of the member.
3 MISDEFARG
Message Missing argument for "defined" operator.
Description The defined preprocessing operator was not supplied
with an argument. The operator expects an identifier
optionally enclosed in parenthesis. The value of the
operator is undefined.
User Action Supply a valid argument to the preprocessing
operator.
3 MISDEFPAR
Message Missing right parenthesis for "defined" operator.
Description The defined preprocessing operator began with a left
parenthesis, but no matching right parenthesis was
found. The value of the operator is undefined.
User Action Add the right parenthesis after the preprocessing
operator argument.
3 MISMATPARAM
Message <Context> parameter <number> has a different type
than specified in an earlier declaration of this
function.
Description A function has been redeclared with a parameter whose
type is different than the type specified in a
previous declaration of the function. This generally
leads to additional errors.
User Action Correct the function declarations so that the
parameter information is the same in each
declaration.
3 MISMATPRSRET
Message "<name>" has a non-void return type but its linkage
"<name>" preserves the return register(s). Standard
linkage will be used.
Description The function or typedef's special linkage specifies
that the register(s) used to return the function
value are to be preserved. This is invalid as the
register can either be preserved, or hold the return
value, but not both.
User Action Modify the #pragma linkage directive to either remove
the register from the preserved list or to specify
another register to hold the return value.
3 MISMATTHREAD
Message <Context> the __declspec(thread) storage class
modifier of "<name>" is different from a previous
declaration of "<name>" at <location>.
Description If an object is declared with thread-local storage,
then all declarations of that object must declare it
with thread-local storage.
User Action Either remove the invalid redeclaration or modify it
to match the previous declaration.
3 MISPARAMCOUNT
Message <Context> the number of parameters differs from an
earlier declaration of this function.
Description A function has been redeclared with a different
number of parameters than a previous declaration of
the function. This message generally proceeds
additional errors.
User Action Correct the function declarations so that the
parameter information is the same in each
declaration.
3 MISSINGCASE
Message Was the 'case' keyword omitted Within a switch
statement, "<label>" defines an unreferenced label
that matches an enumeration constant.
Description This user label has been defined, but there are no
references to it. As the label is defined inside a
switch statement, and the label name matches an
enumumeration constant name, there is a chance you
intended this to be a case label.
User Action Remove the label or add the 'case' keyword before it.
3 MISSINGCOMMA
Message This parameter is not preceded by a comma.
Description The compiler has encountered a parameter specifier
that is missing a preceding comma. The parameter
will be defined anyway, though this may not have been
what you intended.
User Action Correct the formal parameter list so that it consists
of a comma separated list of identifiers (possibly
followed by ", ...").
3 MISSINGFUNC
Message The function "<name>" has internal linkage, occurs in
a context that requires its definition, and has no
definition.
Description The program has referenced a function declared with
static storage class, but the function is not defined
in the compilation unit. If a program references a
static function, the function must be defined in the
compilation unit.
User Action Either define the function or change the function
declaration to have extern storage class.
3 MISSINGLABEL
Message The label "<label name>" is the target of a goto
statement within the function "<function name>", but
has no definition within "<function name>".
Description Every label referenced in a goto statement must be
defined in the same function.
User Action Either change the name of the label in the goto
statement, or define the label.
3 MISSINGRETURN
Message Non-void function "<name>" does not contain a return
statement.
Description This message indicates that a function with an
explicit return type does not contain a return
statement. This message is not issued for functions
with an implicit return type of int. See message
IMPFNCMSSNGRET.
User Action Consider declaring the function to be a void
function. If it is supposed to return a value, add a
return statement with the value the function is to
return.
3 MISSINGTYPE
Message Missing type specifier or type qualifier.
Description The compiler was expecting a type specifier or type
qualifier, but one was not found.
User Action Correct the program syntax.
3 MISSPELLDEF
Message The user label "<label>", defined within a switch
statement, is never referenced.
Description This user label has been defined, but there are no
references to it. As the label is defined inside a
switch statement, there is a chance this is a
misspelling of "default".
User Action Remove the label or correct the spelling.
3 MIXALLOCAVLA
Message <Context> this call to __ALLOCA occurs in a block
that contains <vlaallocafrag1>. The storage
allocated by this __ALLOCA call will
<vlaallocafrag2>vla or aligned automatic declaration
was at <where>.
Description Storage allocated for arrays of variable length and
for automatics whose alignment is greater than
octaword have their storage deallocated when the
block they are declared in exits. Storage allocated
by __ALLOCA is not normally deallocated until
function exit. HP C cannot support both types of
deallocation in the same block. Therefore, when both
appear in the same block, the storage for both will
be deallocated with the block exits.
User Action Be aware of this. If the storage allocated for
__ALLOCA must remain allocated until function exit,
move the __ALLOCA call outside the block declaring
the vla or the aligned auto.
3 MIXALLOCAVLAV
Message <Context> using __ALLOCA and variable-length arrays
in the same function is not allowed on this platform.
The first variable-length array declaration is at
<where>.
Description Because they place different requirements on stack
allocation on VAX systems, __ALLOCA and
variable-length arrays cannot be used in the same
function.
User Action Recode the function to use either variable-length
arrays or __ALLOCA.
3 MIXFUNCVOID
Message <Context> compatibility of a pointer to void and a
pointer to a function is not portable under the C
standard.
Description The C standard defines pointer to void as being
assignment compatible only with pointers to object or
incomplete types. An implementation may represent
function pointers in a way that cannot be stored in a
pointer to void (or vice-versa). Thus even an
explicit cast between a function pointer and a
pointer to void is not portable.
User Action If a generic pointer to function is needed, declare a
typedef for some pointer to function type, and always
use explicit casts to assign to and from that type.
3 MIXINLINE
Message The function <name> is declared both <this> and
<that>.
Description A function is declared with more than one of the
forceinline, inline, or noinline attributes. It will
be given the attribute that will provide the most
optimization.
User Action Make sure each function has only one of the
attributes.
3 MIXLINKAGE
Message <Context> "<name>" is declared with both internal and
external linkage. The previous declaration is at
<location>.
Description This warning is output in certain cases when the
linkage of a declaration conflicts with the linkage
specified in an earlier declaration.
User Action Change one of the declarations so that the linkages
match.
3 MIXLINKAGE1
Message <Context> "<name>" is declared with both internal and
external linkage. The previous declaration is at
<location>.
Description This informational is output when a function
previously declared to have extern storage class is
redeclared to have internal storage class and the
mode of the compiler is common (K & R) mode.
User Action Change one of the declarations so that the linkages
match.
3 MIXOLDNEW
Message The definition of the function <name> includes both a
prototype and a declaration list.
Description A function has been defined using both a declaration
list and a prototype. This is not valid.
User Action Correct the declaration.
3 MIXSTORCLS
Message <Context> a storage class has already been specified.
This storage class is ignored.
Description The same declaration contains more than one storage
class specifier. The compiler will ignore all
storage class specifiers after the first one.
User Action Change the declaration to use only one storage class
specifier.
3 MIXVLAALLOCA
Message Declaring <vlaallocafrag1> in the same block as a
call to __ALLOCA will cause the storage allocated by
any __ALLOCA call to <vlaallocafrag2>previous call to
__ALLOCA was at <where>.
Description Storage allocated for arrays of variable length and
for automatics whose alignment is greater than
octaword have their storage deallocated when the
block they are declared in exits. Storage allocated
by __ALLOCA is not normally deallocated until
function exit. HP C can not support both types of
deallocation in the same block. Therefore, when both
appear in the same block, the storage for both will
be deallocated with the block exits.
User Action Be aware of this. If the storage allocated for
__ALLOCA must remain allocated until function exit,
move the __ALLOCA call outside the block declaring
the vla or the aligned auto.
3 MIXVLAALLOCAV
Message Using both __ALLOCA and variable-length arrays in the
same function is not allowed on this platform. The
first call to __ALLOCA is at <where>.
Description Because they place different requirements on stack
allocation on VAX systems, __ALLOCA and
variable-length arrays cannot be used in the same
function.
User Action Recode the function to use either variable-length
arrays or __ALLOCA.
3 MODNOIDSTR
Message Invalid identifier or character-string constant
specification.
Description If specified, the second argument to the #pragma
module or #module directive must be either an
identifier or a string constant.
User Action Correct the directive.
3 MODSTORCLS
Message Storage class modifier noshare has no meaning with
this storage class. Modifier is ignored.
Description The storage class modifier noshare is only valid for
variables with a storage class of static, extern, or
globaldef. It is ignored for other storage classes.
User Action Remove the noshare storage class modifier.
3 MODULEFIRST
Message "#pragma module" or "#module" directive must precede
any language text.
Description The #pragma module or #module directive must appear
before any declarations. The directive will be
ignored.
User Action Move the directive to the top of the compilation
unit.
3 MSGPOP
Message This "restore" has underflowed the message stack. No
corresponding "save" was found.
Description The message stack, managed by the #pragma message and
#pragma environment directives, contains more
restores than saves. This could signify a coding or
logic error in the program.
User Action Make sure each restore has a corresponding save.
3 MSGSFRMEXLCODE
Message Enabling this message may cause additional messages
from excluded code to be output.
Description This message is never output by the compiler.
Instead it is used to control whether other messages
will be output. Normally, the compiler will not
output some messages when it is processing code that
it knows will never be executed. One example of this
would be the second operand of the conditional
operator when the first operand is FALSE. This
suppression of these messages can be overridden by
enabling this message.
User Action Decide if you want the additional messages.
3 MULTICHAR
Message A character constant includes more than one character
or wide character.
Description A character constant includes more than one
character. While this is valid, it might not have
been what you intended.
User Action Verify that the constant should contain more than one
character.
3 MULTILINK
Message Multiple linkage pragmas specified for "<routine
name>".
Description The same routine appeared in more than one #pragma
use_linkage directive. Each routine can only be
given one linkage.
User Action Remove the routine from all but one #pragma
use_linkage directive.
3 MULTILINKREG
Message The register "<register>" is specified more than once
in the linkage pragma. Pragma is ignored.
Description The same register was specified more than once in the
same register list in a #pragma linkage directive.
The compiler will ignore the entire pragma.
User Action Correct the directive.
3 MULTIMAIN
Message More than one main program has been defined.
Description The compiler has encountered more than one main
program in this compilation unit. Each program can
have only one main program.
User Action Remove one of the main programs.
3 MULTIPSECTNAME
Message Multiple <psect_type> names specified. The name
"<new_name>" supersedes "<old_name>".
Description More than one #pragma code_psect or #pragma
linkage_psect was encountered. The psect specified
by the later #pragma supersedes the one specified
earlier. This message is only output for C compilers
on OpenVMS Alpha.
User Action Each program should contain at most one #pragma
code_psect and one #pragma linkage_psect.
3 NAMESHORTENED
Message The external identifier or module name "<name>"
exceeds 31 characters. The name has been shortened
to "<shortened spelling>".
Description A compilation that used the /NAMES=SHORTENED
qualifier or #pragma names shortened directive has
encountered a name that needs to be shortened. The
external name will be different than the internal
name. Also, because the external name exceeds the
length specified by standard C as the minimum
external length an implementation must support, this
program does not strictly conform to standard C and
might not be accepted by other C compilers.
User Action Be aware of these items.
3 NAMESLOWER1
Message The /NAMES=LOWERCASE qualifier is no longer
supported. The qualifier /NAMES=AS_IS will be used.
Description While the C language has always required identifiers
with internal linkage to be treated case sensitively.
It traditionally permitted implementations to
monocase identifiers with external linkage. Modern
standards require C/C++ implementations to preserve
the case of identifiers with external linkage. As
VMS and other operating systems that traditionally
implemented monocasing chose uppercase as the
convention, /NAMES=LOWERCASE runs contrary both to
the C and C++ standards and to traditional
conventions. Continued support for this option
interferes with support for compatibility between old
code compiled with /NAMES=UPPERCASE and new code
compiled with /NAMES=AS_IS.
User Action Use /NAMES=AS_IS, making source code changes as
needed.
3 NEEDADDRCONT
Message <Context> "<name>" does not have a constant address,
but occurs in a context that requires an address
constant.
Description A variable with static storage has been initialized
to the address of an object whose address is not
constant. This can happen if a static pointer
variable is initialized to the address of an
automatic variable.
User Action Either make the initialize a constant, or, if
possible, initialize the static storage using a
run-time assignment.
3 NEEDARITH
Message <Context> "<expression>" has <type> type, which is
not arithmetic.
Description An expression that must be an arithmetic type was not
an arithmetic type. For example, the operands of an
arithmetic operator such as * must be arithmetic
type.
User Action Modify the expression so that it is an arithmetic
type.
3 NEEDCONSTEXPR
Message <Context> "<name>" is not constant, but occurs in a
context that requires a constant expression.
Description An expression that must evaluate to a compile-time is
not a constant.
User Action Modify the constant expression so that it will
evaluate as a compile-time constant.
3 NEEDCONSTEXT
Message <Context> "<name>" is not constant, but occurs in a
context that requires a constant expression. This is
an extension of the language.
Description The C89 standard requires that an initializer for an
automatic aggregate or union type object have an
initializer that is a list of constant expressions.
HP C allows non-constants in these initializers.
This is an extension to C89. Although this is
allowed by the C99 standard, other C compilers might
not successfully compile a program that uses this
extension.
User Action Be aware of this if you wish to port the program.
3 NEEDDFLOAT
Message The CDD description for <name> specifies the
D_Floating data type. The data can only be
represented when compiling with /FLOAT=D_FLOAT.
Description The /FLOAT command-line qualifier specified a
floating type other than D_floating format. The CDD
description specified was D_floating type, which did
not match the floating type specified on the command
line.
User Action Specify the correct command-line qualifier, or change
the description of the item in the CDD.
3 NEEDFUNCPTR
Message <Context> "<expression>" points to <type> type, but
occurs in a context that requires a pointer to a
function type.
Description An expression that must be a pointer to a function
type is a pointer to an object or incomplete type.
For example, if a function invocation expression is a
pointer, it must be a pointer to a function type.
User Action Modify the expression so that it is a pointer to a
function type.
3 NEEDGFLOAT
Message The CDD description for <name> specifies the
G_Floating data type. The data can only be
represented when compiling with /FLOAT=G_FLOAT.
Description The /FLOAT command-line qualifier specified a
floating type other than G_floating format. The CDD
description specified was G_floating type, which did
not match the floating type specified on the command
line.
User Action Specify the correct command line qualifier, or change
the description of the item in the CDD.
3 NEEDIEEE
Message The CDD description for <name> specifies a VAX
floating data type. The data cannot be represented
when compiling with /FLOAT=IEEE_FLOAT.
Description The command-line qualifier /FLOAT=IEEE_FLOAT was
specified, indicating that all floating-point data
should be represented in IEEE-floating format, yet
the CDD description specified a non-IEEE_floating
type.
User Action Specify the correct command-line qualifier, or change
the description of the item in the CDD.
3 NEEDIEEE1
Message The CDD description for <name> specifies an IEEE
floating data type. The data can only be represented
when compiling with /FLOAT=IEEE_FLOAT.
Description The CDD description for an item specifies an IEEE
floating point type. However this module was not
compiled with the /FLOAT=IEEE_FLOAT qualifier.
User Action Specify the correct command-line qualifier, or change
the description of the item in the CDD.
3 NEEDINTEXPR
Message <Context> "<expression>" has <type> type, which is
not integral.
Description An expression that must be an integer type was not
integral. For example, an array-index specifier must
be an integral type.
User Action Modify the expression so that it is an integral type.
3 NEEDLVALUE
Message <Context> "<expression>" is not an lvalue, but occurs
in a context that requires one.
Description An expression that must be an lvalue was not an
lvalue. For example, the operand of the address-of
operator must be an lvalue.
User Action Modify the expression so that it is an lvalue.
3 NEEDMEMBER
Message <Context> "<name>" is not a member of "<struct or
union expression>".
Description The second operand of a . or -> operator specifies a
member name that is not a member of the struct or
union type specified by the first operand. Note that
in certain modes, HP C will search all other visible
struct/union types for a matching member name. If it
finds one, a diagnostic will be issued, and the
offset of that name will be used.
User Action Specify a valid member name.
3 NEEDNONBLTIN
Message <Context> "<name>" is a builtin and cannot be used in
this context.
Description A program has used a builtin function in a way that
is invalid for builtin functions. For example, a
program cannot take the address of a builtin.
User Action Remove the improper use of the builtin.
3 NEEDNONCONST
Message <Context> "<expression>" has const-qualified type,
but occurs in a context that requires a modifiable
lvalue.
Description The code has attempted to modify an object that is
either a const-qualified type or has been declared
with the readonly storage-class modifier. This is
not valid. A typical example is assigning a value to
a const variable.
User Action Either remove the const qualifier from the object's
type, remove the readonly storage-class modifier from
the object declaration, or rework the code so that
the object is not written to.
3 NEEDNONVOID
Message <Context> "<expression>" has void type, but occurs in
a context that requires a non-void result.
Description An expression that must not be a void type was void.
For example, the control expression for an if
statement must not have void type.
User Action Modify the expression so that it has the required
type.
3 NEEDPOINTER
Message <Context> "<expression>" has <type> type, but occurs
in a context that requires a pointer.
Description An expression that must be a pointer type was not a
pointer type. For example, the operand of the
dereference operator must be a pointer type.
User Action Modify the expression so that it has a pointer type.
3 NEEDPTROBJ
Message <Context> "<expression>" does not point to an object
type.
Description An expression that must be a pointer to an object
type is a pointer to a function or incomplete type.
For example, if a pointer is the operand of the
postincrement operator, it must point to an object
type.
User Action Modify the expression so that it is a pointer to an
object type.
3 NEEDSCALAR
Message <Context> "<expression>" has <type> type, which is
not scalar.
Description An expression that must be a scalar type was not
scalar. For example, only scalars can be cast to
other types.
User Action Modify the expression so that it is a scalar type.
3 NEEDSCALARTYP
Message <Context> "<source type>" is <type> type, which is
not scalar.
Description In a cast expression, the destination type of the
cast is not a scalar type. This is not valid. Both
the source and target type of a cast must be scalars.
User Action Modify the cast destination type so that it is a
scalar type.
3 NEEDSIMPLEASM
Message This asm is unsupported or illegal.
Description The argument to the asm intrinsic is invalid.
User Action Supply a valid argument to the asm instrinsic.
3 NEEDSTRCONST
Message <Context> "<name>" is not a legal asm string, a
string constant is required.
Description The argument to the asm intrinsic must be a string
constant.
User Action Change the argument to be a string constant.
3 NEEDSTRUCT
Message <Context> "<expression>" has <type> type, but occurs
in a context that requires a union or struct.
Description The left operand of the . or -> operator does not
have struct or union type.
User Action Correct the operand.
3 NEGATIVEHINT
Message <Context> a negative hint value is not allowed. The
hint will be ignored.
Description All #pragma hint directives must take positive
floating point values.
User Action Correct the hint.
3 NESTEDCOMMENT
Message Opening comment delimiter found inside a delimited
comment; a previous comment may be missing its
closing delimiter.
Description C comments delimited by /* */ do not nest. When /*
is encountered inside a delimited comment it usually
means that the previous comment is missing its
terminating */ or that the user has ill-advisedly
attempted to "comment out" a section of code that
contains a delimited comment.
User Action It is traditional in C to use #if 0 to conditionalize
out large sections of code. You may also want to
consider //-style comments if the compiler modes you
care about recognize them.
3 NESTEDENUM
Message The type "<type>" is declared nested within
"<enclosing type>". In C, the nesting is ignored and
<type> and its enumerator constants can be accessed
as if they were not nested. <However, the type and
its enumerators are members in C++>. <Fix>.
Description C allows types to be declared within other types.
For example: struct S { int a; enum E { first,
second, third} b; int c; }; In C++ the enum E would
not be accessible without using the :: operator.
User Action Declare the nested type before declaring the
enclosing type.
3 NESTEDTYPE
Message The type "<type>" is declared nested within
"<enclosing type>". In C, the nesting is ignored and
<type> can be accessed as if it were not nested.
<However, the type is a member in C++>. <Fix>.
Description C allows types to be declared within other types.
For example: struct S { int x; struct S1 { int a;
int b; } y; }; In C++ the struct S1 would not be
accessible without using the :: operator.
User Action Declare the nested type before declaring the
enclosing type.
3 NESTINCL
Message Files included by this file are referenced. However
nothing else appears to be referenced from this file.
Description When compiling with the current set of compilation
options, to improve compilation efficiency, you may
wish to include the files which this file includes
directly, rather than including them from this file.
User Action For compilation efficiency, you may exclude this
include file when compiling with the current set of
compilation options.
3 NEWLOCALE
Message The compiler could not set its locale to the
locale-specific native environment. This problem
might be caused by an incorrect value for a name
defined in your process environment such as "LC_ALL"
or "LANG". The "C" locale will be used.
Description During start-up, the compiler was unable to set its
locale to the locale-specific environment. As part
of its initialization, the compiler will issue the
call setlocale(LC_ALL, ""). If this call fails, the
compiler will set its locale to the "C" locale. In
general, this message is output because the
locale-specific native environment has been set
incorrectly.
User Action The best way to determine why the compiler was unable
to set the locale is to write a small program that
contains the library call setlocale(LC_ALL, "") and
then examine the return value from the call.
3 NLCHAR
Message An unexpected newline character is present in a
character constant.
Description An end of line was encountered during the scanning of
a character constant.
User Action Terminate the character constant with a closing
single quote character before the end of line.
3 NLHEADER
Message A newline occurs inside of a header name.
Description An end of line was encountered before the closing
double quote or angle bracket of an #include
directive.
User Action Terminate the directive argument properly.
3 NLSTRING
Message An unexpected newline character is present in a
string literal.
Description An end of line was encountered during the scanning of
a string literal.
User Action Terminate the string constant with a closing double
quote character before the end of line, or continue
the line with a continuation character.
3 NOADD
Message <Context> "<expression1>" and "<expression2>" cannot
be added.
Description Because of their types, the two expressions cannot be
used as the operands of the addition operator.
Either both operands must be arithmetic type, or one
operand must be a pointer to an object type and the
other must be an integral type.
User Action Modify the addition to use valid types.
3 NOBIFDISABLE
Message The function "<routine name>" is a builtin function
reserved to the compiler, and cannot be used with
#pragma function. The function will continue to be
treated as a builtin.
Description A function identifier specified in a #pragma function
directive is the name of a builtin function. These
functions cannot be explicitly disabled, they are
always handled as builtin functions.
User Action Remove the inappropriate use of the pragma, and
change the name of the function in order to have it
treated as an ordinary callable function.
3 NOBITFIELD
Message <Context> "<expression>" is a bitfield, but occurs in
a context that precludes bitfields.
Description An expression that must not be a bitfield was a
bitfield. For example, the operand of the address-of
operator must not be a bitfield.
User Action Modify the expression so that its type is not a
bitfield type.
3 NOCASEHERE
Message This case label occurs outside of any switch
statement.
Description A case label can only occur inside of a switch
statement.
User Action Remove the case label.
3 NOCDDHERE
Message CDD is not available on this platform. The
#dictionary directive has been ignored.
Description The #dictionary directive requires CDD to be present
on the platform. This directive will only be
recognized on OpenVMS systems.
User Action Remove the directive.
3 NOCOLON
Message Missing ":".
Description The compiler was expecting a colon, but one was not
found.
User Action Correct the program syntax.
3 NOCOLONINEXPR
Message Missing colon for conditional expression.
Description A conditional expression that occurs as part of a
preprocessing expression was missing the ":" that
separates the second from the third operand. The
value of the resulting expression is undefined.
User Action Correct the conditional expression.
3 NOCOMMA
Message Missing ",".
Description The compiler was expecting a comma, but one was not
found.
User Action Correct the program syntax.
3 NOCONDEXPR
Message Missing #if conditional expression.
Description An argument was not supplied to an #if or #elif
preprocessing directive. The missing argument will
cause the compiler to consider these as FALSE
conditionals.
User Action Supply a valid argument to the directive.
3 NOCONVERT
Message <Context> "<expression>" is of type "<type>", and
cannot be converted to "<target type>".
Description An expression of one type cannot be converted to the
type required by this expression. This most often
occurs when the source type of an assignment or cast
cannot be converted to the destination type. The
rules for which types can be converted are rather
complicated and differ based upon the compiler mode.
Refer to the language documentation for a complete
list of valid combinations.
User Action Modify the conversion to use valid types.
3 NOCONVERTCLS
Message <Context> "<expression>" is of type "<type>", and
cannot be converted to a different "<type>" type.
Description A struct or union of one type cannot be converted to
a different struct or union type.
User Action Modify the conversion to use valid types.
3 NODCL
Message <Context> nothing is declared.
Description The C standard requires that a declaration must
declare at least a tag, an enumeration constant, or a
declarator. This declaration contains none of these.
This might not have been what you intended.
User Action Correct or remove the declaration.
3 NODEFAULTHERE
Message This default label occurs outside of any switch
statement.
Description A case default label can only occur inside of a
switch statement.
User Action Remove the case default label.
3 NOENDIF
Message Missing #endif directive.
Description The compiler encountered an #if, #ifdef, or #ifndef
preprocessing directive without a matching #endif.
This might not have been what you intended. The
compiler will add the necessary #endif directive at
the end of the compilation unit.
User Action Make sure every #if, #ifdef and #ifndef has a
matching #endif.
3 NOEQUAL
Message Missing "=".
Description The compiler was expecting to see an "=" after the
secondary_name specification of a #pragma weak or
#pragma external_name directive. This message is
only output on UNIX.
User Action Correct the #pragma directive.
3 NOEQUALITY
Message <Context> "<expression1>" and "<expression2>" cannot
be compared for equality or inequality.
Description Because of their types, the two expressions cannot be
compared for equality or inequality. The rules for
which types can be compared are rather complicated
and differ based upon the compiler mode. Refer to
the language documentation for a complete list of
valid combinations.
User Action Modify the comparison to use valid types. This can
often be done by casting one of the expressions to
the type of the other.
3 NOEXCEPTFLTR
Message <Context> this exception handling call is not within
an exception filter of a try block.
Description The exception handling call must appear within an
exception filter of a try statement block.
User Action Either remove the exception handling call, or place
it in a try statement block.
3 NOFBDAT
Message <text> does not contain feedback data
Description The file indicated by the -feedback switch exists,
but does not contain feedback data. This is probably
an error on the users part, although it might be seen
as part of the bootstrapping process.
User Action Create a valid feedback file
3 NOFBFIL
Message Feedback file <text> does not exist
Description The file specified after the -feedback option does
not exist. This is normal during the bootstrapping
process.
User Action Either correct the spelling of the feedback option,
or create the required feedback file.
3 NOFBOPT
Message Compilation will proceed without feedback
optimizations
Description A condition has occurred that has prevented the
compiler from using feedback optimizations. This
message is most often preceded by another message
that will provide additional information.
User Action Correct the condition that prevented the feedback
optimizations.
3 NOFBRTN
Message Feedback inactive for <text> in this compilation
Description Feedback information has gone stale for a particular
routine (the source for the routine has changed).
Feedback optimizations will not be applied to this
routine.
User Action Create a new feedback file
3 NOFIFILE
Message Cannot find include file <filename> specified on the
command line.
Description The header file name specified in the UNIX -FI
command line option or the OpenVMS /FIRST_INCLUDE
qualifier was not found using the search rules in
effect for the quoted form of #include directives.
User Action Either change the name of the file following the
option or create the file.
3 NOFNTPDEFDECL
Message There is no identifier named "<name>" declared as a
function or function typedef in this compilation
unit.
Description A #pragma assert and/or #pragma linkage directive(s)
contains an identifier that is not declared as a
function or function typedef in the compilation unit.
This may not have been what you intented.
User Action Remove the identifier from the #pragma assert and/or
#pragma linkage, or declare it as a function or
function typedef. empty string.
3 NOFORMALPARM
Message Missing formal parameter specifier.
Description While processing the formal parameter list of a macro
definition, the compiler encountered a missing formal
parameter specifier. The macro will be be defined
and this parameter ignored, but that may not have
been what you intended.
User Action Correct the formal parameter list so that it consists
of a comma separated list of identifiers.
3 NOFUNC
Message There is no function named <name> defined in this
compilation unit.
Description A function that appears in a #pragma weak and is not
defined in the compilation unit.
User Action Either define the function or remove the function
name from the pragma.
3 NOFUNC1
Message There is no definition for the inline function named
<name> in this compilation unit.
Description A function that appears in a #pragma inline or
#pragma noinline, or is declared with the __inline or
__forceinline storage class modifier, is not defined
in the compilation unit.
User Action Either define the function or remove the function
name from the pragma, or remove the storage class
modifier or the function specifier from the
declaration.
3 NOIDFOUND
Message <Context> an identifier was expected but not found.
Description The compiler was expecting an identifier, but one was
not found.
User Action Correct the program syntax.
3 NOIDINPACKPOP
Message pragma pack pop directive has no identifier <name>
which was found on the top of the pack stack.
Description The #pragma pack (pop) directive has no identifier
specified while the top element of the pack stack has
one. Either this #pragma pack pop should have the
identifier found on the stack, or this is an extra
pragma pack pop, or the identifier should not be
pushed by the corresponding #pragma pack push.
User Action Check whether the pragma pack pop should have the
identifier. Verify that there's no extra #pragma
pack pop or #pragma member_alignment restore which
popped the identifier to the top of the pack stack.
Correct the directive(s).
3 NOINCLFILE
Message Cannot find file <filename> specified in #include
directive.
Description The specified include file does not exist.
User Action Either change the name of the file in the #include
preprocessing directive, or create the include file.
3 NOINCLFILEF
Message Cannot find file <filename> specified in #include
directive.
Description The specified include file does not exist.
User Action Either change the name of the file in the #include
preprocessing directive, or create the include file.
3 NOINCLUDEARG
Message #include directive missing argument.
Description An argument was not supplied to an #include
preprocessing directive. The directive will be
ignored.
User Action Supply a valid argument to the directive.
3 NOINIT
Message The type of <variable> does not permit
initialization.
Description This type cannot be initialized. Only objects and
arrays of unknown size can be initialized.
User Action Remove the initializer.
3 NOINLFUNC
Message There is no definition for the inline function named
<name> in this compilation unit.
Description A function is declared with an __inline or inline
keyword and is not defined in the compilation unit.
User Action Either define the function or remove the __inline or
inline keyword from the declaration.
3 NOINLINEM
Message The main function cannot be inlined.
Description The C99 standard prohibits the inline keyword from
being used on the main function.
User Action Remove the inline keyword.
3 NOINLINEREF
Message <Context> "<name>" has internal linkage and is
referenced from an an inline auxiliary function.
This is a violation of the C99 Standard.
Description A function declared with the inline keyword and
without a declaration containing the keyword, extern,
or without a declaration which lacks the inline
keyword and the static keyword declares an auxiliary
inline declaration. A definition of an auxiliary
inline shall not contain a definition of a modifiable
object with static storage duration, and shall not
contain a reference to an identifier with internal
linkage.
User Action Remove the inline keyword from all declarations of
the parent function, or if it is appropriate, change
the declaration of the referenced item to a
declaration which has something other than internal
linkage.
3 NOINLINEST
Message In an inline auxiliary function, the modifiable
object "<name>" is declared with static storage
duration. This is a violation of the C99 standard.
Description A function declared with the inline keyword and
without a declaration containing the keyword, extern,
or without a declaration which lacks the inline
keyword and the static keyword declares an auxiliary
inline declaration. A definition of an auxiliary
inline shall not contain a definition of a modifiable
object with static storage duration, and shall not
contain a reference to an identifier with internal
linkage.
User Action Remove the inline keyword from all declarations of
the parent function, or if it is appropriate, add the
const keyword to the declaration to create an
non-modifiable object.
3 NOLEAVETARG
Message This leave statement is not within a try statement.
Description The exception handling statement leave must appear
within a try statement block.
User Action Either remove the leave statement, or place it in a
try statement block.
3 NOLEFTOPERND
Message Token pasting operator missing left operand.
Description The preprocessing token pasting operator "##" appears
in a macro body without the preceeding token
argument.
User Action Either remove the operator or supply it with two
tokens that will be pasted together.
3 NOLINKAGE
Message <Context> "<name>" has no linkage and has a prior
declaration in this scope at <where>.
Description A declaration within a function body redeclares an
identifier declared earlier in the current scope, and
both declarations did not have the extern storage
class.
User Action Either remove the extra declarations, or have all
declarations for the identifier use the extern
storage class.
3 NOLONGLONG
Message <Context> 64-bit integral types are not supported on
this platform.
Description 64-bit integer types are not supported on the VAX
platform.
User Action Change the type to an integer type that is supported
on VAX, or compile the application on a platform that
does support 64-bit integers.
3 NOMACRONAME
Message #define directive is missing macro name identifier.
Description The #define preprocessing directive was not supplied
with an argument. The directive should be followed
with an identifier that specifies the macro name to
be defined. The directive will be ignored.
User Action Supply a valid argument to the preprocessing
directive.
3 NOMAINUFLO
Message No main function encountered within module.
/IEEE_MODE=UNDERFLOW_TO_ZERO is ignored.
Description Use of the /IEEE_MODE=UNDERFLOW_TO_ZERO is only
meaningful for compilation units that contain a main
program. The compiler will ignore the qualifier.
User Action Remove the qualifier from the command line.
3 NOMAPPOSSIBLE
Message The register "<register>" cannot be mapped to a
register on the target platform.
Description The pragma linkage directive contains
architecture-specific information. The Alpha
register conventions are different from the IA64
registers conventions. The compiler will normally
try to map the Alpha registers to the corresponding
registers on IA64. In this case this register cannot
be mapped because there is no corresponding IA64
register.
User Action Update the linkage to use a register that can be
mapped, or specify the linkage to use the
linkage_ia64 directive.
3 NONAMEMEMBERS
Message <Context> a struct or union has no named members.
This is undefined behavior according to the C
standard.
Description The C standard requires that a struct or union
contain at least one named member. Because this
struct/union contains no named members, it does not
conform to the C standard and might not be portable.
User Action Make sure at least one member has a name.
3 NONATOMIC
Message Unable to generate code for atomic access
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 NONEWTYPE
Message The type "<type>" is being declared as part of
<context>. C++ does not permit a new type to be
declared in this context. <Fix>.
Description C++ does not allow types to be declared in certain
contexts that are valid in C. One example is the
declaration of a type within a function prototype.
User Action Declare the type before its use.
3 NONGRNACC
Message Unable to generate code for requested granularity
Description The compiler has generated a call a routine that
performs longword operations on some data that is
requested to be accessed with byte granularity.
Because of this, the requested granularity will not
be met for this data access. This routine may be
generated for a memory copy routine (such as memcpy).
The call can also be generated for certain struct
assignments.
User Action If the data must be accessed with byte granularity
then write your own routine that does the required
action using byte objects. If byte granularity is
not needed at this point, the message can be ignored.
3 NONINTENUM
Message <Context> the enumeration type, and all associated
enumeration constants will have type <type> because
at least one enumeration constant had a value that
could not be represented in the type signed int.
Description The standard requires that enumeration constants have
a value representable as an int. Other C compilers
will allow enumeration constants to have values
outside this range. In some modes the HP C compiler
will allow this extension. To identify exactly which
constants are outside the range, enable the
nonintenumcon message.
User Action Be aware that other compilers may not support this
extension.
3 NONINTENUMCON
Message <Context> allowing an enumeration constant outside
the range of signed int is a language extension.
Description The standard requires that enumeration constants have
a value representable as an int. Other C compilers
will allow enumeration constants to have values
outside the range. In some modes the HP C compiler
will allow this extension.
User Action Be aware that other compilers may not support this
extension.
3 NONINTENUMCON1
Message <Context> this enumeration constant and its
associated enumeration type will not have the type
signed int. This behavior differs from earlier
versions of the compiler.
Description This message will only be output when the "enumrange"
message is disabled. This version of the HP C
compiler will allow enum constants to have a type
other than signed int. This is for compatibility
with other compilers. Programs that rely on the
compiler to truncate enum constants may not work as
expected. For more information, enable the
nonintenum message.
User Action If your program relies on this truncation, cast the
constant to int.
3 NONLBEFOREEOF
Message File does not end in unescaped newline.
Description The final character of a file was not a newline
character. This could indicate that the file has
been corrupted. The compiler will insert a newline
character at this point in the input stream.
User Action Update the source file so that it ends with a
newline.
3 NONMULTALIGN
Message The size of this structure is <size> bytes, which is
not a multiple of its alignment of <align>.
Respecify the alignment of the structure or add
<bytes> bytes of additional padding.
Description The size of a struct or union is not a multiple of
its alignment. This could cause unaligned accesses
if an array of these structs or unions is declared.
User Action Modify the struct/union or the alignment so that the
size of the struct or union is a multiple of the
alignment.
3 NONOCTAL
Message An octal constant contains non-octal digits.
Description An octal constant contains a non-octal digit. The
compiler will convert this non-octal digit to its
corresponding octal value and use that value instead.
For example, 0190 will be converted to 0210 (decimal
136) as the non-octal digit 9 is converted to the
octal 11.
User Action Correct the octal constant to use only octal digits.
3 NONPORTDEFINED
Message "defined" is treated as an identifier here, not an
operator.
Description For compatibility with older C compilers, in certain
modes the compiler will treat #ifdef defined(foo) as
#ifdef defined, and #ifndef defined(foo) as #ifndef
defined. This might not have been what you intended.
User Action Do not mix #ifdef/#ifndef with the defined operator.
3 NONPORTLINEDIR
Message Non-standard #line directive.
Description Accepting the line directive without the "line"
preprocessing keyword is an extension of HP C. The
program does not conform to the C standard, and might
not be accepted by other compilers.
User Action Add the "line" preprocessing keyword to the
directive.
3 NONSTANDCAST
Message <Context> "<expression>" of type "<type>", is being
converted to "<target type>". Such a cast is not
permitted by the standard.
Description The standard only permits casts from a pointer to an
object incomplete type to another pointer to an
object or incomplete type, or from a pointer to
function type to another pointer to function type.
Note that void is considered an incomplete type, so
casts between pointer to void and pointer to function
types are not permitted by the C standard.
User Action Be aware of this difference if you plan to port this
source to another compiler.
3 NONULINIT
Message <Context> , there is no room for the terminating
'\0'. Standard C allows this, but C++ does not.
Description This declaration initializes an object to a strict
literal. Although the object is large enough to hold
the characters in the literal, it is not large enough
to hold the terminating null character. This might
not have been what you intended. This practice is
also not valid in C++.
User Action Increase the size of the object, or reduce the size
of the initializer.
3 NOOPERAND
Message Stringization operator missing operand.
Description The preprocessing stringization operator "#" appears
in a macro body without a token argument after the
operator.
User Action Either remove the operator or supply it with a token
that will be stringized.
3 NOOPERANDS
Message Token pasting operator missing both operands.
Description The preprocessing token pasting operator "##" appears
in a macro body without either the preceeding or
following token arguments.
User Action Either remove the operator or supply it with two
tokens that will be pasted together.
3 NOPARENARGLST
Message Missing right parenthesis for macro argument list.
Description A macro invocation's argument list did not end in a
right parenthesis.
User Action Correct the program syntax.
3 NOPARM
Message This declaration does not declare a parameter.
Description The parameter declaration list of an old-style
function definition included a type but no parameter
identifier.
User Action Replace the old-style function definition with the
recommended prototype-format declaration. If this is
not possible, include the correct identifier after
the parameter type.
3 NOPARMLIST
Message The declaration of <function> has an empty parameter
list. If the function has parameters, they should be
declared here; if it has no parameters, "void" should
be specified in the parameter list.
Description The recommended way to declare a function that takes
no parameters is to use "void" in the parameter list.
User Action Make the recommended change.
3 NOPRAGARG
Message No argument for #pragma <pragma> was found. Pragma
is ignored.
Description A #pragma directive was not followed by one of the
expected arguments. The directive will be ignored.
User Action Supply all required arguments to the directive.
3 NOPSECT
Message Missing psect name.
Description The psect specifier in a globaldef declaration must
be a string constant.
User Action Either make the psect a string constant or remove the
psect specifier.
3 NOREGAVAIL
Message Unable to satisfy program register allocation
requirements.
Description The compiler is unable to allocate all the registers
requested by the program. This most often happens
when asm directives require too many registers.
User Action Rework the asm directives so they use fewer registers
3 NORELATIONAL
Message <Context> "<expression1>" and "<expression2>" cannot
be compared with a relational operator.
Description Because of their types, the two expressions cannot be
used as the operands of a relational operator. The
rules for which types can be used in a relational are
rather complicated and differ based upon the compiler
mode. Refer to the language documentation for a
complete list of valid combinations.
User Action Modify the relational to use valid types. This can
often be done by casting one of the expressions to
the type of the other.
3 NORETNONVOID
Message noreturn assertion of #pragma assert directive can't
be specified for non-void function.
Description noreturn assertion was specified in #pragma assert
directive for non-void function; the noreturn
assertion will be ignored.
User Action Either remove noreturn assertion from the directive,
or change return type for the function to void.
3 NORETURNVAL
Message The function "<name>" returns a value, but no value
is given in this return statement.
Description A function that returns a value contains a return
statement that is missing a return value. Therefore,
the returned value will be undefined. This might not
have been what you intended.
User Action Supply a return value for the return statement.
3 NORETURNVAL1
Message The function "<name>" has an implicit return type of
int, but no value is given in this return statement.
Description A function that has an implicit return type of int
contains a return statement that is missing a return
value. Therefore, the returned value will be
undefined. This might not have been what you
intended.
User Action Supply a return value for the return statement or
define the function with a void return type.
3 NORETVAL
Message routine <text> does not return a value
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 NORGHTPAREN
Message No right parenthesis for parameter list.
Description A macro definition's formal parameter list did not
end in a right parenthesis. A right parenthesis has
been assumed.
User Action End the formal parameter list with a right
parenthesis.
3 NORIGHTOPERND
Message Token pasting operator missing right operand.
Description The preprocessing token pasting operator "##" appears
in a macro body without a token argument after the
operator.
User Action Either remove the operator or supply it with two
tokens that will be pasted together.
3 NORIGHTPAREN
Message Missing ")".
Description A right parenthesis was expected at this point in the
program, but none was found.
User Action Correct the program syntax.
3 NOSEHHAND
Message Missing exception handler.
Description The __builtin_try clause must specify an exception
handler of either __builtin_finally or
__builtin_except. This message is only generated on
UNIX systems.
User Action Correct the __builtin_try clause.
3 NOSEMI
Message Missing ";".
Description The compiler was expecting a semicolon, but one was
not found.
User Action Correct the program syntax.
3 NOSEMI1
Message Missing ";". This condition may have been caused by
an open brace without a matching close brace. The
compiler will attempt to identify open braces that
might be missing a close brace.
Description The compiler was expecting a semicolon, but one was
not found. This condition may have been caused
missing close brace. This message is followed by
some number of additional messages that attempt to
identify the bad open brace.
User Action Correct the program syntax.
3 NOSEMISTRUCT
Message Missing ";" after last structure or union member.
Description Accepting a struct/union type without a semicolon
after the last member specifier is a language
extension of HP C provided for compatiblity with
older C compilers. This syntax is not valid in
standard C, and may not be accepted by other C
compilers.
User Action Add the semicolon at the end of the last member.
3 NOSFILE
Message Cannot create .s file: overlapping static storage
initializations at Psect <text> + <number>
Description When producing an output assembly file, the compiler
back-end as detected a case where the same storage
location has been initialized to more than one value.
This can occur when inter-file optimization has been
enabled.
User Action Remove one of the initializers.
3 NOSHAREEXT
Message noshare is a language extension.
Description The noshare storage class modifier is a language
extension of HP C. Other C compilers might not
successfully compile a program that uses the
extension.
User Action Be aware of this extension if you wish to port the
code.
3 NOSHRINSHR
Message Noshare variable resides in shr extern model -
noshare ignored.
Description The current extern model places all external objects
in a shareable section. Placing an object with a
noshare type qualifier in such a section is invalid.
The compiler will ignore the noshare type qualifier
User Action Place noshare objects in sections with the noshare
attribute.
3 NOSTRING
Message Missing string literal.
Description The compiler was expecting a string literal, but one
was not found.
User Action Correct the program syntax.
3 NOSUBTRACT
Message <Context> "<expression2>" cannot be subtracted from
"<expression1>".
Description Because of their types, the two expressions cannot be
used as the operands of the subtraction operator.
Either both operands must be arithmetic type, or both
operands must be pointers to qualified or unqualified
versions of compatible object types, or the left
operand must be a pointer type and the right operand
must be an integral type.
User Action Modify the subtraction to use valid types.
3 NOTADDRCAST
Message <Context> the address constant "<expression>" can be
cast only to a pointer type, but "<type>" is <type
class> type.
Description An address constant can only be cast to a pointer
type.
User Action Correct the cast.
3 NOTAREDUCTION
Message bad reduction path from fetch of <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 NOTCOMPAT
Message <Context> the type of "<name>" is not compatible with
the type of a previous declaration of "<name>" at
<location>.
Description The same identifier has been redeclared with a type
that is incompatible with the type given in a
previous visible declaration. In some modes, the
compiler will use the redeclared type as the type of
the identifier.
User Action Change the declarations to use compatible types.
3 NOTCOMPATIMP
Message <Context> the type of the function "<name>" is not
compatible with the earlier implicit declaration of
"<name>" at <location>.
Description The declared type of a function does not match the
type given to the function by its earlier implicit
declaration. This may cause unexpected behavior.
User Action Make sure that a valid function declaration is
visible at the point in the source where the function
is first called.
3 NOTCOMPFUNC
Message <Context> an invalid redeclaration of "<name>" to or
from a function type is being ignored.
Description In certain modes, the compiler will allow an
identifier to be redeclared with a different type.
In this case, the type of the redeclaration is used.
However, in cases where the identifier is redeclared
to or from a function type, the redeclaration is
ignored.
User Action Remove the redeclaration of the identifier.
3 NOTCONSTQUAL
Message <Context> the referenced type of the pointer value
"<expression>" is const, but the referenced type of
the target of this assignment is not.
Description In an assignment of two pointer types, the type
pointed to by the destination operand must have all
the type qualifiers of the type pointed to by the
source operand. In this case, the type pointed to by
the source has the const type qualifier, but the type
pointed to by the destination does not.
User Action Correct the assignment to use compatible types. This
can be done by inserting a cast operand.
3 NOTEXPECTING
Message Error parsing <what>. Found "<found>" when expecting
<expecting>.
Description While parsing the program, the compiler has
encountered something unexpected. The message will
detail what the compiler was trying to parse and the
item that was invalid, and will also produce a list
of those items it was expecting to find.
User Action Correct the offending section of the program.
3 NOTINCRTL
Message Identifier "<id>" is reserved by the
<C89|C99|C2010...> standard and will be mapped to
"<name>" although it is not available in the CRTL
available to the compiler.
Description The specified identifier is reserved for use as an
identifer with external lingage in the specified
version of the C standard. But according to the CRTL
mapping table available to the compiler, that
identifier is not defined in the CRTL you expect to
link against. This may be because the function or
object is not yet implemented in the current
DECC$SHR, or because you have used logical
DECC$CRTLMAP to specify a CRTL mapping table for a
version of the CRTL that does not implement it.
User Action If you intended to use the identifier as defined by
the C standard, and you have not defined the logical
DECC$CRTLMAP, then the identifier is not defined in
the DECC$SHR available to the compiler. If this is
the latest released DECC$SHR, then the identifier is
not yet implemented and you need to consider
workarounds; otherwise you should upgrade to the
latest available CRTL that does implement it. If you
did not intend to use the identifier as defined by
the C standard (i.e. it is an identifier you
expected to be defined by your application), then you
have a name clash with the specified version of the
standard and you should change the spelling of the
identifier; alternatively, you could disable
prefixing for it using /PREFIX=EXCEPT=, or specify an
older version of the standard with either /PREFIX= or
/STANDARD=.
3 NOTINTRINSIC
Message The function "<routine name>" is not a known
intrinsic function and cannot be used with #pragma
function. The function is unaffected by this pragma.
Description A function identifier specified in a #pragma function
directive is not a valid intrinsic function on this
platform. The function is thus never treated as an
intrinsic, and so #pragma function can never be
applicable to it. Perhaps the name was misspelled,
or perhaps the function was thought to be intrinsic,
possibly because it is intrinsic on some other
platform. In the latter case, the desired result,
that the function not be treated as intrinsic, would
happen with or without the pragma.
User Action Either correct the identifier spelling or remove the
use of the pragma.
3 NOTLOCALPARM
Message <Context> "<identifier>" is not a local parameter.
Description The second argument to the variable argument list
va_start macro is not a formal parameter of the
current function. The second argument to va_start
should be the rightmost parameter in the function
definition.
User Action Correct the second argument to va_start.
3 NOTONEORZERO
Message <Context> the value of "<expression>" is neither 0
nor 1.
Description The __builtin_va_start macro has been used
incorrectly.
User Action Correct the use of the macro.
3 NOTPARM
Message <Context> <name> is not a parameter.
Description The identifier name in the parameter declaration does
not match a name in the identifier list of an
old-style function definition.
User Action Correct either the identifier in the declaration or
in the identifier list so that they match. HP also
recommends that old-style function definitions be
replaced by prototype-format definitions.
3 NOTPOSINT
Message <Context> the array bound "<expression>" is not a
positive integer.
Description The compiler has encountered an array-bounds
specifier that is either zero or negative.
Array-bounds specifiers must be positive integer
constants.
User Action Correct the array-bounds specifier
3 NOTRESTQUAL
Message <Context> the referenced type of the pointer value
"<expression>" is restrict, but the referenced type
of the target of this assignment is not.
Description In an assignment of two pointer types, the type
pointed to by the destination operand must have all
the type qualifiers of the type pointed to by the
source operand. In this case, the type pointed to by
the source has the restrict type qualifier, but the
type pointed to by the destination does not.
User Action Correct the assignment to use compatible types. This
can be done by inserting a cast operand. Note that
care should be taken in assigning to a restricted
pointer type.
3 NOTRIGHTMOST
Message <Context> "<identifier>" is not the rightmost
parameter to "<function>".
Description The second argument to va_start was not the rightmost
parameter in the variable parameter list in the
function definition. This is an invalid argument to
va_start. Other compilers might not accept this
program.
User Action Update the second argument to va_start to use the
rightmost parameter.
3 NOTSCALARCTRL
Message The controlling expression "<expression>" has <type>
type, which is not scalar.
Description An execution control expression does not have scalar
type. This is not valid. An example of an execution
control expression is the expression following the
while keyword in a while statement.
User Action Change the control expression to have scalar type.
3 NOTTYPEDEF
Message <Context> "<name>" does not name a type.
Description This message is output when the compiler encounters
an identifier that it believes is a typedef and no
valid typedef by this name is defined in the current
scope. This most often occurs when there was an
error in the declaration of the typedef name.
User Action Correct the declaration of typedef.
3 NOTUNALQUA
Message <Context> the referenced type of the pointer value
"<expression>" is __unaligned, but the referenced
type of the target of this assignment is not.
Description In an assignment of two pointer types, the type
pointed to by the destination operand must have all
the type qualifiers of the type pointed to by the
source operand. In this case, the type pointed to by
the source has the __unaligned type qualifier, but
the type pointed to by the destination does not.
User Action Correct the assignment to use compatible types. This
can be done by inserting a cast operand.
3 NOTVOLQUAL
Message <Context> the referenced type of the pointer value
"<expression>" is volatile, but the referenced type
of the target of this assignment is not.
Description In an assignment of two pointer types, the type
pointed to by the destination operand must have all
the type qualifiers of the type pointed to by the
source operand. In this case, the type pointed to by
the source has the volatile type qualifier, but the
type pointed to by the destination does not.
User Action Correct the assignment to use compatible types. This
can be done by inserting a cast operand.
3 NOTYPES
Message Declaration has no type or storage class.
Description A file-scope declaration contains no type and no
storage-class specifier. In some modes, the HP C
compiler will treat this as a tentative definition of
an int variable. Accepting this declaration is an
extension to standard C provided for compatibility
with other compilers.
User Action Rewrite the declaration to contain a data type and/or
storage class.
3 NOUNIQFORMALS
Message Non-unique formal parameter definition.
Description The same name has been used for more than one formal
parameter in a macro definition. Any occurrence of
the name in the macro body will correspond to the
last formal parameter given this name.
User Action Each macro formal parameter should have a unique
name.
3 NOWHILE
Message Missing "while".
Description While processing a do statement, the compiler did not
find a while clause.
User Action Supply a while clause for the do statement.
3 NOWRTWRITTEN
Message Readonly psect <text> is written
Description The compiler has detected an attempt to write to
read-only storage.
User Action Either remove the write or make the storage
read/write.
3 OBJECTTOOBIG
Message The size of "<name>" exceeds the maximum size of an
object allowed on this platform which is <size>
bytes.
Description An object has been declared with a size that is too
large for this platform.
User Action Reduce the size of the object.
3 OKCPPINARGS
Message "#<directive>" directive within a macro argument list
is not portable.
Description HP C will allow certain directives to appear within
the argument list of a macro invocation. This might
not be portable.
User Action If possible, rewrite the macro invocation.
3 OPENBRACE
Message Missing "{".
Description The compiler was expecting an open brace, but one was
not found.
User Action Correct the program syntax.
3 OPENCOMMENT
Message A comment is not terminated.
Description The end of a file was reached while within a comment.
The message will indicate the start of the comment.
All source files, even those included via the
#include preprocessing directive, must not end in a
pending comment.
User Action Terminate the comment before the end of the source
file.
3 OPENPAREN
Message Missing "(".
Description The compiler was expecting an open parenthesis, but
one was not found.
User Action Correct the program syntax.
3 OPTIMIZEPOP
Message This "restore" has underflowed the pragma optimize
stack. No corresponding "save" was found.
Description The optimize stack, managed by the #pragma optimize
and #pragma environment directives, contains more
restores than saves. This could signify a coding or
logic error in the program.
User Action Make sure each restore has a corresponding save.
3 OPTLEVEL
Message Invalid optimization level <number>, defaulted to
<number>.
Description An optimization level that is outside the range of
valid optimization levels has been specified. The
compiler will default to the stated level.
User Action Supply a valid optimization level on the command
line.
3 OTHERDECLUSED
Message <Context> "<name>" is not declared in a scope active
at this point in the compilation. However, there is
a declaration of this identifer with extern storage
class in another scope at <where>. This declaration
will be used.
Description In some modes, if the compiler cannot find the
declaration of an object in the current scope, it
will search other scopes for extern declarations of
that object. If it finds such a declaration, it will
be used. Note that this is a language extension
provided for compatibility with other compilers.
User Action Declare the object so that it is visible at all
places it is referenced.
3 OTHERMEMBER
Message <Context> "<name>" is a member of another struct or
union.
Description In certain modes, the compiler will allow a struct or
union reference whose right operand is not a member
of the struct or union type of the left operand.
This is allowed for compatibility with other
compilers.
User Action Correct the struct or union reference so that the
member specifier is a member of the type of the left
operand.
3 OUTARGPREC
Message <Context> the type of this argument to <function
name> is not appropriate for the precision argument
of the conversion specifier "<incorrect conversion>".
Behavior can be unpredictable.
Description This argument corresponds to an output precision
specification. C requires that this argument have
integer type, and it does not.
User Action Cast the argument to an int type.
3 OUTARGWIDTH
Message <Context> the type of this argument to <function
name> is not appropriate for the width argument of
the conversion specifier "<incorrect conversion>".
Behavior can be unpredictable.
Description This argument corresponds to an output width
specifier. C requires that this argument have
integer type, and it does not.
User Action Cast the argument to an int type.
3 OUTFLOATINT
Message <Context> this argument to <function name> and
conversion specifier "<incorrect conversion>" combine
integer and floating-point types. Behavior can be
unpredictable.
Description The compiler has detected an output conversion
specifier whose data type does not match its
corresponding argument in a way that will cause
unpredictable behavior.
User Action Modify either the argument or the conversion
specifier so that they match.
3 OUTSTRINGTYPE
Message <Context> this argument to <function name> is of
"<type name>" type and is not appropriate for the
conversion specifier "<incorrect conversion>". The
value will be formatted in an unintended manner.
Description The compiler has detected a string conversion
specifier that does not match its corresponding
argument. This might not have been what you
intended.
User Action Modify either the argument or the conversion
specifier so that they match.
3 OUTTOOFEW
Message <Context> the number of conversion specifiers to
<function name> exceeds the number of values to be
converted. Conversion specifiers from "<last valid
conversion>" onward will process meaningless and
perhaps invalid data.
Description The number of conversion specifiers is greater than
the number of values to be converted as specified in
the parameter list. This is probably not what you
intended.
User Action Make sure the number of conversion specifiers match
the values to be converted.
3 OUTTOOMANY
Message <Context> additional arguments to <function name> are
provided for which there are no conversion specifiers
in the format string. Arguments from "<last
expression>" onward will be evaluated, but not
processed by <function name>.
Description The number of conversion specifiers is less than the
number of values to be converted as specified in the
parameter list. This is probably not what you
intended.
User Action Make sure the number of conversion specifiers match
the values to be converted.
3 OUTTYPELEN
Message <Context> this argument to <function name> is of
"<typeclass>" type and is not appropriate for the
conversion specifier "<incorrect conversion>". The
value might be truncated or formatted in an
unintended manner.
Description The compiler has detected an output conversion
specifier that does not match its corresponding
argument. This might not have been what you
intended.
User Action Modify either the argument or the conversion
specifier so that they match.
3 OUTVARORDER
Message <Context> variable ordering is used in a conversion
specifier for <function name>. If variable ordering
is used, it must be specified for all conversions.
Description A conversion specification can contain only one type
of conversion specification - % or %n$. Mixing them
will cause unpredictable behavior.
User Action Change the format specification to use only one type
of conversion specification.
3 PACKSTACKPOP
Message This "pop" has underflowed the pragma <stack name>
stack. No corresponding "push" was found.
Description The member_alignment/pack stack, managed by the
#pragma pack and #pragma member_alignment directives,
contains more pops/restores than pushes/saves, This
could signify a coding or logic error in the program.
User Action Make sure each pop/restore has a corresponding
push/save.
3 PARAMREDECL
Message <Context> "<name>" overrides a formal parameter
declared at <where>.
Description A declaration within a function body redeclares a
formal parameter.
User Action Change the name of either the formal parameter or the
declared variable.
3 PARENLITERAL
Message <Context> accepting a string literal in parentheses
as the initializer for a character array is a
language extension.
Description The compiler accepts this kind of initializer for
compatibility with many other C compilers. According
to the C standard, a string literal in parentheses is
a character pointer. Therefore, this program does
not conform to the standard and may be rejected by
other compilers.
User Action Remove the parentheses.
3 PARMINCOMP
Message <Context> the parameter <name> has an incomplete
type.
Description The parameter of an old-style function definition has
an incomplete type. This is not valid.
User Action Complete the type before the declaration of the
parameter. HP also recommends that old-style
function definitions be replaced by prototype-format
definitions.
3 PARMINIT
Message <Context> a parameter declaration cannot include an
initializer.
Description The parameter declaration list of an old-style
function definition included an initializer. This is
not valid.
User Action Remove the initializer from the declaration and
initialize the parameter in the function body. HP
also recommends that old-style function definitions
be replaced by prototype-format definitions.
3 PARMSTORCLS
Message <Context> a parameter has an explicit storage class
other than "register".
Description The only storage class that can be specified for a
formal parameter is "register".
User Action Either remove the storage class or use "register" if
that is desired.
3 PARMSTORMOD
Message <Context> a parameter cannot have a storage class
modifier.
Description A formal parameter cannot be declared with a storage
class modifier.
User Action Remove the storage class modifier.
3 PARMTYPLIST
Message Ill-formed parameter type list.
Description While processing a function declaration, an invalid
parameter type list was encountered.
User Action Correct the program syntax.
3 PARNOIDENT
Message Missing identifier.
Description While processing an old-style function definition,
the compiler was expecting an identifier, but one was
not found.
User Action Correct the program syntax. HP also recommends that
old-style function definitions be replaced by
prototype-format definitions.
3 PDBOPERR
Message Error opening PDB file <text>: <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 PDBTYPERR
Message Error adding type record to PDB file: <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 PDOINDEXNOTPRIV
Message index variable of PDO <text> is not a private
variable
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 PDONEINSTATIC
Message pdone <text> in statically-scheduled PDO will be
ignored
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 PDONENOTINPDO
Message pdone <text> is not nested in a PDO
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 PLUSWSTOCLS
Message The use of the <spelling> option has prevented this
redeclaration of "<variable>" from changing its
linkage. The linkage will be that specified by the
earlier declaration at <location>.
Description In many cases, the compiler will allow a
redeclaration of an item to change its linkage. For
example, in most modes, if an object is declared with
extern linkage and later with static linkage, the
compiler will give it static linkage. This changing
of linkage usually causes a warning to be issued.
However, in cases where interfile optimization has
been selected (-ifo on UNIX, /PLUS_LIST_OPTIMIZE on
OpenVMS), the compiler cannot allow a later
declaration to modify the linkage of a previous
declaration.
User Action Change all declarations to use the same linkage.
3 POINTERINTCAST
Message <Context> the 64-bit pointer "<expression>" is being
cast to an integer type that is only <size> bits in
size. This behavior is undefined.
Description Casting a 64-bit pointer to a shorter integer type is
undefined behavior. This also could indicate code
that relies on pointers and integers being the same
size. The code will cause an unexpected loss of data
on 64-bit platforms.
User Action If this is the intended behavior, first cast the
pointer to a 64-bit integer, then cast the result to
the desired integer type.
3 POPMISMATCH
Message The member alignment popped/restored with pragma
<pragma name> was saved using pragma <pragma name>.
The member alignment restored will take effect.
Description HP C supports two forms of the member alignment
directives. One begins with #pragma pack, the other
with #pragma member_alignment. A program has mixed
the pack and the member_alignment form of the
directives in a way that is not recommended. This
might indicate a programming error.
User Action If a member alignment has been saved by one form of
the member-alignment directive, it should be restored
by the same form of the directive.
3 PRAGIGNORE
Message The pointer size control <name> pragma is not active.
Pragma is ignored.
Description Either one of the pragmas that used to control
pointer size has been specified on a platform that
does not support mixed pointer sizes, or the #pragma
pointer_size directive has been used without the
appropriate command-line option or qualifier. In all
cases, the directive is ignored.
User Action Either remove the directive or add the appropriate
command-line option.
3 PRAGMA
Message Strict standard C extension: A #pragma directive was
encountered.
Description As the purpose of a #pragma directive is to specify
implementation-defined behavior, it is likely that
other C compilers will not treat this pragma in the
same way HP C will.
User Action Be aware of this if you wish to port the program.
3 PRAGMAIDENT
Message Please use the preferred "#pragma ident" directive in
place of the "#ident" directive.
Description The #ident directive is a language extension. Other
C compilers might not accept it.
User Action Use the portable #pragma ident directive instead.
3 PRAGMAINBLK
Message The pragma <name> cannot be used inside a function
block.
Description This #pragma directive is only permitted at file
scope, outside of all function definitions.
User Action Move the directive to file scope, preceding the
function definition that is to be affected. To limit
the pragma to just that particular function, sandwich
the #pragma and the function definition between a
pair of matching pragmas with the save and restore
keywords.
3 PRAGMAMOD
Message Please use the preferred "#pragma module" directive
in place of the "#module" directive.
Description The #module directive is a language extension. Other
C compilers are unlikely to accept it.
User Action Use the portable #pragma module directive instead.
3 PRAGMAOPTDUP
Message This #pragma optimize has already modified this
optimization setting. This setting will replace the
old.
Description A #pragma optimize has specified the same
optimization setting more than once. The later
setting will replace the previous one.
User Action Remove the earlier setting.
3 PRAGMAOPTLVL
Message The level set by a #pragma optimize directive must be
between 0 and 5. Pragma is ignored.
Description A #pragma optimize has tried to set the optimization
level to a value outside the valid range. The
compiler will ignore the directive.
User Action Set the optimization level to a number from 0 to 5.
3 PRAGMAOPTSPEC
Message Setting speculation control is not available on this
platform. The setting will be ignored.
Description Setting speculation control in only available on
certain platforms. Trying to modify the setting on
other platforms will have no effect.
User Action Remove the speculation setting.
3 PRAGMAOPTZERO
Message If a #pragma optimize specifies level=0, that must be
the only optimization setting specified by the
pragma. Pragma is ignored.
Description If a #pragma optimize specifies level=0, that must be
the only optimization setting specified by the
pragma. The compiler will ignore the directive.
User Action Remove the other settings specified by the directive.
3 PREOPTE
Message An error was detected in the processing of a <option
spelling> option: <#define or #undefine problem>
Description An error was encountered during the processing of a
macro definition specified on the command line. The
message should provide additional information about
the error.
User Action Correct the command line argument.
3 PREOPTW
Message A problem was detected in the processing of a <option
spelling> option: <#define or #undefine problem>
Description A problem was encountered during the processing of a
macro definition specified on the command line. The
message should provide additional information about
the problem.
User Action Correct the command-line argument.
3 PREPROCOUT
Message An error occurred while attempting to open either the
preprocessor output file or the dependency file:
<problem>.
Description An unexpected error occurred during the creation of a
preprocessor output file or a dependency file. The
message text will contain additional information
about the failure.
User Action Correct the condition that caused the failure.
3 PRIVATENOTSHARE
Message variable <text> on a local or lastlocal list is not
declared in a shared scope.
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 PROMOTMATCH
Message <Context> the promoted type of <name> is incompatible
with the type of the corresponding parameter in a
prior declaration.
Description The promoted type of a parameter of an old-style
function declaration does not match the type given
earlier in a prototype declaration of the function.
User Action Correct the data types so they match. HP also
recommends that old-style function definitions be
replaced by prototype-format definitions.
3 PROMOTMATCHW
Message <Context> the promoted type of <name> is incompatible
with the type of the corresponding parameter in a
prior declaration.
Description The promoted interger or floating type of a parameter
of an old-style function declaration does not match
the integer or floating type given earlier in a
prototype declaration of the function.
User Action Correct the data types so they match. HP also
recommends that old-style function definitions be
replaced by prototype-format definitions.
3 PROTOF
Message An error occurred while attempting to open the
prototype output file: <problem>.
Description An unexpected error occurred during the creation of a
prototype output file. The message text will contain
additional information about the failure.
User Action Correct the condition that caused the failure.
3 PROTOSCOPE
Message The type "<type>" has been declared within and is
limited to a function prototype scope. It will not
be compatible with an identical type declared in
another scope. This might not be what you intended.
Description A type is declared within a function prototype. The
type is local to the function prototype and will not
be visible outside the prototype. This might cause
unexpected errors later in the compilation.
User Action Declare the type before the function prototype.
3 PROTOSCOPE2
Message <Context> the struct type was previously declared
with prototype scope in this function. Now it is
declared with a different prototype scope.
Description This function declaration contains a parameter that
is a pointer to a type that has prototype scope, and
an earlier declaration of the function contains a
parameter that is also a pointer to a type that has a
different prototype scope. In most compiler modes
this will cause the function redeclarations to
differ.
User Action Avoid declaring types with function prototype scope.
3 PROTOSCOPE3
Message <Context> the struct type was previously declared in
this function with prototype scope. Now it is
declared with file scope.
Description This message is generated when the compiler first
encounters a function prototype that declares a type
with prototype scope, and then later sees a second
declaration or definition of that same function with
the parameter declared using the same type declared
at file scope. For example: void foo(struct S { int
a; int b;} *s); struct S { int a; int b;} s; void
foo(struct S *s);
User Action Declare the type at file scope before the first
prototype declaration.
3 PROTOSTATIC
Message The extracted header file contains prototypes for
static functions, which should be removed before
including the header in a source file other than the
originator.
Description When extracting function prototype declarations, the
compiler has encountered a static function. The
prototype declaration placed in the output .H file
should be removed if the .H file is included in any
source other than that used to create the .H file.
This is because those static functions may not be
declared in the other files. This message can only
be generated when the compiler has been invoked with
the option to extract function prototype
declarations, and the suboption to generate
prototypes for static functions has also been
specified.
User Action Be aware of this if you wish to use the output .H
file in a file other than the one from which the .H
file was generated.
3 PROTOTAG
Message The extracted header file contains prototypes with
tag names, which should be moved to after the tag
name declaration.
Description When extracting function prototype declarations, the
compiler has encountered a parameter type specifier
that references a tag. Because the created prototype
will use this tag, it should be moved after the tag
declaration in the final compilation source. This
message can only be generated when the compiler has
been invoked with the option to extract function
prototype declarations.
User Action Be aware of this if you wish to use the output .H
file.
3 PROTOTYPEDEF
Message The extracted header file contains prototypes with
typedefs, which should be moved to after the typedef
declaration.
Description When extracting function prototype declarations, the
compiler has encountered a parameter type specifier
that is defined by a typedef. Because the created
prototype will use this typedef, it should be moved
after the typedef declaration in the final
compilation source. This message can only be
generated when the compiler has been invoked with the
option to extract function prototype declarations.
User Action Be aware of this if you wish to use the output .H
file.
3 PROTOVLA
Message The extracted header file contains prototypes for
functions which have formal parameters with variably
modified type. All variable length bound specifiers
have been replaced by a "*" signifying a variable
length array of unspecified size.
Description When extracting function prototype declarations, the
compiler has encountered a function or functions
which have a formal parameter with variably modified
type. The compiler is unable to recreate the source
that specified the number of array elements.
Instead, the output prototype will use the "*" bounds
specifier. Note that the output prototype is valid
for the function.
User Action Be aware that the compiler has made this minor change
to the function declaration.
3 PSECTFIRST
Message "#pragma <psect_type>" directive must precede any
declarations.
Description The #pragma code_psect or #pragma linkage_psect
directives must appear before any function or
external data definitions.
User Action Place the directive earlier in the source program.
3 PSECTTOOLONG
Message Psect name is too long (maximum is 31 characters).
Pragma is ignored.
Description A psect name specified in a #pragma code_psect,
#pragma linkage_psect, or #pragma extern_model
directive must be less than 32 characters in length.
The compiler will ignore the directive.
User Action Shorten the psect name.
3 PTRINTTOLONG
Message <Context> "<expression>", a pointer to a 32-bit
integer, is being cast to a pointer to a 64-bit
integer. This may lead to unintended results.
Description On many platforms long integers are the same size as
integers, and casting a pointer to int to a pointer
to long int is not a problem. On this platform long
integers are 64-bits. This cast could indicate a
potential porting problem.
User Action Verify that this is the intended behavior.
3 PTRLONGTOINT
Message <Context> "<expression>", a pointer to a 64-bit
integer, is being cast to a pointer to a 32-bit
integer. This may lead to unintended results.
Description On many platforms long integers are the same size as
integers, and casting a pointer to long int to a
pointer to int is not a problem. On this platform
long integers are 64-bits. This cast could indicate
a potential porting problem.
User Action Verify that this is the intended behavior.
3 PTRMISMATCH
Message <Context> the referenced type of the pointer value
"<expression>" is "<type>", which is not compatible
with "<target type>".
Description In a pointer assignment, the type pointed to by the
source pointer is different than the type pointed to
by the destination pointer.
User Action Correct the assignment to use compatible types. This
can be done by inserting a cast operand.
3 PTRMISMATCH1
Message <Context> the referenced type of the pointer value
"<expression>" is "<type>", which is not compatible
with "<target type>" because they differ by
signed/unsigned attribute.
Description In a pointer assignment, the type pointed to by the
source pointer is different than the type pointed to
by the destination pointer. In this case the types
differ because the signed/unsigned type attributes
are different.
User Action Correct the assignment to use compatible types. This
can be done by inserting a cast operand.
3 QUALAFTCOMMA
Message Type qualifier(s) after a comma ignored.
Description In Microsoft mode, the compiler used to accept a type
qualifier after a comma used for separating
declarators. Because Microsoft no longer accepts
this type of declaration, HP C will no longer accept
it. The type qualifier is ignored.
User Action Remove the type qualifier.
3 QUALFUNCRET
Message The return type of "<name>" is a qualified type.
Type qualifiers have no meaning for function return
values.
Description A type qualifier has been used as part of the type of
a function return value. The type qualifiers have no
meaning for function return values.
User Action Remove the type qualifier.
3 QUALISPTR
Message <Context> "<expression>" has a pointer type, but
occurs in a context that expects a struct or union.
Description The left operand of the struct/union member operator
(.) is a pointer type instead of a struct or union
type.
User Action Specify the correct struct or union type object as
the left operand. In cases where the left operand is
a pointer to a struct or union, it might be possible
to use the struct/union pointer operator (->) instead
of the member operator.
3 QUALNA
Message The <qualifier name> qualifier is not available on
this platform and will be ignored.
Description The specified qualifier is not supported on this
platform.
User Action Remove the qualifier from the command line.
3 QUALNOTUS
Message <Context> the qualifier for "<name>" is not a struct
or union.
Description In certain modes, the compiler will allow the left
operand of a struct/union member reference to be
certain types other than a struct or union type. In
these cases the compiler will issue a warning that
this non-standard syntax is being accepted.
User Action Modify the left operand to be a struct or union type.
3 QUESTCOMPARE
Message <Context> the unsigned expression "<expr>" is being
compared with a relational operator to a constant
whose value is not greater than zero. This might not
be what you intended.
Description An ordered comparison between an unsigned value and a
constant that is less than or equal to zero often
indicates a programming error. Humans consider an
unsigned value to be larger than any negative value.
But in C a negative value is converted to an unsigned
value before the comparison, so any negative value
compares larger than most unsigned values. An
ordered comparison of an unsigned value to zero
suggests a programming error because the value can
only be greater than or equal to zero. If the code
is correct, the comparison could be more clearly
coded by testing for equality with zero.
User Action Cast (or otherwise rewrite) one of the operands of
the compare to match the signedness of the other
operand, or compare for equality with zero.
3 QUESTCOMPARE1
Message <Context> the unsigned expression "<expr>" is being
compared with an equality operator to a constant
whose value is negative. This might not be what you
intended.
Description An unsigned value and a signed constant whose value
is negative are being compared for equality.
Logically, these value would never be equal. But in
C the negative constant value is converted to an
unsigned value before the comparison, and may well
compare equal.
User Action Cast (or otherwise rewrite) one of the operands of
the compare to match the signedness of the other
operand.
3 QUESTCOMPARE2
Message <Context> the unsigned expression "<expr>" is being
tested to see if it is greater than zero. This might
not be what you intended.
Description An ordered comparison between an unsigned value and a
constant that is zero may indicate a programming
error. Often C programmers do not realize that an
expression has an unsigned type. If the code is
correct, the comparison could be more clearly coded
by testing for equality with zero.
User Action Cast (or otherwise rewrite) one of the operands of
the compare to match the signedness of the other
operand, or compare for equality with zero.
3 READONLYEXT
Message readonly is a language extension.
Description The readonly storage class modifier is a language
extension of HP C. Other C compilers might not
successfully compile a program that uses the
extension.
User Action Be aware of this extension if you wish to port the
code.
3 REDECLNOPARAM
Message <Context> the declaration of the function "<name>"
containing no parameter information replaces an
earlier declaration of "<name>" at <location>.
Description A function which was previously declared with a
function prototype has been redeclared without
parameter information. This is a violation of the C
standard. The HP C compiler will accept this for
compatibility with older compilers.
User Action Remove one of the declarations.
3 REDEF
Message This declaration contains a redefinition of "<name>".
The previous declaration is at <location>.
Description This declaration has tried to redefine an identifier
that was defined earlier. This is not valid.
User Action Remove one of the definitions.
3 REDEFSTRUCT
Message <Context> the struct "<name>" is redefined.
Description The struct tag declared in this declaration is
already declared as a struct tag by another
declaration.
User Action Change the name of the struct tag.
3 REDEFTAG
Message <Context> the tag "<name>" is redeclared.
Description The tag declared in this declaration is already
declared.
User Action Change the name of the tag.
3 REDEFUNION
Message <Context> the union "<name>" is redefined.
Description The union tag declared in this declaration is already
declared as a union tag by another declaration.
User Action Change the name of the union tag.
3 REFBEFORETLS
Message <Context> the reference to the variable "<var>"
lexically precedes its use in a #pragma omp
threadprivate directive. This is not allowed.
Description An OpenMP threadprivate directive must lexically
precede all references to any varible in its variable
list. The compiler had detected a reference to a
variable which appears in a subsequent threadprivate
directive.
User Action Move the threadprivate directive before the
reference.
3 REGCONFLICT
Message Conflicting required uses of register(s): <text>
Description The special linkage associated with a function has
specified that one of the standard calling convention
registers be used in a nonstandard way without also
replacing its standard use with another register. An
example would be a function that returns an int value
using a special linkage that states R0 is not used,
and does not specify another register to hold the
return value.
User Action Correct the #pragma linkage directive that specifies
the special linkage.
3 REGNOSHARE
Message <Context> noshare cannot be used with the register
storage class. Modifier noshare is ignored.
Description The storage class modifier noshare is meaningless for
objects declared with register storage class. The
compiler ignores the noshare.
User Action Remove the noshare storage class modifier.
3 RELOCALIGNMENT
Message An initialization requiring relocation is not
correctly aligned at Psect <text> + <number>
Description On some platforms, initializing an object to an
address requires that the object be aligned on a
natural boundary.
User Action Either remove the static initializer or align the
object being initialized.
3 RESMISMATCH
Message The pointer size restored with pragma <pragma name>
was saved using pragma <pragma name>. The pointer
size restored will take effect.
Description HP C supports two forms of the pointer-size
directives. One begins with #pragma pointer_size,
the other with #pragma required_pointer_size. A
program has mixed the required_pointer_size and the
pointer_size form of the pointer-size directives in a
way that is not recommended. This might indicate a
programming error.
User Action If a pointer size has been saved by one form of the
pointer-size directive, it should be restored by the
same form of the directive.
3 RESTRICTEXT
Message The __restrict type qualifier is a language
extension.
Description The use of the __restrict type qualifier might not be
portable to other C compilers.
User Action Be aware of this portability concern.
3 RESTRICTEXT1
Message Placement of the __restrict qualifier within the
array-bound specifier of a formal parameter
declaration is a language extension.
Description The use of the restrict type qualifier within the
array bound specifier of a formal parameter is a
language extension supported by HP C. Other C
compilers might not successfully compile a program
that uses this extension.
User Action Be aware of this if you wish to port the program.
3 RESTRICTEXT2
Message The restrict type qualifier is a new feature in C99.
Other C compilers might not successfully compile a
program that uses this feature.
Description The use of the restrict type qualifier might not be
portable to other C compilers.
User Action Be aware of this portability concern.
3 RESTRICTNOP
Message The restrict type qualifier can only be applied to a
pointer type that points to an object or incomplete
type. Qualifier is ignored.
Description The restrict type qualifier has been used with an
invalid type. Only pointers to object or incomplete
types can have the restrict type qualifier. The
compiler will ignore the type qualifier in all other
cases.
User Action Remove the type qualifier or change the type to one
that accepts the qualifier.
3 RETLOCALADDR
Message This return statement returns the address of a local
variable. The address returned cannot be used by the
caller in any meaningful way.
Description The storage for all local variables is undefined
after a function has returned. Returning the address
of a local variable will cause undefined behavior
when the return value is used in the calling program.
User Action Either change the variable to have static storage
duration, use malloc to allocate the storage (and
free it after its use), or change the interface to
have the caller pass in the address at which data is
to be stored.
3 RETRYCONV
Message Built-in function <retry-name> is not available on
this platform. It has been converted to
<nonretry-name> by ignoring the retry count and
setting the retry status to 1.
Description The version of this built-in function with retry
capability is not available on the IA64 platform.
User Action Use the non-retry version of this built-in function.
3 RETRYNOTAVAIL
Message Built-in function <name> with retry count is not
available on this platform. The retry count is
ignored.
Description The retry capability of this built-in function is not
available on the IA64 platform.
User Action Remove retry count from built-in function call.
3 RETVALTOOBIG
Message The size of return value of "<name>" exceeds the
maximum size of an object allowed on this platform
which is <size> bytes.
Description A function's return value is too large for this
platform.
User Action Reduce the size of the return value.
3 RIGHTSHIFTOVR
Message <Context> the right shift count "<number>" is greater
than or equal to the size of the unpromoted operand
"<expression>".
Description The compiler has detected a right shift count that is
greater than or equal to the size of the operand to
be shifted (before application of the integral
promotions). This might not be what you intended, as
the result contains none of the original bits of the
operand. For an unsigned operand, the result is
always 0. For a signed operand, the result is either
0 or -1, depending on whether or not the operand had
a negative value. The same result would be achieved
by shifting a signed operand one fewer bits.
User Action Correct the shift count (or replace the expression by
0 if appropriate).
3 RTEXCEPT
Message <Context> the floating-point constant named "<name>"
will cause an exception at runtime.
Description The IEEE trap mode of this program will cause an
exception at runtime if this floating-point constant
is used in an expression.
User Action If you do not choose to cause a runtime exception,
replace the named constant with a conventional
floating point constant. The HUGE_VAL macros defined
by <math.h> may be used in place of IEEE Infinities
with any floating-point representation.
3 RTLMAPNOTFOUND
Message C RTL mapping information for RTL <name> not found.
Could not access <image_name>.
Description In most cases, the HP C compiler will automatically
map names of C standard library functions to their
corresponding names in the HP C RTL shareable image.
In many cases, this is done simply by adding a
"DECC$" prefix to the name. In order for this
mapping to work, the compiler accesses an RTL mapping
table. This message is issued if the compiler was
unable to open the mapping table. In these cases, no
name mapping will be performed. The most common
cause of this message is specifying bad name in the
/PREFIX=RTL="name" compiler qualifier.
User Action Specify a valid RTL on the /PREFIX=RTL qualifier. If
no qualifier was used, it might be necessary to
reinstall the compiler and/or RTL. For more
information consult the HP C Run-time Library Manual
for OpenVMS Systems.
3 RTLMISMATCH
Message HP C RTL prefix table version mismatch: RTL table is
V<major>.<minor>, compiler needs V<major>.<minor>.
Description In most cases, the HP C compiler will automatically
map names of C standard library functions to their
corresponding names in the HP C RTL shareable image.
In many cases, this is done simpl by adding a "DECC$"
prefix to the name. In order for this mapping to
work, the compiler accesses an RTL mapping table.
The compiler also requires that the version of the
RTL mapping table be compatible with the version of
the compiler. In cases where the versions are
incompatible, this message is generated. In these
cases, no name mapping will be performed. The most
common cause of this message is specifying an old RTL
name in the /PREFIX=RTL="name" compiler qualifier.
User Action Specify a new RTL on the /PREFIX=RTL qualifier. If
no qualifier was used, it might be necessary to
reinstall the compiler and/or RTL. For more
information, consult the HP C Run-time Library Manual
for OpenVMS Systems.
3 SAMEASTYPEDEF
Message <Context> the extern has the same name as a
file-scope typedef. This is a language extension.
Description The program has declared an extern inside a function
whose name matches a file-scope typedef. This is not
allowed by the C standard, but is accepted for
compatibility with other C compilers.
User Action Change the name of the variable or the typedef.
3 SCACALL
Message This function contains too many parameters for SCA to
handle. Function parameter info will be truncated.
Description The parameter information for this function contains
more data than SCA can process. The compiler will
truncate the parameter information. Be aware that
the parameter information will be incomplete.
User Action Simplify the parameter information.
3 SCAID2LONG
Message The identifier exceeds the SCA limit of <number>
characters. In the SCA file the name will be
truncated to "<truncated spelling>".
Description The length of an identifier supported by SCA is less
than the length of an identifier supported by the HP
C compiler. Because of this, the compiler will
truncate an identifier name to fit the SCA limits.
User Action Either reduce the identifier name, or be aware of
this when using SCA.
3 SCALEFACTOR
Message The CDD description for <name> specifies a scale
factor of <number>. The scale factor is being
ignored.
Description HP C does not support scaled arithmetic.
User Action Verify that all computations involving this item are
correctly scaled.
3 SCAOVFLO
Message Compiler Internal Error: SCA event buffer
overflowed. Please submit a problem report.
Description When building SCA information, the compiler
overflowed its internal buffer. This should not
happen.
User Action Please submit a problem report detailing the failure.
3 SEQUENCEEXT
Message <Context> allowing a comma operator is a language
extension.
Description In this context the C standard does not allow the
comma (sequence) operator. HP C allows this syntax
for compatibility with some other C compilers. Be
aware that this syntax may not be accepted by other C
compilers.
User Action If the intent is to use an expression that is not
necessarily a constant expression, then enclose it in
parentheses. But if the intent of the declaration is
to use a constant expression, then the comma operator
cannot be used.
3 SESEMULTIEXITS
Message parallel directive scope <text> has multiple exits
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 SESEMULTIPREDS
Message parallel directive scope <text> has multiple entry
paths
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 SESEVFLOW
Message parallel directive scope <text> is crossed by a
VBRANCH
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 SHARECONST
Message In this declaration, noshare has been ignored due to
the presence of const or readonly.
Description A variable declared with the readonly storage class
modifier, or the const type modifier cannot also have
the noshare storage class modifier. The compiler
will ignore the noshare storage class modifier.
User Action Remove either the noshare storage class modifier or
the const or readonly modifiers.
3 SHIFTCOUNT
Message <Context> the shift count "<number>" is negative or
is greater than or equal to the promoted size of the
operand "<expression>".
Description The compiler has detected a shift count that is
negative or is greater than or equal to the promoted
size of the operand to be shifted. This behavior is
undefined.
User Action Correct the shift count.
3 SHORTCIRCUIT
Message <Context> potential side effects from the evaluation
of "<operand>" will not take place. This is because
the first operand of a logical operator is a constant
whose value requires that this expression must not be
evaluated.
Description The C language requires that if the first operand of
a logical || or && operator determines the result of
the expression, the second operand must not be
evaluated. This behavior is different from other
operators. The compiler has noticed that the second
operand will generate code that may produce side
effects that the programmer expects to take place.
This message is to inform the user that the code
generated for the second operand will not be
executed.
User Action Replace the logical expression with its first
operand.
3 SHOWMAPLINKAGE
Message The linkage has been mapped to: #pragma linkage_ia64
<name> = (<stuff>).
Description The pragma linkage directive contains
architecture-specific information. The Alpha
register conventions are different from the IA64
register conventions. The compiler will try to map
the Alpha registers to the corresponding registers on
IA64. This message details the mapping.
User Action Replace the linkage directive with the linkage_ia64
directive that appears in the message.
3 SIGNEDKNOWN
Message <Context> HP C recognizes the standard keyword
"signed". This differs from the VAX C behavior.
Description VAX C does not recognize the "signed" keyword. HP C
will allow this, even in vaxc mode.
User Action Be aware of this difference if you plan to compile
the source with VAX C.
3 SIGNEDMEMBER
Message <Context> HP C recognizes the standard C keyword
"signed" in member declarations. The VAX C compiler
does not and would treat the member as unsigned.
Description VAX C does not recognize the "signed" keyword in a
member declaration. VAX C will treat the member as
an unsigned type. HP C will recognize the keyword
and declare the member as a signed type.
User Action Be aware of this difference if you plan to compile
the source with VAX C.
3 SIMPLEMESSAGE
Message <user text>
Description The compiler has encountered a #pragma message
(<quoted string>)directive. It will output the
message in the quoted string.
User Action Remove the pragma message.
3 SIZEBIT
Message <Context> "<expression>" is a bitfield, and so has no
size.
Description A bitfield expression cannot be used as the argument
to the sizeof operator or the __builtin_alignof
builtin.
User Action Pass an expression with a valid type to the operator
or builtin.
3 SIZEINCOMP
Message <Context> "<expression>" is of an incomplete type,
and so has no size.
Description An expression that has incomplete type has no size
and therefore cannot be used as the argument to the
sizeof operator.
User Action Pass an expression with a valid type to the sizeof
operator.
3 SIZEINCOMPTYP
Message <Context> "<type>" is an incomplete type, and so has
no size.
Description A incomplete type has no size and therefore cannot be
used as the argument to the sizeof operator.
User Action Pass a valid type to the sizeof operator.
3 SIZFUNVOIDTYP
Message <Context> "<type>" has function or void type and may
not appear in this context. The compiler will treat
the type as if it were char.
Description A function or void type cannot be used as the
argument of the sizeof operator or the
__builtin_alignof builtin. For compatibility with
some other compilers, an output file is still
created. The result produced will be the same as if
a char type was passed. This may or may not be
compatible with other compilers that accept this
syntax.
User Action Pass a valid type to the operator or builtin.
3 STACKPOP
Message This "restore" has underflowed the pragma <stack
name> stack. No corresponding "save" was found.
Description One of the pointer-size stacks, managed by the
#pragma pointer_size, #pragma require_pointer_size,
#pragma required_vptr_size, and #pragma environment
directives, contains more restores than saves. This
could signify a coding or logic error in the program.
User Action Make sure each restore has a corresponding save.
3 STATICIFLOAT
Message <Context> conversion of a link-time address constant
to a floating type is required. This is not allowed.
Description The initialization of an object with static extent
requires a value that is a link-time constant
expresion. Link-time constant expressions cannot
involve values of floating types (other than floating
constants that are the immediate operands of casts).
User Action Remove the floating point types from the
initialization.
3 STATICVLA
Message <Context> the static object "<name>" cannot be a
variable length array.
Description Only ordinary identifiers with block scope and
without storage class extern or static, or ordinary
identifiers with function prototype scope can be
declared as variable-length arrays.
User Action Correct the declaration.
3 STATINITWARN
Message <Context> the linker will be unable to perform this
static initialization if the initializer is defined
in a sharable image.
Description A static initialization will require that a link-time
constant be truncated. If the constant is resolved
in a sharable image, the linker will issue a
diagnostic and be unable to perform the
initialization. This message is output on OpenVMS
systems only.
User Action Rewrite the static initialization so that the
link-time constant will not be truncated.
3 STDARG
Message <Context> stdarg.h macros might be required if the
address of the parameter <name> is used to index
through a parameter list.
Description Some older C programs will traverse a function's
parameter list by taking the address of one of the
parameters and then adjusting it to get to subsequent
parameters. In most cases, this technique will not
produce the desired results on Alpha. This message
is specific to UNIX, and is only output if -varargs
option is specified.
User Action If the address is used to walk the parameter list,
recode the function to use the standard stdarg.h
macros.
3 STKALLEXC
Message Allocations to stack exceeded maximum stack size
Description A routine uses more stack space than is available on
this platform. This is most often caused by
declaring too many large automatic variables.
User Action Reduce the size required by the automatic variables.
3 STOALNERR
Message Psect <text> alignment is insufficient for allocation
of <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 STONOTFIRST
Message The placement of a storage-class specifier other than
at the beginning of the declaration specifiers in a
declaration is an obsolescent feature.
Description The standard states that this style of declaration is
obsolescent.
User Action Place the storage-class specifier first in the
declaration.
3 STORCLSDCL
Message <Context> a storage class without a declarator is
meaningless.
Description This message is generated when the compiler
encounters certain declarations that contain a
storage class but no declarator. For example:
extern struct S { int a;};
User Action Either remove the storage class or add a declarator
to the declaration.
3 STOREBIF
Message Built-in function <store-bif> is not available on
this platform. It may be converted to <swap-bif> if
the source and dest parameters are identical.
Description The STORE version of this built-in function is not
available on the IA64 platform.
User Action Use the SWAP version of this built-in function.
3 STOREQEXC
Message Allocations to <text> section exceeded growth bounds
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 STORISSTAT
Message This redeclaration of the static initialized variable
"<name>" will have static storage class that differs
from the VAX C behavior. The previous declaration is
at <location>.
Description In VAX C mode, if a variable is first declared static
and then declared extern, the variable will be given
extern storage class. This matches the VAX C
behavior. If, however, the static variable is
initialized, the storage class will remain static.
User Action Be aware of this difference.
3 STORMODDCL
Message <Context> a storage class modifier without a
declarator is meaningless.
Description This message is generated when the compiler
encounters certain declarations that contain a
storage class modifier but no declarator. For
example: readonly struct S { int a;};
User Action Either remove the storage class modifier or add a
declarator to the declaration.
3 STRCTPADDING
Message An additional <number> bytes of padding have been
implicitly inserted prior to this member for proper
alignment of this member.
Description The compiler has added pad bytes before a member so
that it will be accessed efficiently. This might not
have been what you intended.
User Action Consider rearranging the order of member
declarations.
3 STRINGCONST
Message Ill-formed string constant.
Description An invalid string constant was encountered.
User Action Correct the string constant.
3 STRUCTBRACE
Message <Context> a required set of braces is missing.
Description The initializer for this struct was not enclosed in
braces. While some compilers allow this, standard C
requires braces around the initializer.
User Action Enclose the initializer in braces.
3 STRUCTLIMITSUP
Message <Context> HP C provides only limited support for
struct/union types larger than <n> bytes.
Description This struct/union type is larger than can be
represented by size_t. While HP C will allow a type
declared to be this size, uses of the type are not
fully supported and may cause unpredictable behavior.
User Action Reduce the size of the type.
3 STRUCTOVERFLOW
Message Integer overflow occurred when computing the size of
a struct or union type.
Description An struct or union type is larger than allowed on
this platform. Note that as the compiler computes
the size of the type in bits, the limit on the size
of struct/union types is eight times smaller than the
size of other types.
User Action Reduce the size of the struct/union type.
3 SUBINVALIDCHR
Message Parameter substitution produced an invalid character
constant.
Description In certain modes, the compiler will replace
identifiers found within a character constant if they
match a macro argument name. This form of "old-style
stringization" is provided for compatibility with
older C compilers. This message is output if this
replacement forms an invalid character constant.
User Action Modify the macro argument so that a valid character
constant is formed.
3 SUBINVALIDSTR
Message Parameter substitution produced an invalid string
literal.
Description In certain modes, the compiler will replace
identifiers found within a string literal if they
match a macro argument name. This form of "old-style
stringization" is provided for compatibility with
older C compilers. This message is output if this
replacement forms an invalid string literal.
User Action Modify the macro argument so that a valid string is
formed. HP also recommends that the macro body be
rewritten to use the standard C stringize operator
(#).
3 SUBSCRBOUNDS
Message <Context> an array is being accessed outside the
bounds specified for the array type.
Description The compiler has detected an array access that is
outside the bounds of the array. The array access
might cause unpredictable behavior. Note that in C,
an array is declared using the number of elements,
but the first element has subscript 0. It is a
common coding error to attempt to access the last
element of an array of "n" elements using a subscript
of "n" instead of "n - 1". However, there are two
common practices that intentionally employ
out-of-bounds subscripts to useful/correct effects
that are not reported by this message, but have
separate optional messages. First, taking the
address of an array element that is exactly one
beyond the last element of an array is completely
valid in standard C as long as the address is not
used to access memory. The optional subscrbounds2
message can be enabled to report taking the address
of the array element exactly one beyond the last
element. Second, it is a somewhat common practice to
declare the last member of a struct as an array with
one element, and then allocate such structs at
runtime with different sizes, recording the actual
size in an earlier member of the struct. The
optional subscrbounds1 message can be enabled to
report subscripts greater than zero applied to arrays
declared with only one element.
User Action Specify an array subscript that is within the bounds
of the array type.
3 SUBSCRBOUNDS1
Message <Context> an array type declared with one element is
being accessed beyond the end of the array.
Description An array declared with one element is being accessed
beyond the end of the array. The array access can
cause unpredictable behavior. Note that in C, an
array is declared using the number of elements, but
the first element has subscript 0. It is a common
coding error to attempt to access the last element of
an array of "n" elements using a subscript of "n"
instead of "n - 1".
User Action Specify an array subscript that is within the bounds
of the array type.
3 SUBSCRBOUNDS2
Message <Context> accessing the address of an array element
that is exactly one beyond the end of the array might
not be what you intended.
Description Accessing the address of an array element that is
exactly one beyond the end of the array might be a
coding error (e.g. if the address is then used to
access memory), or it might be fully correct (e.g.
to compute a pointer value to be used as the upper
bound on a loop).
User Action Specify an array addressthat is within the bounds of
the array type.
3 SWAPBIF
Message Built-in function <store-bif> is not available on
this platform. The compiler was able to convert it
to <swap-bif> because the source and dest parameters
are identical.
Description The STORE version of this built-in function is not
available on the IA64 platform.
User Action Use the SWAP version of this built-in function.
3 SWITCHLONG
Message The signed or unsigned long expression "<expression>"
is used in a switch statement.
Description A switch value has an integer type of signed or
unsigned long int. While this is perfectly portable
under the C standard, the original K&R definition of
C required that the expression have type int. HP C
accepts this usage in all modes, but there may be
older C compilers that require type int in this
context.
User Action Be aware that older, non-standard compilers might not
accept this construct, or force the result to type
int.
3 SYSREGUSED
Message System register specified as external register.
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 SYSTEM
Message <text>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 TAGDIFFER
Message <Context> the tag "<name>" differs from the tag
"<name>" used in an earlier declaration of this
function.
Description This function declaration contains a parameter that
is a pointer to a struct or union type whose tag
differs from the tag of the struct or union type
referenced by a pointer type in an earlier
declaration of this function. In most modes of the
compiler, this will cause the function declarations
to be incompatible.
User Action Multiple declarations of a function should use
exactly the same parameter types.
3 TAGORBRACE
Message Missing tag or "{".
Description The enum, struct, and union keywords must be followed
by either an open brace or a tag.
User Action Correct the program syntax.
3 TENTREDEF
Message This <definition or tentative definition> of "<name>"
is redefining the <definition or tentative
definition> on <location>. This is not allowed in
C++. <compiler__declare_tent_redef1>.
Description C will allow a tentative definition to be redefined
later in the compilation unit. C++ does not have the
concept of a tentative definition. Therefore this
redefinition is invalid in C++.
User Action Either remove the previous tentative definition, or
modify it to match the later redefinition.
3 TEXTARRAY
Message The CDD description for <name> specifies that it is
text 1; It has been translated into an array of char.
Description When the CDD type "TEXT" is of length one, HP C will
normally convert this to type "char" in order to be
compatible with VAX C. If however, the nullterminate
or text1toarray keywords are specified in a HP C
dictionary directive, the CDD type TEXT will be
converted to type "array of char".
User Action No action is necessary as long as the type "array of
char" is the desired datatype.
3 TEXTARRAYN
Message The CDD description for <name> specified that it is
text 1; It has been translated into an array of char
because null_terminate was used.
Description The CDD type "TEXT" is of length 1 and has been
converted to the C type "array of char" of size 2
because the null_terminate keyword was specified on
the dictionary directive.
User Action No action is necessary as long as the type "array of
char" of size two is the desired C datatype.
3 TEXTCHAR
Message The CDD description for <name> specified that it is
text 1; It has been translated into a type char.
Description When the CDD type "TEXT" is of length one, HP C will
normally convert this to type "char" in order to be
compatible with VAX C. However, when the length of
the CDD type "TEXT" is greater than one, the C type
"array of char" is generated. This means that CDD
type "TEXT" will result in different C datatypes
depending upon the length of the TEXT stored in the
dictionary.
User Action No action is necessary as long as the type "char" is
the desired datatype.
3 TEXTMODULE
Message The text library module form of #include is an
extension.
Description On OpenVMS systems, an #include directive whose file
specifier is not enclosed in either quotation marks
or angle brackets denotes an include from a text
library. This is an extension of HP C. This
directive will not work as expected on non-VMS
systems.
User Action Be aware of this if you wish to port the program.
3 THREADFUNC
Message <Context> the __declspec(thread) storage class
modifier cannot be used with a function type.
Modifier is ignored.
Description Only objects can be declared with thread-local
storage. The storage class modifier is ignored when
applied to an identifier with function type.
User Action Either remove the storage class modifier or change
the type to one that is valid for __declspec(thread).
3 THREADNYI
Message <Context> the __declspec(thread) storage class
modifier is not implemented on this platform. It
will be ignored except to verify correct compile-time
usage.
Description Thread-local storage is only supported on UNIX
platforms. The compiler will ignore the storage
class modifier except to verify that it is correctly
used.
User Action Remove the __declspec(thread) storage class modifier
or compile the program on a platform that supports
the modifier.
3 THREADSTO1
Message <Context> the __declspec(thread) storage class
modifier requires a storage class of extern, static,
or none. Modifier is ignored.
Description Declaring a file-scope object with thread-local
storage requires that the object have a storage class
of extern, static or none. In other cases, the
compiler will ignore the __declspec(thread) storage
class modifier.
User Action Either remove the storage class modifier or change
the storage class to one that is valid for
__declspec(thread).
3 THREADSTO2
Message <Context> the __declspec(thread) storage class
modifier requires a storage class of extern, or
static. Modifier is ignored.
Description Declaring a local object with thread-local storage
requires that the object have a storage class of
extern, or static. In other cases, the compiler will
ignore the __declspec(thread) storage class modifier.
User Action Either remove the storage class modifier or change
the storage class to one that is valid for
__declspec(thread).
3 TLSANDSTATIC
Message <Context> the storage class modifier
__declspec(thread) cannot be used with the -static
option. The storage class modifier is ignored.
Description Thread-local storage cannot be declared in
compilations that are performed with the -static
option. The compiler will ignore the
__declspec(thread) storage class modifier.
User Action Either remove the __declspec(thread) storage class
modifier or do not compile with the -static option.
3 TOOFEWACTUALS
Message Too few actual parameters in the invocation of the
macro "<name>".
Description A macro invocation supplied fewer actual arguments
than the macro expects. The macro arguments not
specified in the call will be given a null value.
User Action Supply all arguments in the macro invocation.
3 TOOFEWARGS
Message <Context> "<function expression>" expects <correct
number> arguments, but <actual number> are supplied.
Description A function has been invoked with fewer arguments than
it expects. In some modes this is a warning message,
and the compiler will compile the program. In this
case, the function being called might not produce the
expected results.
User Action Make sure the number of arguments passed to a
function match those specified in the function
declaration.
3 TOOFEWARGSO
Message <Context> "<function expression>", which was declared
with an old-style function definition, expects
<correct number> arguments, but <actual number> are
supplied.
Description A function that was declared with an old-style
function definition has been invoked with fewer
arguments than it expects. While this is valid C, it
might not have been what you intended.
User Action Make sure the number of arguments passed to a
function match those specified in the function
declaration. If the function is to be called with a
variable number of arguments, it should use the
facilities of <varargs.h> for old-style definitions.
HP generally recommends that old-style function
definitions be replaced by prototype-format
definitions, in which case variable argument lists
are specified using the ... notation and the
definition uses the facilities of <stdarg.h>.
3 TOOLONG
Message <Context> , "<expression>" is too long by <count>
character(s).
Description A string initializer for a char array contains more
characters than the array can hold. This is not
valid.
User Action Reduce the number of characters to be less than or
equal to the number of elements in the char array.
3 TOOMANY
Message <Context> , there are <actual number> elements, which
is <extra number> too many. The extra initializers
will be ignored.
Description An initializer list contains more initializers than
there are objects to be initialized. This is not
valid.
User Action Reduce the number of initializers to be less than or
equal to the number of objects being initialized.
3 TOOMANYACTLS
Message Too many actual parameters in the invocation of the
macro "<name>".
Description A macro invocation supplied more actual arguments
than the macro expects. The additional arguments
will be ignored.
User Action Remove the extra arguments from the macro invocation.
3 TOOMANYARGS
Message <Context> "<function expression>" expects <correct
number> arguments, but <actual number> are supplied.
Description A function has been invoked with more arguments than
it expects. In some modes this is a warning message,
and the compiler will compile the program.
User Action Make sure the number of arguments passed to a
function match those specified in the function
declaration.
3 TOOMANYARGSO
Message <Context> "<function expression>", which was declared
with an old-style function definition, expects
<correct number> arguments, but <actual number> are
supplied.
Description A function that was declared with an old-style
function definition has been invoked with more
arguments than it expects. While this is valid C, it
might not have been what you intended.
User Action Make sure the number of arguments passed to a
function match those specified in the function
declaration. If the function is to be called with a
variable number of arguments, it should use the
facilities of <varargs.h> for old-style definitions.
HP generally recommends that old-style function
definitions be replaced by prototype-format
definitions, in which case variable argument lists
are specified using the ... notation and the
definition uses the facilities of <stdarg.h>.
3 TOOMANYERR
Message More than <number> errors were encountered in the
course of compilation.
Description After emitting a certain number of errors, the
compiler will stop the compilation and issue this
message. The number of errors output before the
compilation stops can be changed using the
/ERROR_LIMIT qualifier on OpenVMS systems, or the
-error_limit option on UNIX systems.
User Action Either reduce the number of errors generated by the
program or give a larger value for the error limit.
3 TOOMANYGATES
Message only 64 gates maybe be used within a parallel region
Description For each parallel region there is a limit of 64
different gates that can be specified in a #pragma
enter gate/#pragma exit gate pair.
User Action Reduce the number of gates
3 TOOMANYTOKENS
Message Too many tokens in macro expansion.
Description An argument to the #line preprocessing directive
contained a macro whose expansion generated more
tokens than the #line directive expects.
User Action Either modify the macro definition or change the
arguments to the #line directive.
3 TOOMANYTXTLIB
Message Too many text libraries. Library <library name> and
subsequent will not be searched.
Description The compiler has tried to open more text libraries
than it can support in its internal data structures.
The specified library, and all subsequent libraries
will not be opened.
User Action Reduce the number of text libraries the compilation
requires.
3 TOOMNYREL
Message Object file section <text> has <number> relocations;
maximum allowed is <number>
Description This message is emitted by the code generator. It
should never be output when compiling a C program.
User Action Please submit a problem report if you encounter this
message when compiling a C program.
3 TRAILCOMMA
Message Trailing comma found in enumerator list.
Description Accepting an enumerator list that contains a trailing
comma is an extension of HP C provided for
compatibility with other C compilers. An enumerator
list with a trailing comma is not valid in C89, nor
in C++. The C99 standard does permit this syntax.
User Action Remove the trailing comma.
3 TRUNCFLTASN
Message <Context> "<expression>" has more precision than
"<target type>". Assignment might result in loss of
precision and/or range.
Description The destination of a floating-point assignment has
less range and/or precision than the expression being
assigned to the destination. Because of this, the
assignment might cause a loss of range and/or
precision.
User Action Verify that no unexpected data can be lost by the
assignment. If not, cast the expression to the type
of the destination.
3 TRUNCFLTINT
Message <Context> "<expression>" is a floating-point type
being assigned to an integer type. The assignment
might result in data loss.
Description A floating-point expression is being assigned to an
integer type. This assignment might cause a loss of
range and/or precision.
User Action Verify that no unexpected data can be lost by the
assignment. If not, cast the expression to the type
of the destination.
3 TRUNCINTASN
Message <Context> "<expression>" has a larger data size than
"<target type>". Assignment might result in data
loss.
Description The destination of an integer or pointer assignment
is smaller than the expression being assigned to the
destination. Because of this, the assignment might
cause data to be lost.
User Action Verify that no unexpected data can be lost by the
assignment.
3 TRUNCINTCAST
Message <Context> "<expression>" has a larger data size than
"<target type>". Cast might result in data loss.
Description An integer or pointer expression is being cast to a
size that is smaller than the expression. Because of
this, the cast might cause data to be lost.
User Action Verify that no unexpected data can be lost by the
cast.
3 TRUNCLONGCAST
Message <Context> "<expression>", a 64-bit integer, is being
cast to a 32-bit integer. The cast might result in
data loss.
Description On many platforms long integers are the same size as
integers. On this platform long integers are
64-bits. This cast could indicate a potential
porting problem.
User Action Verify that no unexpected data can be lost by the
cast.
3 TRUNCLONGINT
Message <Context> "<expression>", a 64-bit integer, is being
assigned to a 32-bit integer. Assignment might
result in data loss.
Description On many platforms long integers are the same size as
integers. On this platform long integers are
64-bits. This assignment could indicate a potential
porting problem.
User Action Verify that no unexpected data can be lost by the
assignment.
3 TUNEOVERRIDE
Message tune setting <text> overridden by arch setting
<text>, tune forced to <text>
Description The program has specified a tune architecture that is
older than the arch setting. The arch setting is the
oldest architecture that the code should ever run on.
Asking the compiler to tune for an even older
architecture is not reasonable. The compiler will
use the arch setting for the tune option as well
User Action Specify a tune architecture that is at least as new
as the arch architecture.
3 TYPEALIGN
Message <Context> _align cannot be used with the typedef
storage class. Modifier _align is ignored.
Description The storage class modifier _align is meaningless for
typedefs. The compiler ignores the _align.
User Action Remove the _align storage class modifier.
3 TYPECONFLICT
Message <Context> "<typespec1>" cannot be combined with
"<typespec2>".
Description Two type keywords used in the same type specifier
cannot be combined. In some modes, the compiler will
use the most recent keyword as the type specifier.
User Action Correct the type specifier.
3 TYPEDEFFUNC
Message In this function definition, "<name>" acquires its
type from a typedef.
Description A function definition acquires its type from a
typedef. This is not allowed.
User Action Correct the function definition.
3 TYPEDEFINIT
Message The declaration of the typedef "<name>" contains an
initializer. The initializer is ignored.
Description A typedef declaration must not contain an
initializer.
User Action Remove the initializer from the declaration.
3 TYPEDEFNA
Message Accepting an old-style parameter name that matches a
typedef is a language extension.
Description The HP C compiler will allow old-style parameters to
have the same name as a typedef. Many other
compilers will not allow this.
User Action Recode the function definition to use the standard C
prototype syntax.
3 TYPEDEFNOTDEF
Message In this declaration, "<name>" appears to be used as
if it named a type, but there is no declared type of
that name visible.
Description The compiler has encountered what appears to be a
typedef declaration that provides a new name for an
existing type, but the identifier used to specify the
existing type is not the name of a type that is
visible.
User Action Declare the identifier for the first type, or correct
its spelling.
3 TYPEEXPR
Message <Context> "<name>" is declared as <a label, tag, or
typedef>, and so cannot occur as an expression.
Description An identifier declared as a typedef has been used in
an expression when an object or function was
required.
User Action Correct the expression.
3 TYPEOFEXT
Message The use of __typeof__ is a language extension.
Description Support for __typeof__ is a language extension
provided for compatibilty with some other C
compilers. Although some other C compilers will
accept this syntax, many compilers will reject it.
User Action Be aware of this difference if you plan to port this
source to another compiler.
3 TYPQUALNOT
Message A type qualifier is not allowed in this context.
Description In Microsoft mode, the compiler used to accept a type
qualifier after a comma used to separate declarators.
This was refered to as a local type qualifier. This
message is output when a local type qualifier is
applied to a declarator that can not be qualified.
User Action Remove the local type qualifier because this is no
longer accepted.
3 TYPQUALNOT2
Message Use of the keyword "static" or a type qualifier
within the outermost array-bounds specifier of a
formal parameter declaration is a new feature in the
C99 standard.
Description The C99 construct may not be available in other
compilers you use to build your application, in which
case they will likely report it as a syntax error.
User Action You may want to conditionalize your code with the
preprocessor so that you can take advantage of the
feature on platforms that support it, without getting
syntax errors from older compilers or language modes
that do not support it.
3 TYPQUALNOT3
Message Use of the keyword "static" or a type qualifier in an
array-bounds specifier is invalid in this compilation
mode. Keyword/qualifier ignored.
Description Use of the keyword "static" or a type qualifier
within the outermost array bound specifier of a
formal parameter is a new feature in the C99 standard
and is not supported in this language mode.
User Action Either compile in a mode that supports C99 features,
or remove the construct from your code.
3 TYPQUALNOT4
Message Use of this type qualifier in an array-bounds
specifier is invalid. Qualifier ignored.
Description Use of this type qualifier is not a permitted in the
array bound specifier of a formal parameter.
User Action Remove the keyword.
3 UABORT
Message Compilation terminated by user.
Description This message is often output when the compilation was
aborted by the user by hitting Control C.
User Action Do not abort the compilation.
3 UCNICONVOPN
Message The call iconv_open(<CODESET>, "UCS-4") failed
because: <STRERROR>. UCNs will not be mapped to the
native character set.
Description To translate Universal Character Name escape
sequences to the codeset of the current locale, the
compiler needs to call the iconv_open library routine
with the specified parameters. This call failed, for
the reason shown. Thus no UCN escape sequences in
this program can be translated.
User Action Make sure your system has the specified codeset
converter installed, or set your locale to use a
codeset for which a converter from UCS-4 is
available. Alternatively, change your code to avoid
the use of UCNs, e.g. using hexadecimal escape
sequences.
3 UCNNOMAP
Message A UCN escape sequence was recognized, but there was
no translation for it into the current codeset. The
escape sequence will be used verbatim.
Description A Universal Character Name (UCN) escape sequence was
recognized, but there was no translation for it into
the current codeset using the iconv library routine.
The complete escape sequence itself, including the
backslash, will be used in the object module.
User Action Make sure your locale is set at compile-time to use a
codeset for which a converter from UCS-4 is
available, and which supports all of the characters
that are expressed as UCNs in your program.
Alternatively, change your code to avoid the use of
UCNs, e.g. using hexadecimal escape sequences.
3 UCNUNSUPP
Message An apparent UCN escape sequence was encountered, but
UCNs are not supported in this language mode. The
backslash will be ignored.
Description Universal Character Name (UCN) escape sequences were
added to C in the C99 standard. The language mode of
the current compilation does not process UCNs, so
they will be treated as unrecognized escape
sequences, which ignore the backslash.
User Action Compile in a mode that processes UCNs (C99, or the
default "relaxed" mode), or remove the backslash.
Relying on apparent escape sequences to be
unrecognized is not good practice.
3 UCNUSED
Message A UCN escape sequence was encountered.
Description Universal Character Name (UCN) escape sequences were
added to C in the C99 standard, and are processed in
this language mode. C compilers and dialects that do
not specifically process UCNs will treat them as
unrecognized escape sequences, and may silently
ignore the backslash.
User Action Be aware of this if you wish to port the program.
3 UNALIGNEDFUNC
Message Ignoring __unaligned type qualifier in declaration of
<name>.
Description The __unaligned type qualifier has no meaning for
function types. It is being ignored.
User Action Remove the type qualifier.
3 UNALIGNEXT
Message The __unaligned type qualifier is a language
extension.
Description The use of the __unaligned type qualifier might not
be portable to other C compilers.
User Action Be aware of this portability concern.
3 UNAVAILPRAGMA
Message The pragma "<pragma name>" is not available on this
platform.
Description The compiler has encountered a pragma that is not
currently supported on this platform. The compiler
will ignore the pragma.
User Action Compile the program on a platform that does support
the pragma. Otherwise, understand that this pragma
will have no effect.
3 UNAVOLACC
Message volatile access appears unaligned, but must be
aligned at run-time to ensure atomicity and byte
granularity
Description The compiler has detected an unaligned access to a
volatile variable. In order to meet atomicity and
granularity requirements of volatile, the access will
be done using an aligned instruction. This may cause
an alignment fault at runtime if the access is
unaligned.
User Action Make sure volatile objects are aligned on a natural
boundary.
3 UNCALLED
Message routine <text> can never be called
Description The compiler has detected a static function that is
never referenced.
User Action Remove the unused function.
3 UNDECLARED
Message <Context> "<name>" is not declared.
Description An identifier used in an expression has not been
declared. The only time an identifier can be used
and not previously declared is when the identifier
specifies the function name in a function call.
User Action Either declare the identifier or remove its use.
3 UNDECLFUN
Message There is no function declaration for the identifier
"<name>" at the point of this #pragma <pragma type>
<attributes>.
Description An identifier specified in a #pragma assert/hint
func_attrs directive must refer to a function
declaration at the point of the pragma.
User Action Either remove the identifer from the pragma, correct
its spelling, or reorder the source to ensure that a
declaration of the identifier as a function is
visible at the point of the pragma. Identifier must
be a function declaration; no other kind of
declaration (i.e. typedef, var, etc.) is allowed for
func_attrs.
3 UNDECLVAR
Message There is no global declaration visible for the
variable "<name>" at the point of this #pragma assert
global_status_variable.
Description An identifier specified in a #pragma assert directive
must refer to a global variable declaration visible
at the point of the pragma. The identifier will be
ignored.
User Action Either remove the identifer from the pragma, correct
its spelling, or reorder the source to ensure that a
declaration of the identifier as a global_variable is
visible at the point of the pragma.
3 UNDEFENUM
Message <Context> the enum "<name>" is not defined.
Description The enum tag used to declare an enum variable is not
defined at this point in the compilation.
User Action Define the enum tag before using it.
3 UNDEFESCAP
Message An undefined escape sequence was encountered; the
backslash is being ignored.
Description The character or characters following a backslash do
not form a valid escape sequence. The compiler will
ignore the backslash.
User Action Correct the escape sequence.
3 UNDEFINEDTYPE
Message The compiler was expecting a "<token>", but one was
not found. This condition could have occured because
"<id>" is used in what might be a type cast, but
there is no declared type of that name visible.
Description The compiler has discoverd a syntax error. This
error may have been caused because a cast operator
used an unknown type.
User Action Correct the syntax error.
3 UNDEFVARFETCH
Message <Context> the expression "<expr>" modifies "<var>",
and fetches its value in a computation that is not
used to produce the modified value without an
intervening sequence point. This behavior is
undefined.
Description The compiler has detected a case where the same
variable has been modified and fetched in a
computation that does not later modify that same
variable. Because the order of the variable fetch
and store is not defined, this expression might
produce different results on different platforms.
User Action Rewrite the expression so that if a variable is
stored to, it is fetched only to determine the value
to be stored.
3 UNDEFVARMOD
Message <Context> the expression "<expr>" modifies the
variable "<var>" more than once without an
intervening sequence point. This behavior is
undefined.
Description The compiler has detected a case where the same
variable has been modified more than once in an
expression without a sequence point between the
modifications. Because what modification will occur
last is not defined, this expression might produce
different results on different platforms.
User Action Rewrite the expression so that each variable is
modified only once.
3 UNDERFLOW
Message <Context> underflow occurs in evaluating the
expression "<expression>".
Description A floating-point underflow occurred while evaluating
a constant expression. The value of the expression
is undefined.
User Action Correct the floating-point constant expression.
3 UNINIT1
Message The scalar variable "<var>"<declared in> is fetched
but not initialized<inlineinfo>. And there may be
other such fetches of this variable that have not
been reported in this compilation.
Description A variable's value has been used without being set.
This might not have been what you intended. The
algorithms that detect this situation only report it
once for a given variable, and not necessarily at the
first use of the uninitialized value.
User Action Provide the variable with a value before the variable
is used. If you only provide a value for the use
reported here, you may find that when you recompile
your program another uninitialized use is detected.
It is best to initialize variables as close as
possible to the point of declaration.
3 UNINIT2
Message Part or all of the non-scalar variable
"<var>"<declared in> is fetched but not
initialized<inlineinfo>. And there may be other such
fetches of this variable that have not been reported
in this compilation.
Description A non-scalar variable has had its value used and some
or all of the variable has not been given a value.
This might not have been what you intended. The
algorithms that detect this situation only report it
once for a given variable, and not necessarily at the
first use of the uninitialized value.
User Action Provide the variable with a value before the variable
is used. If you only provide a value for the use
reported here, you may find that when you recompile
your program another uninitialized use is detected.
It is best to initialize variables as close as
possible to the point of declaration.
3 UNINIT3
Message Variable "<var>"<declared in> is fetched but not
initialized<inlineinfo>. And there may be other such
fetches of this field that have not been reported in
this compilation.
Description The specified member of a struct variable has been
used without being set. This might not have been
what you intended. The algorithms that detect this
situation only report it once for a given field, and
not necessarily at the first use of the uninitialized
value.
User Action Provide the struct member with a value before the
variable is used. If you only provide a value for
the use reported here, you may find that when you
recompile your program another uninitialized use is
detected. It is best to initialize variables as
close as possible to the point of declaration.
3 UNINIT4
Message Byte offsets <start> to <end> of "<var>"<declared in>
are fetched but not initialized<inlineinfo>. And
there may be other such fetches of this field that
have not been reported in this compilation.
Description The specified byte offsets of a variable have been
used without being set. This might not have been
what you intended. The algorithms that detect this
situation only report it once for a given field, and
not necessarily at the first use of the uninitialized
value.
User Action Provide the full variable with values before the
variable is used. If you only provide a value for
the use reported here, you may find that when you
recompile your program another uninitialized use is
detected. It is best to initialize variables as
close as possible to the point of declaration.
3 UNINIT5
Message <fragment uninit5a><inlineinfo>. Also the variable
itself is not initialized. And there may be other
fetches of this variable that have not been reported
in this compilation.
Description The specified storage location has been used without
being set. This might not have been what you
intended. In addition, as this fetch is outside the
storage allocated to the variable, the behavior is
undefined.
User Action First verify that the fetch is correct(code that uses
the address of a declared object to access memory
outside the address range allocated to that object is
not likely to be reliable). Then initialize the
storage being fetched and, if necessary, the variable
noted in the message. If you only provide a value
for the use reported here, you may find that when you
recompile your program another uninitialized use is
detected, since the algorithms that detect this
situation only report it once for a given variable,
and not necessarily at the first use of the
uninitialized value. It is best to initialize
variables as close as possible to the point of
declaration.
3 UNIONBRACE
Message <Context> a required set of braces is missing.
Description The initializer for this union was not enclosed in
braces. While some compilers allow this, standard C
requires braces around the initializer.
User Action Enclose the initializer in braces.
3 UNKEXTMOD
Message Unknown extern model. Pragma is ignored.
Description The compiler was unable to parse a #pragma
extern_model directive. The extern_model must be an
identifier that specifies one of the valid extern
models. The directive will be ignored.
User Action Correct the directive.
3 UNKINTRIN
Message The function "<routine name>" is not a known
intrinsic function and cannot be used with #pragma
intrinsic. Pragma not applied to this function.
Description A function identifier specified in a #pragma
intrinsic directive is not a valid intrinsic function
on this platform. The pragma will not be applied to
this identifier, leaving it to be treated as an
ordinary function.
User Action Either correct the function name to specify an
intrinsic supported for this platform, or remove it
from the pragma.
3 UNKMSGCMD
Message Bad or missing command in pragma message. Pragma is
ignored.
Description The #pragma message directive must be followed by an
identifier that specifies message-related action for
the compiler to perform. Either something other than
an identifier was found, or the identifier did not
specify one of the valid actions. The compiler will
ignore the pragma.
User Action Specify a valid action for #pragma message.
3 UNKMSGID
Message Unknown message id or group "<id>" is ignored.
Description A message identifier in a #pragma message directive
did not specify a valid message id or message group.
The identifier will be ignored.
User Action Update the identifier so that it specifies a valid
message id or message group.
3 UNKNOWNLINK
Message The specified linkage is undefined. Pragma is
ignored.
Description The linkage specified in a #pragma use_linkage
directive has not been defined by an earlier #pragma
linkage directive. The compiler will ignore the
entire pragma.
User Action Either define the linkage first or change the linkage
name.
3 UNKNOWNMACRO
Message "<name>" is not currently defined as a macro. It has
been replaced by the constant zero.
Description An identifier found in an #if or #elif is not
defined. This might not have been what you intended.
The compiler will replace the identifier with the
constant zero.
User Action Verify the use of the identifier.
3 UNKNOWNPRAGMA
Message The pragma "<pragma text>" is unrecognized.
Description A pragma that has no meaning to HP C was encountered.
The pragma will be ignored.
User Action Make sure that you did not misspell the pragma.
Also, make certain you are running the correct
version of HP C. If the spelling and compiler
version are correct, understand that this pragma will
have no effect.
3 UNKNOWNPRGMA
Message Unrecognized #pragma directive.
Description This #pragma preprocessing directive is not
recognized by HP C. The directive will be ignored.
User Action Make sure that this is the intended behavior.
3 UNKPSECTATTR
Message Unknown psect attribute for extern model. Attribute
is ignored.
Description A psect attribute specified in a #pragma extern_model
is invalid. In general, the psect attributes
accepted by HP C match those accepted by the
assembler. The psect attribute will be ignored.
User Action Correct the psect attribute.
3 UNMATCHENDIF
Message Out of place #endif directive ignored.
Description An #endif preprocessing directive was encountered
without a previous #if directive. The directive will
be ignored.
User Action Remove the directive.
3 UNNAMEDMEM
Message An unnamed member does not have a bitfield, struct,
or union type. Member is ignored.
Description An unnamed member of a struct or union type has no
meaning unless it is a bitfield or a struct/union
type. The compiler will ignore this member.
User Action If the member is desired, give it a name. Otherwise
remove the unnamed member.
3 UNNAMEPARM
Message In the definition of the function <name>, a parameter
has no name.
Description This function declaration contained a parameter type
but no parameter name.
User Action Provide a name for the formal parameter.
3 UNNECCDD
Message It is not necessary to include this dictionary
directive, if other unused dictionary directives and
unused include directives are removed.
Description There is some reference to this file from an unused
include file or from an unused dictionary directive
when using the current set of compilation options.
If you remove the unused include files and unused
dictionary directives, this dictionary directive
could also be eliminated when compiling with the
current set of compilation options.
User Action When compiling with the current set of compilation
options, to increase compilation efficiency you may
exclude this dictionary directive if you also remove
other unused files.
3 UNNECINCL
Message It is not necessary to include this file, if other
unused include directives are removed.
Description There is some reference to this file from another
include file or dictionary directive that is not used
when using the current set of compilation options.
If you remove the unused include files and unused
dictionary directives, this include file could also
be eliminated when compiling with the current set of
compilation options.
User Action When compiling with the current set of compilation
options, to increase compilation efficiency you may
exclude this include file if you also remove other
unused files.
3 UNREACHCODE
Message Code at or just after this location can never be
executed<inline info>.
Description The compiler has detected code that can never be
executed. Often unreachable code represents a real
coding error such as a label that is incorrectly
spelled, or a statement that was inserted on the
wrong line. But sometimes it occurs in good code as
a result of logical expressions that depend only on
the values of constants (typically through macro
expansion).
User Action Usually any code correction is obvious. And often it
is straightforward to rewrite compile-time logical
expressions in terms of preprocessing constructs to
avoid this diagnostic. But in some programs it may
be necessary to suppress this informational message
explicitly in order to obtain a diagnostic-free
compilation of production code, since rewriting the
expression not to be evaluated at compile time would
impact performance.
3 UNREFADECL
Message This local identifier is declared but not referenced
in this module.
Description A declaration was found for an identifier which is
not referenced in this module
User Action Examine your code to determine if this declaration is
needed in this module.
3 UNREFDECL
Message This identifier is declared but not defined or
referenced in this module.
Description A declaration was found for an identifier which is
not defined or referenced in this module
User Action Examine your code to determine if this declaration is
needed in this module.
3 UNREFLABEL
Message The user label "<label>" is never referenced.
Description This user label has been defined, but there are no
references to it.
User Action Remove the label.
3 UNREFSDECL
Message A static variable is declared but never referenced in
this module.
Description This identifier is defined but never referenced when
using the current set of compilation options.
User Action Examine your code to determine if this definition is
needed in this module.
3 UNREFSFUNC
Message A static function definition or prototype is found,
but never referenced.
Description A static function declaration was found in this
module, but is unused when compiling with the current
settings.
User Action Examine your code to determine if this function is
needed in this module.
3 UNREFTYP
Message This type is never referenced in this module.
Description A type is declared but never referenced when using
the current set of compilation options.
User Action Examine your code to determine if this declaration is
needed in this module.
3 UNRLINKATTR
Message Unrecognized attribute for linkage pragma. Pragma is
ignored.
Description The compiler encountered an attribute in a #pragma
linkage directive that it did not recognize. The
message should point to the offending attribute. The
compiler will ignore the entire pragma.
User Action Correct the directive.
3 UNSIGNEDPRES
Message <Context> the conversion of the unsigned char/short
value "<expression>" to unsigned int shows one
example of this program's use of unsigned-preserving
integral promotion. This differs from the
value-preserving semantics of standard C compilers.
Description This expression shows one of possibly many places
where this compilation uses unsigned-preserving
semantics for small integer promotions rather than
value-preserving semantics required of standard C
compilers. In cases where an unsigned char or
unsigned short int is promoted to an integer, there
are two different ways the convert could happen.
Standard C requires that the type be converted to a
signed int (value-preserving semantics) while some
older compilers will convert to an unsigned int
(unsigned-preserving semantics). The difference in
the choice of int or unsigned int can have an impact
on results of expressions that use the converted
value. The compiler cannot determine whether or not
a particular instance of this usage will cause an
observable behavior difference in the program. For
more information, consult Section 3.2.1.1 of the
Rationale for ANSI C.
User Action Be aware that standard compilers might interpret this
expression differently.
3 UNSTRUCTMEM
Message The declaration of a member that is an unnamed struct
or union type is an extension and might not be
portable.
Description HP C allows a member of a struct or union to be an
unnamed struct or union type. This is an extension
of HP C that other compilers might not support. In
addition this behavior does not conform to the C
standard.
User Action If portability is desired, provide a name for the
struct/union member.
3 UNSUPCONV
Message Hexadecimal floating point constants are not yet
implemented.
Description Hexadecimal floating point constants are a new C99
feature that is not yet supported on this platform.
User Action Please use traditional syntax for floating point
numbers.
3 UNSUPCONVSPEC
Message <Context> this argument to <function name> has a
conversion specification "<incorrect conversion>"
that is not supported or not fully supported on this
platform.
Description The compiler has detected a conversion specification
that will not work as specified on this platform.
User Action Review the documentation for this function and modify
the conversion specification as necessary to
accomplish your objective.
3 UNSUPCONVV
Message Hexadecimal floating point constants are not
supported on this platform.
Description Hexadecimal floating point constants are a new
feature in C99 that is not being implemented on the
VAX platform.
User Action Please use traditional syntax for floating point
numbers.
3 UNSUPIEEE
Message The _FASTMATH version of this function has been
specified, but _FASTMATH routines do not support the
IEEE behaviors requested and will simply trap and
terminate when given arguments or computing values
outside the normal range.
Description The compiler has recognized a math intrinsic function
that has a _FASTMATH version and the compilation has
defined the macro _FASTMATH, but command line options
have also specified IEEE trapping behaviors other
than the default of flushing underflow to zero and
aborting on all others.
User Action If the body of your code relies on IEEE denormals,
infinities, or nans, but is careful to condition the
arguments to math library functions to avoid passing
or computing these values, you may ignore or suppress
this warning. Otherwise, you should either remove
the options specifying non-default IEEE behavior or
else undefine the _FASTMATH macro.
3 UNSUPPTYPE
Message The CDD description for <name> specifies a data type
not supported in C.
Description There is no HP C datatype to exactly represent this
type. HP C has created a declaration of the same
total size as the unsupported data type.
User Action If the type provided by the HP C compiler is not
satisfactory, change the CDD description to one that
the compiler can represent more exactly.
3 UNUSEDCDD
Message This CDD record appears to be unused.
Description The contents of this CDD record are not used by the
rest of the compilation.
User Action For compilation efficiency, you can exclude this
dictionary directive when compiling with the current
set of compilation options.
3 UNUSEDINCL
Message This nested include file appears to be unused.
Description The contents of this include file are not used by the
rest of the compilation.
User Action For compilation efficiency, you can exclude this
include file when compiling with the current set of
compilation options.
3 UNUSEDTOP
Message This include directive does not contribute to the
compilation, perhaps because the file has already
been included.
Description The contents of this top-level include file are not
used by the rest of the compilation. This message
can occur when the include file has already been
included, perhaps by a nested include file.
User Action For compilation efficiency, you can exclude this
include file when compiling with the current set of
compilation options.
3 USELESSALIGN
Message <Context> _align cannot be used with the <class>
storage class. Modifier _align is ignored.
Description The storage class modifier _align is meaningless for
objects declared with register, globalref, or
globalvalue storage class. The compiler ignores the
_align.
User Action Remove the _align storage class modifier.
3 USELESSSTOMOD
Message <Context> <noshare or readonly> cannot be used with
the typedef storage class. Modifier is ignored.
Description The storage class modifiers noshare and readonly are
meaningless for typedefs. The compiler ignores the
storage class modifier.
User Action Remove the storage class modifier.
3 USELESSTYPED
Message This typedef declaration is useless because it does
not declare a typedef name.
Description This typedef declaration does not declare a typedef
name. This case can occur when a declaration tries
to declare both a tag and a typedef, but the name of
the typedef is not included.
User Action Either remove the typedef keyword or add a typedef
name.
3 USELESSTYPEQUAL
Message <Context> this type qualifier will have no effect.
Description A type qualifier is applied only to the declarators
in a declaration. Declarations that lack declarators
are permitted if they declare a tag or an enumeration
constant, but in such cases type qualifiers are not
useful.
User Action Remove the type qualifier, or change this to a
typedef declaration that declares a name for the type
and use that typedef name to refer to the qualified
type.
3 VAARGSBODY
Message __VA_ARGS__ may not appear except in a function-like
macro that uses the ellipsis notation in the
parameters.
Description The identifier __VA_ARGS__ may only appear in the
replacement list of a function-like macro definion
that uses ellipsis notation in the parameters.
User Action Either remove __VA_ARGS__ or change its spelling.
3 VAARGSFORMAL
Message __VA_ARGS__ may not be used as a formal parameter.
Description The identifier __VA_ARGS__ may only appear in the
replacement list of a function-like macro definion
that uses ellipsis notation in the parameters.
User Action Rename the formal parameter.
3 VALUENOTSUP
Message <Context> the floating-point constant named "<name>"
is not supported in "<fpmode>" representation.
Description The representation of an IEEE Infinity or NaN has no
special meaning when used with non-IEEE
floating-point operations.
User Action Replace the named constant with a conventional
floating point constant. The HUGE_VAL macros defined
by <math.h> may be used in place of IEEE Infinities
with any floating-point representation.
3 VALUEPRES
Message <Context> the conversion of the unsigned char/short
value "<expression>" to signed int shows one example
of this program's use of value-preserving integral
promotion. This differs from the unsigned-preserving
semantics of some older C compilers.
Description This expression shows one of possibly many places
where this compilation uses value-preserving
semantics for small integer promotions rather than
unsigned-preserving semantics used by some older
compilers. In cases where an unsigned char or
unsigned short int is promoted to an integer, there
are two different ways the convert could happen.
Standard C requires that the type be converted to a
signed int (value-preserving semantics) while some
older compilers will convert to an unsigned int
(unsigned-preserving semantics). The difference in
the choice of int or unsigned int can have an impact
on results of expressions that use the converted
value. The compiler cannot determine whether or not
a particular instance of this usage will cause an
observable behavior difference in the program. For
more information, consult Section 3.2.1.1 of the
Rationale for ANSI C.
User Action Be aware that older, non-standard compilers might
interpret this expression differently.
3 VARIANTDCL
Message A declaration of a variant struct or variant union
must have a single declarator that is an identifier.
Description A variant_struct or variant_union member was either
not followed by a declarator or followed by more than
one declarator. This is not valid.
User Action Declare the variant_struct or variant_union member
with a single identifier.
3 VARIANTDUP
Message The anonymous struct or union member "<member name>"
duplicates the name of a member in the enclosing
struct or union.
Description As members of an anonymous structure or union are
promoted to membership of the enclosing struct/union
type, the names of each element of the anonymous
struct/union must not match an element name in the
enclosing struct/union. This message can also be
output when the variant_struct or variant_union
syntax is used instead of the anonymous struct/union.
User Action Choose a new name for either the offending anonymous
struct/union member or the matching member of the
enclosing type.
3 VARIANTEXT
Message variant struct or union is a language extension.
Description Declaring a member to be a variant_struct or
variant_union is a language extension of HP C. Other
C compilers might not successfully compile a program
that uses the extension.
User Action Consider using an anonymous struct or union (one
without a tag or declarator) instead: anonymous
structs/unions are supported by HP C and some other
vendors' C compilers.
3 VARIANTTAG
Message A variant struct or union cannot have a tag.
Description A variant_struct or variant_union declaration
specified a tag name. This is not allowed.
User Action Either remove the tag or change the declaration to be
a regular struct or union instead of a variant struct
or union.
3 VARNOMEM
Message A variant struct or variant union can occur only as a
member of a struct or union.
Description A declaration contained a variant_struct or
variant_union in some place other than a member of a
struct or union. This is not valid.
User Action Correct the offending declaration.
3 VERTICALSPDIR
Message Vertical whitespace within pp directive.
Description Unexpected vertical white space as been encountered
within a preprocessing directive.
User Action Remove the vertical white space from the directive.
3 VLAEXTENSION
Message <Context> variable length arrays are a new feature in
the C99 standard. Other C compilers may not support
this extension.
Description This is a new language feature in the C99 revision of
the standard. While having a standard specification
for portability, the feature may not yet be available
in all of the compilers you use.
User Action Determine whether or not the use of this feature will
cause portability problems for this code.
3 VOIDRETURN
Message The function "<name>" has return type void, and so
must not contain a return statement with an
expression.
Description The current function was declared with a void return
type. The expression specified in the return value
will be evaluated but will not be returned to the
caller.
User Action Either change the return type in the function
declaration or remove the return value from the
return statement.
3 VOIDRETURN1
Message The function "<name>" has return type void. The
return statement must not specify a return value even
if the return expression has void type.
Description The current function was declared with a void return
type. Although some C compilers allow such a
function to return a void expression, this is a
violation of the C standard and may not be portable.
User Action Modify the program so that the return statement does
not specify a return value.
3 VOLATILEFUNC
Message Ignoring volatile type qualifier in declaration of
<name>.
Description The volatile type qualifier cannot be used with a
function type. The compiler will ignore the type
qualifier.
User Action Remove the type qualifier.
3 WCHARCAT
Message A character string literal was concatenated with a
wide string literal.
Description The C99 standard defines the behavior of adjacent
string concatenation between character string
literals and wide string literals, basically
promoting the character string to a wide string
before forming the wide string result. The older C90
standard gave this construct undefined behavior - it
only defined concatenation between adjacent strings
of the same kind (all character or all wide).
Although this version of HP C always gives the C99
behavior with diagnostics optional, some compilers
(including previous versions of HP C) may give more
severe diagnostics and/or different behaviors.
User Action Be aware of this if you wish to port the program.
3 WRTINNOWRT
Message Writable variable resides in nowrt extern model.
Description The current extern model places all external objects
in a read-only section. An object without a const
type qualifier in such a section means that while the
compiler will not diagnose writes to the object, any
attempt to modify the object at runtime will cause
the program to fail. This might not have been what
you intended.
User Action Place non-const objects in sections that can be
modified.
3 XFERINTOVLA
Message This statement performs an invalid transfer into a
block that declares a variably modified type or
object. The identifier "<name>" is variably
modified, and declared at <where>.
Description It is invalid to transfer control into a block after
that block declares a variably modified type.
User Action Either remove the transfer, or move the declaration
of the variably modified type.
3 XTRALARGE
Message Line number is greater than the 32767 specified by
the C standard and might not be portable.
Description A #line preprocessing directive specified a line
value that is greater than 32767. While the value is
supported by HP C, the C89 standard specifies that
the value must not be greater than 32767. Therefore,
this program does not conform to the C89 standard,
and the directive might not be accepted by other C
compilers.
User Action Be aware of this if you wish to port the program.
3 ZERODIV
Message <Context> division by zero occurs in evaluating the
expression "<expression>".
Description A divide by zero occurred while evaluating a constant
expression. The value of the expression is
undefined.
User Action Correct the constant expression so that it does not
contain a division by zero.
3 ZERODIVIDE
Message Division by zero in expression.
Description A divide by zero occurs in a preprocessor constant
expression. The result of the divide will be zero.
User Action Correct the preprocessor constant expression.
3 ZEROELEMENTS
Message <Context> zero cannot be used as an element count
specifier. The specifier will be ignored, (leaving
the member/parameter with an incomplete array type)
in this context.
Description The C standard states that if an element count
specifier is a constant expression then it shall have
a value greater than zero. For compatibility with
some other C compilers, HP C will accept a zero
element count specifier. When appearing in a
struct/union member or a parameter, the specifier
will be ignored.
User Action Remove the zero.
3 ZEROELEMENTS1
Message <Context> zero cannot be used as an element count
specifier. It will be replaced with the constant one
in this context.
Description The C standard states that if an element count
specifier is a constant expression then it shall have
a value greater than zero. For compatibility with
some other C compilers, HP C will accept a zero
element count specifier. When appearing outside a
struct/union member or a parameter, the compiler will
replace the zero with the value one. This may or may
not be compatible with the behavior of other C
compilers.
User Action Use a valid element count specifier.
2 Language_topics
VSI C language topics
3 Block
A block is a compound statement. It allows more than one statement
to appear where a single statement ordinarily is used. It is made
up of a list of declarations and statements, enclosed in braces:
{ [declaration ...] [statement ...] }
The declaration list is optional; if it is included, all
declarations of variables are local to the block and supersede
previous declarations for the duration of the block. A block is
entered normally when control flows into it, or when a goto
statement transfers control to a label at the beginning of the
block. Each time the block is entered normally, storage is
allocated for auto or register variables. If, on the other hand, a
goto statement transfers control to a label inside the block or if
the block is the body of a switch statement, these storage
allocations do not occur. Blocks can be used wherever single
statements are valid -- for example, as the action clause of an if
statement:
if ( i < 1 )
{ /* BEGINNING OF BLOCK */
char x;
for (x = 'a'; x <= 'z'; x++)
printf("char = %c\n", x);
} /* END OF BLOCK */
3 Valid_File_Specifications
In VSI C source programs, you can include both OpenVMS and UNIX*
style file specifications. Combinations of the two specifications
are not supported by VSI C.
Example of a valid UNIX* file specification:
beatle!/dba0/lennon/songs.lis.3
Example of an invalid UNIX* file specification:
BEATLE::DBA0:[LENNON.C]/songs.lis.3
----------
* UNIX is a trademark of The Open Group.
3 Data_Types
The data type of an object must be specified in its declaration.
The fundamental data types are the scalar types:
short int 16-bit signed integer
signed short int 16-bit signed integer
unsigned short int 16-bit unsigned integer
int 32-bit signed integer
signed int 32-bit signed integer
unsigned int 32-bit unsigned integer
long int 32-bit signed integer
signed long int 32-bit signed integer
unsigned long int 32-bit unsigned integer
long long int 64-bit signed integer
signed long long int 64-bit signed integer
unsigned long long int 64-bit unsigned integer
char 8-bit signed integer
signed char 8-bit signed integer
unsigned char 8-bit unsigned integer
wchar_t Long character (32-bit unsigned integer)
float 32-bit (single-precision) floating-point number
double 64-bit (double-precision) floating-point number
long double 128-bit (double-precision) floating-point
number
long float Interchangeable with double, but usage is
obsolete
_Bool An unsigned int that has the value 0 or 1
_Imaginary A C99-specified data type. In VSI C, use of
the _Imaginary keyword produces a warning,
which is resolved by treating it as an ordinary
identifier.
_Complex C99-specified data type available in all three
precisions: float _Complex, double _Complex,
or long double _Complex. A complex type has
the same representation and alignment
requirements as an array type containing
exactly two elements of the corresponding real
type; the first element is equal to the real
part, and the second element to the imaginary
part, of the complex number.
Note: This complex data type is similar to the
Fortran type, and has an associated header
file, <complex.h>. Although the fundamental
complex data types are implemented in the
compiler, the run-time support will not be
available until an OpenVMS Alpha release
following Version 7.3.
The signed keyword is the default. Declaring an object with int,
for example, is equivalent to declaring it with signed int.
However, char declarations should be explicitly declared, as the
compiler offers command-line options to change the default. If in
doubt, use signed char over char because signed char is more
portable.
Strings are arrays of characters terminated by the null character
(\0).
Also, view the contents of the <ints.h> header file for definitions
of platform-specific integer types.
4 Array
An array is an aggregate of subscripted elements of the same type.
Elements of an array can have one of the fundamental data types or
can be structures, unions, or other arrays (multidimensional
arrays). An array is declared using square brackets. The
following example declares array1 to be an array of 10 integers.
The valid subscripts for array1 range from 0 to 9.
int array1[10];
The next example declares array2 to be a two-dimensional (2 by 3)
array of integers:
int array2[2][3];
The elements are stored in row-major order as follows:
array2[0][0], array2[0][1], ... array2[1][2].
4 enum
An enumerated type is used to restrict the possible values of an
object to a predefined list. Elements of the list are called
enumeration constants.
The main use of enumerated types is to explicitly show the symbolic
names, and therefore the intended purpose, of objects that can be
represented with integer values. Objects of enumerated type are
interpreted as objects of type signed int, and are compatible with
objects of other integral types. The compiler automatically
assigns integer values to each of the enumeration constants,
beginning with 0.
An enumerated type is a set of scalar objects that have type names.
Variables are declared with enum specifiers in the place of the
type specifier. An enumerated type can have one of the following
forms:
enum { enumerator,... }
enum tag { enumerator,... }
enum tag
Each enumerator defines a constant of the enumerated type (tag).
The enumerator list forms an ordered list of the type's values.
Each enumerator has the form "identifier [= expression]", where the
"identifier" is the name to be used for the constant value and the
optional "expression" gives its integer equivalent. If a tag
appears but no list of enumerators, the enum-specifier refers to a
previous definition of the enumerated type, identified by the tag.
The following example declares an enumerated object
'background_color' with a list of enumeration constants:
enum colors { black, red, blue, green, } background_color;
Later in the program, a value can be assigned to the object
'background_color':
background_color = red;
In this example, the compiler automatically assigns the integer
values as follows: black = 0, red = 1, blue = 2, and green = 3.
Alternatively, explicit values can be assigned during the
enumerated type definition:
enum colors { black = 5, red = 10, blue, green = black+2 };
Here, black equals the integer value 5, red = 10, blue = 11, and
green = 7. Note that blue equals the value of the previous
constant (red) plus one, and green is allowed to be out of
sequential order.
Because the ANSI C standard is not strict about assignment to
enumerated types, any assigned value not in the predefined list is
accepted without complaint.
4 Pointer
A pointer in C is a variable that holds the address of another
variable. Pointers are declared with the asterisk operator. For
example:
int i, *ip, *np; /* i IS AN INTEGER, ip AND np ARE
POINTERS TO INTEGERS */
The following operations are permitted on pointers:
o Assigning an address to the pointer (as in ip = &i;)
o Fetching the object of the pointer (by dereferencing the
pointer) with the asterisk operator (i = *ip;, which
assigns the addressed integer to i)
o Adding (as in ip += 5;, which makes ip point to the object
that is five longwords away from the initial address in ip)
o Subtracting (as in i = np - ip;, which gives the number of
objects separating the objects pointed to by np and ip)
4 Structure
A structure is an aggregate of members whose data types can differ.
Members can be scalar variables, arrays, structures, unions, and
pointers to any object. The size of a structure is the sum of the
sizes of its members, which are stored in the order of their
declarations. Structures are defined with the keyword struct,
followed by an optional tag, followed by a structure-declaration
list in braces. The syntax is:
struct [identifier] { struct-declaration ... }
Each struct-declaration is a type specifier (type keyword, struct
tag, union tag, enum tag, or typedef name) followed by a list of
member declarators:
type-specifier member-declarator,... ;
Each member declarator defines either an ordinary variable or a bit
field:
declarator
or
[declarator] : constant-expression
The following example declares a new structure employee with two
structure variables bob and susan of the structure type employee:
struct employee {
char *name;
int birthdate; /* name, birthdate, job_code, and salary are */
int job_code; /* treated as though declared with const. */
float salary;
};
struct employee bob, susan;
4 typedef
Use the typedef keyword to define an abbreviated name, or
synonym, for a lengthy type definition. Grammatically,
typedef is a storage-class specifier, so it can precede any valid
declaration. In such a declaration, the identifiers name types
instead of variables. For example:
typedef char CH, *CP, STRING[10], CF();
In the scope of this declaration, CH is a synonym for "character,"
CP for "pointer to character," STRING for "10-element array of
characters," and CF for "function returning a character." Each of
the type definitions can be used in that scope to declare
variables. For example:
CF c; /* c IS A FUNCTION RETURNING A CHARACTER */
STRING s; /* s IS A 10-CHARACTER STRING */
4 Union
A union is an aggregate of members whose data types can differ.
Members can be scalar variables, arrays, structures, unions, and
pointers to any object. The size of a union is the size of its
longest member plus any padding needed to meet alignment
requirements. All its members occupy the same storage. Unions are
defined with the union keyword, followed by an optional tag,
followed by a union-declaration list in braces. The syntax is:
union [identifier] { union-declaration ... }
Each union-declaration is a type specifier (type keyword, struct
tag, union tag, enum tag, or typedef name) followed by a list of
member declarators:
type-specifier member-declarator,... ;
Each member declarator defines either an ordinary variable or a bit
field:
declarator
or
[declarator] : constant-expression
Once a union is defined, a value can be assigned to any of the
objects declared in the union declaration. For example:
union name {
dvalue;
struct x { int value1; int value2; };
float fvalue;
} alberta;
alberta.dvalue = 3.141596; /*Assigns pi to the union object*/
Here, alberta can hold a double, struct, or float value. The
programmer has responsibility for tracking the current type
contained in the union. The type is maintained until explicitly
changed. An assignment expression can be used to change the type of
value held in the union.
4 Void
You can use the void data type to declare functions that do not
return a value. Functions declared to be of this type cannot
contain return statements and cannot be used in statements where a
return value is expected. The void data type can be used in the
cast operation if casting to a "function without a return value
...". You can also use the void data type with pointers.
3 Declarations
Declarations specify the functions and variables referenced in a
program. Declarations in C have the following syntax:
declaration:
declaration-specifiers [init-declarator-list];
declaration-specifiers:
storage-class-specifier [declaration-specifiers]
type-specifier [declaration-specifiers]
type-qualifier [declaration-specifiers]
init-declarator-list:
init-declarator
init-declarator-list, init-declarator
init-declarator:
declarator
declarator = initializer
Note the following items about the general syntax of a declaration:
o The storage-class-specifier, type-qualifier, and type-specifier
can be listed in any order. All are optional, but, except for
function declarations, at least one such specifier or qualifier
must be present. Placing the storage-class-specifier anywhere
but at the beginning of the declaration is an obsolete style.
o Storage-class keywords are auto, static, extern, and register.
o Type qualifiers are const, volatile, __restrict, and
__unaligned.
o The declarator is the name of the object being declared. A
declarator can be as simple as a single identifier, or can be a
complex construction declaring an array, structure, pointer,
union, or function (such as *x, tree(), and treebar[10]).
o Initializers are optional and provide the initial value of an
object. An initializer can be a single value or a
brace-enclosed list of values, depending on the type of object
being declared.
o A declaration determines the beginning of an identifier's
scope.
o An identifier's linkage is determined by the declaration's
placement and its specified storage class.
Consider the following example:
volatile static int var_number = 10;
This declaration shows a qualified type (a type, int, with a type
qualifier, volatile), a storage class (static), a declarator (data),
and an initializer (10). This declaration is also a definition,
because storage is reserved for the data object var_number.
For more information, see HELP CC LANGUAGE_TOPICS DATA_TYPES, HELP
CC LANGUAGE_TOPICS STORAGE_CLASSES, and HELP CC LANGUAGE_TOPICS
TYPE_QUALIFIERS.
4 Interpretation
The symbols used in declarations are C operators, subject to the
usual rules of precedence and associativity. These operators are
parentheses, brackets, and asterisks for "function returning...",
"array of...", and "pointer to...", respectively. Parentheses and
brackets associate left to right; asterisk operators associate
right to left. Parentheses and brackets have the same precedence,
which is higher than that of asterisks. Parentheses are also used
to change the associativity of the other operators.
The following declaration, for example, is a "function returning a
pointer to an array of pointers to char":
char * ( *x() ) [];
This is how the declaration is broken down to determine what it is:
char * ( *x() ) [];
* ( *x() ) [] is char
( *x() ) [] is (pointer to) char
*x() is (array of) (pointer to) char
x() is (pointer to) (array of) (pointer to)
char
x is (function returning) (pointer to)
(array of) (pointer to) char
In this sort of breakdown, lower precedence operators are removed
first. With two equal precedence operators, remove the rightmost
if they are left-to-right operators, and the leftmost if they are
right-to-left operators. For example, "[]()" means "array of
functions returning...".
3 Functions
Functions consist of one or more blocks of statements that perform
one logical operation. They can be called from other functions
either in the same program or in different programs. A function
may exchange values with the calling function by use of parameters.
Function declarations have the following syntax:
function_name()
or
function_name(arg1, arg2,...)
or
function_name(data-type arg1, data-type arg2,...)
In the first form of the function declaration, the function takes
no arguments. In the second form, the function takes arguments;
the arguments are declared outside the parameter list. In the
third form, the function declaration is a function prototype that
specifies the type of its arguments in the identifier list; the
prototype form is recommended. In all three cases, the parenthesis
after the function name are required.
VSI C for OpenVMS Systems provides a library of common functions.
These functions perform standard I/O operations, character and
string handling, mathematical operations, miscellaneous system
services, and UNIX* system emulation. For more information, see
HELP CRTL.
----------
* UNIX is a trademark of The Open Group.
3 Builtin_Functions
Built-in functions allow you to directly access hardware and
machine instructions to perform operations that are cumbersome,
slow, or impossible in pure C.
These functions are very efficient because they are built into the
VSI C compiler. This means that a call to one of these functions
does not result in a reference to a function in the C run-time
library or in your programs. Instead, the compiler generates the
machine instructions necessary to carry out the function directly
at the call site. Because most of these built-in functions closely
correspond to single VAX, Alpha, or Itanium machine instructions,
the result is small, fast code.
Some of these functions (such as those that operate on strings or
bits) are of general interest. Others (such as the functions
dealing with process context) are of interest if you are writing
device drivers or other privileged software. Some of the functions
are privileged and unavailable to user mode programs.
Be sure to include the <builtins.h> header file in your source
program to access these built-in functions.
VSI C supports the #pragma builtins preprocessor directive for
compatibility with VAX C, but it is not required.
Some of the built-in functions have optional arguments or allow a
particular argument to have one of many different types. To
describe different valid combinations of arguments, the description
of each built-in function may list several different prototypes for
the function. As long as a call to a built-in function matches one
of the prototypes listed, the call is valid. Furthermore, any
valid call to a built-in function acts as if the corresponding
prototype was in scope, so the compiler performs the argument
checking and argument conversions specified by that prototype.
The majority of the built-in functions are named after the machine
instruction that they generate. For more information on these
built-in functions, see the documentation on the corresponding
machine instruction. In particular, see that reference for the
structure of queue entries manipulated by the queue built-in
functions.
4 Alpha_Compatibility
The VSI C built-in functions available on OpenVMS Alpha systems are
also available on I64 systems, with some differences:
o There is no support for the asm, fasm, and dasm intrinsics
(declared in the <c_asm.h> header file).
o The functionality provided by the special-case treatment of R26
on an Alpha system asm, as in asm("MOV R26,R0"), is provided by
a new built-in function for I64 systems:
__int64 __RETURN_ADDRESS(void);
o The only PAL function calls implemented as built-in functions
within the compiler are the 24 queue-manipulation builtins.
The queue manipulation builtins generate calls to new OpenVMS
system services SYS$<name>, where <name> is the name of the
builtin with the leading underscores removed.
Any other OpenVMS PAL calls are supported through macros
defined in the <pal_builtins.h> header file included in the
<builtins.h> header file. Typically, the macros in
<pal_builtins.h> transform an invocation of an Alpha system
builtin into a call to a system service that performs the
equivalent function on an I64 system. Two notable exceptions
are __PAL_GENTRAP and __PAL_BUGCHK, which instead invoke the
I64 specific compiler builtin __break2.
o There is no support for the various floating-point built-in
functions used by the OPenVMS math library (for example,
operations with chopped rounding and conversions).
o For most built-in functions that take a retry count, the
compiler issues a warning message, evaluates the count for
possible side effects, ignores it, and then invokes the same
function without a retry count. This is necessary because the
retry behavior allowed by Alpha load-locked/store-conditional
sequences does not exist on I64 systems. There are two
exceptions to this: __LOCK_LONG_RETRY and
__ACQUIRE_SEM_LONG_RETRY; in these cases, the retry behavior
involves comparisons of data values, not just
load-locked/store-conditional.
o The __CMP_STORE_LONG and __CMP_STORE_QUAD built-in functions
produce either a warning or an error, depending on whether or
not the compiler can determine if the source and destination
addresses are identical. If the addresses are identical, the
compiler treats the builtin as the new __CMP_SWAP_ form and
issues a warning. Otherwise it is an error.
4 <builtins.h>
The <builtins.h> header file contains a section at the top
conditionalized to just __ia64 with the support for built-in
functions specific to I64 systems. This includes macro definitions
for all of the registers that can be specified to the __getReg,
__setReg, __getIndReg, and __setIndReg built-in functions.
Parameters that are const-qualified require an argument that is a
compile-time constant.
Notes:
o The <builtins.h> header file contains comments noting which
built-in functions are not available or are not the
preferred form for I64 systems. The compiler issues
diagnostics where using a different built-in function for
I64 systems would be preferable.
o The comments in <builtins.h> reflect only what is explicitly
present in that header file itself, and in the compiler
implementation. You should also consult the content and
comments in <pal_builtins.h> to determine more accurately
what functionality is effectively provided by including
<builtins.h>. For example, if a program explicitly declares
one of the Alpha built-in functions and invokes it without
having included <builtins.h>, the compiler might issue a
BIFNOTAVAIL error message, regardless of whether or not the
function is available through a system service. If the
compilation does include <builtins.h>, and BIFNOTAVAIL is
issued, then either there is no support at all for the
built-in function or a new version of <pal_builtins.h> is
needed.
4 __break
Generates a break instruction with an immediate.
Syntax:
void __break (const int __break_arg);
4 __break2
Implements the Alpha __PAL_GENTRAP and __PAL_BUGCHK built-in
functions on OpenVMS I64 systems.
The __break2 function is equivalent to the __break function with
the second parameter passed in general register 17:
R17 = __R17_value; __break (__break_code);
Syntax:
void __break2 (__Integer_Constant __break_code, unsigned
__int64 __r17_value);
4 __CMP_SWAP_LONG
Performs a conditional atomic compare and exchange operation on a
longword. The longword pointed to by source is read and compared
with the longword old_value. If they are equal, the longword
new_value is written into the longword pointed to by source. The
read and write is performed atomically, with no intervening access
to the same memory region.
The function returns 1 if the write occurs, and 0 otherwise.
Syntax:
int __CMP_SWAP_LONG (volatile void *source, int old_value, int
new_value);
4 __CMP_SWAP_QUAD
Performs a conditional atomic compare and exchange operation on a
quadword. The quadword pointed to by source is read and compared
with the quadword old_value. If they are equal, the quadword
new_value is written into the quadword pointed to by source. The
read and write is performed atomically, with no intervening access
to the same memory region.
The function returns 1 if the write occurs, and 0 otherwise.
Syntax:
int __CMP_SWAP_QUAD (volatile void *source, int old_value, int
new_value);
4 __CMP_SWAP_LONG_ACQ
Performs a conditional atomic compare and exchange operation with
acquire semantics on a longword. The longword pointed to by source
is read and compared with the longword old_value. If they are
equal, the longword new_value is written into the longword pointed
to by source. The read and write is performed atomically, with no
intervening access to the same memory region.
Acquire memory ordering guarantees that the memory read/write is
made visible before all subsequent data accesses to the same memory
location by other processors.
The function returns 1 if the write occurs, and 0 otherwise.
Syntax:
int __CMP_SWAP_LONG_ACQ (volatile void *source, int old_value,
int new_value);
4 __CMP_SWAP_QUAD_ACQ
Performs a conditional atomic compare and exchange operation with
acquire semantics on a quadword. The quadword pointed to by source
is read and compared with the quadword old_value. If they are
equal, the quadword new_value is written into the quadword pointed
to by source. The read and write is performed atomically, with no
intervening access to the same memory region.
Acquire memory ordering guarantees that the memory read/write is
made visible before all subsequent memory data accesses to the same
memory location by other processors.
The function returns 1 if the write occurs, and 0 otherwise.
Syntax:
int __CMP_SWAP_QUAD_ACQ (volatile void *source, int old_value,
int new_value);
4 __CMP_SWAP_LONG_REL
Performs a conditional atomic compare and exchange operation with
release semantics on a longword. The longword pointed to by source
is read and compared with the longword old_value. If they are
equal, the longword new_value is written into the longword pointed
to by source. The read and write is performed atomically, with no
intervening access to the same memory region.
Release memory ordering guarantees that the memory read/write is
made visible after all previous data memory acceses to the same
memory location by other processors.
The function returns 1 if the write occurs, and 0 otherwise.
Syntax:
int __CMP_SWAP_LONG_REL (volatile void *source, int old_value,
int new_value);
4 __CMP_SWAP_QUAD_REL
Performs a conditional atomic compare and exchange operation with
release semantics on a quadword. The quadword pointed to by source
is read and compared with the quadword old_value. If they are
equal, the quadword new_value is written into the quadword pointed
to by source. The read and write is performed atomically, with no
intervening access to the same memory region.
Release memory ordering guarantees that the memory read/write is
made visible after all previous data memory acceses to the same
memory location by other processors.
The function returns 1 if the write occurs, and 0 otherwise.
Syntax:
int __CMP_SWAP_QUAD_REL (volatile void *source, int old_value,
int new_value);
4 __RETURN_ADDRESS
Produces the address to which the function containing the built-in
call will return as a 64-bit integer (on Alpha systems, the value
of R26 on entry to the function; on I64 systems, the value of B0 on
entry to the function).
This built-in function cannot be used within a function specified
to use nonstandard linkage.
Syntax:
__int64 __RETURN_ADDRESS (void);
4 __dsrlz
Serializes data. Maps to the srlz.d instruction.
Syntax:
void __dsrlz (void);
4 __fc
Flushes a cache line associated with the address given by the
argument. Maps to the fcr instruction.
Syntax:
void __fc (__int64 __address);
4 __flushrs
Flushes the register stack.
Syntax:
void __flushrs (void);
4 __fwb
Flushes the write buffers. Maps to the fwb instruction.
Syntax:
void __fwb (void);
4 __getIndReg
Returns the value of an indexed register. The function accesses a
register (index) in a register file (whichIndReg) of 64-bit
registers.
Syntax:
unsigned __int64 __getIndReg (const int whichIndReg, __int64
index);
4 __getReg
Gets the value from a hardware register based on the register index
specified. This function produces a corresponding mov = r
instruction.
Syntax:
unsigned __int64 __getReg (const int whichReg);
4 _InterlockedCompareExchange_acq
Atomically compares and exchanges the value specified by the first
argument (a 64-bit pointer). This function maps to the
cmpxchg4.acq instruction with appropriate setup.
The value at *Destination is compared with the value specified by
Comparand. If they are equal, Newval is written to *Destination,
and Oldval is returned. The exchange will have taken place if the
value returned is equal to the Comparand. The following algorithm
is used:
ar.ccv = Comparand;
Oldval = *Destination; //Atomic
if (ar.ccv == *Destination) //Atomic
*Destination = Newval; //Atomic
return Oldval;
Those parts of the algorithm marked "Atomic" are performed
atomically by the cmpxchg4.acq instruction. This instruction has
acquire ordering semantics; that is, the memory read/write is made
visible prior to all subsequent data memory accesses of the
Destination by other processors.
Syntax:
unsigned __int64 _InterlockedCompareExchange_acq (volatile
unsigned int *Destination, unsigned __int64 Newval, unsigned
__int64 Comparand);
4 _InterlockedCompareExchange64_acq
Same as the _InterlockedCompareExchange_acq function, except that
those parts of the algorithm that are marked "Atomic" are performed
by the cmpxchg8.acq instruction.
Syntax:
unsigned __int64 _InterlockedCompareExchange64_acq (volatile
unsigned int64 *Destination, unsigned __int64 Newval, unsigned
__int64 Comparand);
4 _InterlockedCompareExchange_rel
Same as the _InterlockedCompareExchange_acq function except that
those parts of the algorithm that are marked "Atomic" are performed
by the cmpxchg4.rel instruction with release ordering semantics;
that is, the memory read/write is made visible after all previous
memory accesses of the Destination by other processors.
Syntax:
unsigned __int64 _InterlockedCompareExchange_rel (volatile
unsigned int *Destination, unsigned __int64 Newval, unsigned
__int64 Comparand);
4 _InterlockedCompareExchange64_rel
Same as the _InterlockedCompareExchange_rel function, except that
those parts of the algorithm that are marked "Atomic" are performed
by the cmpxchg8.rel instruction.
Syntax:
unsigned __int64 _InterlockedCompareExchange64_rel (volatile
unsigned int64 *Destination, unsigned __int64 Newval, unsigned
__int64 Comparand);
4 __invalat
Invalidates ALAT. Maps to the invala instruction.
Syntax:
void __invalat (void);
4 __invala
Same as the __invalat function.
Syntax:
void __invala (void);
4 __isrlz
Executes the serialize instruction. Maps to the srlz.i
instruction.
Syntax:
void __isrlz (void);
4 __itcd
Inserts an entry into the data translation cache. Maps to the
itc.d instruction
Syntax:
void __itcd (__int64 pa);
4 __itci
Inserts an entry into the instruction translation cache. Maps to
the itc.i instruction.
Syntax:
void __itci (__int64 pa);
4 __itrd
Maps to the itr.d instruction.
Syntax:
void __itrd (__int64 whichTransReg, __int64 pa);
4 __itri
Maps to the itr.i instruction.
Syntax:
void __itri (__int64 whichTransReg, __int64 pa);
4 __loadrs
Loads the register stack.
Syntax:
void __loadrs (void);
4 __prober
Determines whether read access to the virtual address specified by
__address bits {60:0} and the region register indexed by __address
bits {63:61} is permitted at the privilege level given by __mode
bits {1:0}. It returns 1 if the access is permitted, and 0
otherwise.
This function can probe only with equal or lower privilege levels.
If the specified privilege level is higher (lower number), then the
probe is performed with the current privilege level.
This function is the same as the Intel __probe_r function.
Syntax:
int __prober (__int64 __address, unsigned int __mode);
4 __probew
Determines whether write access to the virtual address specified by
__address bits {60:0} and the region register indexed by __address
bits {63:61}, is permitted at the privilege level given by __mode
bits {1:0}. It returns 1 if the access is permitted, and 0
otherwise.
This function can probe only with equal or lower privilege levels.
If the specified privilege level is higher (lower number), then the
probe is performed with the current privilege level.
This function is the same as the Intel __probe_w function.
Syntax:
int __probew (__int64 __address, unsigned int __mode);
4 __ptce
Maps to the ptc.e instruction.
Syntax:
void __ptce (__int64 va);
4 __ptcl
Purges the local translation cache. Maps to the ptc.l r,r
instruction.
Syntax:
void __ptcl (__int64 va, __int64 pagesz);
4 __ptcg
Purges the global translation cache. Maps to the ptc.g r,r
instruction.
Syntax:
void __ptcg (__int64 va, __int64 pagesz);
4 __ptcga
Purges the global translation cache and ALAT. Maps to the ptc.ga
r,r instruction.
Syntax:
void __ptcga (__int64 va, __int64 pagesz);
4 __ptri
Purges the instruction translation register. Maps to the ptr.i r,r
instruction.
Syntax:
void __ptri (__int64 va, __int64 pagesz);
4 __ptrd
Purges the data translation register. Maps to the ptr.d r,r
instruction.
Syntax:
void __ptrd (__int64 va, __int64 pagesz);
4 __rum
Resets the user mask.
Syntax:
void __rum (int mask);
4 __rsm
Resets the system mask bits of the PSR. Maps to the rsm imm24
instruction.
Syntax:
void __rsm (int mask);
4 __setIndReg
Copies a value into an indexed register. The function accesses a
register (index) in a register file (whichIndReg) of 64-bit
registers.
Syntax:
void __setIndReg (const int whichIndReg, __int64 index,
unsigned __int64 value);
4 __setReg
Sets the value for a hardware register based on the register index
specified. This function produces a corresponding mov = r
instruction.
Syntax:
void __int64 __setReg (const int whichReg, unsigned __int64
value);
4 __ssm
Sets the system mask.
Syntax:
void __ssm (int mask);
4 __sum
Sets the user mask bits of the PSR. Maps to the sum imm24
instruction.
Syntax:
void __sum (int mask);
4 __synci
Enables memory synchronization. Maps to the sync.i instruction.
Syntax:
void __synci (void);
4 __tak
Returns the translation access key.
Syntax:
unsigned int __tak (__int64 __address);
4 __tpa
Translates a virtual address to a physical address.
Syntax:
__int64 __tpa(__int64 __address);
4 __thash
Generates a translation hash entry address. Maps to the thash r =
r instruction.
Syntax:
void __thash(__int64 __address);
4 __ttag
Generates a translation hash entry tag. Maps to the ttag r=r
instruction.
Syntax:
void __ttag(__int64 __address);
3 Variable_Length_Argument_Lists
The set of functions and macros defined and declared in the
<varargs.h> and the <stdarg.h> header files provide a method of
accessing variable-length argument lists. (Note that the
<stdarg.h> functions are defined by the ANSI C standard and are,
therefore, portable as compared with those defined in <varargs.h>.)
The VSI C RTL functions such as printf and execl, for example, use
variable-length argument lists. User-defined functions with
variable-length argument lists that do not use <varargs.h> or
<stdarg.h> are not portable due to the different argument-passing
conventions of various machines.
To use these functions and macros in <stdarg.h>, you must include
the <stdarg.h> header file with the following preprocessor
directive:
#include <stdarg.h>
The <stdarg.h> header file declares a type (va_list) and three
macros (va_start, va_arg, and va_end) for advancing through a list
of function arguments of varying number and type. The macros have
the following syntax:
void va_start(va_list ap, parmN);
type va_arg(va_list ap, type);
void va_end(va_list ap);
The va_start macro initializes the object ap of type va_list for
subsequent use by va_arg and va_end. The va_start macro must be
invoked before any access to the unnamed arguments. The parameter
parmN is the identifier of the rightmost parameter in the variable
parameter list of the function definition. If parmN is declared
with the register storage class, with a function or array type, or
with a type that is not compatible with the type that results after
application of the default arguments promotions, the behavior is
undefined. The va_start macro returns no value.
The va_arg macro expands to an expresion that has the type and
value of the next argument in the call. The parameter ap is the
same as the one initialized by va_start. Each invocation of va_arg
modifies ap so that the values of successive arguments are returned
in turn. The parameter "type" is a type name specified such that
the type of a pointer to an object that has the specified type can
be obtained by postfixing an asterisk (*) to "type". If there is
no actual next argument, or if type is not compatible with the type
of the next actual argument (as promoted according to the default
argument promotions), the behavior is undefined. The first
invocation of va_arg after that of va_start returns the value of
the argument after that specified by parmN. Successive invocations
return the values of the remaining arguments in turn.
The va_end macro facilitates a normal return from the function
whose variable argument list was referred to by the expansion of
va_start that initialized the va_list ap object. The va_end macro
can modify ap) so that it can no longer be used (without an
intervening invocation of va_start). If there is no corresponding
invocation of va_start or if va_end is not invoked before the
return, the behavior is undefined. The va_end macro returns no
value.
3 Preprocessor
The VSI C preprocessor uses directives to affect the compilation of
a source file. For VSI C on OpenVMS systems, these directives are
processed by an early phase of the compiler, not by a separate
program.
The preprocessor directives begin with a number sign (#) and do not
end with a semicolon. The number sign must appear in the first
column of the source line.
4 Null_directive (#)
A preprocessing directive of the form # <newline> is a null
directive and has no effect.
4 Conditional_Compilation
Conditional compilation is provided by the following directives:
#if constant-expression
Checks whether the constant expression is nonzero (true).
#ifdef identifier
Checks whether the identifier is defined.
#ifndef identifier
Checks whether the identifier is undefined.
#else
Introduces source lines to be compiled as an alternative to the
conditions tested by the previous directives.
#elif constant-expression
Delimits alternative source lines to be compiled if the constant
expression in the corresponding #if, #ifdef, or #ifndef
directive is false and if the additional constant expression
presented in the #elif directive is true. An #elif directive is
optional.
#endif
Ends the scope of the previous directives.
If the condition checked by #if, #ifdef, or #ifndef is true, then
all lines between the #else, #elif, and #endif are ignored. If the
condition is false, then any lines between the conditional
directive and the #else or #elif (if any) are ignored. If there is
no #else, then the lines between the conditional and the #endif are
ignored.
4 #define
The #define preprocessor directive has the form:
#define identifier token-string
The preprocessor substitutes the token string everywhere in the
program that it finds the identifier except within comments,
character constants, or string constants.
Macro replacements are defined in a #define directive of the
following form:
#define name([parm1[,parm2,...]]) token-string
Within the program, all macro references that have the following
form are replaced by the token string. The arguments in the macro
reference replace the corresponding parameters in the token string.
name([arg1[,arg2,...]])
4 #dictionary
The #dictionary directive is retained for compatibility with VAX C
and is supported only when running the VSI C compiler in VAX C mode
(/STANDARD=VAXC). See also the ANSI C equivalent #pragma
dictionary directive.
The #dictionary directive extracts Common Data Dictionary (CDD)
definitions from the specified dictionary. These definitions are
then translated into VSI C and included in the program.
The #dictionary directive has the following form:
#dictionary "cdd_path"
The cdd_path is a character string that gives the path name of the
CDD record. It can also be a macro that resolves to such a
character string.
4 #error
The #error directive issues an optional diagnostic message, and
ends compilation. This directive has the following form:
#error [message] <newline>
4 #include
The #include directive instructs the preprocessor to insert the
contents of the specified file or module into the program. An
#include directive can have one of three forms:
#include "filespec"
#include <filespec>
#include module-name
The first two forms are ANSI-compliant methods of file inclusion
and are therefore more portable. In these forms, .h is the default
file type, unless the compiler is instructed to supply no default
type (that is, a type of just ".") by the
/ASSUME=NOHEADER_TYPE_DEFAULT qualifier.
The third form is specific to OpenVMS systems for specifying the
inclusion of a module from a text library, and is not generally
needed or recommended because the ANSI forms also cause the text
libraries to be searched.
For the order of search, see /INCLUDE_DIRECTORY.
There is no defined limit to the nesting level of #include files
and modules.
4 #line
The #line directive applies a specified line number and optional
file specification to the next line of source text. This can be
useful for diagnostic messages. The #line directive has the
following forms:
#line integer-constant <newline>
#line integer-constant "filename" <newline>
#line pp-tokens <newline>
In the first two forms, the compiler gives the line following a
#line directive the number specified by the integer constant. The
optional filename in quotation marks indicates the name of the
source file that the compiler will provide in its diagnostic
messages. If the filename is omitted, the file name used is the
name of the current source file or the last filename specified in a
previous #line directive.
In the third form, macros in the #line directive are expanded
before it is interpreted. This allows a macro call to expand into
the integer-constant, filename, or both. The resulting #line
directive must match one of the other two forms, and is then
processed as appropriate.
4 #module
The #module directive is retained for compatibility with VAX C and
is supported only when running the VSI C compiler in VAX C mode
(/STANDARD=VAXC). See also the ANSI C equivalent #pragma module
directive.
The #module directive passes information about an object module to
the compiler.
The #module directive can have one of the following forms:
#module identifier identifier
#module identifier string
The first argument of the directive is an VSI C identifier or macro
that resolves to an identifier. It gives the system-recognized
(for example, internally recognized by the debugger and the
librarian) name of the module; the object file name remains the
same. The second argument specifies the optional identification
that appears on listings. This may be either a VAX C identifier, a
character-string constant with no more than 31 characters, or a
macro that resolves to one of these.
There can be only one #module directive per compilation. It can
appear anywhere before the C language text.
4 #pragma
The #pragma preprocessor directive performs compiler-specific tasks
as designated by each implementation of the C language.
All pragmas have a <pragma-name>_m version, which makes the pragma
subject to macro replacement. For example, #pragma assert is not
subject to macro expansion, but #pragma assert_m is.
All pragmas also have a <pragma-name>_nm version, which prevents
macro expansion. For example, #pragma inline is subject to macro
expansion, but #pragma inline_nm is not.
There is also a _Pragma operator (C99 Standard), which destringizes
its string literal argument, effectively allowing #pragma
directives to be produced by macro expansion. When specified using
this operator, the tokens of the pragma, which appear together
within a single string literal in this form, are not macro
expanded, even if they have an "_m" suffix. But macro expansion
can be accomplished if desired by using the stringization operator
(#) to form the string.
The _Pragma operator has the following syntax:
_Pragma ( string-literal )
VSI C for OpenVMS Systems supports the following #pragma
directives:
#pragma assert[_m|_nm]
Lets you specify assertions that the compiler can make about a
program to generate more efficient code.
The #pragma assert directive is never needed to make a program
execute correctly, however if a #pragma assert is specified,
the assertions must be valid or the program might behave
incorrectly.
Syntax:
#pragma assert func_attrs(identifier-list)function-assertions
#pragma assert global_status_variable(variable-list)
#pragma assert non_zero(constant-expression) string-literal
Descriptions follow.
The #pragma assert func_attrs directive:
The identifier-list is a list of function identifiers about
which the compiler can make assertions. If more than one
identifier is specified, separate them by commas.
The function-assertions specify the assertions for the compiler
to make about the functions. Specify one or more of the
following, separating multiple assertions with whitespace:
noreturn
The compiler can assert that any call to the routine will
never return.
nocalls_back
The compiler can assert that no routine in the source
module will be called before control is returned from this
function.
nostate
The compiler can assert that the value returned by the
function and any side-effects the function might have are
determined only by the function's arguments. If a
function is marked as having both noeffects and nostate,
the compiler can eliminate redundant calls to the
function.
noeffects
The compiler can assert that any call to this function
will have no effect except to set the return value of the
function. If the compiler determines that the return
value from a function call is never used, it can remove
the call.
file_scope_vars(option)
The compiler can make assertions about how a function will
access variables declared at file scope (with either
internal or external linkage).
The file_scope_vars option is one of the following:
o none - The function will not read nor write to any
file-scope variables except those whose type is
volatile or those listed in a #pragma assert
global_status_variable.
o noreads - The function will not read any file-scope
variables except those whose type is volatile or those
listed in a #pragma assert global_status_variable.
o nowrites - The function will not write to any
file-scope variables except those whose type is
volatile or those listed in a #pragma assert
global_status_variable.
format (<style>, <format-index>, <first-to-check-index>)
Asserts to the compiler that this function takes printf-
or scanf-style arguments to be type-checked against a
format string. Specify the parameters as follows:
o <style> -- PRINTF or SCANF.
This determines how the format string is interpreted.
o <format-index> -- {1|2|3|...}
This specifies which argument is the format-string
argument (starting from 1).
o <first-to-check-index> -- {0|1|2|...}
This is the number of the first argument to check
against the format string. For functions where the
arguments are not available to be checked (such as
vprintf), specify the third parameter as 0. In this
case, the compiler only checks the format string for
consistency.
The #pragma assert global_status_variable directive:
Use the #pragma assert global_status_variable(variable-list)
form of the pragma to specify variables that are to be
considered global status variables, which are exempt from any
assertions given to functions by #pragma assert func_attrs
file_scope_vars directives.
The variable-list is a list of variables.
The #pragma assert non_zero directive:
When the compiler encounters this directive, it evaluates the
constant-expression. If the expression is zero, the compiler
generates a message that contains both the specified
string-literal and the compile-time constant-expression. For
example:
#pragma assert non_zero(sizeof(a) == 12) "a is the wrong size"
In this example, if the compiler determines that the sizeof a
is not 12, the following diagnostic message is output:
CC-W-ASSERTFAIL, The assertion "(sizeof(a) == 12)" was not
true. a is the wrong size.
Unlike the #pragma assert options func_attrs and
global_status_variable, #pragma assert non_zero can appear
either inside or outside a function body. When used inside a
function body, the pragma can appear wherever a statement can
appear, but the pragma is not treated as a statement. When
used outside a function body, the pragma can appear anywhere a
declaration can appear, but the pragma is not treated as a
declaration.
Because macro replacement is not performed on #pragma assert,
you might need to use the #pragma assert_m directive to obtain
the results you want. Consider the following program that
verifies both the size of a struct and the offset of one of its
elements:
#include <stddef.h>
typedef struct {
int a;
int b;
} s;
#pragma assert non_zero(sizeof(s) == 8) "sizeof assert failed"
#pragma assert_m non_zero(offsetof(s,b) == 4) "offsetof assert
failed"
Because offsetof is a macro, the second pragma must be #pragma
assert_m so that offsetof will expand correctly.
#pragma builtins[_m|_nm]
Enables the VSI C built-in functions that directly access
processor instructions.
The #pragma builtins directive is provided for VAX C
compatibility.
VSI C implements #pragma builtins by including the <builtins.h>
header file, and is equivalent to #include <builtins.h> on
OpenVMS systems.
This header file contains prototype declarations for the
built-in functions that allow them to be used properly. By
contrast, VAX C implemented this pragma with special-case code
within the compiler, which also supported a #pragma nobuiltins
preprocessor directive to turn off the special processing.
Because declarations cannot be "undeclared", VSI C does not
support #pragma nobuiltins. Furthermore, the names of all the
built-in functions use a naming convention defined by ANSI C to
be in a namespace reserved to the C language implementation.
#pragma dictionary[_m|_nm]
Allows you to extract CDD data definitions and include these
definitions in your program.
The ANSI C compliant #pragma dictionary directive is equivalent
to the VAX C compatible #dictionary directive, but is supported
in all compiler modes. (The #dictionary directive is retained
for compatibility and is supported only when compiling with the
/STANDARD=VAXC qualifier.)
Syntax:
#pragma dictionary "cdd_path" [null_terminate]
[name(structure_name)] [text1_to_array | text1_to_char]
The cdd_path is a character string that gives the path name of
the CDD record. It can also be a macro that resolves to such a
character string.
The optional null_terminate keyword can be used to specify that
all string data types should be null-terminated.
The optional name() can be used to supply an alternate tag name
or a declarator, struct_name for the outer level of a CDD
structure.
The optional text1_to_char keyword forces the CDD type "text"
to be translated to char, rather than "array of char" if the
size is 1. This is the default if null_terminate is not
specified.
The optional text1_to_array keyword forces the CDD type "text"
to be translated to type "array of char" even when the size
is 1. This is the default when null_terminate is specified.
#pragma environment[_m|_nm]
Sets, saves, or restores the states of context pragmas. This
directive protects include files from contexts set by
encompassing programs, and protects encompassing programs from
contexts that could be set in header files that they include.
The #pragma environment directive affects the following
pragmas:
o #pragma extern_model
o #pragma extern_prefix
o #pragma member_alignment
o #pragma message
o #pragma names
o #pragma pointer_size
o #pragma required_pointer_size
Syntax:
#pragma environment command_line
#pragma environment header_defaults
#pragma environment restore
#pragma environment save
command_line
Sets, as specified on the command line, the states of all
the context pragmas. You can use this pragma to protect
header files from environment pragmas that take effect
before the header file is included.
header_defaults
Sets the states of all the context pragmas to their
default values. This is almost equivalent to the
situation in which a program with no command-line options
and no pragmas is compiled, except that this pragma sets
the pragma message state to #pragma nostandard, as is
appropriate for header files.
save
Saves the current state of every pragma that has an
associated context.
restore
Restores the current state of every pragma that has an
associated context.
#pragma extern_model[_m|_nm]
Controls the compiler's interpretation of objects that have
external linkage. This pragma lets you choose the global
symbol model to be used for externs.
Syntax:
#pragma extern_model common_block [attr[,attr]...]
#pragma extern_model relaxed_refdef [attr[,attr]...]
#pragma extern_model strict_refdef "name" [attr[,attr]...]
#pragma extern_model strict_refdef
#pragma extern_model globalvalue
#pragma extern_model save
#pragma extern_model restore
The default model on VSI C is #pragma relaxed_refdef noshr.
This is different from the model used by VAX C, which is common
block, shr.
The [attr[,attr]...] are optional psect attribute
specifications chosen from the following (at most one from each
line):
o gbl lcl (Not allowed with relaxed_refdef)
o shr noshr
o wrt nowrt
o pic nopic (Not meaningful for Alpha)
o ovr con
o rel abs
o exe noexe
o vec novec
o noreorder (named strict_refdef only)
o natalgn (named strict_refdef only)
o 0 byte 1 word 2 long 3 quad 4 octa 5 6 7 8 9 10 11 12 13 14
15 16 page
See the HP C User's Guide for more information on the #pragma
extern_model directive.
#pragma extern_prefix[_m|_nm]
Controls the compiler's synthesis of external names, which the
linker uses to resolve external name requests.
When you specify #pragma extern_prefix with a string argument,
the compiler prepends the string to all external names
produced by the declarations that follow the pragma
specification.
This pragma is useful for creating libraries where the
facility code can be attached to the external names in the
library.
Syntax:
#pragma extern_prefix "string" [(id[,id]...)]
#pragma extern_prefix {NOCRTL|RESTORE_CRTL} (id[,id]...)
#pragma extern_prefix save
#pragma extern_prefix restore
Where "string" prepends the quoted string to external names in
the declarations that follow the pragma specification.
You can also specify an extern prefix for specific identifiers
using the optional list [(<emphasis>(id)[,<emphasis>(id)]...)].
The NOCRTL and RESTORE_CRTL keywords control whether or not the
compiler applies its default RTL prefixing to the names
specified in the id-list, required for this form of the pragma.
The effect of NOCRTL is like that of the EXCEPT=keyword of the
/PREFIX_LIBRARY_ENTRIES command-line qualifier. The effect of
RESTORE_CRTL is to undo the effect of a #pragma extern_prefix
NOCRTL or a /PREFIX=EXCEPT= on the command line.
The save and restore keywords can be used to save the current
pragma prefix string and to restore the previously saved pragma
prefix string, respectively.
The default external prefix, when none has been specified by a
pragma, is the null string.
#pragma function[_m|_nm]
Specifies that calls to the specified functions are not
intrinsic but are, in fact, function calls. This pragma has
the opposite effect of #pragma intrinsic.
Syntax:
#pragma function[_m|_nm] (function1[, function2, ...])
#pragma include_directory[_m|_nm]
The effect of each #pragma include_directory is as if its
string argument (including the quotes) were appended to the
list of places to search that is given its initial value by the
/INCLUDE_DIRECTORY qualifier, except that an empty string is
not permitted in the pragma form.
Syntax:
#pragma include_directory <string-literal>
This pragma is intended to ease DCL command-line length
limitations when porting applications from POSIX-like
environments built with makefiles containing long lists of -I
options specifying directories to search for headers. Just as
long lists of macro definitions specified by the /DEFINE
qualifier can be converted to #define directives in a source
file, long lists of places to search specified by the
/INCLUDE_DIRECTORY qualifier can be converted to #pragma
include_directory directives in a source file.
Note that the places to search, as described in the help text
for the /INCLUDE_DIRECTORY qualifier, include the use of
POSIX-style pathnames, for example "/usr/base". This form can
be very useful when compiling code that contains POSIX-style
relative pathnames in #include directives. For example,
#include <subdir/foo.h> can be combined with a place to search
such as "/usr/base" to form "/usr/base/subdir/foo.h", which
will be translated to the filespec "USR:[BASE.SUBDIR]FOO.H"
This pragma can appear only in the main source file or in the
first file specified on the /FIRST_INCLUDE qualifier. Also, it
must appear before any #include directives.
#pragma [no]inline[_m|_nm]
Expands function calls inline. The function call is replaced
with the function code itself.
Syntax:
#pragma inline (id,...)
#pragma noinline (id,...)
If a function is named in an inline directive, calls to that
function will be expanded as inline code, if possible.
If a function is named in a noinline directive, calls to that
function will not be expanded as inline code.
If a function is named in both an inline and a noinline
directive, an error message is issued.
For calls to functions named in neither an inline nor a
noinline directive, DEC C expands the function as inline code
whenever appropriate as determined by a platform-specific
algorithm.
#pragma intrinsic[_m|_nm]
Specifies that calls to the specified functions are intrinsic
(that is, handled internally by the compiler, allowing it to
generate inline code, move or eliminate calls, or do various
other optimizations). This pragma is only valid for functions
that are known to the compiler.
Syntax:
#pragma intrinsic (function1[, function2, ...])
#pragma linkage[_m|_nm]
Specifies special linkage types for function calls. This
pragma is used with the #pragma use_linkage directive, which
associates a previously defined special linkage with a
function.
Syntax:
#pragma linkage linkage-name = (characteristics)
#pragma linkage_ia64 linkage-name = (characteristics)
On I64 systems, these two formats behave differently:
o The #pragma linkage_ia64 format requires I64 register names
be specified.
o The #pragma linkage format requires Alpha register names be
specified, which are automatically mapped, where possible,
to specific I64 registers.
The two formats are further described after the description of
the characteristics.
The characteristics specify information about where parameters
will be passed, where the results of the function are to be
received, and what registers are modified by the function call.
Specify these characteristics as a parenthesized list of items
of the following forms:
parameters (register-list)
result (simple-register-list)
preserved (simple-register-list)
nopreserve (simple-register-list)
notused (simple-register-list)
notneeded (ai, lp)
standard_linkage
You can supply the option keywords in any order.
Description of Options:
simple-register-list
A comma-separated list of register names, either Rn or Fn.
Example:
nopreserve(F5, F6)
For the #pragma linkage format, valid registers for the
preserved, nopreserve, and notused options include
general-purpose registers R0 through R30, and
floating-point registers F0 through F30.
Valid registers for the result and parameters options
include general-purpose registers R0 through R25, and
floating-point registers F0 through F30.
For the #pragma linkage_ia64 format, see below for an
explanation of register usage.
register-list
Similar to a simple-register-list except that it can
contain parenthesized sublists. Use the register-list to
describe arguments and function result types that are
structs, where each member of the struct is passed in a
single register. Example:
parameters(R5, (F5, F6))
parameters
Use this option to pass arguments to the parameters of a
routine in specific registers.
result
Use this option to specify the register to be used to
return the value for the function. If a function has a
return type of void, do not specify the result option as
part of the linkage.
preserved
A preserved register contains the same value after a call
to the function as it did before the call.
nopreserve
A nopreserve register does not necessarily contain the
same value after a call to the function as it did before
the call.
notused
A notused register is not used in any way by the called
function.
notneeded
Indicates that certain items are not needed by the
routines using this linkage. Valid options are:
AI -- Specifies that the Argument Information
register (R25) does not need to be set up when
calling the specified functions.
LP -- Specifies that the Linkage Pointer register
does not need to be set up when calling the specified
functions. Note that for I64 systems, there is no
linkage pointer, so this setting is accepted but does
not change the behavior of the pragma.
standard_linkage
Tells the compiler to use the standard linkage appropriate
to the target platform. This can be useful to confine
conditional compilation to the pragmas that define
linkages, without requiring the corresponding #pragma
use_linkage directives to be conditionally compiled as
well.
If the standard_linkage keyword is specified, it must be
the only option in the parenthesized list following the
linkage name. For example:
#pragma linkage special1 = (standard_linkage)
If the standard_linkage keyword is not specified, you can
supply the parameters, result, preserved, nopreserve, and
notused options in any order, separated by commas.
Description of the two formats of this pragma:
The #pragma linkage_ia64 format of this preprocessor directive
requires register names to be specified in terms of an OpenVMS
I64 system. The register names are never mapped to a different
architecture. This form of the pragma always produces an error
if encountered on a different architecture.
For this format of the pragma, valid registers for the
preserved, nopreserve, notused, parameters, and result options
are:
o Integer registers R3 through R12 and R19 through R31
o Floating-point registers F2 through F31
In addition, the parameters and result options also permit
integer registers R32 through R39 to be specified, according to
the following convention. On IA64, the first eight integer
input/output slots are allocated to stacked registers, and thus
the calling routine refers to them using different names than
the called routine. The convention for naming these registers
in either the parameters or result option of a #pragma
linkage_ia64 directive is always to use the hardware names as
they would be used within the called routine: R32 through R39.
The compiler automatically compensates for the fact that within
the calling routine these same registers are designated using
different hardware names.
The #pragma linkage format of this preprocessor directive
accepts Alpha register names and conventions and automatically
maps them, where possible, to specific I64 registers. So
whenever VSI C for I64 encounters a #pragma linkage directive,
it attempts to map the Alpha registers specified in the linkage
to corresponding I64 registers, and emits a SHOWMAPLINKAGE
informational message showing the I64 specific form of the
directive, #pragma linkage_ia64, with the I64 register names
that replaced the Alpha register names. The SHOWMAPLINKAGE
message is suppressed under the #pragma nostandard directive,
normally used within system header files.
Code compiled on I64 systems that deliberately relies on the
register mapping performed by #pragma linkage should either
ignore the SHOWMAPLINKAGE informational, or disable it.
The following shows the mapping that VSI C applies to the Alpha
integer register names used in #pragma linkage format
directives when they are encountered on an I64 system. Note
that the six standard parameter registers on Alpha (R16-R21)
are mapped to the first six (of eight) standard parameter
registers on I64 systems, which happen to be stacked registers:
Integer Register Mapping:
Alpha -> I64 Alpha -> I64
R0 -> R8 R16 -> R32 *
R1 -> R9 R17 -> R33 *
R2 -> R28 R18 -> R34 *
R3 -> R3 R19 -> R35 *
R4 -> R4 R20 -> R36 *
R5 -> R5 R21 -> R37 *
R6 -> R6 R22 -> R22
R7 -> R7 R23 -> R23
R8 -> R26 R24 -> R24
R9 -> R27 R25 -> R25
R10 ->R10 R26 - no mapping
R11 ->R11 R27 - no mapping
R12 ->R30 R28 - no mapping
R13 ->R31 R29 -> R29
R14 ->R20 R30 -> R12
R15 ->R21 R31 -> R0
* In parameters or result; else ignored
The following shows the mapping that VSI C applies to the Alpha
floating-point register names used in #pragma linkage
directives when they are encountered on an I64 system:
Floating-Point Register Mapping:
Alpha -> I64 Alpha -> I64
F0 -> F8 F16 -> F8
F1 -> F9 F17 -> F9
F2 -> F2 F18 -> F10
F3 -> F3 F19 -> F11
F4 -> F4 F20 -> F12
F5 -> F5 F21 -> F13
F6 -> F16 F22 -> F22
F7 -> F17 F23 -> F23
F8 -> F18 F24 -> F24
F9 -> F19 F25 -> F25
F10 ->F6 F26 - F26
F11 ->F7 F27 - F27
F12 ->F20 F28 - F28
F13 ->F21 F29 -> F29
F14 ->F14 F30 -> F30
F15 ->F15
Mapping Diagnostics:
In some cases, the HP C compiler on Alpha systems silently
ignores linkage registers if, for example, a standard parameter
register like R16 is specified in a preserved option. When you
compile on an I64 system, this situation emits an MAPREGIGNORED
informational message, and the SHOWMAPLINKAGE output might not
be correct. If there is no valid mapping to I64 registers, the
NOMAPPOSSIBLE error message is output. There are two special
situations that can arise when floating-point registers are
specified in a linkage:
o Only IEEE-format values are passed in floating-point
registers under the OpenVMS Calling Standard for I64: VAX
format values are passed in integer registers. Therefore,
a compilation that specifies /FLOAT=D_FLOAT or
/FLOAT=G_FLOAT produces an error for any linkage that
specifies floating-point registers. Note that this
includes use in options that do not involve passing values,
such as the preserved and notused options.
o The mapping of floating-point registers is many-to-one in
two cases:
- Alpha registers F0 and F16 both map to I64 register F8
- Alpha F1 and F17 both map to I64 register F9.
A valid Alpha linkage may well specify uses for both F0 and
F16, and/or both F1 and F17. Such a linkage cannot be
mapped on an I64 system. But because of the way this
situation is detected, the MULTILINKREG warning message
that is produced can only identify the second occurrence of
an Alpha register that got mapped to the same I64 register
as some previous Alpha register. The actual pair of Alpha
registers in the source is not identified, and so the
message can be confusing. For example, an option like
preserved(F1,F17) gets a MULTILINKREG diagnostic saying
that F17 was specified more than once.
#pragma [no]member_alignment[_m|_nm]
Tells the compiler to align structure members on the next
boundary appropriate to the type of the member rather than the
next byte. For example, a long variable is aligned on the next
longword boundary; a short variable on the next word boundary.
Syntax:
#pragma nomember_alignment [base_alignment]
#pragma member_alignment [save | restore]
The optional base_alignment parameter can be used with #pragma
nomember_alignment to specify the base alignment of the
structure. Use one of the following keywords to specify the
base_alignment:
o BYTE (1 byte)
o WORD (2 bytes)
o LONGWORD (4 bytes)
o QUADWORD (8 bytes)
o OCTAWORD (16 bytes)
The optional save and restore keywords can be used to save the
current state of the member_alignment and to restore the
previous state, respectively. This feature is necessary for
writing header files that require member_alignment or
nomember_alignment, or that require inclusion in a
member_alignment that is already set.
#pragma message[_m|_nm]
Controls the issuance of individual diagnostic messages or
groups of messages. Use of this pragma overrides any
command-line options that may affect the issuance of messages.
Syntax:
#pragma message option1 message-list
#pragma message option2
#pragma message (quoted-string)
where option1 is:
disable Suppresses the issuance of the indicated
messages.
Only messages of severity Warning (W) or
Information (I) can be disabled. If the
message has severity of Error (E) or
Fatal (F), it is issued regardless of
any attempt to disable it.
enable Enables the issuance of the indicated
messages.
emit_once Emits the specified messages only once
per compilation.
emit_always Emits the specified messages at every
occurrence of the condition.
error Sets the severity of each message in the
message-list to Error.
fatal Sets the severity of each message on the
message-list to Fatal.
informational Sets the severity of each message in the
message-list to Informational.
warning Sets the severity of each message in the
message-list to Warning.
The message-list can be any one of the following:
o A single message identifier (within parentheses or not).
o A single message-group name (within parentheses or not).
Message-group names are:
ALL All the messages in the compiler
ALIGNMENT Messages about unusual or inefficient
data alignment.
C_TO_CXX Messages reporting the use of C features
that would be invalid or have a
different meaning if compiled by a C++
compiler.
CDD Messages about CDD (Common Data
Dictionary) support.
CHECK Messages reporting code or practices
that, although correct and perhaps
portable, are sometimes considered
ill-advised because they can be
confusing or fragile to maintain. For
example, assignment as the test
expression in an "if" statement.
NOTE: The check group gets defined by
enabling level5 messages.
DEFUNCT Messages reporting the use of obsolete
features: ones that were commonly
accepted by early C compilers but were
subsequently removed from the language.
NEWC99 Messages reporting the use of the new
C99 Standard features.
NOANSI Messages reporting the use of non-ANSI
Standard features. The NOANSI message
group is a synonym for NOC89. Also see
message groups NEWC99, NOC89, NOc99.
NOC89 Messages reporting the use of non-C89
Standard features.
NOC99 Messages reporting the use of non-C99
Standard features.
OBSOLESCENT Messages reporting the use of features
that are valid in ANSI Standard C, but
which were identified in the standard as
being obsolescent and likely to be
removed from the language in a future
version of the standard.
OVERFLOW Messages that report assignments and/or
casts that can cause overflow or other
loss of data significance.
PERFORMANCE Messages reporting code that might
result in poor run-time performance.
PORTABLE Messages reporting the use of language
extensions or other constructs that
might not be portable to other compilers
or platforms.
PREPROCESSOR Messages reporting questionable or
non-portable use of preprocessing
constructs.
QUESTCODE Messages reporting questionable coding
practices. Similar to the check group,
but messages in this group are more
likely to indicate a programming error
rather than just a non-robust style.
Enabling the QUESTCODE group provides
lint-like checking.
RETURNCHECKS Messages related to function return
values.
UNINIT Messages related to using uninitialized
variables.
UNUSED Messages reporting expressions,
declarations, header files, CDD records,
static functions, and code paths that
are not used.
Note, however, that unlike any other
messages, these messages must be enabled
on the command line
(/WARNINGS=ENABLE=UNUSED) to be
effective.
o A single message-level name (within parentheses or not).
Note: There is a core of very important compiler messages
that are enabled by default, regardless of anything
specified with /WARNINGS or #pragma message. Referred to as
message level 0, it includes all messages issued in header
files, and comprises what is known as the nostandard group.
All other message levels add additional messages to this
core of enabled messages.
You cannot disable level 0. However, you can disable
individual messages in level 0 that are not errors or
fatals.
Message-level names are:
LEVEL1 Important messages. These are less
important than level 0, because messages
in this group are not displayed if #pragma
nostandard is active.
LEVEL2 Moderately important messages. This level
is used to introduce new messages that
will be output in the DIGITAL UNIX V4.0
release. LEVEL2 is the default for
DIGITAL UNIX and Tru64 UNIX platforms.
LEVEL3 Less important messages. In general,
these are the messages output by default
in DEC C Version 5.5 for OpenVMS Systems.
LEVEL3 is the default message level for
VSI C for OpenVMS systems.
LEVEL4 Useful check/portable messages.
LEVEL5 Not so useful check/portable messages.
LEVEL6 All messages in LEVEL5 plus additional
"noisy" messages.
Enabling a level also enables all the messages in the levels
below it. So enabling LEVEL3 messages also enables messages
in LEVEL2 and LEVEL1.
Disabling a level also disables all the messages in the
levels above it. So disabling LEVEL4 messages also disables
messages in LEVEL5 and LEVEL6.
o A comma-separated list of message identifiers, group names,
and messages levels, freely mixed, enclosed in parentheses.
option2 is:
save -- saves the current state of which messages are
enabled and disabled.
restore -- restores the previous state of which messages
are enabled and disabled.
The save and restore options are useful primarily within header
files.
The #pragma message (quoted-string) form outputs the
quoted-string as a compiler message. This form of the pragma is
subject to macro replacement. For example, the following is
valid:
#pragma message ("Compiling file " __FILE__)
#pragma module[_m|_nm]
The ANSI C compliant #pragma module directive is equivalent to
the VAX C compatible #module directive, but is supported in all
compiler modes. (The #module directive is retained for
compatibility and is supported only when compiling with the
/STANDARD=VAXC qualifier.) The #pragma module directive is
specific to VSI C for OpenVMS Systems and is not portable.
Use the #pragma module directive to change the
system-recognized module name and version number. You can find
the module name and version number in the compiler listing file
and the linker load map.
Syntax:
#pragma module identifier identifier
#pragma module identifier string
The first parameter must be a valid VSI C identifier. It
specifies the module name to be used by the linker. The second
parameter specifies the optional identification that appears on
listings and in the object file. It must be either a valid VSI
C identifier of 31 characters or less, or a character-string
constant of 31 characters or less.
Only one #pragma module directive can be processed per
compilation unit, and that directive must appear before any C
language text. The #pragma module directive can follow other
directives, such as #define, but it must precede any function
definitions or external data definitions.
#pragma names[_m|_nm]
Provides the same kinds of control over the mapping of external
identifiers' object-module symbols as does the /NAMES
command-line qualifier, and it uses the same keywords. But as
a pragma, the controls can be applied selectively to regions of
declarations.
This pragma should only be used in header files and is intended
for use by developers who supply libraries and/or header files
to their customers.
The pragma has a save/restore stack that is also managed by
#pragma environment, and so it is well-suited for use in header
files. The effect of #pragma environment header_defaults is to
set NAMES to "uppercase,truncated", which is the compiler
default.
Syntax:
#pragma names <stack-option>
#pragma names <case-option>
#pragma names <length-option>
Where
<stack-option> is one of:
o save - save the current names state
o restore - restore a saved names state
<case-option> is one of:
o uppercase - uppercase external names
o as_is - do not change case
<length-option> is one of:
o truncated - truncate at 31 characters
o shortened - shorten to 31 using CRC
#pragma optimize[_m|_nm]
Sets the optimization characteristics of function definitions
that follow the directive. It allows optimization-control
options that are normally set on the command line for the
entire compilation to be specified in the source file for
individual functions.
Syntax:
#pragma optimize <settings>
#pragma optimize save
#pragma optimize restore
#pragma optimize command_line
Where <settings> is any combination of the following:
o <level settings>
Set the optimization level. Specify as:
level=n
Where n is an integer from 0 to 5.
o <unroll settings>
Control loop unrolling. Specify as:
unroll=n
Where n is a nonnegative integer.
o <ansi-alias settings>
Control ansi-alias assumptions. Specify one of the following:
ansi_alias=on
ansi_alias=off
o <intrinsic settings>
Control recognition of intrinsics. Specify one of the
following:
intrinsics=on
intrinsics=off
Use the save, restore, and command_line keywords as follows:
o save -- Saves the current pointer size
o restore -- Restores the current pointer size to its last
saved state
o command_line -- Sets the optimization settings to what was
specified on the command line
Example:
#pragma optimize level=5 unroll=6
Usage Notes:
o If the level=0 clause is present, it must be the only
clause present.
o The #pragma optimize directive must appear at file scope,
outside any function body.
o The #pragma environment save and restore operations include
the optimization state.
o The #pragma environment command_line directive resets the
optimization state to that specified on the command line.
o If #pragma optimize does not specify a setting for one of
the optimization states, that state remains unchanged.
o When a function definition is encountered, it is compiled
using the optimization settings that are current at that
point in the source.
o When a function is compiled under level=0, the compiler
will not inline that function. In general, when functions
are inlined, the inlined code is optimized using the
optimization controls in effect at the call site instead of
using the optimization controls specified for the function
being inlined.
o When the OpenVMS command line specifies /NOOPT (or
/OPTIMIZE=LEVEL=0), the #pragma optimize directive has no
effect (except that its arguments are still validated).
#pragma pack[_m|_nm]
Specifies the byte boundary for packing members of C
structures.
Syntax:
#pragma pack [n]
The n specifies the new alignment restriction in bytes:
1 - align to byte
2 - align to word
4 - align to longword
8 - align to quadword
16 - align to octaword
A structure member is aligned to either the alignment specified
by #pragma pack or the alignment determined by the size of the
structure member, whichever is smaller. For example, a short
variable in a structure gets byte-aligned if #pragma pack 1 is
specified. If #pragma pack 2, 4, or 8 is specified, the short
variable in the structure gets aligned to word.
When #pragma pack is specified without a value or with a value
of 0, packing reverts to that specified by the
/[NO]MEMBER_ALIGNMENT qualifier setting (either explicitly
specified or by default) on the command line. Note that when
specifying #pragma pack without a value, you must use
parentheses: #pragma pack ().
#pragma pointer_size[_m|_nm]
Controls whether pointers are 32-bit pointers or 64-bit
pointers.
Syntax:
#pragma pointer_size keyword
Where keyword is one of the following:
o short -- 32-bit pointer
o long -- 64-bit pointer
o system_default -- 32-bit pointers on OpenVMS systems;
64-bit pointers on Tru64 UNIX systems
o save -- Saves the current pointer size
o restore -- Restores the current pointer size to its last
saved state
This directive is enabled only when the /POINTER_SIZE command-line
qualifier is specified. Otherwise, #pragma pointer_size has the
same effect as #pragma required_pointer_size.
#pragma required_pointer_size[_m|_nm]
Intended for use by developers of header files to control
pointer size within header files.
Syntax:
#pragma required_pointer_size keyword
Where keyword is one of the following:
o short -- 32-bit pointer
o long -- 64-bit pointer
o system_default -- 32-bit pointers on OpenVMS systems;
64-bit pointers on Tru64 UNIX systems
o save -- Saves the current pointer size
o restore -- Restores the current pointer size to its last
saved state
This directive is always enabled, even if the /POINTER_SIZE
command-line qualifier is omitted. Otherwise, #pragma
required_pointer_size has the same effect as #pragma pointer_size.
#pragma [no]standard[_m|_nm]
Directs the compiler to define regions of source code where
portability diagnostics are not to be issued.
Use #pragma nostandard to suppress diagnostics about non-ANSI C
extensions, regardless of the /STANDARD qualifier specified,
until a #pragma standard directive is encountered.
Use #pragma standard to reinstate the setting of the /STANDARD
qualifier that was in effect before before the last #pragma
nostandard was encountered.
Every #pragma standard directive must be preceded by a
corresponding #pragma nostandard directive.
Note that this pragma does not change the current mode of the
compiler or enable any extensions not already supported in that
mode.
#pragma unroll[_m|_nm]
Directs the compiler to unroll the for loop that follows it by
the number of times specified in the unroll_factor argument.
The #pragma unroll directive must be followed by a for
statement.
Syntax:
#pragma unroll (unroll_factor)
The unroll_factor is an integer constant in the range 0 to 255.
If a value of 0 is specified, the compiler ignores the
directive and determines the number of times to unroll the loop
in its normal way. A value of 1 prevents the loop from being
unrolled. The directive applies only to the for loop that
follows it, not to any subsequent for loops.
#pragma use_linkage[_m|_nm]
Associates a special linkage, defined by the #pragma linkage
directive, with the specified functions.
Syntax:
#pragma use_linkage linkage-name (routine1, routine2, ...)
The linkage-name is the name of a linkage previously defined by
the #pragma linkage directive.
The parenthesized list contains the names of functions you want
to associated with the named linkage.
The list can also contain typedef names of function type, in
which case functions or pointers to functions declared using
that type will have the specified linkage.
4 #undef
The #undef directive cancels a previously defined macro
replacement. Any other macro replacements that occurred before the
#undef directive remain.
The #undef directive has the following syntax:
#undef identifier
3 Predefined_Macros
In addition to the ANSI-compliant, implementation-independent
macros described in the HP C Language Reference Manual, The VSI C
compiler provides the following predefined macros:
4 System_Identification_Macros
Each implementation of the VSI C compiler automatically defines
macros that you can use to identify the system on which the program
is running. These macros can assist in writing code that executes
conditionally, depending on the architecture or operating system on
which the program is running.
The following table lists the traditional and new spellings of
these predefined macro names for VSI C on OpenVMS systems. Both
spellings are defined for each macro unless ANSI C mode is in
effect (/STANDARD=ANSI89), in which case only the new spellings are
defined.
Traditional spelling New spelling
vms __vms
VMS __VMS
vms_version __vms_VERSION
VMS_VERSION __VMS_VERSION
__VMS_VER
__DECC_VER
__DECCXX_VER
vaxc __vaxc
VAXC __VAXC
vax11c __vax11C
VAX11C __VAX11C
--- __DECC
--- __STDC__
__STDC_HOSTED__
__STDC_VERSION__
__STDC_ISO_10646__
__MIA
On OpenVMS I64 Systems, VSI C also supports the following
predefined system identification macro names in all compiler modes:
__ia64
__ia64__
__32BITS
__INITIAL_POINTER_SIZE
Predefined macros (with the exception of __STDC_VERSION__,
__STDC_ISO_10646__, vms_version, VMS_VERSION, __vms_version,
__VMS_VERSION, and __INITIAL_POINTER_SIZE) are defined as 1 or 0,
depending on the system you're compiling on (VAX or Alpha
processor), the compiler defaults, and the qualifiers used. For
example, if you compiled using G_floating format, then __D_FLOAT
and __IEEE_FLOAT (Alpha processors only) are predefined to be 0,
and __G_FLOAT is predefined as if the following were included
before every compilation unit:
#define __G_FLOAT 1
These macros can assist in writing code that executes
conditionally. They can be used in #elif, #if, #ifdef, and #ifndef
directives to separate portable and nonportable code in a VSI C
program. The vms_version, VMS_VERSION, __vms_version, and
__VMS_VERSION macros are defined with the value of the OpenVMS
version on which you are running (for example, Version 6.0).
The __STDC__ macro is defined to 1 for /STANDARD options ANSI89,
C99, LATEST and MIA. It is defined to 2 for /STANDARD=RELAXED and
to 0 for /STANDARD=MS. It is not defined for /STANDARD options
VAXC and COMMON.
The __STDC_HOSTED__ macro is defined to 1 for /STANDARD=c99 and
/STANDARD=LATEST. It is not defined for all other /STANDARD
keywords.
The __STDC_VERSION__ macro is defined to 199901L for /STANDARD
keywords C99, LATEST, RELAXED, MS, PORTABLE. It is defined to
199409L when the ISOC94 keyword is specified alone or with the
ANSI89, MIA, RELAXED, MS, PORTABLE, or COMMON modes. The macro is
undefined for the VAXC keyword or for keywords ANSI89, MIA, or
COMMON without ISOC94 specified.
The __STDC_ISO_10646__ macro evaluates to an integer constant of
the form yyyymmL (for example, 199712L), intended to indicate that
values of type wchar_t are the coded representations of the
characters defined by ISO/IEC 10646, along with all amendments and
technical corrigenda as of the specified year and month.
4 Compiler_Mode_Macros
The following predefined macros are defined as 1 if the
corresponding compiler mode is selected (Otherwise, they are
undefined):
__DECC_MODE_STRICT ! /STANDARD=ANSI89
__DECC_MODE_RELAXED ! /STANDARD=RELAXED
__DECC_MODE_VAXC ! /STANDARD=VAXC
__DECC_MODE_COMMON ! /STANDARD=COMMON
__STDC__ ! /STANDARD=ANSI89, /STANDARD=RELAXED
__STDC_VERSION__ ! /STANDARD=ISOC94
__MS ! /STANDARD=MS
4 Floating_Point_Macros
VSI C automatically defines the following predefined macros
pertaining to the format of floating-point variables. You can use
them to identify the format with which you are compiling your
program:
__D_FLOAT
__G_FLOAT
__IEEE_FLOAT
_IEEE_FP
__X_FLOAT
4 RTL_Standards_Macros
VSI C defines the following macros that you can explicitly define
(using the /DEFINE qualifier or the #define preprocessor directive)
to control which VSI C RTL functions are declared in header files
and to obtain standards conformance checking:
_XOPEN_SOURCE_EXTENDED
_XOPEN_SOURCE
_POSIX_C_SOURCE
_ANSI_C_SOURCE
_VMS_V6_SOURCE
_DECC_V4_SOURCE
__BSD44_CURSES
__VMS_CURSES
_SOCKADDR_LEN
4 __HIDE_FORBIDDEN_NAMES
The ANSI C standard specifies exactly what identifiers in the
normal name space are declared by the standard header files. A
compiler is not free to declare additional identifiers in a header
file unless the identifiers follow defined rules (the identifier
must begin with an underscore followed by an uppercase letter or
another underscore).
When you compile with VSI C using any values of /STANDARD that set
strict C standard conformance (ANSI89, MIA, C99, and LATEST),
versions of the standard header files are included that hide many
identifiers that do not follow the rules. The header file
<stdio.h>, for example, hides the definition of the macro TRUE.
The compiler accomplishes this by predefining the macro
__HIDE_FORBIDDEN_NAMES for the above-mentioned /STANDARD values.
You can use the command line qualifier
/UNDEFINE="__HIDE_FORBIDDEN_NAMES" to prevent the compiler from
predefining this macro, thus including macro definitions of the
forbidden names.
The header files are modified to only define additional VAX C names
if __HIDE_FORBIDDEN_NAMES is undefined. For example, <stdio.h>
might contain the following:
#ifndef __HIDE_FORBIDDEN_NAMES
#define TRUE 1
#endif
4 CC$gfloat
When you compile using the /G_FLOAT qualifier, CC$gfloat is defined
as 1. When you compile without the /G_FLOAT qualifier, CC$gfloat
is defined as 0. The CC$gfloat macro is provided for compatiblity
with VAX C. The __G_FLOAT predefined macro should be used instead.
4 __DATE__
The __DATE__ macro evaluates to a string specifying the date on
which the compilation started. The string presents the date in the
form "Mmm dd yyyy" The names of the months are those generated by
the asctime library function. The first d is a space if dd is less
than 10.
Example:
printf("%s",__DATE__);
4 __FILE__
The __FILE__ macro evaluates to a string literal specifying the
file specification of the current source file.
Example:
printf("file %s", __FILE__);
4 __LINE__
The __LINE__ macro evaluates to a decimal constant specifying the
number of the line in the source file containing the macro
reference.
Example:
printf("At line %d in file %s", __LINE__, __FILE__);
4 __TIME__
The __TIME__ macro evaluates to a string specifying the time that
the compilation started. The time has the following format:
hh:mm:ss
Example:
printf("%s", __TIME__);
The value of this macro remains constant throughout the translation
unit.
3 Predeclared_Identifiers
4 __func__
The __func__ predeclared identifier evaluates to a static array of
char, initialized with the spelling of the function's name. It is
visible anywhere within the body of a function definition.
Example:
void foo(void) {printf("%s\n", __func__);}
This function prints "foo".
3 Statements
Statements are the executable instructions performed by the
program. Statements produce values and control program flow. A
group of statements enclosed in braces makes up a block.
Any valid expression or declaration terminated by a semicolon is
considered a statement. The statements that control program flow
are described in further HELP frames.
See also HELP CC LANGUAGE_TOPICS DECLARATION and HELP CC
LANGUAGE_TOPICS PREPROCESSOR.
4 break
The break statement terminates the immediately enclosing while, do,
for, or switch statement. Control passes to the statement
following the terminated statement.
Syntax:
break ;
4 continue
The continue statement passes control to the test portion of the
immediately enclosing while, do, or for statement.
Syntax:
continue ;
In each of the following statements, a continue statement is
equivalent to "goto label;":
while (expression) { statement ... label: ; }
do { statement ... label: ; } while (expression);
for (expression; expression; expression)
{ statement ... label: ; }
The continue statement is not intended for switches. A continue
statement inside a switch statement inside a loop causes
reiteration of the loop.
4 do
The do statement executes a statement one or more times, as long as
a stated condition expression is true.
Syntax:
do statement while ( expression ) ;
The do statement is executed at least once. The expression is
evaluated after each execution of the statement. If the expression
is not 0, the statement is executed again. The statement following
the do statement (the body of the do statement) is not optional;
the null statement (a lone semicolon) is provided for specifying a
do statement with an empty body.
4 for
The for statement executes a statement zero or more times, with
three specified control expressions. Expression-1 is evaluated
only once, before the first iteration; expression-2 is evaluated
before every iteration; expression-3 is evaluated after every
iteration. The for loop terminates if, on evaluation, expression-2
is 0.
Syntax:
for ( [expression-1] ; [expression-2] ; [expression-3] )
statement
The for statement is equivalent to the following format:
expression-1;
while ( expression-2 ) { statement expression-3; }
You can omit any of the three expressions. If expression-2 is
omitted, the while condition is true.
4 goto
The goto statement transfers control unconditionally to a labeled
statement.
Syntax:
goto identifier ;
The identifier must be a label located in the current function.
You may use goto to branch into a block, but no initializations are
performed on variables declared in the block.
4 if
The if statement is a conditional statement. It can be written
with or without an else clause as follows:
if ( expression ) statement
if ( expression ) statement else statement
In both cases, the expression is evaluated, and if it is not 0, the
first statement is executed. If the else clause is included and
the expression is 0, the statement following else is executed
instead. In a series of if-else clauses, the else matches the most
recent else-less if.
4 Labeled
Any statement can be preceded by a label prefix of the following
form:
identifier:
This declares the identifier as a label. The scope of such a
declaration is the current function. Labels are used only as the
targets of goto statements.
4 Null
A null statement is a semicolon:
;
The null statement provides a null action -- for example, the body
of a for loop that takes no action:
for(i=0; i < ARRAYSIZE && x[i] == 5; i++)
;
4 return
The return statement causes a return from a function, with or
without a return value.
Syntax:
return ;
return expression ;
The return value is undefined if not specified in a return
statement. If an expression is specified in the return statement,
it is evaluated and the value is returned to the calling function;
the value is converted, if necessary, to the type with which the
called function was declared. If a function does not have a return
statement, the effect (on reaching the end of the function) is the
same as with a return statement that does not specify an
expression. Functions declared as void may not contain return
statements specifying an expression.
4 switch
The switch statement executes one or more of a series of cases,
based on the value of an integer expression.
Syntax:
switch ( expression ) body
The switch's body typically is a block, within which any statement
can be prefixed with one or more case labels as follows:
case constant-expression :
At most one statement in the body may have the label as follows:
default :
The switch expression is evaluated and compared to the cases. If
there is a case matching the expression's value, it is executed; if
not, the default case is executed. The switch is normally
terminated by a break, return, or goto statement in one of the
cases. If there is no matching case and no default, the body of
the switch statement is skipped.
4 while
The while statement executes a statement 0 or more times, as long
as a stated condition is true.
Syntax:
while ( expression ) statement
The expression is evaluated before each execution, and the
statement is executed if the expression is not 0. The statement
following the parentheses (the body of the while statement) is not
optional; the null statement (a lone semicolon) is provided for
specifying a while statement with an empty body.
3 Storage_Classes
The storage class of a variable determines when its storage is
allocated, whether its contents are preserved across different
blocks or functions, and what link-time scope the variable has.
Auto variables are allocated at run time. They are not preserved
across functions. Auto is the default storage class for variables
declared within a function.
Extern variables are allocated at compile time. They are preserved
across functions. There can be only 65,532 extern variables per
program. Extern is the default storage class for variables
declared outside a function.
Globaldef, globalref, and globalvalue variables are allocated at
compile time. They are preserved across functions. The number of
global symbols is unlimited.
Register variables are allocated at run time. They cannot be
referenced from other separately compiled functions.
Static variables are allocated at compile time. If externally
declared, they retain their values across functions. If internally
declared (inside of a function), they cannot be referenced from
other functions; if control passes from the defining function, to
other functions, and then passed back to the defining function, the
variable retains its previous value and is not reinitialized.
3 Type_Qualifiers
Data-type qualifiers affect the allocation or access of data
storage. The data-type qualifiers are const, volatile, __restrict,
and __unaligned.
4 const
The const data-type qualifier restricts access to stored data. If
you declare an object to be of type const, you cannot modify that
object. You can use the const data-type qualifier with the
volatile data-type qualifier or with any of the storage-class
specifiers or modifiers. The following example declares the
variable x to be a constant integer:
int const x;
4 volatile
The volatile data-type qualifier prevents an object from being
stored in a machine register, forcing it to be allocated in memory.
This data-type qualifier is useful for declaring data that is to be
accessed asynchronously. A device driver application often uses
volatile data storage. Like const, you can specify the volatile
data-type qualifier with any of the storage-class specifiers or
modifiers with the exception of the register storage class.
4 __restrict
The __restrict data-type qualifier is used to designate a pointer
as pointing to a distinct object, thus allowing compiler
optimizations to be made.
4 __unaligned
This data-type qualifier is used in pointer definitions, indicating
to the compiler that the data pointed to is not properly aligned on
a correct address. (To be properly aligned, the address of an
object must be a multiple of the size of the type. For example,
two-byte objects must be aligned on even addresses.) When data is
accessed through a pointer declared __unaligned, the compiler
generates the additional code necessary to copy or store the data
without causing alignment errors. It is best to avoid use of
misaligned data altogether, but in some cases the usage may be
justified by the need to access packed structures, or by other
considerations.
3 Storage_Class_Modifiers
The storage-class modifiers allow individual attributes of a
variable to change without changing the other default attributes
connected with a given storage class. Storage-class keywords and
storage-class modifiers can be specified in either order.
Syntax:
modifier storage_class_keyword identifier;
If you specify a storage-class modifier but not a storage class
keyword, the storage class defaults to extern.
4 noshare
Noshare variables are assigned the PSECT attribute NOSHR. Noshare
variables may not be shared between processes. This modifier is
used when linking variables that are not to be shared within a
shareable image. You can use the noshare modifier with the
storage-class keywords static, [extern], globaldef, and
globaldef{"name"}.
4 readonly
Readonly variables are assigned the PSECT attribute NOWRT and are
stored in the PSECT $READONLY$ which is a nonwritable data area.
Other programs can access the PSECT directly, but none of the
information can be overwritten. You can use the readonly modifier
with the storage-class keywords [extern], static, globaldef, and
globaldef{"name"}.
You can use both the readonly and noshare modifiers with the
[extern] and the globaldef{"name"} specifiers. If you use both
modifiers with either the static or the globaldef specifiers, the
compiler ignores noshare and accepts readonly.
4 _align
The _align modifier allows you to align objects of any of the VSI C
data types on a specified storage boundary. Use the _align
modifier in a data declaration or definition.
When specifying the boundary of the data alignment, you can use a
predefined constant: BYTE or byte, WORD or word, LONGWORD or
longword, QUADWORD or quadword, OCTAWORD or octaword, and PAGE or
page.
You can also specify an integer value that is a power of two. The
power of two tells VSI C the number of bytes to pad in order to
align the data:
For OpenVMS VAX systems, specify a constant 0, 1, 2, 3, 4, or 9.
For OpenVMS Alpha systems, specify any constant from 0 to 16.
4 __align
The __align storage-class modifier has the same semantic meaning as
the _align keyword. The difference is that __align is a keyword in
all compiler modes while _align is a keyword only in modes that
recognize VAX C keywords. For new programs, using __align is
recommended.
4 __forceinline
Similar to the __inline storage-class modifier, the __forceinline
storage-class modifier marks a function for inline expansion.
However, using __forceinline on a function definition and prototype
tells the compiler that it must substitute the code within the
function definition for every call to that function. (With
__inline, such substitution occurs at the discretion of the
compiler.)
Syntax:
__forceinline [type] function_definition
4 __inline
The __inline modifier marks a function for inline expansion. Using
__inline on a function definition and prototype tells the compiler
that it can substitute the code within the function definition for
every call to that function. Substitution occurs at the discretion
of the compiler. The __inline storage-class specifier has the same
effect as the #pragma inline preprocessor directive, except that
the latter attempts to provide inline expansion for all functions
in a translation unit, rather than for selected functions.
Syntax:
__inline [type] function_definition
4 inline
Similar to the __inline storage-class modifier, the inline
storage-class modifier can be used as a declaration specifier in
the declaration of a function. This modifier is supported in
relaxed ANSI C mode (/STANDARD=RELAXED) or if the
/ACCEPT=C99_KEYWORDS or /ACCEPT=GCCINLINE qualifier is specified.
With static functions, inline has the same effect as applying
__inline or #pragma inline to the function.
However, when inline is applied to a function with external
linkage, besides allowing calls within that translation unit to be
inlined, the inline semantics provide additional rules that also
allow calls to the function to be inlined in other translation
units or for the function to be called as an external function, at
the compiler's discretion:
o If the inline keyword is used on a function declaration with
external linkage, then the function must also be defined in the
same translation unit.
o If all of the file scope declarations of the function use the
inline keyword but do not use the extern keyword, then the
definition in that translation unit is called an inline
definition, and no externally-callable definition is produced
by that compilation unit.
Otherwise, the compilation unit does produce an
externally-callable definition.
o An inline definition must not contain a definition of a
modifiable object with static storage duration, and it must not
refer to an identifier with internal linkage. These
restrictions do not apply to the externally-callable
definition.
o As usual, at most one compilation unit in an entire program can
supply an externally-callable definition of a given function.
o Any call to a function with external linkage may be translated
as a call to an external function, regardless of the presence
of the inline qualifier. It follows from this and the previous
point that any function with external linkage that is called
must have exactly one externally-callable definition among all
the compilation units of an entire program.
o The address of an inline function with external linkage is
always computed as the address of the unique
externally-callable definition, never the address of an inline
definition.
o A call to inline function made through a pointer to the
externally-callable definition may still be inlined or
translated as a call to an inline definition, if the compiler
can determine the name of the function whose address was stored
in the pointer.
2 Link_libraries
The following describes how to link with the VSI C Run-Time Library
(RTL).
On I64 systems, you link to the VSI C RTL by using the C RTL
shareable image IA64$LIBRARY:DECC$SHR.EXE, which the linker
automatically finds through IMAGELIB.OLB.
Because DECC$SHR.EXE has only prefixed names (no unprefixed names),
to successfully link against it, make sure you cause prefixing to
occur for all VSI C RTL entry points. Do this by compiling in one
of two ways:
1. Compile with the /PREFIX_LIBRARY_ENTRIES=ALL_ENTRIES qualifier.
2. Compile with the /STANDARD=VAXC or /STANDARD=COMMON qualifier.
You get /PREFIX_LIBRARY_ENTRIES=ALL_ENTRIES as the default.
After making sure that all VSI C RTL entry points are prefixed,
link against the shareable image using the LINK command. For
example:
$ CC/DECC/PREFIX_LIBRARY_ENTRIES=ALL_ENTRIES PROG1
$ LINK PROG1
The linker automatically searches IMAGELIB.OLB to find
DECC$SHR.EXE, and resolves all C RTL references.
2 Run-time_functions
For help on the C run-time library (C RTL) functions supplied with
your OpenVMS operating system, enter the following:
$ HELP CRTL
Also see the HP C Run-Time Library Reference Manual for OpenVMS
Systems.
2 Release_Notes
The release notes for VSI C are contained in the following files:
SYS$HELP:CC.RELEASE_NOTES
SYS$HELP:CC_RELEASE_NOTES.PS
2 Socket_Routines
For help on the socket routines used for writing Internet
application programs for the TCP/IP Services protocol, enter the
following:
$ HELP TCPIP_Services Programming_Interfaces Sockets_API
Also see the HP TCP/IP Services for OpenVMS product documentation.