Home / Autodocs / exec.library
NAME
- InitResident
-
initialize resident module
SYNOPSIS
object = InitResident(resident, segList)
D0 A1 D1
APTR InitResident(struct Resident *,ULONG);
D0 A1 D1
APTR InitResident(struct Resident *,ULONG);
FUNCTION
Initialize a ROMTag. ROMTags are used to link system modules together. Each disk based device or library must contain a ROMTag structure in the first code hunk.
Once the validity of the ROMTag is verified, the RT_INIT pointer is jumped to with the following registers unless the RTF_AUTOINIT flag is set in rt_Flags:
Once the validity of the ROMTag is verified, the RT_INIT pointer is jumped to with the following registers unless the RTF_AUTOINIT flag is set in rt_Flags:
D0 = 0
A0 = segList
A6 = ExecBase
A0 = segList
A6 = ExecBase
INPUTS
- resident
-
Pointer to a ROMTag
- segList
-
SegList of the loaded object, if loaded from disk. Libraries & Devices will cache this value for later return at close or expunge time. Pass NULL for ROM modules.
RESULT
- object
-
Return value from the init code, usually the library or device base. NULL for failure.
NOTES
AUTOINIT FEATURE
An automatic method of library/device base and vector table initialization is also provided by InitResident(). The initial code hunk of the library or device should contain "MOVEQ #-1,d0; RTS;". Following that must be an initialized Resident structure with RTF_AUTOINIT set in rt_Flags, and an rt_Init pointer which points to four longwords. These four longwords will be used in a call to MakeLibrary();
An automatic method of library/device base and vector table initialization is also provided by InitResident(). The initial code hunk of the library or device should contain "MOVEQ #-1,d0; RTS;". Following that must be an initialized Resident structure with RTF_AUTOINIT set in rt_Flags, and an rt_Init pointer which points to four longwords. These four longwords will be used in a call to MakeLibrary();
-
The size of your library/device base structure including initial Library or Device structure.
-
A pointer to a longword table of standard, then library specific function offsets, terminated with -1L. (short format offsets are also acceptable)
-
Pointer to data table in InitStruct() format for initialization of Library or Device structure.
-
Pointer to library initialization function, or NULL. The initialization function is called with the following register configuration:
This function must return the library/device base in D0 to be linked into the respective library or device list. If the initialization function fails, the library or device memory must be manually deallocated, and NULL must be returned in D0.D0 = library base
A0 = segList
A6 = ExecBase
Deallocating the memory allocated for the library/device base works as follows:
struct Library * base;
FreeMem((BYTE *)base - base->lib_NegSize,
(LONG)base->lib_NegSize + (LONG)base->lib_PosSize);