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

alphabetic list of compiler options, 1 - 2

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

binary optimization, 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

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

cache, as used by optimizer, 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

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

-xbinopt

grouped by functionality, 1

syntax, 1

-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

-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

-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

-xlicinfo, 1

-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

-xmodel, 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, 3

-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

warning for trigraphs, 1

-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

#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

OMP_DYNAMIC, 1

OMP_NESTED, 1

OMP_NUM_THREADS, 1

OMP_SCHEDULE, 1

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

exec function, 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

temporary, 1

filters for lint, 1 - 2

-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

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

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

getc function, 1

getenv function, 1

gets function, 1

getutxent function, 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

sunmedia_intrin.h, 1

with lint, 1

heap, setting page size for, 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

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

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 - 3

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

K

-k, 1

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

-keeptmp, 1

keywords, 1

list for C99, 1

L

-L, 1, 2

-l, 1, 2

LANG environment variable

in C90, 1

in C99, 1, 2

layout level alias disambiguation, 1

LC_ALL environment variable

in C90, 1

in C99, 1

LC_CTYPE environment variable

in C90, 1

in C99, 1

ld (C compiler), 1

libfast.a, 1

libraries

building shared libraries, 1

default dirs searched by cc, 1

intrinsic name, 1

libfast.a, 1

lint, 1 - 2

llib-lx.ln, 1

renaming shared, 1

shared or non shared, 1

specifying dynamic or static links, 1

sun_prefetch.h, 1

library bindings, 1

licensing options, list of, 1

limit of memory allocation on stack, 1

limits.h

macros defined in, 1

link, 1, 2

linker

options received from compiler, 1

specifying dynamic or static linking in, 1

suppressing linking with, 1

linking and libraries, list of compiler options for, 1

link-time optimization, 1

link-time options, list of, 1

lint

basic mode

introduced, 1

invoking, 1

commands

-#, 1

-###, 1

-a, 1

-b, 1

-C, 1

-c, 1

-dirout, 1

-err=warn, 1

-errchk, 1

-errfmt, 1

-errhdr, 1

-erroff, 1

-errsecurity, 1

-errtags, 1

-errwarn, 1

-F, 1

-fd, 1

-flagsrc, 1

-h, 1

-I, 1

-k, 1

-L, 1

-l, 1

-m, 1

-n, 1

-Ncheck, 1

-Nlevel, 1

-o, 1

-p, 1

-R, 1

-s, 1

-u, 1

-V, 1

-v, 1

-W, 1

-x, 1

-Xalias_level, 1

-Xarch=amd64, 1

-Xarch=v9, 1

-Xc99, 1

-XCC, 1

-Xexplicitpar, 1

-Xkeeptmp, 1

-Xtemp, 1

-Xtime, 1

-Xtransition, 1

-Xustr, 1

-y, 1

consistency checks, 1

diagnostics, 1 - 2

directives, 1 - 2

enhanced mode

introduced, 1

invoking, 1

filters, 1 - 2

header files, finding, 1

how lint examines code, 1

introduction to,