Skip to content
This repository has been archived by the owner on Nov 19, 2024. It is now read-only.

Latest commit

 

History

History
42 lines (27 loc) · 1.08 KB

LoadSeg.md

File metadata and controls

42 lines (27 loc) · 1.08 KB
Raw

NAME

LoadSeg -- Scatterload a loadable file into memory

SYNOPSIS

    seglist = LoadSeg( name )
    D0                 D1

    BPTR LoadSeg(STRPTR)

FUNCTION

The file 'name' should be a load module produced by the linker. LoadSeg() scatterloads the CODE, DATA and BSS segments into memory, chaining together the segments with BPTR's on their first words. The end of the chain is indicated by a zero. There can be any number of segments in a file. All necessary relocation is handled by LoadSeg().

In the event of an error any blocks loaded will be unloaded and a NULL result returned.

If the module is correctly loaded then the output will be a pointer at the beginning of the list of blocks. Loaded code is unloaded via a call to UnLoadSeg.

INPUTS

name - pointer to a null-terminated string

RESULTS

seglist - BCPL pointer to a seglist

SEE ALSO

UnLoadSeg, InternalLoadSeg, InternalUnLoadSeg, CreateProc, CreateNewProc, NewLoadSeg.