lighttpd2/include/lighttpd/module.h

#ifndef _LIGHTTPD_MODULE_H_
#define _LIGHTTPD_MODULE_H_

#include <lighttpd/settings.h>

#define MODULE_VERSION ((guint) 0x00000001)
#define MODULE_VERSION_CHECK(mods) do { \
		if (mods->version != MODULE_VERSION) { \
			ERROR(mods->main, "Version mismatch for modules system: is %u, expected %u", mods->version, MODULE_VERSION); \
			return FALSE; \
		} \
		if (mods->sizeof_off_t != (guint8)sizeof(off_t)) { \
			ERROR(mods->main, "Compile flags mismatch: sizeof(off_t) is %u, expected %u", (guint) sizeof(off_t), mods->sizeof_off_t); \
			return FALSE; \
		} \
	} while(0)

/** see module_load */
#define MODULE_DEPENDS(mods, name) do { \
	if (!module_load(mods, name)) { \
		ERROR(mods->main, "Couldn't load dependency '%s'", name); \
		return FALSE; \
	} } while(0)

struct module;
typedef struct module module;

struct modules;
typedef struct modules modules;

/** Type of plugin_init function in modules */
typedef gboolean (*ModuleInit)(modules *mods, module *mod);
typedef gboolean (*ModuleFree)(modules *mods, module *mod);

struct module {
	gint refcount;    /**< count how often module is used. module gets unloaded if refcount reaches zero. */
	GString *name;      /**< name of module, can be set my plugin_init */
	GModule *module;  /**< glib handle */
	gchar *path;      /**< path to the module file */

	gpointer config;  /**< private module data */
	ModuleFree free;  /**< if set by plugin_init it gets called before module is unloaded */
};

struct modules {
	guint version;    /**< api version */

	gpointer main;    /**< pointer to a application specific main structure, e.g. server */
	GArray *mods;      /**< array of (module*) */
	gchar *module_dir;

	guint8 sizeof_off_t; /** holds the value of sizeof(off_t) to check if loaded module was compiled with the same flags */
};

LI_API modules* modules_init(gpointer main, const gchar *module_dir);
LI_API void modules_cleanup(modules *mods);

/** Loads a module if not loaded yet and returns the module struct for it (after increasing refcount)
  * returns NULL if it couldn't load the module.
  *
  * You should release modules after you used them with module_release or module_release_name */
LI_API module* module_load(modules *mods, const gchar* name);

/* find module by name */
LI_API module *module_lookup(modules *mods, const gchar *name);

LI_API void module_acquire(module *mod);
LI_API void module_release(modules *mods, module *mod);
LI_API void module_release_name(modules *mods, const gchar* name);

#endif