Museum

LOADER_$UNLOAD                    Domain/OS                     LOADER_$UNLOAD


NAME
     loader_$unload - unload a loaded module

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/loader.h>

     void loader_$unload(
          loader_$handle_t &image_handle,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/loader.ins.pas';

     procedure loader_$unload(
          in handle: loader_$handle_t;
          out status: status_$t);

DESCRIPTION
     loader_$unload unloads an  object module, specified by image_handle,
     loaded earlier by loader_$load or loader_$cond_load. The object module
     must be in Common Object File Format, must have been loaded with the
     loader_$no_dynamic option, and must not have been loaded with the
     loader_$keep_on_exec option.

     image_handle
          Specifies which object module image should be removed from memory.

     status
          The completion status.

NOTES
     loader_$unload will not remove any Known Global Table (KGT) entries
     created by loading a module with the loader_$install option.

SEE ALSO
     loader_$load, loader_$cond_load