Scroll to navigation

INIT_MODULE(2) Wsparcie dla modułów INIT_MODULE(2)

NAZWA

init_module - inicjalizacja wpisu ładowalnego modułu

SKŁADNIA

#include <linux/module.h>

int init_module(const char *name, struct module *image);

OPIS

init_module ładuje do przestrzeni jądra przesunięty obraz modułu i wykonuje funkcję init tego modułu.

Obraz modułu rozpoczyna się od struktury modułu, po której następują, odpowiednio, kod i dane. Struktura modułu jest zdefiniowana następująco:

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 };

Wszystkie pola wskazujące, oprócz next i refs, powinny wskazywać na adresy w ciele modułu i zostać zainicjalizowane odpowiednio dla przestrzeni adresowej jądra, tzn. przesunięte wraz z resztą modułu.

Ta funkcja jest dostępna jedynie dla superużytkownika.

RETURN VALUE

W przypadku sukcesu zwracane jest zero. W przypadku błędu, -1 i odpowiednio ustawiane jest errno.

BŁĘDY

Użytkownik nie jest superużytkownikiem.
Nie istnieje moduł o tej nazwie.
Któryś z wpisów image jest wypęłniony nieprawidłowo, image->name różni się od oryginalnej nazwy modułu, któryś z wpisów image->deps nie odpowiada żadnemu załadowanemu modułowi lub inna podobna niespójność.
Procedura inicjalizacji modułu zakończyła się niepowodzeniem.
name lub image znajduje się poza dostępną przestrzenią adresową.

ZOBACZ TAKŻE

create_module(2), delete_module(2), query_module(2).

26 grudnia 1996 Linux 2.1.17