Index

#pragma callee_saves

3.2.9 | 3.19 | 3.19

#pragma codeseg

#pragma constseg

#pragma disable_warning

#pragma exclude

3.13.2 | 3.19 | 3.19

#pragma less_pedantic

#pragma nogcse

3.2.8 | 3.19 | 3.19

#pragma noinduction

3.2.8 | 3.19 | 3.19 | 8.1.4

#pragma noinvariant

3.2.8 | 3.19

#pragma noiv

#pragma nojtbound

3.2.8 | 3.19 | 8.1.7

#pragma noloopreverse

#pragma nooverlay

3.8 | 3.8 | 3.9.1.4 | 3.19

#pragma opt_code_balanced

#pragma opt_code_size

#pragma opt_code_speed

#pragma pedantic_parse_number

3.19 | 3.19

#pragma preproc_asm

3.19 | 3.19

#pragma restore

3.19 | 3.19

#pragma save

3.19 | 3.19

#pragma sdcc_hash

3.19 | 3.19

#pragma stackauto

3.7 | 3.19

#pragma std_c89

#pragma std_c99

#pragma std_sdcc89

#pragma std_sdcc99

~ Operator

1.4 | 6.1

--acall-ajmp

3.2.4 | 8.1.13

--all-callee-saves

--c1mode

--callee-saves

3.2.9 | 3.14.2

--code-loc <Value>

3.2.3 | 3.4.1.9

--code-size <Value>

3.2.4 | 3.4.1.9

--codeseg <Value>

--compile-only

--constseg <Value>

--cyclomatic

--data-loc <Value>

3.2.3 | 3.4.1.9

--debug

3.1.1 | 3.1.5 | 3.2.9 | 4.6.2.5 | 5.1.1

--disable-warning

--dumlrange

3.2.10

--dumpall

3.2.10 | 7.1

--dumpdeadcode

--dumpgcse

--dumploop

--dumplrange

--dumprange

--dumpraw

--dumpregassign

--fdollars-in-identifiers

--float-reent

--funsigned-char

--i-code-in-asm

--idata-loc <Value>

--int-long-reent

3.2.9 | 3.9.1.4 | 3.15

--iram-size <Value>

3.2.4 | 3.4.1.9 | 3.12.1

--less-pedantic

--lib-path <path>

--main-return

3.2.9 | 3.12.1

--model-large

3.2.4 | 3.17.2.1.2

--model-medium

3.2.4

--model-small

3.2.4

--more-pedantic

--no-c-code-in-asm

--no-gen-comments

--no-pack-iram

3.2.3 | 3.2.4

--no-peep

3.2.8

--no-peep-comments

--no-std-crt0

3.12.3

--no-xinit-opt

3.2.8 | 3.12.1

--nogcse

--noinduction

--noinvariant

--nojtbound

--nolabelopt

--noloopreverse

--nooverlay

--nostdinc

--nostdlib

--opt-code-size

--opt-code-speed

--out-fmt-ihx

--out-fmt-s19

3.1.1 | 3.2.3 | 3.2.3

--pack-iram

3.2.3 | 3.2.4

--peep-asm

3.2.8 | 3.13.1

--peep-file

3.2.8 | 8.1.13

--print-search-dirs

2.7 | 3.2.9

--short-is-8bits

--stack-auto

3.2.5 | 3.2.9 | 3.7 | 3.9.1.4 | 3.15 | 3.18.1.2 | 3.19 | 8.2

--stack-loc <Value>

3.2.3 | 3.4.1.9

--stack-size <Value>

3.2.4

--std-c89

1.4 | 1.4 | 1.4 | 1.4 | 3.2.9 | 8.2 | 8.2

--std-c99

1.4 | 1.4 | 1.4 | 1.4 | 8.2 | 8.2

--std-sdcc89

--std-sdcc99

3.2.9 | 3.2.9

--use-stdout

3.2.9 | 3.2.11

--vc

3.2.9 | 3.2.11

--verbose

--Werror

--xdata-loc<Value>

3.4.1.9

--xram-loc <Value>

--xram-size <Value>

3.2.4 | 3.4.1.9

--xstack

3.2.4 | 3.2.5 | 3.4.1.4 | 3.18.1.2

--xstack-loc <Value>

-Aquestion(answer)

-C

-c --compile-only

-D<macro[=value]>

-dD

-dM

-dN

-E

3.2.2 | 3.2.9

-I<path>

-L --lib-path

-M

-mavr

-mds390

-mds400

-mgbz80

-mhc08

-MM

-mmcs51

-mpic14

-mpic16

-mxa51

-mz80

-o <path/file>

-pedantic-parse-number

-S

-Umacro

-V

-Wa asmOption[,asmOption]

-Wl linkOption[,linkOption]

-Wp preprocessorOption[,preprocessorOption]

8031, 8032, 8051, 8052, mcs51 CPU

1.1

<file> (no extension)

<file>.adb

3.1.1 | 5.1.1

<file>.asm

<file>.cdb

3.1.1 | 5.1.1

<file>.dump*

<file>.ihx

3.1.1 | 3.1.2

<file>.lib

3.1.4

<file>.lnk

3.1.3

<file>.lst

3.1.1 | 3.6

<file>.map

3.1.1 | 3.4.1.9 | 3.6

<file>.mem

3.1.1 | 3.4.1.9

<file>.o

<file>.rel

3.1.1 | 3.1.3 | 3.1.4

<file>.rst

3.1.1 | 3.6

<file>.sym

<stdio.h>

3.17.2.1.1

__ (prefix for extended keywords)

__asm

3.13.1 | 3.13.1 | 3.13.1 | 3.13.2 | 3.13.3

__at

3.4.1.7 | 3.4.1.7 | 3.4.2.2 | 3.6 | 3.6 | 3.6 | 3.13.1

__bit

__code

__critical

3.10.1

__data (hc08 storage class)

__data (mcs51, ds390 storage class)

no title | 3.4.1.9

__ds390

__endasm

3.13.1 | 3.13.1 | 3.13.1 | 3.13.2 | 3.13.3 | 3.13.3

__far (storage class)

no title | 3.13.1

__hc08

__idata (mcs51, ds390 storage class)

no title | 3.4.1.9

__interrupt

3.4.1.9 | 3.9.1 | 3.13.2

__mcs51

__naked

3.13.2 | 3.19

__near (storage class)

__pdata (mcs51, ds390 storage class)

__sbit

1.4 | no title

__sfr

no title | no title | no title | no title

__sfr16

__sfr32

__using (mcs51, ds390 register bank)

3.4.1.9 | 3.9.1 | 3.9.2 | 3.11

__xdata (hc08 storage class)

__xdata (mcs51, ds390 storage class)

no title | 3.4.1.9 | 3.6

__z80

_asm

3.10.2 | 3.13.1 | 3.13.1 | 3.13.1 | 3.13.2 | 3.13.3

_endasm

3.10.2 | 3.13.1 | 3.13.1 | 3.13.1 | 3.13.2 | 3.13.3 | 3.13.3

_naked

3.13.2 | 3.19

_sdcc_external_startup()

3.12.1

_XPAGE (mcs51)

4.1.1

Absolute addressing

no title | 3.7

ACC (mcs51, ds390 register)

Aligned array

3.6 | 3.13.1 | 3.13.1

Annotated syntax tree

Parsing

ANSI-compliance

1.4 | no title

Any Order Bit

AOMF, AOMF51

3.1.1 | 3.2.9 | 5. | 5.

Application notes

6.6

aslink

1.1 | 6.3

Assembler documentation

3.13.1 | 6.3

Assembler listing

3.1.1 | 3.1.1

Assembler options

Assembler routines

3.10.2 | no title | no title | 8.1.13

Assembler routines (non-reentrant)

3.14.3

Assembler routines (reentrant)

3.14.4

Assembler source

asXXXX (as-gbz80, as-hc08, asx8051, as-z80)

1.1 | 3.13.1 | 6.3

at

3.4.1.7 | 3.4.1.7 | 3.4.2.2 | 3.6 | 3.6 | 3.6 | 3.6 | 3.6 | 3.7 | 3.13.1

atomic

3.9.1.2 | 3.10.3 | 3.10.3

AVR

B (mcs51, ds390 register)

backfill unused memory

3.1.2

banked

4.1.3.2

Bankswitching

4.1.3

Basic blocks

3.2.10 | 9.2

bit

1.4 | 3.2.3 | no title | 3.4.1.9 | 3.6 | 3.6 | 6.1

Bit rotation

Bit shifting

Bit toggling

1.4

bitfields

3.4.1.6

block boundary

3.6

Bug reporting

Building SDCC

Byte swapping

C FAQ

6.5

C Reference card

6.5

Carry flag

3.4.1.7

Changelog

7.5

checksum

3.1.2

cmake

code

3.2.3 | 3.2.9 | no title

code banking

4.1.3

code banking (limited support)

1.7

code page (pic14)

Command Line Options

Compatibility with previous versions

Compiler internals

compiler.h (include file)

6.1

const

Copy propagation

cpp

see sdcpp

critical

3.10.1

cvs

see Subversion

Cyclomatic complexity

3.2.9 | no title

d52

d52 (disassembler)

data (hc08 storage class)

data (mcs51, ds390 storage class)

3.2.3 | no title | 3.4.1.9

DDD (debugger)

5.1.6 | 6.4

Dead-code elimination

3.2.10 | no title | ICode

Debugger

3.1.1 | 5.1

Defines created by the compiler

DESTDIR

2.2

Division

3.8 | 3.9.1.4

Documentation

no title | no title

double (not supported)

download

7. | 7.1

doxygen (source documentation tool)

DPTR

3.14.1 | 4.1.2 | 8.1.10

DPTR, DPH, DPL

3.14.1 | 3.14.3

DS390

Options

--model-flat24: 3.2.5
--protect-sp-update: 3.2.5
--stack-10bit: 3.2.5
--stack-probe: 3.2.5
--tini-libid: 3.2.5
--use-accelerator: 3.2.5

DS390 memory model

DS400

4.2

DS80C390

DS80C400

3.2.1 | 4.2 | 6.6

DS89C4x0

6.6

dynamic memory allocation (malloc)

ELF format

Emacs

Endianness

Environment variables

Examples

no title | 7.9

External stack (mcs51)

far (storage class)

no title | 3.13.1

Feature request

1.7 | no title

Flags

3.4.1.7

Flat 24 (DS390 memory model)

3.18.2

Floating point support

3.9.1.4 | no title | 3.17.2.1.2 | 8.2

FPGA (field programmable gate array)

FpgaC ((subset of) C to FPGA compiler)

function epilogue

3.2.9 | 3.13.2

function parameter

no title | 3.7 | 3.14.3 | 3.14.4

function pointer

3.4.1.8

function pointers

function prologue

3.2.9 | 3.13.2 | 3.19

GBZ80

Options

--callee-saves-bc: 3.2.7
--codeseg <Value>: 3.2.7
--constseg <Value>: 3.2.7
-ba <Num>: 3.2.7
-bo <Num>: 3.2.7

gbz80 (GameBoy Z80)

3.2.1 | 4.3

gcc (GNU Compiler Collection)

gdb

5.1

generic pointer

getchar()

3.17.2.1.1

Global subexpression elimination

3.2.10

GNU General Public License, GPL

1.2

GNU Lesser General Public License, LGPL

3.17.4

gpsim (pic simulator)

gputils (pic tools)

4.5.4 | 6.4

HC08

3.2.1 | 3.2.3 | 3.4.3.1 | no title | 3.12.2 | 4.4

interrupt

3.9.3 | 3.10.2

Options

--out-fmt-elf: 3.2.3

Storage class

HD64180 (see Z180)

Header files

3.4.1.7 | 6.1 | 6.2

heap (malloc)

3.17.2.2

Higher Order Byte

Higher Order Word

Highest Order Bit

HTML version of this document

I/O memory (Z80, Z180)

3.4.2.1

ICE (in circuit emulator)

iCode

3.2.10 | no title | Code | Code | no title

idata (mcs51, ds390 storage class)

3.2.3 | no title | 3.4.1.9

IDE

3.2.9 | 6.6

Include files

3.4.1.7 | 6.1 | 6.2

indent (source formatting tool)

inline (not supported)

8.2 | 8.2

Install paths

Install trouble-shooting

Installation

instruction cycles (count)

int (16 bit)

int (64 bit) (not supported)

Intel hex format

3.1.1 | no title | 3.2.3 | 5.1.3

Intermediate dump options

interrupt

3.4.1.9 | 3.8 | 3.9.1 | 3.9.2 | 3.10.1 | 3.10.2 | 3.10.3 | 3.11 | 3.13.1 | 3.13.2 | 3.15 | 3.19 | 3.19

interrupt jitter

3.10.2

interrupt latency

3.10.2

interrupt mask

3.10.2

interrupt priority

3.10.2 | 3.11

interrupt vector table

3.2.3 | 3.9.1 | 3.9.2 | 3.19

interrupts

3.11

jump tables

8.1.7

K&R style

Labels

3.13.3

Libraries

no title | 3.2.3 | 3.2.9 | 3.4.1.8 | no title | 3.17.4

Linker

3.1.3

Linker documentation

6.3

Linker options

lint (syntax checking tool)

3.2.9 | 5.

little-endian

Live range analysis

3.2.10 | 3.2.10 | 8.4 | no title | ICode

local variables

no title | 3.7 | 3.8 | 3.18.1.2 | 6.

lock

3.10.3

long (32 bit)

long long (not supported)

Loop optimization

3.2.10 | no title | ICode

Loop reversing

3.2.8 | no title

Mailing list(s)

7. | 7.4

main return

Makefile

malloc.h

MCS51

MCS51 memory

MCS51 memory model

MCS51 options

MCS51 variants

no title | 8.1.13

Memory bank (pic14)

Memory map

3.1.1 | 6.1

Memory model

3.4.1.8 | 3.8 | no title | no title

Microchip

4.5 | 4.6

Modulus

3.9.1.4

Motorola S19 format

3.1.1 | 3.2.3

MSVC output style

Multiplication

3.8 | 3.9.1.4 | 8.1.4 | ICode

naked

3.14.2

Naked functions

near (storage class)

Nibble swapping

objdump (tool)

3.1.1 | 6.4

Object file

Optimization options

Optimizations

no title | no title

Options assembler

Options DS390

Options GBZ80

Options intermediate dump

Options linker

Options MCS51

Options optimization

Options other

Options PIC16

Options preprocessor

Options processor selection

Options SDCC configuration

Options Z80

Oscilloscope

Other SDCC language extensions

Overlaying

P2 (mcs51 sfr)

3.4.1.4 | 3.18.1.2 | 4.1.1

packihx (tool)

3.1.2 | 6.2

Parameter passing

Parameters

Parsing

Patch submission

7. | 7.3 | 7.9

pdata (mcs51, ds390 storage class)

3.2.3 | 3.2.4 | no title | 3.18.1.2 | 4.1.1

PDF version of this document

pedantic

3.2.2 | 3.2.9 | 3.2.9 | 3.19 | 3.19

Peephole optimizer

3.2.8 | 3.13.1 | no title

PIC

4.6

PIC14

3.2.1 | no title | 4.5 | 4.5.7.2

interrupt

4.5.3

Options

--debug-extra: 4.5.5
--no-pcode-opt: 4.5.5
--stack-loc: 4.5.5
--stack-size: 4.5.5

PIC16

3.2.1 | no title | 4.6.4 | 4.6.5 | 4.6.6 | 4.6.7 | 4.6.8 | 4.6.12 | 4.6.14 | 6.3

Header files

interrupt

Libraries

MPLAB

Options

--callee-saves: 4.6.1
--fommit-frame-pointer: 4.6.1

Pragmas

#pragma code: 4.6.6
#pragma stack: 4.6.6

shadowregs

4.6.12

stack

4.6.11 | 4.6.17.1

wparam

4.6.12

Pointer

no title | 3.4.1.8

Pragmas

Preprocessor options

printf

printf()

printf_fast() (mcs51)

printf_fast_f() (mcs51)

printf_small()

printf_tiny() (mcs51)

Processor selection options

project workspace

promotion to signed int

3.13.1 | 3.13.1 | 6.

push/pop

3.13.1 | 3.13.2 | 3.19 | 3.19

putchar()

3.17.2.1.1

Quality control

reentrant

3.2.9 | 3.2.9 | 3.7 | 3.7 | 3.8 | 3.14.3 | 3.14.4 | 3.15 | 3.18.1.1 | 8.2

Register allocation

8.1.4 | no title | ICode

Register assignment

3.2.10

register bank (mcs51, ds390)

3.4.1.9 | 3.7 | 3.11

Regression test

4.3 | 6.3 | 7.9 | 7.10

Regression test (PIC14)

7.9

Regression test (PIC16)

Related tools

Release policy

Reporting bugs

Requesting features

1.7 | no title

return value

3.14.1 | 8.2

rotating bits

8.1.9

Runtime library

3.12.1 | 3.12.1

s51

2.9.4 | 2.9.5

sbit

1.4 | no title

SDCC

SDCC Wiki

7.7

SDCC_ds390

SDCC_HOME

SDCC_INCLUDE

SDCC_INT_LONG_REENT

SDCC_LEAVE_SIGNALS

SDCC_LIB

SDCC_mcs51

SDCC_MODEL_FLAT24

3.20 | 3.20

SDCC_MODEL_LARGE

SDCC_MODEL_MEDIUM

SDCC_MODEL_SMALL

SDCC_PARMS_IN_BANK1

SDCC_REVISION

SDCC_STACK_AUTO

SDCC_STACK_TENBIT

SDCC_USE_XSTACK

SDCC_z80

sdcclib

no title | 3.1.5 | 3.1.5 | 3.1.5

SDCDB (debugger)

2.9.5 | no title | 6.3 | 6.4

sdcpp (preprocessor)

2.9.2 | no title | 3.2.2 | 3.19

Search path

semaphore

sfr

no title | no title | no title | no title | 4.1.1

sfr16

sfr32

signal handler

sloc (spill location)

3.2.8

splint (syntax checking tool)

3.2.9 | 5. | 6.4

srecord (bin, hex, ... tool)

3.1.1 | 3.1.1 | 3.1.2 | 3.2.3 | 6.4

stack

3.2.3 | 3.2.9 | 3.4.1.3 | 3.4.1.9 | 3.7 | 3.7 | 3.9.1.3 | 3.9.2 | 3.10.1 | 3.10.2 | no title | 8.1.4

stack overflow

3.9.1.3

Startup code

static

3.7

Status of documentation

1.1 | 2.6

Storage class

no title | 3.7 | 3.8 | 3.18.1.1

Strength reduction

8.1.4 | ICode

struct

Subexpression

8.1.6

Subexpression elimination

3.2.8 | no title

Subversion code repository

7. | 7.6

Support

swapping nibbles/bytes

switch statement

3.2.8 | no title | 8.1.7

Symbol listing

tabulator spacing (8 columns)

2.4.4

Test suite

7.9

Tinibios (DS390)

3.18.2

TLCS-900H

TMP, TEMP, TMPDIR

Tools

Trademarks

10.

type conversion

1.4

type promotion

1.4 | 3.9.1.4 | 3.13.1 | 3.13.1 | 6.

Typographic conventions

uCsim

6.2 | 6.3

union

UnxUtils

2.4.5

USE_FLOATS

using (mcs51, ds390 register bank)

3.4.1.9 | 3.9.1 | 3.9.2 | 3.11

vararg, va_arg

1.4 | 6.1

Variable initialization

3.2.8 | 3.6 | 3.12.1

version

2.7 | 7.5

volatile

3.6 | 3.6 | 3.9.1.1 | 3.10.3 | 3.13.2

VPATH

Warnings

warranty

1.2

watchdog

3.12.1

wiki

7.7 | 8.4

XA51

xdata (hc08 storage class)

xdata (mcs51, ds390 storage class)

3.2.3 | no title | 3.4.1.9 | 3.6 | 3.6 | 3.12.1

XEmacs

xstack

Z180

I/O memory

Options

--portmode: 3.4.2.3

Pragmas

#pragma portmode: 3.4.2.3

Z80

3.2.1 | no title | 3.4.2.1 | 3.9.4 | 3.12.3 | 4.3

I/O memory

3.4.2.1

interrupt

3.9.4

Options

--asm=<Value>: 3.2.6
--callee-saves-bc: 3.2.6
--codeseg <Value>: 3.2.6
--constseg <Value>: 3.2.6
--no-std-crt0: 3.2.6 | 3.2.7
--portmode=<Value>: 3.2.6

return value

4.3

stack

4.3

Storage class