Commodore Amiga A500 Technical Reference Manual page 62

We hope to eventually try and boot off a disk device. We will try and
boot off of each device in turn, based on priority,
if
there is no boot
floppy in the floppy disk drive. As of this writing that facility does not
yet exist.
There is only one additional piece of magic done by AddDosNode.
If
there is no executable code specified in the deviceNode structure
(e.g. dnSegList, d~Handler, and dn_Task are all null) then the stan-
dard dos file handler is used for your device.
Documentation note: a "task" as used here is a dos-task, not an exec-
task.
A
dos-task, in the strictest sense, is the "address of an exec-
style message port. In general,
it
is a pointer to a process's
pr-MsgPort field (e.g. a constant number of bytes after an exec
port).
INPUTS
bootPri
-
a
BYTE
quantity with the boot priority for this disk.
This priority is only for which disks should be looked at: the actual
disk booted from will be the first disk with a valid boot block. If
no disk is found then the "bootme" hand will come up and the
bootstrap code will wait for a floppy to be inserted. Recommend
priority assignments are:
+
5
-
unit zero for the floppy disk. The floppy should always
be highest priority to allow the user to abort out of a hard disk
boot.
0
-
the run of the mill hard disk
-5
-
a "network" disk (local disks should take priority).
-1 28
-
don't even bother to boot from this device.
flags
-
additional flag bits for the call:
ADN-TARTPROC (bit
0)
-
start a handler process imme-
diately.
Normally the process is started only when the device node is
first referenced. This bit is meaningless
if
you have already
specified a handler process (non-null d ~ T a s k ) .
deviceNode
-
a legal DOS device node, properly initialized.
Typically this will be the result of a MakeDosNode() call, but feel
free to manufacture your own
if
you need to. If deviceNode is null
then AddDosNode does nothing.
RESULTS
ok
-
non-zero everything went ok, zero
if
we ran out of memory or
some other weirdness happened.