kld(3) [freebsd man page]

KLD(3)							   BSD Library Functions Manual 						    KLD(3)

NAME

     kld_isloaded, kld_load -- kld utility functions

LIBRARY

     System Utilities Library (libutil, -lutil)

SYNOPSIS

     #include <libutil.h>

     int
     kld_isloaded(const char *name);

     int
     kld_load(const char *name);

DESCRIPTION

     These functions facilitate loading kernel modules from userland applications.

     The kld_isloaded() function takes a name and returns a non-zero value if a module of that name is currently loaded.  The name can be either
     the name of a module file (cpufreq.ko), the same name without the .ko extension (cpufreq), or the name of a module contained within that file
     (cpu/ichss).  Only the latter will return correct results if the module is compiled into the kernel.

     The kld_load() function is a simple wrapper around the kldload(2) function.  It returns zero if and only if the corresponding kldload() call
     succeeded or returned EEXIST (signifying that the requested module was already loaded).

SEE ALSO

     kldfirstmod(2), kldload(2), kldnext(2), kldstat(2), modfnext(2), modstat(2), kld(4)

HISTORY

     The kld_isloaded() and kld_load() functions first appeared in FreeBSD 6.3.

AUTHORS

     The kld_isloaded() and kld_load() functions and this manual page were written by Dag-Erling Smorgrav <des@FreeBSD.org>.

BSD
								 February 18, 2006							       BSD

KLDLOAD(2)                                                    BSD System Calls Manual                                                   KLDLOAD(2)

NAME

     kldload -- load KLD files into the kernel

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <sys/param.h>
     #include <sys/linker.h>

     int
     kldload(const char *file);

DESCRIPTION

     The kldload() system call loads a kld file into the kernel using the kernel linker.

RETURN VALUES

     The kldload() system call returns the fileid of the kld file which was loaded into the kernel.  If an error occurs, kldload() will return -1
     and set errno to indicate the error.

ERRORS

     The named file is loaded unless:

     [EPERM]            You do not have access to read the file or link it with the kernel.  You should be the root user to be able to use the kld
                        system calls.

     [EFAULT]           Bad address encountered when adding kld info into the kernel space.

     [ENOMEM]           There is no memory to load the file into the kernel.

     [ENOENT]           The file was not found.

     [ENOEXEC]          The file format of file was unrecognized.

     [EEXIST]           The supplied file has already been loaded.

SEE ALSO

     kldfind(2), kldfirstmod(2), kldnext(2), kldstat(2), kldsym(2), kldunload(2), modfind(2), modfnext(2), modnext(2), modstat(2), kld(4),
     kldload(8)

HISTORY

     The kld interface first appeared in FreeBSD 3.0.

BSD                                                                March 3, 1999                                                               BSD