Next: Modifying Code in Up: Configuring a Kernel Previous: Debug versus Optimized

Useful Make Targets

The previously mentioned make targets (compose, depend, xkernel (the default)) are the minimal set necessary to build an x-kernel. This section describes some additional useful make targets.

Some of these descriptions refer to ``x-kernel system areas''. These areas contain source and object code shared by all users of the x-kernel. Each platform has four main system areas:

prot:
Code for the x-kernel protocols. (/usr/xkernel/protocols)

pi:

Platform-independent code common to all platforms. (/usr/xkernel/pi)

pxk:

Platform-specific code including device drivers and application programmer interfaces (APIs). (e.g., /usr/xkernel/mach3, /usr/xkernel/sunos, etc.)

user:

Platform-specific user libraries that can be linked with user applications to access the x-kernel through one of the x-kernel APIs. (e.g., /usr/xkernel/mach3/user) Not all platforms have such libraries.

These targets are all executed from a build directory.

prot, pi, pxk, user, libs:
Rebuilds any out-of-date source code in the indicated area. The target libs rebuilds code in the prot, pi, and pxk areas.

clean:

removes object files in the build directory.

protClean, piClean, pxkClean, userClean, allClean:

Removes object files, libraries and other generated files from the indicated area. The allClean target runs in all areas except the user area.

protCompose, piCompose, pxkCompose, allCompose:

Rebuilds ComposeFiles lists for the indicated area. These files group object files together so the compose program knows which files to link in for which protocols. These files are generated by the system make target during system installation, but they are only updated when these targets are run explicitly. The allCompose target runs in all areas except the user area.

protDepend, piDepend, pxkDepend, userDepend, allDepend:

Rebuilds the dependency lists in the indicated area. The allDepend target runs in all areas except the user area.

srcList, hdrList:

Builds files in the local build directory listing all of the active x-kernel source files. These targets will do nothing if the files already exist. To force the files to be rebuilt, use the targets SrcList and HdrList instead.

grep:

greps for the target G in all x-kernel source and header files produced by the srcList and hdrList targets.

Example usage:

make grep G="xCreate"

tags:

Creates an emacs tag file TAGS in the local build directory for all x-kernel source and header files produced by the srcList and hdrList targets.



Next: Modifying Code in Up: Configuring a Kernel Previous: Debug versus Optimized


Tue Nov 29 16:28:56 MST 1994