User guide

Names and Symbols
The following table lists typographical conventions used for names of various
items throughout this manual.
Items Example
Bits sysBus<32:2>
Commands boot command
Command arguments address argument
Command options -sb option
Environment variables AUTO_ACTION
Environment variable values HALT
Files and pathnames
/usr/foo/bar
Pins LIRQ pin
Register symbols VIP_ICR register
Signals iogrant signal
Variables n, x, mydev
Note
Notes emphasize particularly important information.
Numbering
Numbers are decimal or hexadecimal unless otherwise indicated. The prefix
0x indicates a hexadecimal number. For example, 19 is decimal, but 0x19 and
0x19A are hexadecimal (see also Addresses). Otherwise, the base is indicated by
a subscript; for example,
2
is a binary number.
Ranges and Extents
Ranges are specified by a pair of numbers separated by two periods (..) and are
inclusive. For example, a range of integers 0..4 includes the integers 0, 1, 2, 3,
and 4.
Extents are specified by a pair of numbers in angle brackets (<>) separated by a
colon (:) and are inclusive. Bit fields are often specified as extents. For example,
bits <7:3> specifies bits 7, 6, 5, 4, and 3.
Register and Memory Figures
Register figures have bit and field position numbering starting at the right
(low-order) and increasing to the left (high-order).
Memory figures have addresses starting at the top and increasing toward the
bottom.
xxv