loader_load() — Apollo

LOADER_$LOAD                      Domain/OS                       LOADER_$LOAD


NAME
     loader_$load - load a module

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

     void loader_$load(
          char *path_name,
          short &path_length,
          loader_$opts &load_options,
          loader_$handle_t *image_handle,
          status_$t *status)

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

     procedure loader_$load(
          in path_name: univ name_$long_pname_t;
          in path_length: integer;
          in load_options: loader_$opts;
          out image_handle: loader_$handle_t;
          out status: status_$t);

DESCRIPTION
     Loader_$load loads the object module at path_name.

     path_name
          The pathname of an object module.

     path_length
          The number of bytes in path_name.

     load_options
          A small set of options that affect how the module will be loaded.
          Specify a combination of the following values:

          loader_$copy_proc
               Copy the object module text into the address space, instead of
               mapping it.

          loader_$install
               Put all defined globals into the Known Global Table (KGT).

          loader_$no_unresolveds
               Do not load the module if it has unresolved globals.

          loader_$dont_redefine
               Do not redefine any already known symbols in the Known Global
               Table (KGT).

          loader_$load_writable
               Map the object module text in the address space as writable.

          loader_$keep_on_exec
               Keep the module loaded across UNIX exec(2) calls.

     image_handle
          A handle on the loaded image of the object module, used to refer to
          the image when making further calls on the loader.

     status
          The completion status.
Museum
