[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    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().