serenity/Base/usr/share/man/man2/module_load.md at 50fa7598065757d65ad6c36395d269b51b4e80c2

mirror of https://github.com/RGBCube/serenity synced 2025-10-31 10:32:43 +00:00

Andreas Kling 0c22646e2b Base: Document EPERM error in module_load(2) and module_unload(2)

Only the superuser can use these system calls.

2020-01-02 12:35:19 +01:00

Name

module_load - load a kernel module

#include <serenity.h>

int module_load(const char* path, size_t path_length);

module_load() will load a kernel module from an ELF object file given its path in the filesystem.

If the module is successfully loaded, module_load() returns 0. Otherwise, it returns -1 and sets errno to describe the error.

EPERM: The calling process does not have superuser permissions.
EFAULT: path pointed to memory that was not accessible for the caller.
ENOEXEC: The specified file could not be parsed as an ELF object.
ENOENT: One or more symbols referred to by the module could not be resolved.
EINVAL: The module had no .text section, or didn't export a module_init function.
EEXIST: A module with the same name was already loaded.