create_module(2)

1CREATE_MODULE(2)             Linux Module Support             CREATE_MODULE(2)
2
3
4

NAME

6       create_module - create a loadable module entry
7

SYNOPSIS

9       #include <linux/module.h>
10
11       caddr_t create_module(const char *name, size_t size);
12

DESCRIPTION

14       create_module()  attempts to create a loadable module entry and reserve
15       the kernel memory that will be needed to hold the module.  This  system
16       call requires privilege.
17

RETURN VALUE

19       On success, returns the kernel address at which the module will reside.
20       On error -1 is returned and errno is set appropriately.
21

ERRORS

23       EEXIST A module by that name already exists.
24
25       EFAULT name is outside the program's accessible address space.
26
27       EINVAL The requested size is too  small  even  for  the  module  header
28              information.
29
30       ENOMEM The kernel could not allocate a contiguous block of memory large
31              enough for the module.
32
33       EPERM  The caller was not privileged (did not have  the  CAP_SYS_MODULE
34              capability).
35

CONFORMING TO

37       create_module() is Linux specific.
38

NOTES

40       This  system  call is only present on Linux up until kernel 2.4; it was
41       removed in Linux 2.6.
42