loader_kg_define()

LOADER_$KG_DEFINE                 Domain/OS                  LOADER_$KG_DEFINE


NAME
     loader_$kg_define - add to the Known Global Table (KGT)

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

     void loader_$kg_define(
          char *global_name,
          short &name_length,
          void *&global_address,
          long &global_size,
          loader_$kg_define_opts &define_options,
          status_$t *status)

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

     procedure loader_$kg_define(
          in global_name: univ loader_$string;
          in name_length: loader_$string_index;
          in global_address: univ_ptr;
          in global_size: integer32;
          in define_options: loader_$kg_define_opts;
          out status: status_$t);

DESCRIPTION
     Loader_$kg_define adds a symbol or section named global_name to the KGT.

     global_name
          The name of the symbol or section to be added.

     name_length
          The number of bytes in global_name.

     global_address
          The address of the new global.

     global_size
          The number of bytes in the new global section.  To add a symbol,
          specify loader_$kg_symbol for global_size.

     define_options
          A small set of options that define symbol attributes.  Specify a
          combination of the following values:

          loader_$kg_keep_on_exec
               Keep the symbol in the Known Global Table (KGT) across UNIX
               exec(2) calls.

          loader_$kg_function
               Mark the symbol as a function.

     status
          The completion status.
Museum
