imake Examples

The following examples demonstrate how to create an Imakefile using single and multiple source files.

Using imake

The application in this example is composed of a single C source file, myprog.c, in the directory myprog. Writing an Imakefile is fairly straightforward.

1. Set the SRCS variable to the list of source files.

   In this case there is only one source file:

   SRCS = myprog.c

2. Specify how to build the executable.

   The macro you use depends on the type of binary you want. If you want to build a user-mode binary (for example myprog_u), use the UserActorTarget() macro, as illustrated in the following file extract. The first argument is the name of the executable and the second lists the object files. The third argument enables you to specify which libraries your program requires. In this example there is no library, therefore the argument is empty (you could also pass a NullParameter).

   UserActorTarget(myprog_u,myprog.o,) 

   In the following example, we will build a user-mode binary. If you want to build a supervisor-mode binary (for example, myprog_s.r), use the SupActorTarget() macro as shown. The arguments are the same as for UserActorTarget().

   SupActorTarget(myprog_s.r,myprog.o,)  

3. Use the Depend() macro to generate the Makefile dependencies.

   Depend($(SRCS))

   The Imakefile is now complete and looks as follows:

   SRCS = myprog.c
   UserActorTarget(myprog_u,myprog.o,)
   Depend($(SRCS))

4. Generate the Makefile with the ChorusOSMkMf tool.

   See the ChorusOSMkMf(1CC) man page for details of how to do this. In the myprog directory, type:

   % ChorusOSMkMf build_dir

   Where build_dir is the directory where you have built the ChorusOS system image on which your application will run.

5. Generate the make dependencies

   To do this type:

   % make depend

6. Compile and link the program

   To do this type:

   % make

   The compiled program is now in your myprog directory and ready to be executed.

Using imake with Multiple Source Files

If an application used source files located in several subdirectories, you need to create a root Imakefile in the root directory, containing only the following:

#define IHaveSubdirs
SUBDIRS = subdir1 subdir2 ...

Where subdir1, subdir2, ... are the subdirectories containing the source files (or other intermediate root Imakefile files). Next, create an Imakefile in each subdirectory containing source files. To generate the first Makefile, go to the root directory and type:

% ChorusOSMkMf build_dir

Next, populate the tree with Makefile files, generate dependencies and finally compile the programs by typing make Makefiles, make depend, and then make.

% make Makefiles   
% make depend   
% make

The compiled program is now ready to be executed.

Examples of Imakefiles which can be modified and used to build your own applications are provided in install_dir/chorus_family/src/opt/examples.