diff options
Diffstat (limited to 'share/examples/lkm/syscall/module')
| -rw-r--r-- | share/examples/lkm/syscall/module/Makefile | 65 | ||||
| -rw-r--r-- | share/examples/lkm/syscall/module/mycall.c | 76 | ||||
| -rw-r--r-- | share/examples/lkm/syscall/module/newsyscall.c | 115 |
3 files changed, 256 insertions, 0 deletions
diff --git a/share/examples/lkm/syscall/module/Makefile b/share/examples/lkm/syscall/module/Makefile new file mode 100644 index 0000000..7090e86 --- /dev/null +++ b/share/examples/lkm/syscall/module/Makefile @@ -0,0 +1,65 @@ +# 05 Jun 93 +# +# Makefile for newsyscall +# +# 05 Jun 93 Terry Lambert Original +# +# Copyright (c) 1993 Terrence R. Lambert. +# 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. +# 3. All advertising materials mentioning features or use of this software +# must display the following acknowledgement: +# This product includes software developed by Terrence R. Lambert. +# 4. The name Terrence R. Lambert may not be used to endorse or promote +# products derived from this software without specific prior written +# permission. +# +# THIS SOFTWARE IS PROVIDED BY TERRENCE R. LAMBERT ``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 TERRENCE R. LAMBERT 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. +# + +SRCS=newsyscall.c +OBJS=$(SRCS:.c=.o) + +KSRCS=mycall.c +KOBJS=mycall.o + +MODOBJ=combined.o + +KMOD=newsyscall +CFLAGS= -DKERNEL -I/sys/sys -I/sys + +all: $(MODOBJ) + +clean: + rm -f $(OBJS) $(KOBJS) $(MODOBJ) $(KMOD) + +load: + /sbin/modload -o $(KMOD) -e$(KMOD) $(MODOBJ) + +unload: + /sbin/modunload -n $(KMOD) + +$(MODOBJ): $(OBJS) $(KOBJS) + $(LD) -r -o $(MODOBJ) $(OBJS) $(KOBJS) + +# +# EOF -- This file has not been truncated +# diff --git a/share/examples/lkm/syscall/module/mycall.c b/share/examples/lkm/syscall/module/mycall.c new file mode 100644 index 0000000..ac44399 --- /dev/null +++ b/share/examples/lkm/syscall/module/mycall.c @@ -0,0 +1,76 @@ +/* 05 Jun 93*/ +/* + * mycall.c + * + * 05 Jun 93 Terry Lambert Split out of newsyscall.c + * + * Copyright (c) 1993 Terrence R. Lambert. + * 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. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by Terrence R. Lambert. + * 4. The name Terrence R. Lambert may not be used to endorse or promote + * products derived from this software without specific prior written + * permission. + * + * THIS SOFTWARE IS PROVIDED BY TERRENCE R. LAMBERT ``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 TERRENCE R. LAMBERT 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. + * + */ +#include <sys/param.h> +#include <sys/ioctl.h> +#include <sys/systm.h> + + +/* + * This is the actual code for system call... it can be static because + * we've externed it up above... the only plae it needs to be referenced + * is the sysent we are interested in. + * + * To write your own system call using this as a template, you could strip + * out this code and use the rest as a prototype module, changing only the + * function names and the number of arguments to the call in the module + * specific "sysent". + * + * You would have to use the "-R" option of "ld" to ensure a linkable file + * if you were to do this, since you would need to combine multiple ".o" + * files into a single ".o" file for use by "modload". + */ +int +mycall( p, uap, retval) +struct proc *p; +void *uap; +int retval[]; +{ + /* + * Our new system call simply prints a message; it takes no + * arguments. + */ + + printf( "\nI am a loaded system call using the kernel printf!\n"); + printf( "I will print this message each time I am called!\n"); + + return( 0); /* success (or error code from errno.h)*/ +} + +/* + * EOF -- This file has not been truncated. + */ diff --git a/share/examples/lkm/syscall/module/newsyscall.c b/share/examples/lkm/syscall/module/newsyscall.c new file mode 100644 index 0000000..5ae9e7d --- /dev/null +++ b/share/examples/lkm/syscall/module/newsyscall.c @@ -0,0 +1,115 @@ +/* 25 May 93*/ +/* + * Makefile for newsyscall + * + * 05 Jun 93 Terry Lambert Split mycall.c out + * 25 May 93 Terry Lambert Original + * + * Copyright (c) 1993 Terrence R. Lambert. + * 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. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by Terrence R. Lambert. + * 4. The name Terrence R. Lambert may not be used to endorse or promote + * products derived from this software without specific prior written + * permission. + * + * THIS SOFTWARE IS PROVIDED BY TERRENCE R. LAMBERT ``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 TERRENCE R. LAMBERT 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. + * + */ +#include <sys/param.h> +#include <sys/ioctl.h> +#include <sys/systm.h> +#include <sys/conf.h> +#include <sys/mount.h> +#include <sys/exec.h> +#include <sys/lkm.h> +#include <a.out.h> +#include <sys/file.h> +#include <sys/errno.h> + + +extern int mycall(); + +/* + * These two entries define our system call and module information. We + * have 0 arguments to our system call. + */ +static struct sysent newent = { + 0, mycall /* # of args, function pointer*/ +}; + +MOD_SYSCALL( "newsyscall", -1, &newent) + + +/* + * This function is called each time the module is loaded. Technically, + * we could have made this "nosys" in the "DISPATCH" in "newsyscall()", + * but it's a convenient place to kick a copyright out to the console. + */ +static int +newsyscall_load( lkmtp, cmd) +struct lkm_table *lkmtp; +int cmd; +{ + if( cmd == LKM_E_LOAD) { /* print copyright on console*/ + printf( "\nSample Loaded system call\n"); + printf( "Copyright (c) 1993\n"); + printf( "Terrence R. Lambert\n"); + printf( "All rights reserved\n"); + } + + return( 0); +} + + +/* + * External entry point; should generally match name of .o file. The + * arguments are always the same for all loaded modules. The "load", + * "unload", and "stat" functions in "DISPATCH" will be called under + * their respective circumstances unless their value is "nosys". If + * called, they are called with the same arguments (cmd is included to + * allow the use of a single function, ver is included for version + * matching between modules and the kernel loader for the modules). + * + * Since we expect to link in the kernel and add external symbols to + * the kernel symbol name space in a future version, generally all + * functions used in the implementation of a particular module should + * be static unless they are expected to be seen in other modules or + * to resolve unresolved symbols alread existing in the kernel (the + * second case is not likely to ever occur). + * + * The entry point should return 0 unless it is refusing load (in which + * case it should return an errno from errno.h). + */ +newsyscall( lkmtp, cmd, ver) +struct lkm_table *lkmtp; +int cmd; +int ver; +{ + DISPATCH(lkmtp,cmd,ver,newsyscall_load,nosys,nosys) +} + + +/* + * EOF -- This file has not been truncated. + */ |
