MAN page from Old RedHat 7.X modutils-2.3.14-3.i386.rpm

INIT_MODULE

Section: Linux Module Support (2)
Updated: 26 Dec 1996
Index

NAME

init_module - initialize a loadable module entry

SYNOPSIS

#include <linux/module.h>int init_module(const char *name, struct module *image);

DESCRIPTION

init_moduleloads the relocated module image into kernel space and runs themodule's init function.

The module image begins with a module structure and is followed bycode and data as appropriate. The module structure is defined as follows:

struct module{  unsigned long size_of_struct;  struct module *next;  const char *name;  unsigned long size;  long usecount;  unsigned long flags;  unsigned int nsyms;  unsigned int ndeps;  struct module_symbol *syms;  struct module_ref *deps;  struct module_ref *refs;  int (*init)(void);  void (*cleanup)(void);  const struct exception_table_entry *ex_table_start;  const struct exception_table_entry *ex_table_end;#ifdef __alpha__  unsigned long gp;#endif};

All of the pointer fields, with the exception of next andrefs, are expected to point within the module body and beinitialized as appropriate for kernel space, i.e. relocated withthe rest of the module.

This system call is only open to the superuser.

RETURN VALUE

On success, zero is returned. On error, -1 is returned and errnois set appropriately.

ERRORS

EPERM: The user is not the superuser.
ENOENT: No module by that name exists.
EINVAL: Some image slot filled in incorrectly, image->name does notcorrespond to the original module name, some image->deps entrydoes not correspond to a loaded module, or some other similar inconsistency.
EBUSY: The module's initialization routine failed.
EFAULT: name or imageis outside the program's accessible address space.

This document was created byman2html,using the manual pages.