static void init(const char* execName);This function initializes the linker module by telling it where the executable for this program is. For most purposes, passing it the value of
argvpassed to the
mainfunction will suffice.
static int linkObj(const char* objName);Link in a single object module using the temporary link mechanism (this entry point is provided for backward compatibility).
static int multiLink(const char* args, int permanent);Both of these functions give access to the main function for doing an incremental link. They permit either a temporary or a permanent link of multiple files; flags to the Unix linker such as
static int multiLink(int argc, char** argv);
-lto specify a library or
-Lto specify a search directory for libraries are permitted. For the first form,
argsare passed as part of a linker command that is expanded by the Unix shell. A permanent link is performed if
permanentis true (nonzero); otherwise a temporary link is performed. The second form is provided for ease of interfacing to the Tcl interpreter, which likes to pass arguments to commands in this style. In this case,
argvindicates the type of link: if it begins with the character
p,a permanent link is performed; otherwise a temporary link is performed. The remaining arguments are concatenated (separated by spaces) and appear in the argument to the Unix linker.
static int isActive();This function returns TRUE if the linker is currently active (so objects can be marked as dynamically linked by the known list classes). Actually the flag it returns is set while constructors or other functions that have just been linked are being run.
static int enabled();Returns true if the linker is enabled (it is enabled by calling
Linker::initif that function returns successfully). On platforms that do not support dynamic linking, this function always returns false (zero).
static const char* imageFileName();Return the fully-expanded name of the executable image file (set by
static void setDefaultOpts(const char* newValue);These functions set or return the linker's default options, a set of flags appended to the end of the command line by all links.
static const char* defaultOpts();