C User's Guide

Symbols

-#, 1, 2

-###, 1, 2

#assert, 1, 2

#define, 1

#include, adding header files with, 1

#pragma, 1 - 2, 3 - 4

.profile filename extension, 1

// comment indicators

in C99, 1

with -xCC, 1

_ _asm keyword, 1

_ _STDC_ _ value under -Xc, 1

__'uname -s'_'uname -r', 1, 2, 3

__amd64, 1

__BUILT_IN_VA_ARG_INCR, 1, 2, 3

__DATE__, 1

__func__, 1

__global, 1

__hidden, 1

__i386, 1, 2, 3

__lint predefined token, 1

__PRAGMA_REDEFINE_EXTNAME, 1

__RESTRICT, 1, 2, 3

__sparc, 1, 2, 3

__sparcv9, 1, 2, 3

__sun, 1, 2, 3

__SUNPRO_C, 1, 2, 3

__SVR4, 1, 2, 3

__symbolic, 1

__thread, 1

__TIME__, 1

__unix, 1, 2, 3

__x86_64, 1

_Exit function, 1

_OPENMP preprocessor token, 1

_Pragma, 1

_REENTRANT-lthread, 1

_Restrict, 1

A

-A, 1

-a, 1

abort function, 1

accessible documentation, 1

acomp (C compiler), 1

alias disambiguation, 1 - 2

alignment of structures, 1

any level alias disambiguation, 1

arithmetic conversions, 1 - 2

array

declarators per C99, 1

incomplete array types per C99, 1

ascftime function, 1

_ _asm keyword, 1

assembler, 1

assembly in source, 1

assembly language templates, 1

#assert, 1, 2

B

-B, 1

-b, 1

basic level alias disambiguation, 1

basic mode of lint, 1

behavior, 1, 2 - 3

Binary Interface Descriptors (BIDS), 1

binding, 1, 2

bit-field

as impacted by transition to ISO C, 1

portability of constants assigned to, 1

promotion of, 1

treating as signed or unsigned, 1

bits, in execution character set, 1

bitwise operations on signed integers, 1

buffering, 1

C

-C, 1, 2

-c, 1, 2

C compiler

changing default dirs searched for libraries, 1

compilation modes and dependencies, 1

compiling a program, 1 - 2

components, 1

driver call to incremental linker, 1

options passed to linker, 1

C programming tools, 1

C99

// comment indicators, 1

__func__ support, 1

_Pragma, 1

array declarator, 1

flexible array members, 1

FLT_EVAL_METHOD, 1

idempotent qualifiers, 1

implicit function declaration in, 1

inline function specifier, 1

list of keywords, 1

mixed declarations and code, 1

Sun's implementation of, 1 - 2

type declaration in for loop, 1

type specifier requirement, 1

variable length arrays, 1

calloc function, 1

case statements, 1

cc compiler options, 1 - 2

-#, 1, 2

-###, 1, 2

-A, 1, 2

-B, 1, 2

-C, 1, 2

-c, 1, 2

-D, 1, 2

-d, 1, 2, 3

interaction with -G, 1

-E, 1, 2

-errfmt, 1, 2

-erroff, 1, 2

-errshort, 1, 2

-errtags, 1, 2

-errwarn, 1, 2

-fast, 1, 2, 3

-fd, 1, 2

-features, 1, 2

-flags, 1

-flteval, 1, 2, 3

interaction with FLT_EVAL_METHOD, 1

-fnonstd, 1

-fns

as part of -fast expansion, 1

grouped by functionality, 1

syntax, 1

-fprecision, 1, 2, 3

interaction with FLT_EVAL_METHOD, 1

interaction with -flteval, 1

-fround, 1, 2

-fsimple

as part of -fast expansion, 1

grouped by functionality, 1

syntax, 1

-fsingle

as part of -fast expansion, 1

grouped by functionality, 1

interaction with FLT_EVAL_METHOD, 1

syntax, 1

-fstore, 1, 2, 3

-ftrap

as part of -fast expansion, 1

grouped by functionality, 1

syntax, 1

-G, 1, 2

-g, 1, 2

-H, 1, 2

-h, 1, 2

-I, 1, 2

-i, 1, 2

-keeptmp, 1, 2

-KPIC, 1

-Kpic, 1

-L, 1, 2

-l, 1, 2

-mc, 1, 2

-mr, 1, 2

-mt, 1, 2, 3

-native, 1

-nofstore

as part of -fast expansion, 1

grouped by functionality, 1, 2

interaction with -flteval, 1

syntax, 1

-O, 1

-o, 1, 2

-P, 1, 2

-p, 1, 2

-Q, 1, 2

-qp, 1

-R, 1, 2

-S, 1, 2

-s, 1, 2

-U, 1, 2

-V, 1, 2

-v, 1, 2

-W, 1, 2

-w, 1, 2

-X, 1, 2, 3

interaction with FLT_EVAL_METHOD, 1

-xalias_level

as part of -fast expansion, 1

examples, 1 - 2

explanation, 1

grouped by functionality, 1

syntax, 1

-xarch

grouped by functionality, 1, 2

interaction with FLT_EVAL_METHOD, 1

interaction with -flteval, 1

syntax, 1

-xautopar, 1, 2, 3

-xbuiltin

as part of -fast expansion, 1

grouped by functionality, 1

syntax, 1

-xc99

grouped by functionality, 1, 2

in math conversions, 1

syntax, 1

-xcache, 1, 2

-xCC, 1, 2

-xchar, 1, 2, 3

-xchar_byte_order, 1, 2

-xcheck, 1, 2, 3

-xchip, 1, 2

-xcode, 1, 2

-xcrossfile, 1, 2

-xcsi, 1, 2

-xdebugformat, 1, 2

-xdepend

as part of -fast expansion, 1

grouped by functionality, 1, 2, 3

syntax, 1

-xdryrun, 1

-xe, 1, 2

-xexplicitpar, 1, 2, 3

-xF, 1, 2

-xhelp, 1, 2

-xhwcprof, 1, 2, 3

-xildoff, 1, 2

-xildon, 1, 2

-xinline, 1, 2

-xipo, 1, 2, 3

-xipo_archive, 1, 2

-xjobs, 1, 2, 3

-xldscope, 1, 2, 3

-xlibmieee, 1, 2

-xlibmil

as part of -fast expansion, 1

grouped by functionality, 1

syntax, 1

-xlibmopt, 1, 2

as part of -fast expansion, 1

-xlic_lib, 1, 2

-xlicinfo, 1, 2

-xlinkopt, 1, 2, 3

interaction with -G, 1

-xloopinfo, 1, 2

-xM, 1, 2

-xM1, 1, 2

-xmaxopt, 1, 2

interaction with -xO, 1

-xmemalign

as part of -fast expansion, 1

grouped by functionality, 1

syntax, 1

-xMerge, 1, 2

-xnativeconnect, 1, 2

-xnolib, 1, 2

-xnolibmil, 1, 2, 3

-xnolibmopt, 1, 2

-xO

grouped by functionality, 1

interaction with -xmaxopt, 1

syntax, 1

-xopenmp, 1, 2, 3, 4

-xP, 1, 2

-xpagesize, 1, 2, 3, 4

-xpagesize_heap, 1, 2, 3, 4

-xpagesize_stack, 1, 2, 3, 4

-xparallel, 1, 2, 3

-xpch, 1, 2, 3

-xpchstop, 1, 2, 3

-xpentium, 1, 2, 3

-xpg, 1, 2

-xprefetch

grouped by functionality, 1

syntax, 1

-xprefetch_auto_type, 1, 2

-xprefetch_level, 1, 2

-xprofile, 1, 2, 3

-xprofile_ircache, 1, 2

-xprofile_pathmap, 1, 2

-xreduction, 1, 2

-xregs, 1, 2

-xrestrict, 1, 2

-xs, 1, 2

-xsafe, 1, 2

-xsb, 1, 2, 3

-xsbfast, 1, 2

-xsfpconst, 1, 2

-xspace, 1, 2

-xstrconst, 1, 2

-xtarget

grouped by functionality, 1

syntax, 1

-xtemp, 1, 2

-xtime, 1, 2

-xtransition, 1, 2

-xtrigraphs, 1, 2

-xunroll, 1, 2

-xustr, 1, 2

-xvector, 1, 2, 3

-xvis, 1, 2

-xvpara, 1, 2, 3

-Y, 1, 2

-YA, 1, 2

-YI, 1, 2

-YP, 1, 2, 3

-YS, 1, 2

-Zll, 1, 2

cftime function, 1

cg (code generator), 1

char

signedness of, 1

storage allocation for, 1

character

bits in set, 1

decimal point, 1

mapping set, 1

multibyte, shift status, 1

set, collation sequence, 1

single-character character-constant, 1

source and execution of set, 1

space, 1

testing of sets, 1

clock function, 1, 2

code generator, 1

code optimization

by using -fast, 1

optimizer, 1

with -xO, 1

comments

preventing removal by preprocessor, 1

using // by issuing -xCC, 1

using // in C99, 1

compatibility options, 1, 2

compilation mode options, list of, 1

compiled code options, list of, 1

compiler commentary in object file, reading with er_src utility, 1

compiler options grouped by function, 1 - 2

compilers, accessing, 1

computed goto, 1

consistency checks by lint, 1

const, 1 - 2, 3

constants

promotion of integral, 1

specific to Sun ISO C, 1 - 2

conversions, 1 - 2

integers, 1

cpp (C preprocessor), 1

creat function, 1

cscope, 1 - 2

command-line use, 1 - 2, 3 - 4

editing source files, 1 - 2, 3 - 4, 5 - 6

environment setup, 1 - 2, 3

environment variables, 1

searching source files, 1 - 2, 3, 4 - 5

See also Source Browser

usage examples, 1 - 2, 3 - 4

D

-D, 1

-d, 1

data alignment, list of compiler options for, 1

data reordering, 1

data types

long long, 1

unsigned long long, 1

__DATE__, 1, 2

date and time formats, 1

dbx tool

disable Auto-Read for, 1

symbol table information for, 1

debugger data format, 1

debugging information, removing, 1

debugging, list of compiler options for, 1

decimal-point character, 1

declaration specifiers

__global, 1

__hidden, 1

__symbolic, 1

__thread, 1

declarators, 1

default

compiler behavior, 1

handling and SIGILL, 1

locale, 1

default dirs searched for libraries, 1

deferred-link messages, 1

#define, 1

diagnostics, format, 1

diagnostics, list of compiler options for, 1

-dirout, 1

documentation index, 1

documentation, accessing, 1

domain errors, math functions, 1

double, storage allocation for, 1

dwarf debugger-data format, 1

dynamic linking, 1

E

-E, 1

edit, source files, See cscope

EDITOR, 1, 2

elfdump, 1

ellipsis notation, 1, 2, 3

enhanced mode of lint, 1

environment variable

EDITOR as used by cscope, 1, 2

LANG

in C90, 1

in C99, 1, 2

LC_ALL

in C90, 1

in C99, 1

LC_CTYPE

in C90, 1

in C99, 1

LD_DEBUG, 1

LD_LIBRARY_PATH, 1

LD_LIBRARY_PATH as used by incremental linker, 1

LD_LIBRARY_PATH_64, 1

LD_OPTIONS, 1

LD_PRELOAD, 1

LD_RUN_PATH, 1

OMP_DYNAMIC, 1, 2

OMP_NESTED, 1

OMP_NUM_THREADS, 1, 2

OMP_SCHEDULE, 1, 2

PARALLEL, 1, 2

PARALLEL example, 1

STACKSIZE, 1

SUN_PROFDATA, 1, 2

SUN_PROFDATA_DIR, 1, 2

SUNPRO_MP_THR_IDLE, 1

SUNPRO_SB_INIT_FILE_NAME, 1

SUNW_MP_THR_IDLE, 1

SUNW_MP_WARN, 1

TCOVDIR, 1

TERM as used by cscope, 1

TMPDIR, 1

TZ, 1

VPATH as used by cscope, 1

er_src utility, 1

ERANGE, 1

ERANGE macro, 1

-err, 1

-errchk, 1

-errfmt, 1, 2

-errhdr, 1

errno

C98 implementation of, 1

header file, 1

impact of -fast on, 1, 2

impact of finalization functions on, 1

impact of initialization functions on, 1

impact of -xbuiltin on, 1

impact of -xlibmieee on, 1

impact of -xlibmil on, 1

impact of -xlibmopt on, 1

preserving value of, 1

setting value to ERANGE on underflow, 1, 2, 3

-erroff, 1, 2

error messages, 1

adding prefix "error:" to, 1

controlling length for a type mismatch, 1

suppressing in lint, 1

-errsecurity, 1

-errshort, 1

-errtags, 1, 2

-errwarn, 1, 2

example messages

full relink, 1

ild version, 1

new working directory, 1

out of room, 1

running strip, 1

too many files changed, 1

exec function, 1

executable, modifying, 1

expressions, grouping and evaluation in, 1 - 2

F

-F, 1

-fast, 1

fbe (assembler), 1

fclose function, 1

-fd, 1, 2

-features, 1

fegetexceptflag function, 1

See function, C-12

fgetc function, 1

fgetpos function, 1

filename, .profile extension for, 1

files

padding by incremental linker, 1

temporary, 1

used by ild, 1

filters for lint, 1 - 2

final production code and incremental linker, 1

Fix and Continue

and ild, 1

linking, 1

-flags, 1

-flagsrc, 1

float expressions as single precision, 1

float, storage allocation for, 1

float.h

in C90, 1

macros defined in, 1

floating point, 1

gradual underflows, 1

list of compiler options for, 1

nonstop, 1

representations, 1

truncation, 1

values, 1

FLT_EVAL_METHOD

evaluation format in C99, 1

impact on accuracy of library functions, 1

impact on float_t and double_t, 1

non-standard negative values of, 1

-flteval, 1

fmod function, 1

-fns, 1

fopen function, 1

for loop that contains a type declaration, 1

-fprecision, 1

fprintf function, 1, 2

free function, 1

-fround, 1

fscanf function, 1, 2

fsetpos function, 1

-fsimple, 1

-fsingle, 1

-fstore, 1

ftell function, 1

-ftrap, 1

full relink, reasons for, 1

function

_Exit, 1

abort, 1

ascftime, 1

calloc, 1

cftime, 1

clock, 1, 2

creat, 1

declaration specifier, 1

exec, 1

fclose, 1

fegetexceptflag, 1

See , C-12

fgetc, 1

fgetpos, 1

fmod, 1, 2

fopen, 1

fprintf, 1, 2

free, 1

fscanf, 1, 2

fsetpos, 1

ftell, 1

fwprintf, 1

fwscanf, 1

getc, 1

getenv, 1

gets, 1

getutxent, 1

ilogb, 1

ilogbf, 1

ilogbl, 1

implicit declaration of, 1

isalnum, 1

isalpha, 1, 2

isatty, 1

iscntrl, 1

islower, 1

isprint, 1

isupper, 1

iswalpha, 1

iswctype, 1

main, 1

malloc, 1

omp_get_num_threads, 1

omp_set_dynamic, 1

printf, 1

prototypes, 1, 2 - 3

prototypes, lint checks for, 1

realloc, 1

remove, 1, 2

rename, 1, 2

reordering, 1

scanf, 1

setlocale, 1

signal, 1

sizeof, 1

stat, 1

strerror, 1

strftime, 1

strlcpy, 1

strtod, 1

strtof, 1

strtold, 1

sunw_mp_register, 1

system, 1, 2

towctrans, 1

using varying argument lists, 1 - 2

wait, 1

wait3, 1

waitid, 1

waitpid, 1

wcsftime, 1

wcstod, 1

wcstof, 1

wcstold, 1

fwprintf function, 1

fwscanf function, 1

G

-G, 1

-g, 1

example 1, 1

example 2, 1

getc function, 1

getenv function, 1

gets function, 1

getutxent function, 1

global symbols and the incremental linker, 1

gradual underflows, 1

H

-H, 1

-h, 1, 2

hardware architecture, 1

header files

float.h in C90, 1

format for #include directives, 1

how to include, 1 - 2

list of standard headers, 1

standard place, 1 - 2

with lint, 1

heap, setting page size for, 1

how to use the incremental linker, 1

I

-I, 1, 2

-i, 1

i386 predefined token, 1, 2, 3

idempotent qualifier in C99, 1

ilogb function, 1

ilogbf function, 1

ilogbl function, 1

implementation-defined behavior, 1 - 2

incomplete types, 1 - 2

incremental linker (ILD)

as compared to linker, 1

as part of C compilation system, 1

as used by compiler driver, 1

bypassing with -G, 1

commands

-a, 1

-B, 1

-d, 1

-e, 1

-g, 1

-I, 1

-i, 1

-L, 1

-l, 1

-m, 1

-o, 1

-Q, 1

-R, 1

-s, 1

-t, 1

-u, 1

-V, 1

-xildoff, 1

-xildon, 1

-YP, 1

-z, 1

-z defs, 1

-z i_dryrun, 1

-z i_full, 1

-z i_noincr, 1

-z i_quiet, 1

-z i_verbose, 1

-z nodefs, 1

commands accepted from compiler

-a, 1

-e, 1

-I, 1

-m, 1

-t, 1

-u, 1

environment variables

LD_DEBUG, 1

LD_LIBRARY_PATH, 1

LD_LIBRARY_PATH_64, 1

LD_OPTIONS, 1

LD_PRELOAD, 1

LD_RUN_PATH, 1

examples, 1 - 2

figure explaining, 1

global symbols, 1

how it works, 1

how to use, 1

impact of changing object files, 1

impact on final production code, 1

introduction, 1

invalidating object files, 1

invoking with -g, 1

limitations, 1

linker commands passed to, 1

overview, 1

relink messages, 1

relocation records, 1

saved files, 1

See linker

symbol references, 1

timestamps, 1

turning off with -xildoff, 1

turning on with -xildon, 1

unsupported commands

-D, 1

-F, 1

-M, 1

-r, 1

unsupported commands from linker

-B, 1

-b, 1

-G, 1

-h, 1

-z muldefs, 1

-z text, 1

inline expansion templates, 1, 2

inline function specifier for C99, 1

inlining, 1

int, storage allocation for, 1

integers, 1 - 2

integral constants, promotion of, 1

interactive device, 1

internationalization, 1 - 2, 3 - 4

interprocedural analysis pass, 1

invoking the incremental linker, 1

ipo (C compiler), 1

ir2hf (C compiler), 1

iropt (code optimizer), 1

isalnum function, 1

isalpha function, 1, 2

isatty function, 1

iscntrl function, 1

islower function, 1

ISO C vs. K&R C, 1, 2

ISO/IEC 9899:1999 Programming Language C, 1, 2

ISO/IEC 9899-1990 standard, 1

isprint function, 1

isupper function, 1

iswalpha function, 1

iswctype function, 1

J

ja_JP.PCK locale, 1

Java Native Interface, 1

JNI, 1