It would be nice if these files (or the relevant contents) could get incorporated into the KHG at some point.

To summarize, it looks like modules should be built with the following compiler options (at least, this is the way the Makefile for drv_hello.o goes):

-O6 -pipe -fomit-frame-pointer -Wall -DMODULE -D__KERNEL__ -DLINUX

Of the above, it seems likely that the key arguments are the -DMODULE -D__KERNEL__ and possibly the -O6 are actually needed. If you want to build your module with versioning support, add the following options:

-DMODVERSIONS -include /usr/include/linux/modversions.h

From the examples and docs, it looks like modules should be in the form:

#include   /* must be first! */
#include   /* optional? */
#include  /* ? */


/* More includes and the body of the driver go here. */

/* Note that any time a function returns a resource to the kernel
 * (for example, after a open),
 * call the MOD_INC_USE_COUNT; macro.  Whenever the
 * kernel releases the resource, call MOD_DEC_USE_COUNT;.
 * This prevents the module from getting removed
 * while other parts of the kernel still have
 * references to its resources.
 */


#ifdef MODULE  /* section containing module-specific code */

int
init_module(void)
{
        /* Module initialization code.
         * Registers drivers, symbols, handlers, etc. */
        return 0; /* on success */
}

void 
cleanup_module(void)
{
        /* Do cleanup and unregister anything that was
         * registered in init_module. */
}

#endif

Again, see the documentation scattered through the modules-2.0.0 package (and also presumably through the newer modutils-2.1.x packages) for more detailed information.