Stack Item Notation

Alternate stack results shown with space, e.g. ( input -- addr len false | result true )

Alternate stack items shown without space, e.g. ( input -- addr len|0 result ).

Unknown stack item(s). 

Unknown stack item(s). If used on both sides of a stack comment, means the same stack items are present on both sides. 

Space delimiter. Leading spaces are ignored. 

Variable-aligned address. 

Memory address (generally a virtual address). 

Address and length for memory region 

byte bxxx

8-bit value (low order byte in a 32-bit word). 

7-bit value (low order byte), high bit unspecified. 

cnt len size

Count or length. 

dxxx

Double (extended-precision) numbers. 2 stack items, most significant cell on top of stack. 

<eol>

End-of-line delimiter. 

false

0 (false flag). 

ihandle

Pointer for an instance of a package. 

n n1 n2 n3

Normal signed values (32-bit). 

nu nu1

Signed or unsigned values (32-bit). 

<nothing>

Zero stack items. 

phandle

Pointer for a package. 

phys

Physical address (actual hardware address). 

phys.lo phys.hi

Lower/upper cell of physical address 

pstr

Packed string. 

quad qxxx

Quadlet (32-bit value). 

qaddr

Quadlet (32-bit) aligned address 

{text}

Optional text. Causes default behavior if omitted. 

"text<delim>"

Input buffer text, parsed when command is executed. Text delimiter is enclosed in <>. 

[text<delim>]

Text immediately following on the same line as the command, parsed immediately. Text delimiter is enclosed in <>. 

true

-1 (true flag). 

uxxx

Unsigned value, positive values (32-bit). 

virt

Virtual address (address used by software). 

waddr

Doublet (16-bit) aligned address 

word wxxx

Doublet (16-bit value, low order two bytes in a 32-bit word). 

x x1

Arbitrary stack item. 

x.lo x.hi

Low/high significant bits of a data item 

xt

Execution token. 

xxx?

Flag. Name indicates usage (e.g. done? ok? error?).

xyz-str xyz-len

Address and length for unpacked string. 

xyz-sys

Control-flow stack items, implementation-dependent. 

( C: -- )

Compilation stack diagram. 

( -- ) ( E: -- )

Execution stack diagram. 

( R: -- )

Return stack diagram.