Index
Symbols
# comment delimiter, assembler 300
# comments in configuration file 589
!= binary not equal to, assembler operator 315
!H 153
!L 153
$ assembler hexadecimal constant prefix 304
% binary modulo assembler operator 314
%, assembler binary constant prefix 304
%f format specifier 510
%hi unary operator 313
%hiadj unary operator 313
%lo unary operator 313
%p conversion, implementation-defined
behavior 608
%S field, with -Xsubtitle 296
%sdaoff unary operator 313
%T field with -Xtitle 296
%X conversion, implementation-defined
behavior 608
%x conversion, implementation-defined
behavior 608
& binary bitwise and, assembler operator 314
&& concatenating macro parameter 352
* assembler comment delimiter 300
* binary multiply assembler operator 314
+ binary add assembler operator 314
+ unary assembler add 313
- binary subtract assembler operator 314
- unary assembler negate 313
/ binary divide assembler operator 314
:= expression assembler directive 318
; comment delimiter 300
; statement separator 295
< binary less than assembler operator 315
<< binary shift left assembler operator 314
<= binary less than or equal to assembler
operator 315
=: defines global symbol 301
=: expression assembler directive 318
== binary equal to, assembler operator 314
>
> binary greater than assembler operator 315
>= binary greater than or equal to assembler
operator 315
>> binary shift left assembler operator 314
-? compiler options 39
@, assembler octal constant prefix 304
-@ name assembler option, options from file or
variable 288
-@ name common option, options from file or
variable 434
-@ name compiler option, options from file or
variable 53
-@ name linker option, options from file or
variable 380, 386
-@@ name common option, options from file or
variable 581
-@@ name assembler option, options from file or
variable 288
-@@ name common option, options from file or
variable 434
-@@ name compiler option, options from file or
variable 53
-@E common option, redirecting output 434
-@E compiler option, redirects output 54
-@E linker option, redirects output 386
-@O assembler option, redirecting output 288
-@O common option, redirecting output 434
-@O compiler option, redirects output 54
-@O linker option, redirects output 387
-# option 288
display linker command lines 379
print command lines as executed 53
-## compiler option, prints command lines 53
-### compiler option, prints subprograms 53
@function symbol type 345
@h unary operator 313
@ha high adjust operator 313
@ha unary operator 313
@l unary operator 313
@object symbol type 345
@sdarx unary operator 313
@sdax unary operator 313
\@ special macro parameter 352
\0 special macro parameter 351
^ binary exclusive or, assembler operator 314
| bitwise or 314
~ unary assembler complement 313
`\' backslash escape sequence 305
`\b' backspace escape sequence 305
' single quote escape sequence 305
'\f' form feed escape sequence 305
'\n' line feed (newline) escape sequence 305
'\r' return escape sequence 305
'\t' horizontal tab escape sequence 305
'\v' vertical tab escape sequence 305
\xda , assembler hexadecimal constant prefix 304
Numerics
0, assembler octal constant prefix 304
0x, assembler hexidecimal constant prefix 304
.2byte assembler directive 318
.4byte assembler directive 318
A
-A compiler option
define assertion 40, 123
-A- compiler option
ignore macros and assertions 40
.a file extension, archive library 23
-a linker option, forcing -r to allocate common
variables 380
-a option
ddump 446
a64lconversion function 496
abort function
definiton 496
implementation-defined behavior
calling, assert function 607
flushing and closing files 608
abs absolute value function 496
.abs.nnnnnnnn section. See under sections
absolute
assembler expressions 311
expressions 311
sections. See under sections
variables
accessing at specific addresses 273
accesssing with symbolic debugger 246
access function determining file accessiblility 496
access I\xda O function
RAM-disk support, checking file
accessibility 271
access modes
COMDAT section, with O access mode 243
defining section accessibility 242
R, default for use 238
RW, default for use 238
RX, default for use 238
access modes
default values for predefined section
classes 238
in pragma section & pragma use_section 236
read, write, execute 242
accessing variables and functions at specific
addresses 273
acc-mode. See access modes
acos function 497
acosf function 497
ADDR pseudo function 403
addressing modes
definitions, table of 239
code generated by compiler for each 247
far-absolute 239, 240, 248
default for use 238
far-code 240, 248
far-data 240, 248
example 241
mode used when referencing a variable 239
near-absolute 248
near-code 240, 248
default for use 238
example 241
near-data 240, 248
default for use 238
operands 612
r2-relative 252
standard 248
default for use 238
definition 239
for CODE section class 240
for data sections, equivalent to far-
absolute 240
table of command line options that affect the
default 241
addr-mode. See addressing modes
advance function, definition 497
AIX
argument passing 178
stack frame 175, 176
aliasing
pointer arguments 63
variables, #pragma no_alias 130
.align assembler directive, definition 318
ALIGN keyword 410
align pragma 126
aligned (__attribute__ keyword) 139
alignment
array 164
classes 165
data, -Xstruct-best-align 109
minimum for target memory access, -
Xalign-min 62
packed structures 133
output sections 392
#pragma align 126
#pragma pack 132
strings, -Xstring-align 108
structures 165
-Xmember-max-align 142
-Xstruct-max-align 94
unions 165
.alignn assembler directive 319
alloca function
dynamic stack space allocation 144
__alloca intrinsic function 146
alloca intrinsic function 146
allocate
storage 309
AltiVec
intrinsic functions 147
libraries 16
vector code generation 113
ANSI
C
mode invoked with -Xdialect-ansi 76
C standard
additions to 119
conformance to
implementation-defined behavior 603
library functions disregarded with -Xclib-
optim-off 69
recommended reference 8
C++ standard
additions to 119
differences from ANSI C 224
recommended reference 8
compiler limits 601
references 494
standards. See ANSI C mode and ANSI C standard
a.out
default linked output object file 383
naming by default, single executable file 115
archiver, dar 13
argc argument
environment 606
argc defining for target program with setup 275
argument address optimization
explanation 194
interprocedural optimizations 199
argument passing 176
AIX 178
C++ 178
class, struct, union 179
EABI 176
floating point 83
in AIX argument passing 178
use with -Xcrb6 73, 178
hidden
pass in register r3 180
hidden, call a function with a return type of
class, struct, or union 180
in the homing area, numbering of register 178
non-register, in EABI argument passing 176
pointers to members 179
registers, save in homing area 176
variable, number of 178
argv
argument 606
defining for target program with setup 275
using in init.c 262
arrays
alignment 164
implementation defined behavior 605
incomplete initialization
parsing controlled, -Xbottom-up-init 66
treatment in different modes 597
index with pointers 200
initialization of automatic arrays in different
modes 596
large initialized and compiler limits 602
size of 164
.ascii assembler directive 320
.asciz assembler directive 320
.asciz directive 320
asctime function
calling .tzset function 569
definition 497
asin function 498
asinf function 498
asm
macro 152
See also assembler macros
string statement
disabling optimizations 158
strings 149
asm keyword
See assembler macros
__asm__ keyword 139
asm keyword 139
allowing in different modes 596
C++ 224
assembler
directives
direct assignment 311
operand field format 300
symbol types 345
embedding within compiled programs 272
macros 149
mixing C and assembler functions 272
options 284
relocation types, table of 248
assembler decimal constants 304
assembler directives
.2byte 318
assembler macros
asm 150, 151, 152
register list line 154
storage mode for parameters
con 153
storage mode line 152
assembler operator precedence, table of 315
assembler operators
unary, table of 312
assembler supported constants 304
assembly
code
generaing for each addr-mode 247
show inner loop produced by
compiler 200
file
keep 88
preprocess 99
temporary 88
output 40, 117
including source, -Xpass source 98
.section directive 237
assert
function
definition 498
implementation-defined behavior 607
macro, <assert.h>, standard header files 488
preprocessor directive 123
assertions
See also assert, -A compiler option
dumping symbol information 72
assignment
command 416
command in section-definition 408
pop optimization 195
statements, with -WD complier option 48
assignment statements
configuration files 581
configuration language, definition 591
atan function 499
atan2 function 499
atan2f function 500
atanf function 499
atexit function
definition 500
exit function 508
atof function 500
atoi function 500
atol function 501
__attribute__ keyword 139
auto storage class 605
automatic variables 127
B
-B option
ddump 446
b, assembler binary constant suffix 304
backslash escape sequence, `\' 305
backspace escape sequence, '\b' 305
backward compatibility 218
.balign assembler directive 320
basic data types, table of 162
-Bd, -Bt options 381
Big-Endian byte ordering 633
binary operators, table of 314
bit-fields
char type 164
definiton 164
enum type 164
implementation-defined behavior 605
int plain, sign of 221
int type 164
long long
not permitted in long long variables 142
type not allowed 164
long type 164
making signed with signed keyword 164
plain treating as
signed with -Xbit-fields-signed 65
unsigned with -Xbit-fields-unsigned 65
reducing size with -Xbit-fields-compress-... 65
short type 164
blanks in macro arguments, -Xmacro-arg-space-
off 293
.blkb assembler directive 320
bool
__bool preprocessor predefined macro 121
type. See type, bool
branch
complex optimization 196
PC-relative
using -Xcode-relative-near and -Xcode
relative-far options 252
using -Xcode-relative-near-all and -Xall-
far-code relative options 252
predicting in feedback optimization 203
with tail recursion 192
branch islands
explanation 372
-Xbranch-islands-off disabling 387
-Xmax-long-branch limiting 16-bit
branches 391
-Xmax-long-branch limiting 26-bit
branches 391
-Xpic-only making position-independent 392
break statement, configuration language 594
bsearch function 501
.bsect assembler directive 321
.bss assembler directive 321
.bss section. See under sections
BSS section type 409
__BSS_START, __BSS_END symbols
initializing static variables to zero 262
using in clearing static uninitialized
variables 400
BUFSIZ constant
defining required size of buf 553
defining, stdio.h function 492
with setvbuf 554
building, rebuilding, the libraries 485
.byte assembler directive 321
byte ordering 163
byte-swapping using #pragma pack 132
C
C
driver program, dcc 13
standard, recommended reference 8
to C++ migration 224
.C file extension, C++ source 23
-C option 40
ddump 447
-c option
during separate compilation 116
stopping after assembly, producing object 40
-Xkeep-object-file 88
C++
argument passing 178
classes 165
code, #pragma inline vs. keyword,
linkage 193
driver program, dplus 13
features and compatibility 223
library 50
standard
conformance to 6
recommended reference 8
-c, compiler option
stopping after assembly 23
calling conventions 173
EABI
specified by -Xsoft-float 106
specify by -Xconventions-eabi 72
calloc function
definition 501
free function 515
implementation-defined behavior 608
realloc function 549
case
label, implementation-defined behavior 606
statement, configuration language 594
catch C++ keyword 79, 191
catch keyword
disabling exceptions 79
flagging as error 227
if user-defined identifier, may necessitate
modification of program 224
.cc file extension, C++ source 23
ceil function 501, 502
ceilf function 502
char type
See basic data types, table of
bit-fields 164
signed 163
unsigned 163
character
constants
escape sequences, table of 306
constructing internal representation 604
entering integral constants 304
escape sequences for 304
replacing macro arguments in 598
swap, -Xswap-cr-nl 110
I/O function 269
implementation-defined behavior 604
Newline 306
signed, -Xchar-signed 68
unsigned, -Xchar-unsigned 68
character constants, assembler 304
chario.c file 269
_chgsign function 502
class
auto storage 605
definition, type_info 227
instantiation, -Ximplicit-templates-off 84
library
C++ iostream.a 476
libcomplex.a
C++ complex math class library 16
directory location 479
supplied with DIAB tools 475
libcomplexold.a
supplied with DIAB tools 475
member
function 228
name qualifiers 170
name mangling 228
register storage 605
templates 225
virtual function table generation, key
functions 169
with destructors 79
class C++ keyword 224
classes
alignment 165
argument passing 179
C++ 165
derived
adding virtual base pointers 168
using the virtual function table
pointer 167
EABI argument passing 176
internal data representation 165
local 171
meanings
if inside a function but outside any
class 170
if outside any function and any class 170
if outside any function but inside a C++
class definition 170
if within a local C++ class and inside a
function 171
return type 180
storage
as permitted by scope 171
different classes allowed 169
virtual base
C++ 166
virtual base, with constructors and
destructors 179
clearerr function 502
clock function
definition 502
implementation-defined behavior 609
use in clock.c 271
CLOCKS_PER_SEC constant
clock function 503
defining, time.h function 492
close function
definition 503
RAM-disk support, closing a file 271
code
generating options, controlling 257
generating with -Xfintrz-off 82
location, #pragma section 137
relative addressing
far-code addr-mode 240
near-code addr-mode 240
using to achieve PIC 240
CODE section class. See under section classes
COFF
file
components, table of 630
header fields, table of 632
optional (executable) header fields, table
of 633
section header fields, table of 634
structure 630, 632
symbol table fields, table of 642
format 388
input files 393
line number
entry layouts, table of 639
entry structure 640
fields, table of 640
object files
converting to
IEEE 695, ddump command -I 448
object module format 279
AIX conventions 28
alignment information not supported 340
crt0.o startup module and libraries, parallel
to ELF 17, 479
padding 308
section alignment and size 308
selecting, -Xobject-format 294
optional header from file aouthdr.h 633
output 394
relocation
entry fields, table of 637
entry structure 637
information 637
types, table of 638
section header
specifying, f_nscns field 634
structure 634
string table 643
symbol table entry structure 641
symbols, additional supported 643
COMDAT sections. See under sections
.coment section. See under sections
.comm assembler directive
declaring COMMON sections with 369
definition 321
external symbols 301
indicating use of with string COMM 237
vs. .lcomm 333
COMM section. See under sections
command line length limit 38
command line options
quoting strings 37
that affect the default addr-mode, table of 241
command line options, writing 36
command line order 379
commands
dar 435
das 284
dbcnt 441
ddump 445
comment delimiters in D-AS 300
COMMENT section. See under sections
.comment section. See under sections
comments
configuration language, token 589
linker command file 404
common
symbols 302
tail optimization 196
COMMON section. See under sections
COMMON sections. See under sections 369
communicating with the target hardware 272
compatibility
C++ 218
compatibility modes
ANSI 595
for C programs, table of for ANSI, Strict ANSI,
K&R, and PCC 596
K&R 595
PCC 595
Strict ANSI 595
table of features 595
compilation
conditional 123
disabling exception handling 79
four stages 115
if speed is crucial 185
older programs, -Xmemory-is-volatile 95
problems 217
separate 116
speed vs. optimization, trade-off 184
stopping, -Xstop-on-warning 108
without optimization corrects execution,
possible causes 219
-Xlint, warnings for suspicious constructs 211
compile function, definition 503
compile regular expression 503
compiler
backward compatibility 218
C++-to-assembly 23
code written for older UNIX 218
compatibility with
older compilers using setjmp /
longjmp 190
others 6
creating temporary objects not visible 231
C-to-assembly 23
emulating UNIX behavior 596
environment variables recognized, table of 18
flag keywords: try, catch and throw as
errors 227
installation 11
invoking 35
limits 601
options 39
-X options 54
producing optimized code 186
register use, table of 181
time
options 257
pragmas 257
components of installation 11
compressible ELF object modules 28
concatenate underscore, -Xadd-underscore 61
conf directory, contains linker command files 268
configuration files
assignment statements 581
default.conf
changing\xda overriding variables stored
in 31
definition 585
exit statement 592
standard version shipped with tools 583
using 14
default.conf, editing 32
dtools.conf
configuration variables 587
description 14
exit statement 592
simplified structure, table of 585
standard version shipped with tools 583
hierarchy of three 583
nesting 593
processing at startup 581
reading at startup 14
relation to command lines and environment
variables 580
site-dependent defaults 580
standard
name, location 583
shipped with tools 586
user.conf
dtools.conf configuration file, simplified
structure 585
providing own 584
variable evaluation, table of 591
configuration language
comments, token 589
how to write 584
options 588
purpose and effect 588
statements 588
break 594
case 594
else
if statement 592
syntax 588
endsw 594
error definiton 592
exit 592
if
defintion 592
syntax 588
with __ERROR__ function 145
include 584
with dtools 584
print 593
switch 593
string constants 589
variables
$$, expands to $ 590
$*, dtools.conf, simplified structure 585
$*, evalutating entire command 591
$, evaluatating value of a variable 590
$, introducing variables 589
DCONFIG
setting, -WC option 581
definiton\xda explanation 590
DENVIRON
avoiding altering dtools -t option 584
default library search path controlled
by 584
dtools.conf 584
editing default.conf to change 32
overriding with environment variable
of same name 18
setting, -t option 581
-t sets 31
DFLAGS
definition 586
DFP
and __VEC__ macro, setting for
AltiVec targets 122
avoiding altering dtools -t option 584
dtools.conf, simplified structure 585
editing default.conf to change 32
evaluating in configuration files 591
overriding with environment variable
of same name 18, 19
setting, -t option 581
-t sets 31
DOBJECT
avoiding altering dtools, -t
option 584
dtools.conf, simplified structure 585
editing default.conf to change
settings 32
overriding with environment variable
of same name 18
setting, -t option 581
-t sets 31
DOBJECT, with -Xconventions-eabi 72
DTARGET
avoiding altering dtools, -t
option 584
editing default.conf to change 32
overriding with environment variable
of same name 18
setting, -t option 581
-t sets 31
simplified structure 585
UAFLAGS1
definition 587
dtools.conf, simplified structure 586
UAFLAGS2
definition 587
dtools.conf, simplified structure 586
UFLAGS1
definition 586
dtools.conf, simplified structure 585,
586
overriding options set by 587
UFLAGS2
definition 586
dtools.conf, simplified structure 585,
586
occuring after $*, in dtools.conf 587
ULFLAGS1
definiton 587
dtools.conf, simplified structure 586
ULFLAGS2
definition 587
dtools.conf, simplified structure 586
configuration language, assignment statements,
definition 591
configuration, target. See target configuration
CONST
section class
-Xconst-in-text mask bits 249
const
data, -Xstrings-in-text in embedded
development 257
global, default linkage in C and C++ 225
keyword
and compatibility mode 596
help optimizer 188
variable
moving from "text" to "data" 248
with -Xdata-relative-far 74
with -Xdata-relative-near 74
CONST section class. See under section classes
constants
$, assembler hexadecimal prefix 304
%, assembler binary prefix 304
@, assembler octal prefix 304
\xda , assembler hexadecimal prefix 304
0, assembler octal prefix 304
0x, assembler hexidecimal prefix 304
and variable propagation optimization 196
assembler character 304
assembler decimal 304
b, assembler binary suffix 304
BUFSIZ
defining required size of buf 553
defining, stdio.h function 492
setvbuf 554
character
escape sequences 304
CLOCKS_PER_SEC
clock function 503
CLOCKS_PER_SEC, defining, time.h
function 492
DOMAIN 537
EDOM
errno setting, acos function 497
errno setting, asin function 498
errno setting, atan2 function 499
errno setting, matherr function 537
ENTER 522
EOF
defining, studio.h function 492
fscanf function 517
scanf function 550
sscanf function 557
ungetc function 570
ERANGE
setting, exp function 508
setting, matherr function 537
EXIT_FAILURE
defining, stdlib.h function 492
providing, exit function 508
EXIT_SUCCESS
defining, stdlib.h function 492
providing, exit function, successful
termination 508
FIND
hsearch function 522
floating point
assembler support 304
format 305
HUGE_VAL 491, 508
defining, <math.h> header file 488
HUGE_VAL_F 491
integer 304
integral 304
format and description, table of 304
_IOFBF 554
_IOLBF 554
_IONBF 554
LC_ALL 553
LC_COLLATE
setlocale function 553
strcoll function 558
LC_MONETARY 553
LC_NUMERIC 553
LC_TIME 553
locating vs. .data sections 248
locating with -Xonst-in-text, -Xconst-in-
data 72
MB_CUR_MAX 538
NULL
defining, stddef.h function 492
defining, stdio.h function 492
defining, stdlib.h function 492
defining, string.h function 492
o, assembler octal suffix 304
O_APPEND
defining, fcntl.h function 490
O_NDELAY
defining, fcntl.h function 490
O_RDONLY
defining, fcntl.h function 490
setting values, open function 542
O_RDWR
defining, fcntl.h function 490
values of, open function 542
OVERFLOW 537
O_WRONLY
defining , fcntl.h function 490
values, open function 542
PLOSS 537
q, assembler octal suffix 304
RAND_MAX 548
SEEK_CUR 534
SEEK_END 534
SEEK_SET 534
short initialized data in .sdata2 308
SING 537
static data 61
supported by assembler 304
TLOSS 537
UNDERFLOW 537
constructors
global C++ 86
mangling 229
missing calls to 231
operator 225
with avoiding setjmp, longjmp functions 231
control code generation options 257
control register 201
copying initial values from "rom" to "ram" 261
_copysign function 503
cos function 504
cosf function 504
cosh function 504
coshf function 504
__cplusplus preprocessor predefined macro
definition 121
using with #ifdef directives 224
.cpp file extension, C++ source 23
cpp preprocessor
defaults 23
with -W compiler option 50
creat function
<fcntl.h>, standard header file 488
definition 505
fdopen function 510
RAM-disk support, opening file 271
cross reference table in link map 383
cross/libc.a library
ELF standard C libraries 15
location 479
crt0.o startup module 181
default overridden, -W sfile compiler
option 379
source of standard version crt0.s 15
specify non-standard, -W s 49
start up code 15
crt0.s startup module
details 260
overview 258
ctime function 505
ctoa preprocessor 23
ctoa subprogram 13
ctype functions
isalnum 607
isalpha 607
iscntr 607
isdigit 607
isgraph 607
islower 607
isprint 607
ispunct 607
isspace 607
isupper 607
isxdigit 607
table of 607
test for characters 607
.cxx file extension, C++ source 23
D
-D option 285
ddump 447
+d option
ddump 452
-d option
ddump 447, 451
.d1line assembler directive, using to suppress, -
Xdebug-mode 75
dar
archiver 13
building archive libraries 376
commands
- p print 436
-d delete 436
examples 439
-m move 436
modifiers, table of 437
-q quick append 437
-qf quick update 437
-r replace 436, 437
-s symbol table update 437
syntax 435
-t table of contents 437
table of command 436
-V version 437
-x extract 437
das
assembler, locating executable 13
command 284
das preprocessor 23
data
basic types 162
char, size and alignment 162
constant
short initialized in .sdata2 308
static 61
-Xstrings-in-text in embedded
development 257
double, size and alignment 163
enum, same as int 162
float, size and alignment 162
global
pure_function pragma 136
-Xaddr-const 61
-Xaddr-data 61
-Xaddr-sconst 61
-Xaddr-sdata 61
initialized
containing in particular section, with
istring 237
in .data section 307
int
size, alignment, and range 162
with -Xstruct-best-align 109
internal representation 161
locating
in constant vs. .data sections 248
initialized vs. uninitialized 244
long double, size and alignment 163
long long, size and alignment 162
long, size and alignment 162
non-constant static 61
pointers, size and alignment 162
ptr-to-member-fn, size and alignment 163
reference, size and alignment 163
relative addressing
far-data addr-mode 240
modes, using to achieve PID 240
near-data addr-mode 240
relocation 251
short
initialized in .sdata section 308
uninitialized in .sbss section 307
short, size and alignment 162
signed char, size and alignment 162
static 136
storing in big-endian order 163
type size 164
types, table of C/C++ 162
uninitialized
.bss section 307, 321
containing in particular section, with
ustring 237
unsigned
char, size and alignment 162
int, size and alignment 162
long long, size and alignment 162
long, size and alignment 162
short, size and alignment 162
volatile 257
data
ptr-to-member, type, size and alignment 163
.data assembler directive 323
.data section
r13 register as a pointer to 252
restrictions on using -Xcode-relative-near-
all 252
DATA section class. See under section classes
.data section. See under sections
__DATA_END, __DATA_RAM, __DATA_ROM
symbols, copy initial values from "rom" to
"ram" 261
__DATA_END, __DATA_RAM, __DATA_ROM
symbols, copy initial values from "rom" to
"ram", in bubble.dld 400
__DATE__ preprocessor predefined macro
precompiled headers 233
__DATE__ preprocessor predefined macro 121
dbcnt
command syntax 441
dbcnt.out file
default 443
environment variable. See under environment
variables
examples 443
generating profiling information 13
options
-f profile file 442
read from 442
-h high line limit 442
-l low line limit 442
-n number every line 442
-t most frequent lines 442
table of commands 442
-V version 442
required functions
__dbexit 444
__dbini 444
dbcnt.out
using if DBCNT is not set 442
with -Xfeedback compiler option 80
__dbexit function, required for dbcnt 444
__dbini function, required for dbcnt 444
dc.b assembler directive 322
__DCC__ preprocessor predefined macro 121
DCC reference 494
dcc. See driver program, dcc
dc.l assembler directive 322
DCONFIG environment variable. See under
environment variables
__DCPLUSPLUS__ preprocessor predefined
macro 121
dctrl program
displaying -t options 47
locating executable 13
setting default target 26
alternatives 32
setting default target configuration
variables 18
dc.w assembler directive 323
DCXXOLD 219
ddump
commands
+t symbol table, dump with upper
limit 451
+z line number information, dump with
upper limit 451
-a archive header, dump 446
-B binary format, converting to 446
-C difference file, generate 447
-c string table, dump 447
commands, table of 446
converting -I COFF to IEEE 695 448
-D DWARF debugging information,
dump 447
examples 453
-F demangle names 447
-f file header, dump 447
-g global symbols, dump 447
-H hex and ASCII, dump 447
-h section headers, dump 447
-l line number information, dump 448
-M dmunch 448
-m write Motorola S-records of a given
type 450
modifiers, table of 451
multiple output files, create 446
-N symbol table, dump 449
-o optional header, dump 449
-p write a plain ASCII file in
hexadecimal 450
-R converting to Motorola S-Records 450
-r relocation information, dump 450
-s section contents, dump 451
-S size of sections, display 451
syntax 445
-t symbol table, dump 451
-T symbol table, remove 451
-u write a binary file 450
-v do not output the .bss or .sbss
section 450
-V version 451
-w set the line width of S-records 450
-z line number information, dump 451
converter utility 278, 279
object file converter and dumper 13
ddump -F
demangling utility 230
debugging
-D option 447
DWARF 43, 75, 285, 289, 384, 447, 623
-g option 42, 285
generating debug information for unreferenced
types 75
selecting levels, DFLAGS 587
declarations
force, -Xforce 82
in header files 224
declarators, implementation-defined behavior 605
declared symbol, definition of 300
default
acc-mode, values for section classes 238
addr-mode
options that change 240
values for section classes 238
istring / ustring values for section classes 238
tab size, -Xtab-size 296
default.conf
default configuration information stored by
dctrl program 18
DENVIRON configuration variable set in 584
default.conf configuration file
changing\xda overriding variables stored in 31
definition 585
exit statement 592
standard version shipped with tools 583
using 14
default.dld linker command file
_SDA_BASE_, _SDA2_BASE_ defined in 182
default.dld linker command file 268
component in conf subdirectory 14
default overridden, -W m compiler option 378
example use of 378
__HEAP_START, __HEAP_END defined in
default.dld 264
overriding -Bd and -Bt options 381
present in conf directory 398
serving as model 398
__SP_END must define in for stack
checking 263
-W m option 49
default.lnk. See default.dld
#define preprocessor directive 41
defined
symbol, definition of 300
variables, types, and constants 490-492
delete
array operators 227
C++ keyword 224
operator 180
demangling utility, ddump -F 230
DENVIRON environment variable. See under
environment variables
derived class
adding virtual base pointers 168
using the virtual function table pointer 167
destructors
__DTORS using during initialization 225
increasing efficiency with -Xexceptions-off 79
mangling 229
missing calls to 231
operator 225
DFLAGS environment variable. See under
environment variables
DFP environment variable. See under configuration
language: variables
__diab_lib_error function
calling with __rtc_error function 267
defining in src/lib_err.c 267
handling errors from library function 266
_DIAB_TOOL preprocessor predefined macro 121
DIALIB environment variable. See under
environment variables
difftime function 505
direct
assignment statements
definition and syntax 301
function for embedding machine code 160
directives
See preprocessor directives
#ident in .comment 622
#pragma, use with asm macro 152
.section 394
directories
conf, contains linker command files 268
src, source files 269
structure 11
disabling optimization, -g, (-Xoptimized-debug-
off) 97
disassembler, windiss 457
div
part of stdlib.h header file 492
div function
definition 505
div_t type 492, 506
.dld file extension, linker 23
dld linker, locating executable 13
dld preprocessor 23
dmake
"make" utility 13, 455
executable, installation 455
requires startup directory 456
using 456
DMALLOC_CHECK environment variable. See
under environment variables
DMALLOC_INIT environment variable. See under
environment variables
DOBJECT configuration variable
with -Xconventions-eabi 72
DOBJECT environment variable
setting object format, -Xobject-format 294
DOBJECT environment variable. See under
environment variables
DOMAIN constant 537
.double float-constant, . . . assembler directive
definition 323
dplus
See driver program, dplus
template instantiation 225
drand48 function
definiton 506
lcong48 function 530
srand48 function 556
driver program
dcc for C, locating executable 13
dplus for C++, locating executable 13
invoking 36
main program flow 21
renaming to access different version 17
table of subprograms and stopping options 23
verbose mode, -v 48
-W control meaning of source file extension 52
ds.b assembler directive 323
.dsect assembler directive 323
DTARGET environment variable. See under
environment variables
dtoa preprocessor 651
dtoa subprogram 13
dtools.conf configuration file
$DENVIRON.conf 584
configuration variables 587
description 14
exit statement 592
simplified structure, table of 585
standard version shipped with tools 583
dumper ddump 13
dup function
definition 506
fdopen function 510
DWARF, debug information 43, 75, 285, 289, 384,
447, 623
dynamic
casts 227
stack space allocation, alloca 144
dynamic_cast expression 227
E
-E compiler option
vs. -P compiler option 47
-E complier option
write source to standard output 41
-e linker option
default entry point address 381
-e option 41
EABI
argument passing 176
calling conventions 72
specified by -Xsoft-float 106
specify by -Xconventions-eabi 72
pointer to Small Data Area, r13 182
stack frame 174, 176
using -Xcrb6-always, -float, and -never 73
__EABI__ preprocessor predefined macro 121
ecvt function 506
_edata symbol created by linker 367
EDOM constant
errno setting, acos function 497
errno setting, asin function 498
errno setting, atan2 function 499
errno setting, matherr function 537
.eject assembler directive 324
ELF
files
header fields, table of 617
headers, table of 616
input 393
relocation entry fields, table of 624
section header fields, table of 620
structure, typical 616
symbol fields, table of 627
format 389
header structure 617
object files
convert ing to Motorola S-Records, ddump
command -R 450
object module format 28, 279
absolute sections 309
compressible 28
libraries 15
.org assembler directive, using with 335
section alignment 308
selecting, -Xobject-format 294
output 394
overall structure 616
program header
fields, table of 619
structure 618
relocation
entry structure 623
selecting information format 389
types, table of 624
section header structure 620
symbol table section structure 627
typical sections, table of 622
#elif preprocessor directive 123
.else assembler directive 324, 329
else statement, configuration language
if statement 592
syntax 588
.elsec assembler directive 324
definition 324
equivalent to .else, .endif, .endc 329
.elseif assembler directive
definition 324
equivalent to .else, .endif, .endc 329
embedded
assembly code 149, 150
See also asm string statement
See also assembler macros
methods, table of 150
environment 603
compile time options 257
features facilitating access to the
hardware 272
functions, table of 269
hardware exception handling 266
linker command file 268
miscellaneous functions 271
operating system calls 269
profiling 277
raise function 266
setup program 275
src directory, source files 269
startup and termination 258
using in 255
volatile keyword 274
encoding modifiers, table of type 230
_end and end symbol created by linker 367
.end assembler directive 325
.endc assembler directive 325
definition 325
equivalent to .else, .elsec, .endif 329
.endif assembler directive
definition 325
equivalent to .else, .elsec, .endc 329
#endif preprocessor directive 598
.endm assembler directive 325
.endof.section-name symbol created by linker 367
endsw statement, configuration language 594
ENTER constant 522
.entry assembler directive 325
entry point symbols 302
enum
equivalent to int 78
size of in C, C++ 224
type bit-field 164
enumeration
implementation-defined behavior 605
size of, See -Xenum-is-. . .
environment
embedded 603
implementation-defined behavior 606
variables
See configuration variables
DOBJECT
setting object format, -Xobject-
format 294
variables. See under environment variables
environment variable MAKESTARTUP,
defining 456
environment variables
table of 18
configuration language 588
dbcnt
naming the profile data file 443
DCONFIG
changing location of main file 584
overriding 582
recognized by compiler, description 19
DCXXOLD 20, 219
DENVIRON
recognized by compiler, description 19
DFLAGS
dtools.conf, simplified structure 585
evaluating in configuration files 591
recognized by compiler, definition 19
using when difficult to change scripts,
makefiles, add an option 186
DFP. See under configuration language:
variables
DIABLIB
recognized by compiler, definition 20
DIABTMPDIR 20
DMALLOC_CHECK
malloc function 535
DMALLOC_INIT
malloc function 535
DOBJECT
overriding, -WDDOBJECT 287
recognized by compiler, description 19
-WDDOBJECT, assembler option 287
DTARGET
overriding, -WDDTARGET 287
overriding, -WDDTARGET assembler
option 287
recognized by compiler, description 19
pointers to 606
relationship to command lines, configuration
files 580
specify with setup program 262
TMPDIR 438
EOF constant
defining, studio.h function 492
fscanf function 517
scanf function 550
sscanf function 557
ungetc function 570
.equ assembler directive 326
defining a symbol 300
definition 326
ERANGE
constant
setting, expfunction 508
ERANGE constant
setting, matherr function 537
value of errno 607
erf function 507
erfc function 507
erfcf function 507
erff function 507
errno variable 488, 490, 495, 497, 498, 499, 508, 511,
517, 537, 543, 607, 608
See also under multi-tasking
support
__errno_fn 495
library functions set on error 266
preserving 495
__errno_fn function 495
error
caught by library function 266
compilation
caused by using try, catch or throw
keyword 79
generating time with __ERROR__
function 145
-Xstop-on-warning 108
compiler flags keywords try, catch and throw as
errors 227
fatal 145
generated if
address of variable, function, string used
by static initializer, -Xstatic-addr-
error 107
double precision operation used, -Xdouble-
error 77
no environment variable or file found, -
@name 53, 288
generated with
#error string 145
exception handling 227
generating
illegal structure references 598
missing parameter name after # in macro
declaration 598
generating if
no environment variable or file found, -
@name 434
parameters redeclared in outer level of
function 599
pointers and integers mismatched 597
prototypes and arguments do not
match 597
output, standard 43
preprocessor, treatment of 598
standard
output, assert function 607
redirect to file, -@E 54
redirecting to file, -@E 288, 386, 434
treat warnings as, -Xlint 211
undervalue 607
.error assembler directive 326
___ERROR__ function, produces compile-time error
or warning 145
error messages 649
error pragma 126
#error preprocessor directive 124
error statement
configuration language, definition 592
_etext symbol created by linker 367
etoa preprocessor 23
__ETOA__ preprocessor predefined macro 121
etoa subprogram 13
__ETOA_IMPLICIT_USING_STD preprocessor
predefined macro 121
__ETOA_NAMESPACES preprocessor predefined
macro 121
.even assembler directive 326
example 378
exception handling 227, 266
exceptions
disable with -Xexceptions-off in C++ 79
enable with -Xexceptions in C++ 79
-Xjmpbuf-size in C++ 88
__EXCEPTIONS__ preprocessor predefined
macro 121
execution problems 219
exit
function 492, 496, 500, 508
implementation-defined behavior 608
statement, configuration language 592
_exit function 508
in _exit.c termination module 272
_exit.c
profile in an embedded environment 278
termination module, overview 258
exit.c and _exit.c termination module
details 262
overview 258
EXIT_FAILURE constant
defining,h stdlib.h function 492
providing, exit function 508
.exitm assembler directive 326
EXIT_SUCCESS constant
defining, stdlib.h function 492
providing, exit function, successful
termination 508
exp function 508
expf function 509
.export assembler directive 301, 302, 327
declaring ordinary external symbols 301
expressions
absolute 311
evaluation precedence 315
float 83, 597
linker command file 402
precedence change with parentheses 311
relocatable 311
forms, table of 312
terms 311
typeid 227
typeinfo& 227
extend
instruction 201
optimization 201
extended keyword, synonym for long double 89,
140
.extern
references, making available to linker using
.global assembler directive 328
extern
"C" use to avoid name mangling 224, 228
keyword 369
variable 171
.extern assembler directive 327
external symbols
common 301
examples 302
global undefined, if not defined in same
file 302
ordinary 301
.externassembler directive 327
F
-F option
ddump 447
-f option 382
ddump 447
fabs function 509
fabsf function 509
"far" libraries 17, 479
far-absolute addressing mode 248
See under addressing modes
with PowerPC COFF 240
far-code addressing mode 248
far-code-relative mode 626
far-data addressing mode 248
far-data-relative mode 626
fclose function 509
fcntl function 490, 510
definition under <fcntl.h> header file 488
RAM-disk support, getting information about a
file 271
fcvt function 510
fdopen function 510
feedback optimization 203
feof function
definiton 510
ferror function 511
__ff0 intrinsic function 146
__ff0ll intrinsic function 146
__ff1 intrinsic function 147
__ff1ll intrinsic function 147
fflush function 511
fgetc function 511
fgetpos function 511
fgets function 512
.file assembler directive 327
file extensions
.a, archive library 23
.C, C++ source 23
.cc, C++ source 23
.cpp, C++ source 23
.cxx, C++ source 23
.dld, linker 23
.i, proprocessed source 23
.o, object module 23
.o, preprocessed source 23
.s, assembly source 23
__FILE__ preprocessor predefined macro 121, 498
FILE structure 513, 516, 567
fileno function 512
files
absolute vs. relative pathnames,
implementation-defined
behavior 606
a.out, during compile and link 115
header 43, 488
search order 606
initialize in setup.c in embedded
environment 275
input 284
lpragma.h, optimizes calls to C library
functions 69
stderr 515, 549
declaring, stdio.h function 492
stdin 521, 550
declaring, stdio.h function 492
stdout 390, 544, 546, 547
declaring, stdio.h function 492
temporary, DIABTMPDIR 20
types 513
.o 23, 88
.s 88, 150
.fill assembler directive 327
FIND constant, hsearch function 522
.fini section
for _STD__n termination functions 265
in crt0.s 260
_finite function 512
.float assembler directive 328
float expressions 83, 597
float registers, floating point arguments, passing
in 178
floating point
- Xfp-min-prec-long-double 83
arguments 83
arguments in AIX argument passing 178
constants 304
default 28
float values returned in
r3 180
hardware
f1 register returns floating point
values 180
libraries 16, 479
utilizing floating point register file 181
IEEE, .float assembler directive 328
implementation defined behavior 605
libcfp.a
hardware library 479
stubs library 16, 479
method selection 47
register
file, used only with hardware floating
point 181
in EABI argument passing 176
not saved by interrupt function 129
selecting type of support, -t option 28
software
libraries 16
software emulation
float values returned in
r3, double values in r3/r4 180
in GTYPE 176
specifying with environment variable DFP 19
supporting 25
types
alignments 162
argument 73
FTYPE 176
ranges 162
sizes 162
value
returned in f1 register with hardware
floating point 180
single and double precision 176
-Xextend-args 80
-Xfp-float-only 83
-Xfp-long-double-off 83
-Xfp-min-prec-float 83
-Xfp-min-prec-long-double 83
-Xieee754-pedantic 84
-Xuse-double
See -Xfp-min-prec-double 83
See -Xfp-min-prec-long-double 83
-Xuse-float
See -Xfp-min-prec-float 83
floating point types, software emulation using -
Xsoft-float 106
floor function 512
floorf function 513
flow-control optimization 195
fmadds instruction 200
fmod function 513
fmodf function 513
fopen function 276, 513
for statement, scope of initialization part 82
form feed escape sequence, '\f' 305
fpos_t type, defining, stdio.h function 492
fprintf function 514, 570
implementation-defined behavior 608
__fpscr intrinsic function 147
fputc function 514
fputs function 515
fread function 515
free function 515, 535
freopen function 516
frexp function 516
frexpf function 516, 541
friend C++ keyword 224
fscanf function 517, 571
implementation-defined behavior 608
fseek function 517, 550
fsetpos function 517
fstat function 518
ftel function 518
implementation-defined behavior 608
#function symbol type 345
function-level optimization 5
functions
See individual functions
locating specific address 273
modifying errno marked by REERR 495
name encoding with the types of all
arguments 179
no return promised, #pragma no_return 189
no side effects promised, #pragma
no_side_effects 131
pointers, absolute 240
#pragma interrupt 129
pure promised, #pragma pure_function 136
standards and definitions, table of 494
templates 225
fwrite function, definition 518
G
-g option 42, 285
ddump 447
line number information
COFF 639
line number information ELF 627
symbolic debugging 643
-Xoptimized-debug-off 97
gamma function 518, 519
gap in memory, fill value 319
gap in section
creating 417
filling 414
gcvt function 519
getc function 511, 519, 570
getchar function 520
getenv function 276, 520
defining target environment variables for 275
implementation-defined behavior 606
getopt function 520
getpid function 272, 521
gets function 521
getw function 521
global
allocating variable to register 127
common subexpression elimination
optimization 198
construction and destruction of objects 225
constructors C++ 86
data
#pragma pure_function 136
-Xaddr-const 61
-Xaddr-data 61
-Xaddr-sconst 61
-Xaddr-sdata 61
function
indicator `F' in mangled names 228
optimization 5
no_side_effects pragma promises no
modification of variable 131
optimization 6
register assignments 127
variables
absolute sections 246, 273
constructors 225
destructors 225
modifying with asm macro 152
vs. local 186
-Xsmall-const 106
-Xsmall-data 106
.global assembler directive 301, 302, 328
declaring ordinary external symbols 301
global_register pragma
preserve across function calls 127
variable used to control allocation 127
.globl assembler directive 301, 302, 328
declaring ordinary external symbols 301
gmtime function 521
GNU compatibility
GNU local symbols 303
enabling, -Xgnu-locals-on 291
semicolon as statement separator 295
GNU extended syntax
assigning variables to registsers 144
inline assembler 150
GNU local symbols
disabling, -Xgnu-locals-off 291
GROUP definition 415
H
@h unary operator 313
-H option 43, 285, 291
ddump 447
-h option
ddump 447, 449
h option
ddump 447
@ha unary operator 313
__hardfp preprocessor predefined macro 121
hardware exception handling in an embedded
environment 266
hardware floating point
f1 register returns floating point values 180
utilizing floating point register file 181
hcreate function 522
hdestroy function 522
hdrstop pragma 128, 232, 233
header
field %T title, -Xtitle option 296
files 43, 488
C++ 224
declarations in 224
missing standard 217
precompiled 231
search order 606
specify search path ,-I option 44
standard, table of 488
treat #include as #import 85
typeinfo.h C++ 227
string
default format, -Xheader-format 292
format specifications, -Xheader-
format 291
HEADERSZ pseudo function, definition 403
heap, sbrk function manages 264
__HEAP_START, __HEAP_END define heap for
sbrk function 264
in bubble.c 400
%hi unary operator 313
%hiadj unary operator 313
hole in memory, fill value 319
hole in section
See gap in section
horizontal tab escape sequence, '\t' 305
host_dir subdirectory 13
name under version_path 12
hsearch function 522
HUGE_VAL constant 491, 508
defining, <math.h> header file 488
HUGE_VAL_F constant 491
hypot function 523
hypotf function 523
I
.i file extensions, preprocessed source 23
-I option 44, 53, 285, 606
ddump 448
-i option 45, 127
-i file1=file2 change name of header file 45, 217
-I@ option 45
I\xda O functions, table of 270
#ident
directives in C in .comment 622
preprocessor directive 124, 128
strings 84
.ident assembler directive 328
ident pragma 128
identifiers
See symbols
allowing $ in 76
implementation defined behavior 604
maximum length, -Xtruncate 112
underscores added to, -Xunderscore-... 112
user-defined 225
-Xtruncate 112
IEEE 695 object format 279
ddump commands -I 448
IEEE floating point
.double assembler directive 323
.float assembler directive 328
.if assembler directive 325, 329
#if preprocessor directive 123
implementation-defined behavior 606
if statement
configuration language
definition 592
syntax 588
with __ERROR__ function 145
optimization with expressing using ? 195
.ifc assembler directive 330
.ifdef assembler directive 330
#ifdef preprocessor directives 125, 224
if-else clause optimization 203
.ifendian assembler directive 329
.ifeq assembler directive 330
.ifge assembler directive 330
.ifgt assembler directive 331
.ifle assembler directive 331
.iflt assembler directive 331
.ifnc assembler directive 331
.ifndef assembler directive 332
.ifne assembler directive 332
implementation
selected issues 220
specific behavior in code 220
implementation-defined behavior 603-609
abort function 607, 608
absolute vs. relative pathnames 606
arrays 605
bit-fields 605
characters 604
declarators 605
enumerations 605
environment 606
main function C++ 606
floating point 605
fprintf 608
fscanf 608
ftell 608
getenv function 606
identifiers 604
#if preprocessor directive 606
implementation of library functions 607-609
integers 604
library functions
%p conversion 608
%X conversion 608
%x conversion 608
assert 607
calloc 608
clock 609
denoting range of characters 608
exit 608
malloc 608
NULL macro 607
perror message 608
realloc 608
remove 608
rename 608
setenv 608
strerror message 608
system 609
pointers 605
preprocessor directives 606
qualifiers 605
registers 605
struct members 605
union members 605
statements, case labels 606
structures 605
switch statements 606
unions 605
.import assembler directive 332
#import preprocessor directive 125
__inchar function 269
include
subdirectory, standard header files 14
.include assembler directive 332
#include preprocessor directive 44, 45
See also #import preprocessor directive
treat as #import directive 85
include statements, configuration language 584
definition 593
dtools 584
including source in assembly code 98
INF floating point constant 305
info pragma 128
#info preprocessor directive 125
#inform preprocessor directive 125
#informing preprocessor directive 125
.init section
for _STD__n initialization functions 265
in crt0.s 260
init.c startup module, details 261
initialization
constructors 86
.init section, -Xinit-section 86
local variables, -Xinit-locals 86
run-time 265
structures, parsing incomplete controlled, -
Xbottom-up-init 66
initialized data
containing in particular section, with
istring 237
in .data section 307
initializers for static variables 253
__init_main function 260, 261, 272
inline
C++ keyword 224
optimization 189
keyword 89, 140, 193
pragma 128, 189, 193
inline assembly. See asm string statement and
assembler macros
__inline__ keyword 140
inlining 184
changing options to increase 186
optimization 192, 199, 203
activating with the -XO option 183
-Xexplicit-inline-factor controls expansion 79
-Xparse-size 98
-Xsize-opt option 106
input file 284
input/output
basic character input/output
environ part of -t option, simple 29
library, part of simple/libc.a 479
RAM-disk
environ part of -t option, cross 29
library, part of cross/libc.a 479
installation
components 11
default path names, table of 12
install_path directory 11
instantiation
class, -Ximplicit-templates-off 84
explicit 390
of templates, -Ximplicit-templates-off 84
instructions
extend 201
fmadds 200
lfsu 200
lmw 107
lswi 110
string 110
lwz 110
mnemonics 611
rfci generated by -Xinterrupt-funcs-use-rfci 88
rfi generated without -Xinterrupt-funcs-use-
rfci 88
stmw 107
stswi 110
string 110
stw 110
int bit-fields 164
plain, sign of 221
integers
constants 304
implementation defined behavior 604
long 604
mismatched 597
mixing different types in an expression 597
types
alignments 162
magic, preceding virtual base classes 168
ranges 162
sizes 162
integral constants 304
format and description, table of 304
internal data representation 161
classes 165
for aggregates 165
for non-aggregates 165
interprocedural optimizations 98, 184, 185, 199, 602
interrupt
functions
return with rfci instruction 88
ssr0 and ssr1 save and restore, -Xnested-
interrupts 96
interrupt
keyword 89, 141
pragma 129, 141
interrupt functions 246
locating at absolute addresses 273
#pragma interrupt 129
__interrupt__ keyword 141
intrinsics
__alloca( ) function 146
alloca( ) function 146
__ff0( ) function 146
__ff0ll( ) function 146
__ff1( ) function 147
__ff1ll( ) function 147
__fpscr( ) function 147
invisible objects in optimized code 231
invoke
a macro 353
the compiler 35
_IOFBF constant 554
_IOLBF constant 554
_IONBF constant 554
iostream C++ class library 16, 479
iostream.a C++ class library 476
irand48 function 523
isalnum ctype function 607
isalnum function 523
isalpha ctype function 607
isalpha function 524
isascii function 524
isatty function 524
RAM-disk support 271
iscntr ctype function 607
iscntrl function 524
isdigit ctype function 607
isdigit function 525
isgraph ctype function 607
isgraph function 525
islowe function 525
islower ctype function 607
_isnan function 525
isprint ctype function 607
isprint function 525
ispunct ctype function 607
ispunct function 526
isspace ctype function 607
isspace function 526
isupper ctype function 607
isupper function 526
isxdigi function 526
isxdigit ctype function 607
J
j0 function 527
j0f function 527
j1 function 527
j1f function 527
jmpbuf type 491
jn function 528
jnf function 528
jrand48 function 528
K
K&R mode 66, 76, 596, 598
key function for a virtual function table 169
keywords
asm 149, 596
C++ 224
using to embed assembly code 272
catch
disabling exceptions 79
flagging as error 227
keyword
if user-defined identifier, may
necessitate modification of
program 224
catch C++ 79, 191, 224
const
compatibility mode 596
help optimizer 188
delete C++ 224
extended as synonym for long double 89, 140
extern 369
friend C++ 224
inline 89, 193
C++ 224
optimization, C++ 189
interrupt 89, 141
namespace C++ 96
new C++ 224
operator 224
__packed__ 142
specify structure padding 142
specifying structure padding 133
packed 89, 142, 164
pascal 89, 143
private 170, 224
protected 170, 224
public 170, 224
recognize new 89
register 92
has priority 171
using to declare variables 190
signed
and compatibility mode 596
in basic data types 161
using to make bit-fields signed 164
static 188, 369
template C++ 224
this C++ 224
in storage mode lines 153
throw C++ 79, 191, 224, 227
try C++ 79, 191, 224, 227
try, disabling exceptions 79
unsigned, in basic data types 161
using C++ 96
virtual C++ 225
void 224
volatile 95, 188, 220
compatibility mode 596
in an embedded environment 274
use for variables 257
kill function 272, 528
krand48 function 529
L
@l unary assembler operator 313
-l linker option
specify library or process file 45
-L option 45, 286, 293, 324
.eject assembler directive 324
.list assembler directive to turn on listing
lines 333
search path for -l 382
-l option 286, 293, 382
ddump 448
.eject assembler directive 324
example 378
.listassembler directive to turn on listing
lines 333
use with -Y L 385
use with -Y P 385
use with -Y U 386
-l optionl 386
-l:crt0.o startup module
specifyng with -YP option 378
l3tol function 529, 535
l64a function 529
labels 298
See also local symbols
"start", in crt0.s 260
colon optional 299
for branch instructions, generating 302
unique, generating in macros 352
labs absolute value function 529
LC_ALL constant 553
LC_COLLATE constant
setlocale function 553
strcoll function 558
LC_MONETARY constant 553
.lcnt assembler directive 332
LC_NUMERIC constant 553
.lcomm assembler directive 321, 333
indicating use of with string COMM 237
lcong4 function 523
lcong48 function 506, 530, 534, 541
LC_TIME constant 553
__LDBL__ preprocessor predefined macro 122
ldexp function 530
ldexpf function 530
ldiv function 492, 530
ldiv_t type 492
leaf function, using -Xstmw-ok 107
_lessgreater function 531
lfind function 531
lfsu instructions 200
libc.a
library 365
standard C library master file 15, 478
libc.a library
-ttof-:cross option 270
libcfp.a floating point library 16, 475, 479
libchar.a basic character I/O library 15, 29, 30, 269,
475, 478
libcomplex.a
C++ complex math class library 16
directory location 479
supplied with DIAB tools 475
libcomplexold.a
supplied with DIAB tools 475
libd.a C++ additional standard library 16, 475, 478
libdk*.a thread sub-library 16, 476, 479
libdold.a C++ additional standard library 475
libg.a debugger library 16
libi.a standard C library 15, 476, 478
libimpfp.a compiler support library 16, 476, 479
libimpl.a compiler support library 15, 476, 478
libios.a math library 16, 479
libm.a math library 16, 476, 479
libpthread.a thread library 16, 476, 479
libram.a RAM disk I/O library 15, 29, 30, 269, 477,
478
libraries
ANSI C, functions disregarded, -Xclib-optim-
off 69
basic character input output, part of libc.a 479
ELF "far" root directory 17, 479
ELF little endian root directory 16
ELF root directory 15
exception handling 266
floating point
hardware 16, 479
libcfp.a 479
software 16
stubs, libcfp.a 16, 479
function, raise 266
iostream C++ class 16, 479
iostream.a, C++ iostream class 476
-L option specifying path for -l 382
libc.a 15, 365
standard C library master file 15, 478
libcfp.a, floating point 16, 475, 479
libchar.a, basic character I/O 15, 29, 30, 269,
475, 478
libcomplex.a
directory location 479
supplied with DIAB tools 475
libcomplex.a, C++ complex math class 16
libcomplexold.a
supplied with DIAB tools 475
libd.a, additional standard C++ 16, 475, 478
libdk*.a, thread sub-libraries 16, 476, 479
libdold.a, additional standard C++ 475
libg.a, debugger 16
libi.a standard C 15, 476, 478
libimpfp.a, compiler support 16, 476, 479
libimpl.a, compiler support 15, 476, 478
libios.a, math 16, 479
libm.a, math 16, 476, 479
libpthread.a, thread 16, 476, 479
libram.a, RAM disk I/O 15, 29, 30, 269, 477,
478
librta*.a, RTA 16, 478
librta*.a, Run-Time Analysis Suite 477
libwindiss.a support for instruction-set
simulator 16
libwindiss.a supporting instruction set
simulator 479
missing symbols 50
object (archives) 13
RAM-disk input output, part of libc.a 479
rebuilding 485
search paths 30
selecting with environ part of -t option 29
windiss/libwindiss.a with RAM disk I/O 476
librta*.a RTA libraries 16, 478
librta*.a Run-Time Analysis Suite library 477
libwindiss.a library support for instruction-set
simulator 16
libwindiss.a library supporting instruction set
simulator 479
license, waiting for 90
#line directive 233
line feed (newline) escape sequence, '\n 305
__LINE__ preprocessor predefined macro 122, 498
.line section 627
link
editor command language 251
register, lr 182
link
function
definition 531
RAM-disk support, causing two file names
to point to same file 271
linkage and storage allocation 169-171
linker
See also default.dld linker command file
COFF
specifications, sections required 409
symbols, additional supported 643
command file
assignment
definition 416
in section-definition 408
comments 404
default set, -Wm option 49
default.dld, example use of 378
definiton 268
example 399
expressions 402
GROUP definition 415
__HEAP_START, __HEAP_END defined
in 264
identifiers, as symbols 401
MEMORY 403, 404
numbers 401
order of sections 408
section-definition 405
address specification 409
ALIGN specification 410
area specification 415
fill specification 414
LOAD specification 410
OVERFLOW specification 411
section-contents 406
STORE statement 415
type specification 409
SECTIONS 403, 405
GROUP used within 405
STORE statement, in section-
definition 408
structure 403
symbols 401
using -Xstack-probe option 263
command language, aligning sections 340
dld, locating executable 13
example 115
options 380
resolving .comm symbols 302
sections, required 409
lint facility, -Xlint 91, 211, 586
__lint preprocessor predefined macro 122, 490
.list assembler directive 333
list file
format 357
line length
.llen assembler directive 333
.psize assembler directive 337
-Xllen 293
page break margin, -Xpage-skip 294
page length
.lcnt assembler directive 332
.psize assembler directive 337
-Xplen 295
preventing generation, -Xlist-off 293
little endian
ELF libraries 16
little-endian, #pragma pack 133
.llen assembler directive 333
.llong assembler directive 334
-lm option 494
lmw instruction 107
.lnk preprocessor 23
%lo unary operator 313
LOAD directive 420
local
optimization 5
symbols 302
generic style 303
GNU style 303
disabling, -Xgnu-locals-off 291
enabling, -Xgnu-locals-on 291
variable 194
local data area 250
localeconv function 531, 553
localtime function 532
location
alter with \xfa = 309
code and variables, #pragma section 137
configuration files, change standard 583
counter 309
alignment, specifying, -Xdefault-align
option 326
header files, version_path/include 488
log function 532
log10 function 533
log10f function 533
_logb function 532
logf function 532
long
integers 604
type bit-fields 164
.long assembler directive 334
long float 596
long long
C dialects 596
constant, specify with LL or ULL suffix 142
parameters in asm macros 153
values, returned in r3/r4 180
longjmp function 491, 533, 553
avoiding for safety 231
avoiding to improve optimization 190
definition under <setjmp.h> header file 489
with -Xjumpbuf-size 88
loops
count-down optimization 198
invariant code motion optimization 202
maximum
nodes for loop unrolling 113
size defined 198
statics optimization 201
strength reduction optimization 197
testing, -Xtest-at-bottom, -Xtest-at-top and -
Xtest-at both 111
unrolling
optimization 184, 186, 198, 203
-Xsize-opt 106
-Xunroll-size 184
lpragma.h file optimizes calls to C library
functions 69
lrand4 function 556
lrand48 function 530, 533
lsearch function 531, 534
lseek function 534, 566
RAM-disk support, positioning file
pointer 271
lswi instruction 110
lswi string instruction 110
ltol3 function 535
lwz instruction 110
M
-M option 45
ddump 448
-m option 383
ddump 450
-m2 option 383
-m4 option 383
machine instruction statements, operand field
format 300
.macro assembler directive 334
macros 349
See also preprocessor predefined macros
\@ special parameter 352
\0 special parameter 351
assembler 149, 349
assert, <assert.h>, standard header files 488
assert, assert function 499
concatenating parameters 352
defining 350
dumping symbol information 72
in pragmas 93
invoking 353
labels, generating unique 352
NARG symbol 353
parameters
names, separating from text 352
referencing by name 350
referencing by number 351
va_arg 491
va_end 491
va_start 491, 570, 572
magic integer, preceding virtual base classes 166,
168
main function 261
define arguments for in embedded
environment 275
in setup.c in embedded environment 276
.init code executing before 623
n setup.c in embedded environment 276
three ways to define 606
MAKESTARTUP environment variable,
defining 456
mallinfo function 535
malloc function 515, 535, 549
call with sbrk 264
checking free list 264
__diab_lib_err called by 266
implementation-defined behavior 608
initializing allocated space 264
old definition with <cmalloc.h> header file, use
dlib.h> instead 488
__malloc_set_block_size function 536
mallopt function 536
mangling
See name mangling
static data members 228
MATH functions require math library 494
matherr function 536
matherrf function 537
MB_CUR_MAX constant 538
mblen function 538
mbstowcs function 538
mbtowc function 538
mem declaration under <string.h> header file 489
members
alignment 165
functions 179
class name encoded in name 179
constructors 179
destructors 179
pointers to 179
static 170
struct 164
memccpy function 539
memchr function 539
memcmp function 539
memcpy function 539
memfile.c, create with setup program 275
memmove function 540
memory
hole, fill value 319
MEMORY command 403, 404
memset function 540
messages 649
.mexit assembler directive 335
minor transformations optimization 199
mix C and assembler functions 272
mktemp function 540
mktime function 540
mnemonics
instruction 611
type specify with DOBJECT 19
modf function 541
modff function 541
Motorola
S-Record, ddump commands -R 450
S-Record, object module format 279
mrand48 function 530, 541, 556
multi-tasking support 274
errno variable, not re-entrant 274
malloc and free must be thread-safe 274
N
N noload access mode 243
-N option 383
ddump 449
place .data immediately after .text 381
-n option
ddump 452
n$ local symbols 303
.name assembler directive 335
name mangling 224, 228
avoid in function names 272
demangle names with ddump -F 230
table of type encodings for C++ 229
namespace C++ keyword 96
namespaces
compiler implementation 227
mangling 228
NAN floating point constant 305
NARG macro symbol 353
NDEBUG preprocessor predefined macro 499
near-absolute addressing mode 248
near-code addressing mode 248
See under addressing modes
near-data addressing mode 248
See under addressing modes
new
array operator 227
C++ keyword 224
Newline character 306
NEXT pseudo function
definition 403
_nextafter function 541
no_alias pragma 130, 189
nodes
inlining functions 87
loop unrolling 113
__nofp preprocessor predefined macro 122
.nolist assembler directive 335
noload access mode 243
__no_malloc_warning 515, 549
non-static member function 179
non-virtual
member function 165
no_pch pragma 232
nops, insert into function 88
nops, insert into function 87
no_return pragma 189
no_return pragma function
no return promised, #pragma no_return 130
no_side_effects pragma 131, 189
nrand48 function 542
NULL
constant
defining, stblib.h function 492
defining, stddef.h function 492
defining, stdio.h function 492
defining, string.h function 492
macro, implementation-defined behavior 607
pointer 162
dereferences 220
null pointer-to-member function 168
null-terminated array of pointers 606
O
O COMDAT access mode 243
.o file extension 23
keeping object files 88
object module 23
-O option 46, 51, 90, 116, 185, 219
optimize code 46
with environment variable DFLAGS 19
-o option 46, 116, 284, 286, 383
ddump 449, 452
example 378
o, assembler octal constant suffix 304
O_APPEND constant
defining, fcntl.h function 490
object
files
converter and dumper, ddump 13
converting to Motorola S-Records, ddump -
R command 450
dar archives 436
keeping 88
libraries (archives) 13
object module format
COFF 279
AIX conventions 28
-Xobject-format 294
ELF 279
compressible 28
EABI conventions 28
-Xobject-format 294
IEEE 695 279
Motorola S-Record 279
selecting 28
offsetof function 542
O_NDELAY constant
defining,fcntl.h function 490
opcodes
assembler directives 299
case sensitivity in D-AS 299
instructions 299
syntax rules 299
open function 276, 490, 510, 542
calling with create function 271
definition under <fcntl.h> header file 488
RAM-disk support, opening file 271
operand field 321
operands
addressing modes 612
field, syntax rules 299
spaces between
allowing, -Xspace-on 295
disallowing, -Xspace-off 295
operator keyword 224
operators
assembler
precedence 315
unary, table of 312
binary
table of 314
compound (like +=) not allowed for volatile
members in packed structures 134
constructor 225
delete 180
delete array 227
destructor 225
new array 227
precedence
assembler, table of 315
sizeof 114, 147
defining, stddef.h function 492
defining, stdio.h function 492
defining, stdlib.h function 492
defining, string.h function 492
optimization
disabling with asm string statements 158
optimizations
access static and global variables
conservatively 71
additional loop 205
argument
address 194
assignment 195
basic reordering 204, 207
branch complex 196
coding techniques 186
common tail 196
complex branch 206
constant and variable propagation 196, 207
control via parameter setting 81
device driver failure 95
disable with
alloca 144
setjmp and longjmp 190
volatile keyword 188
-Xkill-opt 89, 191
-Xkill-reorder 89, 204
disabling with
-g or -Xoptimized-debug-off 97
effectiveness 188
enable 116
-Xargs-not aliased 63
examples 206
expose uninitialized variables 220
extend 201
failure with parameter modifications in asm
macros 151
feedback 203
flow-control 195
for size, -Xsize-opt 106
function-level 5
global 5, 6
common subexpression elimination 198,
206
guidelines for 185
hints 183-191
if statements
with expressing using ? 195
if-else clause 203
inlining 5, 184, 192, 199, 203
activating with the -XO option 183
function 206
interprocedural 98, 184, 185, 199, 602
register allocations 5
invoke 46
levels 602
local 5
loop
count-down 198
invariant code motion 202
statics 201
strength reduction 197, 206
unrolling 184, 186, 198, 203
merge
common block entry, exit code 205
multiple adds 205
minor transformations 199
oop
count-down 206
peephole 13, 204, 206
reaching analysis 205
program-level 5
question-expression pop optimization 195
range optimization 194
reaching analysis 5
register, coloring 199
remove entry and exit code 199, 206
selecting levels of, DFLAGS 587
space vs. speed 184
static function 202
structure members 194
tail recursion 192
target-dependent 204
done by reorder program 204
target-independent 191
undefined variable propagation 198
unused assignment deletion 199, 206
use scratch registers for variables 200, 206
variable live range 196
vs. compilation speed 184
-Xargs-not-aliased 63
-Xblock-count and -Xfeedback used as
guide 185
-Xlint 211
-Xlocal-data-area, operation 250
-Xrestart, start over 103
optimized code, invisible objects 231
optimizer
recompile without -O option 219
remove __ERROR__ function 145
options
appearing more than once 36
assembler 284
case sensitivity 37
compiler 39, 54
-Xoptions 54
disabling 54
displaying 39, 47, 53
linker 380
pragma 131
quoting on command line 37
writing on command line 36
O_RDONLY constant
defining,fcntl.h function 490
setting values, open function 542
O_RDWR constant
defining, fcntl.h function 490
values of, open function 542
.org assembler directive 309, 335
in location counters 309
__outchar function 269
output
assembly 40, 117
standard, redirect to file, -@E 54
OVERFLOW
constant 537
specification 411
O_WRONLY constant
defining, fcntl.h function 490
values of, open function 542
P
-P compiler option
preprocessor, stopping after 23
-P option 40, 47
-p option
ddump 449, 450, 452
-p2 option
ddump 447
.p2align assembler directive 336
pack pragma 132
packed (__attribute__ keyword) 139
__packed__ keyword 142
specify structure padding 142
specifying structure padding 133
packed keyword 89, 142, 164
pad sections 308
.page assembler directive 336
.pagelen assembler directive 336
pascal keyword 89, 143
PCC mode 76, 598
PCH files 232
peephole optimization, rlwinm 206
perror
function 543
message, implementation-defined
behavior 608
PIC initializers 253
pipe function 510
.plen assembler directive 336
PLOSS constant 537
pointers
basic data type, size and alignment 162
implementation-defined behavior 605
NULL 162
to members
argument passing 179
as arguments and return types 179
to static member function 165
pointers to members types
explanation 168
port programs 275, 595-599
position-independent code (PIC) 107
achieve using code relative addressing
modes 240
address initializer
-Xstatic-addr-error 107
-Xstatic-addr-warning 107
generate with
-Xcode-relative-... 70, 257
use to provide load-time allocation 251
position-independent code and data (PIC and
PID) 251
position-independent data (PID)
achieve using data relative addressing
modes 240
generate with
-Xdata-relative-... 257
generate with -Xdata-relative-... 74
r13 register, global pointer 182
r2 register, global pointer 181
POSIX reference 494
pow function 543
powf function 543
ppc preprocessor predefined macro 122
#pragma no_side_effects
example 189
pragmas 126-138
align for structures 126
compile-time 257
control code generation 257
directives, use with asm macro 152
error 126
global_register, preserve across function
calls 127
hdrstop 128, 232, 233
ident 128
info 128
inline 128, 189, 193
versus inline keyword in C++ 193
interrupt 129, 141, 266
compiler option for embedded
development 257
macros 93
no_alias 130, 189
no_pch 232
no_return 130, 189
no_side_effects 131, 189
pack for structures 132, 258
pure_function 136
section 137
causing compiler to generate sections 369
compiler option for embedded
development 258
in hardware exception handling 266
use to specify a variable be placed at an
absolute address 273
use_section 236
weak 138
COMDAT symbol may be treated as 370
precedence, assembler operators 315
precompiled headers 231
predefined macros
See preprocessor predefined macros
preprocessor 51
assembly files 99
cpp
defaults 23
with -W compiler option 50
ctoa 23
dtoa 651
errors, treatment of 598
selecting 99
preprocessor directives 126-138
#align 126
#assert 123
#define 41
#elif 123
#endif 598
#error 124
#ident 124, 128
#if 123, 606
#ifdef 125, 224
implementation-defined behavior 606
#import 125
#include 44, 45
treat as #import directive 85
#info 125
#inform 125
#informing 125
#pack 132
#pragma
See pragmas
removing, -E option 41
#unassert 123
#undef 47
#warn 125
#warning 125
preprocessor predefined macros
table of 121
__bool 121
__cplusplus
definiton 121
__DATE__ 121
__DCC__ 121
__DCPLUSPLUS__ 121
defaults predefined in dtools 585
_DIAB_TOOL 121
__EABI__ 121
__ETOA__ 121
__ETOA_IMPLICIT_USING_STD 121
__ETOA__NAMESPACES 121
__EXCEPTIONS__ 121
__FILE__ 121, 498
__hardfp 121
__LDBL__ 122
__LINE__ 122, 498
__lint 122, 490
macro arguments replacing in strings 598
name, defining with -D option 41
NDEBUG 499
__nofp 122
__ppc 122
__RTTI__ 122
SBRK_SIZE
See sbrk function 264
__SIGNED_CHARS__ 122
__softfp 122
__STDC__ 122
__STRICT_ANSI__ 122
suppress extra spaces 73
__TIME__ 122
__VEC__ 122
__wchar_t 122
preprocessors
das 23
dld 23
etoa 23
.lnk 23
preserved registers, floating point, f14 - f31 182
.previous assembler directive 337
print statement, configuration language 593
printf function 510, 544
private keyword 170, 224
profiling
in an embedded environment 277
Diab Run-Time Analysis Suite (RTA) 203
-Xblock-count 66
-Xfeedback 80
-Xprof-exec, with RTA 101
-Xprof-feedback, with RTA 101
-Xprof-snapshot, with RTA 102
profiling information generating, dbcnt 13
program-level optimization 5
programs
port existing 275
reorder 204
setup.c, initializes arguments, variables, and
files in an embedded
environment 275
protected keyword 170, 224
prototypes
force, -Xforce-prototypes 82
placement of sections 246
.psect assembler directive 337
.psize assembler directive 337
ptrdiff_t type 492
public keyword 170, 224
pure_function pragma 136
putc function 515, 546
putchar function 546
putenv function 547
puts function 547
putw function 547
Q
q, assembler octal constant suffix 304
qsort function 548
qualifiers, implementation-defined behavior 605
question-expression pop optimization 195
quoting command line values 37
R
R access mode. See under access modes
-R assembler option 286
-R linker option 384
-R option
ddump 450
-r option 383
ddump 449, 450
-r2 option 383
-r3 option 383
raise function 548
in embedded environment 266
RAM-disk files 270, 275
rand function 548
RAND_MAX constant 548
raw data sections 636
table of 636
.rdata assembler directive 337
read function 495, 548
RAM-disk support, reading buffer 271
realloc function 515, 549
implementation-defined behavior 608
rebuilding the libraries 485
REENT functions are reentrant 495
reentrant library functions. See under multi-tasking
support 274
REERR functions modify errno 495
register keyword 92
has priority 171
using to declare variables 190
register list line 154
REGISTER specification 412
registers 181
assigning variables to 144
attribute 599
coloring optimization 199
control 201
floating point
arguments, passing in 178
in EABI argument passing 176
global assignments 127
I/O, in absolute sections 246, 273
implementation-defined behavior 605
link, register usage, lr 182
lower preserved 127
preserved floating point, f14 - f3 182
r13 points to _SDA_BASE_ 182
r2 set to _SDA2_BASE_ 181
reserved
r2 in AIX (COFF) 181
reserved, compiler using only addressing
modes that are relative to 251
scratch 129
r0 181
use for variables 200
ssr0 96
ssr1 96
storage class 605
struct members, implementation-defined
behavior 605
temporary
r3 - r12 in Power PC 181
tracking 98
union members, implementation-defined
behavior 605
use, table of 181
variables 127
registers temporary
floating point, f1 - f 13 in PowerPC 182
relnote.htm 39
relocatable expressions 311
table of 312
relocation
data 251
information, selecting format 389
types, table of 248
remove
entry and exit code optimization 199
unused sections 393
remove function 549
implementation-defined behavior 608
rename function 549
implementation-defined behavior 608
reorder
optimizer subprogram 13, 46, 50, 51, 89
program
input assumed to be correct 204
target-dependent optimization 204
preprocessor directives
#include
See also #import preprocessor directive
reserved
registers, compiler using only addressing
modes that are relative to 251
storage 309
restrictions for position-independent code
(PIC) 253
result passing
See return results
return escape sequence, '\r' 305
return results
class 180
struct 180
union 180
returning results
in r3 - r12, temporary registers 181
rewind function 550
rlwinm peephole optimization 206
.rodata assembler directive 338
__rtc_error function 267
_RTC_MD_ATEXIT_REPORT 267
__rtc_set_mode function 267
RTTI
See run-time type information
__RTTI__ preprocessor predefined macro 122
run-time
error checking, -Xrtc 103
initialization 265
run-time type information
control with -Xrtti, -Xrtti-off 104
__tdescr symbols generated 104
RW access mode. See under access modes
RX access mode. See under access modes
S
.s files, assembly source 23, 88, 150
-S option 46, 47, 88, 117
compiler, stopping after 23
ddump 451
generate assembly file 150
-s option 384
ddump 451
suppress symbol table information 366
sbrk function 264, 400, 550
.sbss
assembler directive 338
section 307, 367
-R, -v suppressing 450
.sbss section
"small" common blocks appended to 370
.sbss section. See under sections
.sbttl assembler directive 338
_scalb function 550
scanf function 550, 572
SCOMMON sections 370
explicit placement 408
SCONST section class 106
"text" or "data" 248, 249
-Xconst-in-data same as -Xconst-in-text=0 249
-Xconst-in-text mask bits 249
SCONST section class. See under section classes
scope of for statement initialization part 82
scratch register 129
r0 181
use for variables 200
_SDA2_BASE_ symbol
created by linker 367
See Small Constant Area, _SDA2_BASE_ 181
_SDA_BASE_ symbol
created by linker 367, 368
See Small Data Area, _SDA_BASE_ 182
%sdaoff unary operator 313
@sdarx unary operator 313
.sdata
assembler directive 338
section 308
pointed to by a5 367
symbol created by linker 367
SDATA section class 106
SDATA section class. See under section classes
.sdata2
assembler directive 339
section 308
pointed to by $23 367
@sdax unary assembler operator 313
search path
header files 44
ibrary files 382
libraries 30
.section
assembler directive 308, 339
directive 394
.section assembler directive
aligning ELF 308
using istring 237
section classes
CODE, default attributes 238
CONST
alternative specifications 409
default attributes 238
value of RW 243
with const variables 249
with -Xconst-in-text option 248
DATA
alternative specifications 409
locating initialized vs. uninitialized 244
with linker created symbol, _edata 367
DATA, default attributes 238
SCONST
default attributes 238
value of RW 243
SDATA
default attributes 238
STRING
default attributes 238
TEXT
alternative specifications 409
user-defined 238
section classes CONST
-Xconst-in-data same as -Xconst-in-text=0 249
.section n assembler directive 340
section .warning 371
section-definition
See linker command file, section-definition 405
.sectionlink assembler directive 340
sections
.abs.nnnnnnnn
absolute sections 309
definition 335
producing, .org 309
absolute, advantages 246
align, using linker command language 340
alignment of output sections 392
.bss
clearing using init.c 261
common blocks appended to 369
common blocks appending to 369
common symbols allocating 301, 302
common symbols allocating for use by
linker 301
controlling allocation of uninitialized
variables 67
displaying size, ddump -S 451
holding common blocks not defined in .text
or .data 365
holds common blocks not defined in .text
or .data 365
.lcomm assembler directive
allocating 333
linker allocating storage for common
symbols 302
predefined program 307
-R, -v suppressing 450
switching output 321
-Xlocal-data-area may suppress
storage 93
classes
CONST
const-in-text mask bits 249
SCONST
"text" or "data" 248, 249
section 106
-Xconst-in-text mask bits 249
SDATA
section 106
STRING
"text" or "data" 248, 249
value of RW 243
user-defined 237
-X options direct addressing mode 241
COMDAT
'o' type in .section assembler
directive 339
with implicit templates 226
COMDAT
treatment by linker 370
COMM, allocation of static variables 238
COMMENT
linker, specifications 409
.comment
with -s linker option 384
.comment, appending character string, .ident
assembler directive 328
COMMON
explicit placement 408
COMMON, linker 369
.data
allocation of
static variables 238
allocation of user-defined sections 238
copying initial values to, using init.c 261
displaying size, ddump -S 451
predefined program 307
r13 register as a pointer to 252
restrictions on using -Xcode-relative-near-
all 252
using -Bd to allocate 381
using -N to allocate immediately after
.text 383
using -N to place immediately after
.text 381
with -Xbss-off compiler option 67
-Xlocal-data-area 93
.fini
for _STD__n termination functions 265
in crt0.s 260
.init
for _STD__n initialization functions 265
in crt0.s 260
.line 627
order, ensuring with GROUP 415
padding and fill 308
placement, with prototypes 246
pragma 137
predefined 237
table of 307
raw data 636
table of 636
removing unused 393
.sbss 307, 367
"small" common blocks appending 370
allocating 338
allocation of static variables 238
-R, -v suppressing 450
SCOMMON 370
explicit placement 408
.sdata 308
pointed to by a5 367
.sdata2 308
pointed to by $23 367
.shstrtab string table 628
.strtab string table 628
.symtab 627
.text 307
allocation of
const variables 238
allocation of functions 238
displaying size, ddump -S 451
line number information 639
use -N to allocate immediately before
.data 383
use with -Bt 381
-Xstrings-in-text 257
types
BSS 409
TEXT 367
SECTIONS command 403, 405
GROUP used within 405
seed4 function 506
seed48 function 523, 534, 541, 552
SEEK_CUR constant 534
SEEK_END constant 534
SEEK_SET constant 534
select
target 283
target configuration 25, 31
target processor 25
separate compilation 116
.set (equ) assembler directive 341
.set (let) assembler directive 341
.set assembler directive 341
alternative to .equ 341
instead of .equ 326
symbol, define 300
symbol, define, alternative to .equ
directive 341
.set option assembler directives available 341
setbuf function 552
setenv function, implementation-defined
behavior 608
setjmp function 491, 533, 553
avoiding for safety 231
avoiding to improve optimization 190
definition under <setjmp.h> header file 489
with -Xjumpbug-size 88
setjmp function, compatibility 599
setlocale function 553
setup program
initialize arguments, variables and files in an
embedded environment 275
output used by init.c 262
setvbuf function 554
short
initialized data in .sdata section 308
uninitialized data in .sbss section 307
.short assembler directive 342
short type bit-fields 164
.shstrtab string table section 628
SIGABRT signal 496
sig_atomic_t type 491
sigjmpbuf type 491
siglongjmp function 491
signal function 272, 554
signed keyword
and compatibility mode 596
in basic data types 161
using to make bit-fields signed 164
__SIGNED_CHARS__ preprocessor predefined
macro 122
sigsetjmp function 491
sigset_t type 491
simple libc.a subdirectory 479
simple target execution environment, basic character
input/output 29
simple/libc.a subdirectory 15
simulator windiss 457
sin function 554
sinf function 555
SING constant 537
single quote escape sequence, ' 305
sinh function 555
sinhf function 555
.size assembler directive 342
size of
character constant in C and C++ 224
enum in C, C++ 224
sizeof
operator 114, 147
defining, stddef.h function 492
defining, stdio.h function 492
defining, stdlib.h function 492
SIZEOF pseudo function
definition 403
.sizeof.section-name symbol created by linker 367
size_t type
stddef.h 492
stdlib.h 492
string.h 492
.skip assembler directive 309, 342
Small Constant Area
_SDA2_BASE_ symbol
defined by linker 181
r2 register points to 181
Small Constant Area, -Xsmall-const defines variable
size 257
small constant static variables 106
Small Data Area 368
fast access even with -Xdata-relative-far 74
_SDA_BASE_ symbol
defined by linker 182
r13 register points to 182
with -Xdata-relative-far 242, 252
with -Xsmall-data defines variable size 257
__softfp preprocessor predefined macro 122
software floating point, float values returned in r3,
double values in r3/r4 180
sorted section init$nn 265
sorted sections, input section order, definition 371
source, including in assembly code, -Xpass-
source 98
.space assembler directive 343
space optimization 196
spaces between operands
allowing, -Xspace-on 295
not allowed, -Xspace-off 295
__SP_END symbol, stack end initialized to 263
in bubble.c 400
__sp_grow function 263
__SP_INIT symbol, stack start initialized to 263
in bubble.c 400
sprintf function 555, 572
sqrt function 556
sqrtf function 556
srand function 556
srand48 function 506, 523, 534, 541, 556
src
directory, source files 269
subdirectory 14
S-Record object module format 279
-ss option 384
sscanf function 557, 572
ssize_t type
defining, stdio.h function 492
ssr0 register 96
ssr1 register 96
stack
alignment 174, 176
checking
__sp_grow_ function 263
__rtc_error function called on
overflow 263
__SP_END symbol 263
__sp_grow function 263
initialization, by __SP_INIT symbol 263
in bubble.c 400
layout, EABI 174
overflow check, -Xstack-probe 107
standard
header files, table of 488
standard
addressing mode 248
See under addressing modes
with PowerPC COFF 240
standards, C++, conformance to 6
"start" label in crt0.s 260
.startof.section-name symbol created by linker 367
startup
and termination 258
crt0.o 181
crt0.s 258
module
See crt0.o startup module
startup module
-l:crt0.o, specifying with -YP option 378
statements
asm string, disabling optimizations 158
assignment with -WD compiler option 48
configuration language
break 594
case 594
exit 592
include
definition 593
print 593
switch 593
for initialization part scope 82
switch, implementation-defined behavior 606
switch, table vs. compares 111
static
allocate variables 169
data 136
function optimization 202
member 170
mangling 228
member function 165
objects 225
variables 127
constructors 225
destructors 225
initializers 253
modify with asm macro 152
vs. local 186
static
function, outside any function, but inside a C++
class definition 171
keyword 188, 369
static constvariable
with -Xcode-relative-far 70
stdarg function
in EABI stack frame 176
stdarg function in EABI stack frame 176
__STDC__ macro 122
stderr 515, 549
buffering 107
declaring,stdio.h function 492
redirect to file, -@E 54
stdin file 521, 550
declaring, stdio.h function 492
stdio function 524
_STD__n termination functions 265
stdout file 390, 544, 546, 547
declaring, stdio.h function 492
stdout redirect to file, -@E 54
step function 503, 557
sterror messages, implementation-defined
behavior 608
stext symbol created by linker 367
_STI__n initialization functions 265
stmw instruction 107
stop on warning 395
storage
classes, as permitted by scope 169, 171
mode for assembler macro parameters,
con 153
mode line 152
reserve 309
STORE statement 408
str* declaration under <string.h> header file 489
strcat function 557
strchr function 557
strcmp function 534, 558, 564
strcoll function 553, 558, 564
strcpy function 558
strcspn function 558
strdup function 559
strerror function 559
strftime function 553, 559
Strict ANSI C mode 76
__STRICT_ANSI__ macro 122
.string assembler directive 343
string constants 72
configuration language 589
-Xcharset-ascii 68
-Xswap-cr 110
STRING section class
"text" or "data" 248, 249
value of RW 243
-Xconst-in-data same as -Xconst-in-text=0 249
STRING section class. See under section classes
strings
alignment, -Xstring-align 108
#ident 84
location, -Xconst-in-... 72
quoting on command line 37
strlen function 560
strncat function 560
strncmp function 561
strncpy function 561
strpbrk function 561
strrchr function 562
strspn function 562
strstr function 562
.strtab string table section 628
strtod function 562
strtok function 563
strtol function 563
strtoul function 563
struct
lconv 531
member 164
return type 180
scope in C++ versus C 224
structure member alignment
-Xstruct-min-align, set minimum 110
structures
__packed__ keyword 142
align pragma 126
alignment 165
alignment of members
changing with -Xbit-fields-compress-
... 65
-Xmember-max-align 94
-Xstruct-max-align 94
-Xstruct-min-align 110
assignment, -Xstruct-assign-split-... 109
byte-swapping 142
enum uses smallest type in packed 134
illegal references, error treatment of 598
implementation-defined behavior 605
in EABI argument passing 176
incomplete initialization, parsing controlled, -
Xbottom-up-init 66
initialization, -Xbottom-up-init 66
initialized, warning in PCC mode 596
initializers, incomplete parsing 597
maximum alignment 132, 142
members
byte-swapping 133
to registers optimization 194
minimum alignment 132, 142
pack pragma 132
packed keyword 132, 142
padding 133
See also __packed__ keyword
minimize 165
with a zero-length bit-field 164
reducing size with -Xbit-fields-compress-... 65
return type 180
size 165
argument, -Xstruc-arg-warning 108
volatile
member access not atomic in packed
structures 134
strxfrm function 553, 564
.strz assembler directive 343
stswi instruction 110
stswi string instruction 110
stw instruction 110
subdirectories
host_dir 13
name under version_path 12
include, standard header files for user
programs 14
target 15
subprograms run by driver program, table of 23
.subtitle assembler directive 343
subtitle, defining, -Xsubtitle 296
SVID reference 494
swab function 564
switch statements
configuration language 593
implementation-defined behavior 606
.symbol assembler directive 341
symbol table
including
all locals, -Xstrip-locals-off 296
certain locals, -Xstrip-temps-off 296
suppressing
all locals, -Xstrip-locals 295
certain locals, -Xstrip-temps 296
symbols
"declared" when the assembler recognizes it as a
symbol of the program 300
"defined" when a value is associated with
it 300
.comm treating as undefined global 302
common
declaring, .comm assembler directive 301
storage allocated by linker 302
created by linker 366
entry point 302
external
common 301
examples 302
ordinary 301
forcing linker to define 385
global
defining with =: 301
undefined, if not defined in same file 302
GNU style 303
linker command file 401
local
generic style 303
GNU style 303
n$ 303
renaming in linker output 384
restrictions 300
syntax rules 300
types
table of 345
@function 345
@object 345
#function 345
#object 345
undefined
flagged in symbol table 302
underscores added, -Xunderscore-... 112
valid characters 300
.symtab section 627
syntax
assembler lines 297
comments 300
constants, integral 304
direct assignment statements 301
external symbols 301
floating point constants 305
format of an assembly language line 298
labels 298
local symbols 302
generic style 303
GNU style 303
opcode 299
operand field 299
symbols 300
SYS functions provided by system 495
sys_errlist variable 543
sys_nerr variable 543
system function, implementation-defined
behavior 609
T
-T option 286
ddump 451
+t option
ddump 451
-t option 47, 286, 384, 584
changing, dctrl 32
ddump 451
setting configuration variables 581
table of values 26
tab stops, default, -Xtab-size 296
tail recursion optimization 192
tan function 564
tanf function 565
tanh function 565
tanhf function 565
target
communicating with 272
configuration
selecting 25, 31
examples 30
configuration, changing the default 31
dependent optimization 204
environment variables 275
input/output support, selecting with environ
part of -t option 29
operating system support, special configuration
file selecting with environ part of -t
option 29
predefined files 275
processor, selecting 26
program arguments 275
select 283
subdirectory 15
target-dependent options
Refer to Target User's Manual
Refer to relnote.txt file
tdelete function 565
__tdescr symbols generated by -Xrtti 104
tell function 566
templates
C++ keywords 224
class 225
function 225
instantiation
in dplus 225
recursion limit set with -Xmax-inst-
level 94
-Ximplicit-templates-off 84
tempnam function 566
temporary
assembly file 88
files, DIABTMPDIR environment variable 20
floating point registers, f1 - f 13 in
PowerPC 182
registers
r3 - r12 in Power PC 181
.text assembler directive 344
.text section 307
displaying size, ddump -S 451
line number information 639
use -N to allocate immediately before
.data 383
use with -Bt 381
-Xstrings-in-text 257
TEXT section class. See under section classes
.text section. See under sections
TEXT section type 367
tfind function 566
this C++ keyword 224
in storage mode lines 153
thread-safe operation. See under multi-tasking
support 274
throw C++ keyword 79, 191, 224, 227
time function 272, 540, 566
__TIME__ macro
precompiled headers 233
__TIME__ macro 122
.title assembler directive 344
title, defining, -Xtitle 296
TLOSS constant 537
TMPDIR environment variable 438
tmpfile function 567
tmpnam function 567
toascii function 567
tolower function 568
toupper function 568
try
C++ keyword 224, 227
try C++ keyword 79, 191
try keyword
disabling exceptions 79
tsearch function 569
.ttl assembler directive 344
-ttof 47
-ttof assembler, compiler, linker option 26
-ttof option
target processor component 29
-ttof-:cross option, part of libc.a library 270
twalk function 569
.type assembler directive 344
typedef scope in C++ versus C 224
typeid expression 227
type_info class definition 227
typeinfo& expressions 227
typeinfo.h C++ header file 227
types 491
bool
- Xbool-off disables 66
__bool preprocessor predefined
macro 121
set type for 66
defining, fpos_t function 492
div_t 492, 506
generate debug information for unreferenced
types 75
identification, typeid 227
jmpbuf 491
ldiv_t 492
ptfdiff 492
sig_atomic_t 491
sigjmpbuf 491
sigset_t 491
size_t
defining, stdio.h function 492
stddef.h 492
stdlib.h 492
string.h 492
VISIT 569
wchar, __wchar_t preprocessor predefined
macro 122
tzset function 569
U
-U option 47
-u option 385
ddump 449, 450, 452
.uhalf assembler directive 345
.ulong assembler directive 345
#unassert preprocessor directive 123
#undef preprocessor directive 47
undefined
global symbol 302
symbols, flagging in the symbol table 302
variable propagation optimization 198
UNDERFLOW constant 537
ungetc function 570
uninitialized data
.bss section 307
containing in particular section, with
ustring 237
unions
alignment 165
implementation-defined behavior 605
in EABI argument passing 176
initialized, warning in PCC mode 596
return type 180
size 165
UNIX
configuration variable DCONFIG 19
default installation path name 12
directory separator character 590
environment variable DIABTMPDIR 20
reference 494
setting environment variables 18
standard name, location of main configuration
file 583
unlink function 570
RAM-disk support, removing a file 271
_unordered function 570
unsigned
keyword, in basic data types 161
long long variable type 142
unused assignment deletion optimization 199
use scratch registers for variables optimization 200
user
modifications 258
user.conf configuration file
description 14
dtools.conf configuration file, simplified
structure 585
user-defined section class 237
user-defined section class. See under section classes
use_section pragma 236
.ushort assembler directives 345
using C++ keyword 96
.uword assembler directive 346
V
-V option 48, 287, 385
ddump 451
-v option 48
ddump 447, 450, 452
va_arg macro 491
va_end macro 491
va_list type 491
values
float returned in r3 180
floating point returned in f1 register with
hardware floating point 180
floating point, single and double precision 176
long long returned in r3/r4 180
small constant, r2 pointer to 181
varargs function
in EABI stack frame 176
variable live range optimization 196
variables
absolute, accessing at specific addresses 273
absolute, accesssing with symbolic
debugger 246
access at specific addresses 273
allocation on stack, -Xlocals-on-stack 92
automatic 127
configuration language 590
conservative access of static and global
variables 71
const
moving from "text" to "data" 248
with -Xdata-relative-near 74
with-Xdata-relative-far 74
constructor 225
destructor 225
embedded environment, initialize in
setup.c 275
errno 488, 490, 495, 497, 498, 499, 508, 511, 517,
537, 543, 607
__errno_fn 495
preserving 495
extern 171
global
absolute sections 246, 273
allocating to register 127
modifying with asm macro 152
vs. local 186
-Xsmall-const 106
-Xsmall-data 106
global_register pragma used to control
allocation 127
initial values
copying from "rom" to "ram" 261
initialization of locals, -Xinit-locals 86
local 194
locating initialized vs. uninitialized 244
locating specific address 273
location, #pragma section 137
long long 142
__no_malloc_warning 549
non-constant static 106
register 127, 171
small constant static 106
static 127
modify with asm macro 152
vs. local 186
static const
with -Xcode-relative-far 70
sys_errlist 543
sys_nerr 543
unsigned long long 142
volatile 95
va_start macro 491, 570, 572
__VEC__ macro 122
version number, displaying 48
version_path 11
directory 44
subdirectories & important files 13
vertical tab escape sequence, '\v' 305
vfprintf function 570
vfscanf function 571
virtual
base class 166
one extra argument added for each 179
function table 166, 167
generation, key functions 169
virtual base class
pointers, added to a derived class 168
virtual C++ keyword 225
virtual function table
array of pointers to functions 168
VISIT type 569
void keyword 224
volatile
data 257
keyword 95, 188, 220, 274
and compatibility mode 596
inline assembler 151, 158
use for variables 257
member access not atomic in packed
structures 134
vprintf function 571
-VS option 385
vscanf function 572
vsprintf function 572
vsscanf function 572
-VV option 48
W
-W a option 48
-W as option 48
-W D option 48
-W l option 49
-W ld option 49
-W m option changes default linker command
file 49, 378
-w option 52
ddump 450
-W s option changes default startup file 49, 260, 379
-W x,arguments option 51
-W x.ext compiler option 52
-W xfilename option 50
#warn preprocessor directive 125
#warning preprocessor directive 125
.warning assembler directive 346
warning messages 649
.warning section 371
-WC option 590
DCONFIG 584
default DCONFIG if not used 19
setting configuration language variables 581
specify configuration file 50
use for DCONFIG 50
vs. -WDDCONFIG 582
__wchar_t preprocessor predefined macro 122
wcstombs function 137, 573
wctomb function 573
-WD environment_variable command line option
overriding values of variables 32
-WD option 50, 287, 581, 590, 591
overriding environment variable value 18
setting configuration language variable 581
-WD variable option
overriding configuration variable 31
-WDDCONFIG option equivalent to -WC 582
-WDDENVIRON option
setting library search path 29
-WDDOBJECT option 287
-WDDOBJECT option setting -Xobject-format 294
-WDDOBJECT option, setting -Xobject-format 294
.weak assembler directive 346
weak pragma 138
COMDAT symbol may be treated as 370
.width assembler directive 346
windiss
compiling 459
disassembler mode
batch 464
interactive 465
simulator and disassembler 457
simulator mode
-b load binary file 460
-d debug using mask 460
-e entry point 462
-E specify endianity 462
-h load hex file 462
-M memory mask 462
-m memory specification 462
-ma automatic memory allocation 462
-mm memory map 462
-N windows priority 462
-q quiet mode 463
-s clock speed 463
-S stack address 463
-t target processor 463
-V print version 463
windiss/libwindiss.a library 476
Windows
configuration variable DCONFIG 19
directory separator character 590
environment variables
DIABTMPDIR 20
setting 18
installation 12
NT, installation 12
-Wm compiler option 268
.word assembler directive 347
write function 573
RAM-disk support, writing a buffer 271
X
-x option
ddump 449
-X options
- Xblock-count 66
disable 54
switch-table 111
table of, for embedded environment 257
-X 288, 385
-x 287
-Xa
See -Xdialect-k-and-r 76
-Xaddr-... 61
Xaddr 257
-Xaddr-code 241, 242
-Xaddr-const 241, 242
-Xaddr-data 241, 242
-Xaddr-sdata 241, 242
-Xaddr-string 241, 242
-Xaddr-user 241, 242
-Xadd-underscore 61
-Xalign-... 62
-Xalign-... 62
-Xalign-fill-text 289
-Xalign-min
packed structures 133
-Xalign-min-hardware-float 63
-Xalign-power2 289, 319
-Xalign-value 289, 318
-Xall-far-code-relative
See -Xcode-relative-far 70
-Xall-near-code-relative
See -Xcode-relative-near-all 71
-Xansi
See -Xdialect-k-and-r 76
-Xargs-... 63
-Xarray-align-min 64
-Xascii-charset
See -Xcharset-ascii 68
-Xasm-debug-... 289
-Xassociate-headers 387
-Xauto-align 289
-Xbitfield-compress
See --Xbit-fields-compress 65
-Xbitfield-no-optim
See -Xbit-fields-access-as-... 64
-Xbit-fields-... 64, 65
-Xbit-fields-signed 164, 221
-Xblock-count 13, 80, 203, 277
D-BCNT requirement 442
__dbini and __dbexit functions
requirement 444
-Xbool-is-... 66
-Xbool-off 121
-Xbottom-up-init 66
-Xbranch-islands... 387
-Xbss-... 67
-Xbss-common-off 369
-Xc
See -Xdialect-strict-ansi 76
-Xc++-old 67
old preprocessor 99
-Xchar-... 68, 162, 163
-Xcharset-ascii 68
-Xcheck-input-patterns 387
-Xcheck-overlapping 388
-Xclass-type-name-visible 68
-Xclib-optim-off 69
-Xcode-absolute... 69
-Xcode-absolute-far 241
-Xcode-absolute-near 241
-Xcode-relative-... 257
-Xcode-relative-far 70, 242, 252
-Xcode-relative-far-all 242, 252
-Xcode-relative-near 70, 241, 252
-Xcode-relative-near-all 242
-Xcoff 279, 388
-Xcomdat
in table of options related to template
instantiation 226
run-time type information collapsed
by 104
-Xcommon-align 388
-Xcompress-symbols 388
-Xcompress-symbols-... 388
-Xconservative-static-live 71
-Xconst-in-... 72
-Xconst-in-data 249
-Xconst-in-text 243, 248, 249, 257
-Xconventions-eabi 72
-Xcpp-dump-symbols 72
old preprocessor 99
-Xcpp-no-space 73
-Xcpu-... 290
-Xcrb6-... 73
-Xcrb6-always 178
-Xcrb6-float 178
-Xcrb6-never 178
-Xcritical-interrupts
See -Xinterrupt-funcs-use-rfci 88
-Xdata-absolute... 73
-Xdata-absolute-far 242
-Xdata-absolute-near 242
-Xdata-relative-... 74, 257
-Xdata-relative-far 242, 252
-Xdata-relative-near 242, 252
-Xdebug-... 75
-Xdebug-align 74
-Xdebug-dwarf... 75
-Xdefault-align 290, 308, 326
-Xdialect-... 76
-Xdialect-ansi 122, 595
See -Xfp-min-prec-long-double 83
-Xdialect-k-and-r 76, 595
-Xdialect-pcc 190, 596
-Xdialect-strict-ansi 76, 122, 150, 595
-Xdigraphs-... 76
-Xdollar-in-ident 76, 257
-Xdont-die 389
-Xdont-link 389
-Xdynamic-init 77
-Xeieio 77
-Xelf 279, 389
-Xelf-rela-... 389
-Xendian-little 79
-Xenum-is-... 78, 134, 162
-Xenum-is-int 163
-Xenum-is-small 162, 163
-Xexception
See -Xexceptions-off 79
-Xexceptions 227
-Xexceptions-... 79
-Xexplicit-inline-factor 79
-Xexpl-instantiations 390
in table of options related to template
instantiation 226
-Xextend-args 80, 83
-Xextern-in-place 390
-Xfar-code-relative
See -Xcode-relative-far 70
-Xfar-data-relative
See -Xdata-relative-far 74
-Xfeedback 80, 203, 277
-Xfeedback-... 81
-Xfix-bc-fw-mask-bug 290
-Xforce 82
-Xforce-prototypes 82
-Xforeign-as-ld 82
-Xfor-init-scope-... 82
-Xfp-... 83
-Xfull-pathname 84
-Xgenerate-paddr 390
-Xgenerate-vmap 390
-Xgnu-locals-... 291
-Xgnu-locals-off 303
-Xheader-... 291
-Xheader-format 296
-Xhi-mark
See -Xfeedback-frequent 81
-Xident-... 84
-Xieee754-pedantic 84
-Ximplicit-templates-... 84
in table of options related to template
instantiation 226
-Ximport 85
-Xincfile-missing-ignore 85
-Xinit-... 86
-Xinit-section 265
-Xinline 87, 184
inlining method 192
-Xinline-explicit-force 87
-Xinsert-nop-init 88
-Xinterrupt-funcs-use-rfci 88
-Xintrinsic-mask 88
-Xjmpbuf-size 88
-Xk-and-r
See -Xdialect-k-and-r 76
-Xkeep-assembly-file 88
-Xkeep-object-file 88
-Xkeywords 89, 143
-Xkill-opt 89, 191, 203
-Xkill-reorder 89, 204
-Xlabel-colon 292, 299, 317
-Xlabel-colon, allowing assembler directives to
start in column one 159
-Xlabel-colon-off 292, 317
-Xleading-underscore
See -Xunderscore-... 112
-Xlicense-wait 90
-Xline-format 292
-Xlint 91, 211
-Xlist-... 293
-Xllen 293
-Xlocal-data-area 92, 250
-Xlocals-on-stack 92, 171
-Xlocal-struct
See Xlocal-data-area 92
-Xlo-mark
See -Xfeedback-seldom 81
-Xmacro-arg-space-... 293, 353
-Xmacro-in-pragma 93
old preprocessor 99
-Xmacro-undefined-warn 93
-Xmake-dependency 93
old preprocessor 99
-Xmax-inst-level 94
-Xmax-long-branch 391
-Xmax-short-branch 391
-Xmember-max-align 94, 133, 257
-Xmemory-is-volatile 95, 257
-Xmin-align
See -Xalign-min 63
-Xmismatch-warning 95, 597
-Xmixed-compression 391
-Xname-... 95
-Xnamespace-... 96
-Xnear-code-relative
See -Xcode-relative-near 70
-Xnear-data-relative
See -Xdata-relative-near 74
-Xnested-interrupts 96
-Xno-bool
See -Xbool-off 66
-Xno-bss
See -Xbss-off 67
-Xno-common
See -Xbss-common-off 67
-Xno-diagraphs
See -Xdigraphs-off 76
-Xno-double
See -Xfp-float-only 83
-Xno-ident
See -Xident-off 84
-Xno-implicit-templates
See -Ximplicit-templates... 85
-Xno-long-double
See -Xfp-long-double-off 83
-Xno-optimized-debug
See -X optimized-debug . . . 97
-Xnop-end 87
-Xno-recognize-lib
See -Xclib-optim-off 69
-Xno-rtti
See -Xrtti-... 104
-Xno-wchar
See -Xwchar-t-... 114
-XO 19, 46, 51, 80, 90, 97, 98, 103, 111, 185, 200
inlines functions 193
sets -Xinline 87
-Xobject-format 294
-Xold-align 392
-Xold-scoping
See -Xfor-init-scope-... 82
-Xopt-count 97
-Xoptim-all 294
-Xoptimized-debug-... 97
-Xoptimized-load 392
-Xoptim-off 294
-Xpage-skip 294
-Xparse-size 98, 184, 602
-Xpass-source 40, 98, 117
-Xpcc
See -Xdialect-pcc 76
-Xpch-... 98
-Xpic-only 392
-Xplen 295
-Xpragma-section-... 99
-Xprefix-underscore-... 393
-Xprefix-underscore-coff 393
-Xprefix-underscore-elf 393
-Xpreprocess-assembly 99
-Xpreprocessor-lineno-off 99
-Xpreprocessor-old 99
-Xprof-all 100
-Xprof-all-fast 100
-Xprof-count 100
-Xprof-coverage 100
-Xprof-exec 101
-Xprof-feedback 101
-Xprof-snapshot 102
-Xprof-time 100
-Xprof-time-fast 100
-Xput-const-in-text 74
-Xreloc-bug 393
-Xremove-unused-sections 393
-Xrescan-... 394
-Xrescan-libraries 376
-Xrestart 103
-Xrtc 103, 263
-Xrtc=4 equivalent to -Xstack-probe 107
-Xrtti-... 104
-Xsection-align 394
-Xsection-pad 104
-Xsection-split 105
-Xsect-pri-... 105, 113, 114
-Xsemi-is-newline 295
-Xshow-target 105
-Xsigned-bitfields
See -Xbit-fields-signed 65
-Xsigned-char
See -Xchar-signed 68
-Xsize-opt 106, 185, 257
-Xsmall-const 106, 238, 257, 368
-Xsmall-const, r2 register accesses 181
-Xsmall-data 92, 106, 257, 368
-Xsmall-data, r13 register points to 182
-Xsoft-float 106
-Xspace-... 295
-Xspace-off 298, 317
-Xstack-probe 107, 257, 263
-Xstatic-addr-... 107
-Xstderr-fully-buffered 107
-Xstmw-... 107
-Xstop-on-warning 108, 395
-Xstrict-ansi
See -Xdialect-strict-ansi 76
-Xstrict-eabi 108
-Xstring-align 108
-Xstrings-in-text 250
-Xstrip-... 295
-Xstruct-... 108
-Xstruct-best-align 109
-Xstruct-max-align
See -Xmember-max-align 94
-Xstruct-min-align 110, 257
-Xstsw-... 110
-Xsubtitle 296
-Xsuppress-dot-... 395
-Xsuppress-path 395
-Xsuppress-section-names 395
-Xsuppress-underscore-... 395
-Xsuppress-warnings 110
-Xswap-cr-nl 110
-Xsyntax-warning-... 111
-Xt
See -Xdialect-k-and-r 76
-Xtab-size 296
-Xtarget 111
-Xtest-at-... 111
-Xtitle 296
-Xtrace-table 112, 257
-Xtrailing-underscore
See -Xunderscore-... 112
-Xtruncate 112
-Xunaligned-slow
See -Xalign-min 63
-Xunderscore-... 112
-Xunroll 113, 198
-Xunroll-size 113, 184, 198
-Xunsigned-bit-fields
See -Xbit-fields-unsigned 65
-Xunsigned-bitfields
See -Xbit-fields-unsigned 65
-Xunsigned-char
See -Xchar-unsigned 68
-Xunused-sections-... 396
-Xuse-double
See -Xfp-min-prec-double 83
See -Xfp-min-prec-long-double 83
-Xuse-float
See -Xfp-min-prec-float 83
-Xuse-.init
See -Xinit-section 86
-Xusing-std-... 113
-Xvoid-ptr-arith-ok 114
-Xwchar-off 122
-Xwchar_t-... 114
.xdef assembler directive 301, 302, 347
declaring ordinary external symbols 301
.xref assembler directive 347, 369
Y
-Y I option 53
-Y L option 53
-Y L option, search path for -l 382, 385
-y option
ddump 452
-Y P option 53
-Y P option, search path for -l 378, 382, 385
-Y U option 53
-Y U option, search path for -l 382, 385
y0 function 574
y0f function 574
y1 function 574
y1f function 574
-YI option 44
yn function 575
ynf function 575
Z
+z option
ddump 451
-z option
ddump 451
support@windriver.com
Copyright © 2002, Wind River Systems, Inc. All rights reserved.