diff options
author | des <des@FreeBSD.org> | 2006-02-18 11:25:28 +0000 |
---|---|---|
committer | des <des@FreeBSD.org> | 2006-02-18 11:25:28 +0000 |
commit | 748c235cfd99c801088fb73c735a91b031cac89b (patch) | |
tree | f8e33dca170a81252d62b0bdc19991f3521db36b /lib | |
parent | 5729ae2a57c3327356e04ecd66634c4ee8ad5cbb (diff) | |
download | FreeBSD-src-748c235cfd99c801088fb73c735a91b031cac89b.zip FreeBSD-src-748c235cfd99c801088fb73c735a91b031cac89b.tar.gz |
Add utility functions for checking if a given kernel module is loaded,
and loading it.
Diffstat (limited to 'lib')
-rw-r--r-- | lib/libutil/Makefile | 5 | ||||
-rw-r--r-- | lib/libutil/kld.3 | 98 | ||||
-rw-r--r-- | lib/libutil/kld.c | 74 | ||||
-rw-r--r-- | lib/libutil/libutil.h | 5 |
4 files changed, 180 insertions, 2 deletions
diff --git a/lib/libutil/Makefile b/lib/libutil/Makefile index ebbcf55..8da897e 100644 --- a/lib/libutil/Makefile +++ b/lib/libutil/Makefile @@ -6,19 +6,20 @@ SHLIB_MAJOR= 5 SHLIBDIR?= /lib CFLAGS+=-DLIBC_SCCS -I${.CURDIR} -I${.CURDIR}/../libc/gen/ CFLAGS+=-DINET6 -SRCS= _secure_path.c auth.c fparseln.c humanize_number.c login.c \ +SRCS= _secure_path.c auth.c fparseln.c humanize_number.c kld.c login.c \ login_auth.c login_cap.c login_class.c login_crypt.c login_ok.c \ login_times.c login_tty.c logout.c logwtmp.c \ pidfile.c property.c pty.c pw_util.c realhostname.c stub.c \ trimdomain.c uucplock.c INCS= libutil.h login_cap.h -MAN+= login.3 login_auth.3 login_tty.3 logout.3 logwtmp.3 pty.3 \ +MAN+= kld.3 login.3 login_auth.3 login_tty.3 logout.3 logwtmp.3 pty.3 \ login_cap.3 login_class.3 login_times.3 login_ok.3 \ _secure_path.3 uucplock.3 property.3 auth.3 realhostname.3 \ realhostname_sa.3 trimdomain.3 fparseln.3 humanize_number.3 \ pidfile.3 MAN+= login.conf.5 auth.conf.5 +MLINKS+= kld.3 kld_isloaded.3 kld.3 kld_load.3 MLINKS+= property.3 properties_read.3 property.3 properties_free.3 MLINKS+= property.3 property_find.3 MLINKS+= auth.3 auth_getval.3 diff --git a/lib/libutil/kld.3 b/lib/libutil/kld.3 new file mode 100644 index 0000000..c3cc3a7 --- /dev/null +++ b/lib/libutil/kld.3 @@ -0,0 +1,98 @@ +.\"- +.\" Copyright (c) 2006 Dag-Erling Coïdan Smørgrav +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd February 18, 2006 +.Os +.Dt KLD 3 +.Sh NAME +.Nm kld_isloaded , +.Nm kld_load +.Nd kld utility functions +.Sh LIBRARY +.Lb libutil +.Sh SYNOPSIS +.In libutil.h +.Ft int +.Fn kld_isloaded "const char *name" +.Ft int +.Fn kld_load "const char *name" +.Sh DESCRIPTION +These functions facilitate loading kernel modules from userland +applications. +.Pp +The +.Fn 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 +.Po +.Va cpufreq.ko +.Pc , +the same name without the +.Pa .ko +extension +.Po +.Va cpufreq +.Pc , +or the name of a module contained within that file +.Po +.Va cpu/ichss +.Pc . +Only the latter will return correct results if the module is compiled +into the kernel. +.Pp +The +.Fn kld_load +function is a simple wrapper around the +.Fn kldload +function. +It returns zero if and only if the corresponding +.Fn kldload +call succeeded or returned +.Er EEXIST +(signifying that the requested module was already loaded). +.Sh SEE ALSO +.Xr kldfirstmod 2 +.Xr kldload 2 , +.Xr kldnext 2 , +.Xr kldstat 2 , +.Xr modfnext 2 , +.Xr modstat 2 +.Sh HISTORY +The +.Fn kld_isloaded +and +.Fn kld_load +functions first appeared in +.Fx 7.0 . +.Sh AUTHORS +The +.Fn kld_isloaded +and +.Fn kld_load +functions and this manual page were written by +.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org . diff --git a/lib/libutil/kld.c b/lib/libutil/kld.c new file mode 100644 index 0000000..b8aa9ef --- /dev/null +++ b/lib/libutil/kld.c @@ -0,0 +1,74 @@ +/*- + * Copyright (c) 2006 Dag-Erling Coïdan Smørgrav + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer + * in this position and unchanged. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#include <sys/param.h> +#include <sys/linker.h> +#include <sys/module.h> + +#include <errno.h> + +int +kld_isloaded(const char *name) +{ + struct kld_file_stat fstat; + struct module_stat mstat; + const char *ko; + int fid, mid; + + for (fid = kldnext(0); fid > 0; fid = kldnext(fid)) { + fstat.version = sizeof(fstat); + if (kldstat(fid, &fstat) != 0) + continue; + /* check if the file name matches the supplied name */ + if (strcmp(fstat.name, name) == 0) + return (1); + /* strip .ko and try again */ + if ((ko = strstr(fstat.name, ".ko")) != NULL && + strlen(name) == ko - fstat.name && + strncmp(fstat.name, name, ko - fstat.name) == 0) + return (1); + /* look for a matching module within the file */ + for (mid = kldfirstmod(fid); mid > 0; mid = modfnext(mid)) { + mstat.version = sizeof(mstat); + if (modstat(mid, &mstat) != 0) + continue; + if (strcmp(mstat.name, name) == 0) + return (1); + } + } + return (0); +} + +int +kld_load(const char *name) +{ + if (kldload(name) == -1 && errno != EEXIST) + return (-1); + return (0); +} diff --git a/lib/libutil/libutil.h b/lib/libutil/libutil.h index 961fa1b..aefff0c 100644 --- a/lib/libutil/libutil.h +++ b/lib/libutil/libutil.h @@ -94,6 +94,10 @@ int realhostname(char *host, size_t hsize, const struct in_addr *ip); struct sockaddr; int realhostname_sa(char *host, size_t hsize, struct sockaddr *addr, int addrlen); + +int kld_isloaded(const char *name); +int kld_load(const char *name); + #ifdef _STDIO_H_ /* avoid adding new includes */ char *fparseln(FILE *, size_t *, size_t *, const char[3], int); #endif @@ -119,6 +123,7 @@ int pidfile_write(struct pidfh *pfh); int pidfile_close(struct pidfh *pfh); int pidfile_remove(struct pidfh *pfh); #endif + __END_DECLS #define UU_LOCK_INUSE (1) |