on Unix/linux:
ld -o [name of your CECIL executable] [your C object files and archives] lib<system name>.a -lm
Note: On Unix, linking with "-lm" is required since the Eiffel run-time uses the standard math libraries. You may need to link with other libraries (for example, on linux: with "-lbsd", in MT mode with "-lpthread" (posix threads) or "-lthread" (solaris)).
on Windows, with MS VC++:
link [your link flags] -OUT:[name of your cecil executable] [your C object files and archives] lib<system name>.lib [other Windows libraries]
on Windows with Borland:
ilink32 -ap -c -Tpe main.obj c0w32.obj, [name of your cecil executable],,EIFGEN\W_code\lib<system name>.lib CW32 IMPORT32 OLE2w32,,
Notes for compiling
CECIL C files:
The CECIL library is built automatically, which is unfortunately not
the case of the corresponding object files of the cecil program you
wrote.
The C flags to use are usually the same as the ones needed during the
compilation of the generated C-code plus those which are relevant to your own
C-code.
Typically, you will compile with your flags as below (if you are using gcc):
gcc -c -O -I$ISE_EIFFEL/studio/spec/$PLATFORM/include -I<SOME_INCLUDE_PATH> -D<SOME_FLAGS> your_file.c
or , if you are on Windows using MS VC++:
cl -c -nologo -Ox -I$ISE_EIFFEL\studio\spec\windows\include -I<SOME_INCLUDE_PATH> -D<SOME_FLAGS> your_file.c
or, if you are on Windows using Borland:
bcc32 -c -I$ISE_EIFFEL\studio\spec\windows\include -I<SOME_INCLUDE_PATH> -D<SOME_FLAGS> your_file.c
Sample: if you want to use the multithreaded facilities
of Eiffel, you should define the EIFFEL MT flags by adding "-DEIF_THREADS" to
the command line and follow the instructions of your C compiler and platform to
find out which additional flags you may need.
For example: on Solaris you need to add "-DSOLARIS_THREADS -D_REENTRANT".
You can specify a Makefile in your Ace file, so that your C files will be compiled automatically after the Eiffel compilation and before the final linking. Just add at the end of your Ace file in the external clause:
external: "$PATH_TO_MAKEFILE/your_makefile";
This makefile will be run from the $/EIFGEN/W_code or $/EIFGEN/F_code directory. You should not give the CECIL executable the same name as your system, because it will be replaced by the Eiffel executable when you run another compilation.
In the C file containing the "main" C function, you must add the following line to include the header file "eif_setup.h" provided with this example:
#include "eif_setup.h" /* Macros EIF_INITIALIZE and EIF_DISPOSE_ALL */ #include "eif_eiffel.h" /* Exported functions of the Eiffel run-time */
Your "main" function must have the three standard arguments of the C "main" function: "argc", "argv" and "envp" and include the following macros that are defined in "eif_setup.h":
int main(int argc, char **argv, char **envp)
/* Please respect this signature: `argc', `argv' and `envp' are used
* in EIF_INITIALIZE.
*/
{
/* declarations of variables */
/* Initialize the Eiffel run-time. */
EIF_INITIALIZE(failure)
/* body of your "main" function */
/* Reclaim the memory allocated by the Eiffel run-time. */
EIF_DISPOSE_ALL
}
Notes:
The above mentioned macros must imperatively be in the body of
the "main" function for the Eiffel exception handling mechanism to
work correctly.
You also need to add the Eiffel run time directory to the list of
directories in which the C compiler searches for include files. You can do so
by using the "-I" option of your C compiler.
You can only link one CECIL library into your C applications at
a time.
Caution: Even though external object files and archives are correctly specified in the "object" clause of the Ace file, you will need to explicitly link them to your C application.