NewLoadSeg.md

NAME

NewLoadSeg -- Improved version of LoadSeg for stacksizes (V36)

SYNOPSIS

    seglist = NewLoadSeg(file, tags)
    D0                    D1    D2

    BPTR NewLoadSeg(STRPTR, struct TagItem *)

    seglist = NewLoadSegTagList(file, tags)
    D0                           D1    D2

    BPTR NewLoadSegTagList(STRPTR, struct TagItem *)

    seglist = NewLoadSegTags(file, ...)

    BPTR NewLoadSegTags(STRPTR, ...)

Links: TagItem TagItem

FUNCTION

Does a LoadSeg on a file, and takes additional actions based on the tags supplied.

Clears unused portions of Code and Data hunks (as well as BSS hunks). (This also applies to InternalLoadSeg and LoadSeg).

NOTE to overlay users: NewLoadSeg() does NOT return seglist in both D0 and D1, as LoadSeg does. The current ovs.asm uses LoadSeg, and assumes returns are in D1. We will support this for LoadSeg ONLY.

INPUTS

file - Filename of file to load tags - pointer to tagitem array

RESULT seglist - Seglist loaded, or NULL

BUGS No tags are currently defined.

SEE ALSO

LoadSeg, UnLoadSeg, InternalLoadSeg, InternalUnLoadSeg