qlink is used to link IR modules together.
Syntax
qlink [options] file_name.file_extension
Possible options
-? [ --usage ] |
displays usage information |
-V [ --version ] |
shows versions of the linker and code generator as well as Lycia build number and hash value |
-v [ --verbose ] |
produces verbose output (detailed compilation information) |
-d [ --database-driver ] arg |
sets database driver for compilation |
--verify |
verifies output |
--errors arg (=default) |
verifies function resolution |
-o [ --output ] arg |
determines the output file |
-l [ --lib ] arg |
links dynamic C libraries |
-m [ --merge ] |
merges the source files |
Usage and examples
To link 4gl files together, the following command must be called:
qlink -o x.4a a.4o b.4o c.4o
where a.4o, b.4o, and c.4o are files statically linked together to form the IR module x.4a.
If this command is invoked:
qlink-ox.4aa.4ob.4o-libc.4o
a.4o and b.4o will be statically linked into x.4a, whereas c.4o will be dynamically linked to x.4a. Thus, x.4a will contain two IR modules as well as a runner (necessary to execute x.4a directly by the operating system).
When you specify a file name, be careful with its case.
UNIX is case-sensitive, so it will treat files which names come in different cases as separate files.
--verify is used to check for duplicated function declarations and for function calls for which functions are not defined. If omitted, the program will compile normally even if it includes duplicated functions or calls for missing functions. Otherwise, names and locations of duplicated functions will be reported, though this will not prevent the successful compilation. In both cases, duplicated or missing functions will produce a runtime error.
-d is only used for validation purposes: The compiled program can be run against any database server available, either by using qfgl -d, or by setting the LYCIA_DB_DRIVER environment variable.
-V is used to obtain basic info about Lycia - version of the linker, code generator version, Lycia build number, and hash value:
Linker Version: 7.1
Code Generator Version: 50
Build: 7.1.6672 00ec5b5 (rel)
Hash: 00ec5b538ab9e2fc7f3bf4e988296527c774cea6