1 /* 08 Nov 1998*/ 2 /* 3 * cdevmod.c - a sample kld module implementing a character device driver. 4 * 5 * 08 Nov 1998 Rajesh Vaidheeswarran 6 * 7 * Copyright (c) 1998 Rajesh Vaidheeswarran 8 * All rights reserved. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions and the following disclaimer. 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 3. All advertising materials mentioning features or use of this software 19 * must display the following acknowledgement: 20 * This product includes software developed by Rajesh Vaidheeswarran. 21 * 4. The name Rajesh Vaidheeswarran may not be used to endorse or promote 22 * products derived from this software without specific prior written 23 * permission. 24 * 25 * THIS SOFTWARE IS PROVIDED BY RAJESH VAIDHEESWARRAN ``AS IS'' AND ANY 26 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 28 * ARE DISCLAIMED. IN NO EVENT SHALL THE RAJESH VAIDHEESWARRAN BE LIABLE 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 31 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 32 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 34 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 35 * SUCH DAMAGE. 36 * 37 * Copyright (c) 1993 Terrence R. Lambert. 38 * All rights reserved. 39 * 40 * Redistribution and use in source and binary forms, with or without 41 * modification, are permitted provided that the following conditions 42 * are met: 43 * 1. Redistributions of source code must retain the above copyright 44 * notice, this list of conditions and the following disclaimer. 45 * 2. Redistributions in binary form must reproduce the above copyright 46 * notice, this list of conditions and the following disclaimer in the 47 * documentation and/or other materials provided with the distribution. 48 * 3. All advertising materials mentioning features or use of this software 49 * must display the following acknowledgement: 50 * This product includes software developed by Terrence R. Lambert. 51 * 4. The name Terrence R. Lambert may not be used to endorse or promote 52 * products derived from this software without specific prior written 53 * permission. 54 * 55 * THIS SOFTWARE IS PROVIDED BY TERRENCE R. LAMBERT ``AS IS'' AND ANY 56 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 57 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 58 * ARE DISCLAIMED. IN NO EVENT SHALL THE TERRENCE R. LAMBERT BE LIABLE 59 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 60 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 61 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 62 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 63 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 64 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 65 * SUCH DAMAGE. 66 * 67 * 68 * $FreeBSD$ 69 */ 70 #include <sys/param.h> 71 #include <sys/systm.h> 72 #include <sys/kernel.h> 73 #include <sys/module.h> 74 #include <sys/conf.h> 75 76 #include "cdev.h" 77 78 #if __FreeBSD_version < 500000 79 #define CDEV_MAJOR 32 80 #else 81 #define CDEV_MAJOR MAJOR_AUTO 82 #endif 83 84 static struct cdevsw my_devsw = { 85 /* version */ .d_version = D_VERSION, 86 /* open */ .d_open = mydev_open, 87 /* close */ .d_close = mydev_close, 88 /* read */ .d_read = mydev_read, 89 /* write */ .d_write = mydev_write, 90 /* ioctl */ .d_ioctl = mydev_ioctl, 91 /* name */ .d_name = "cdev", 92 /* maj */ .d_maj = CDEV_MAJOR 93 }; 94 95 /* 96 * Used as the variable that is the reference to our device 97 * in devfs... we must keep this variable sane until we 98 * call kldunload. 99 */ 100 static struct cdev *sdev; 101 102 /* 103 * This function is called each time the module is loaded or unloaded. 104 * Since we are a miscellaneous module, we have to provide whatever 105 * code is necessary to patch ourselves into the area we are being 106 * loaded to change. 107 * 108 * The stat information is basically common to all modules, so there 109 * is no real issue involved with stat; we will leave it lkm_nullcmd(), 110 * since we don't have to do anything about it. 111 */ 112 113 static int 114 cdev_load(module_t mod, int cmd, void *arg) 115 { 116 int err = 0; 117 118 switch (cmd) { 119 case MOD_LOAD: 120 121 /* Do any initialization that you should do with the kernel */ 122 123 /* if we make it to here, print copyright on console*/ 124 printf("\nSample Loaded kld character device driver\n"); 125 printf("Copyright (c) 1998\n"); 126 printf("Rajesh Vaidheeswarran\n"); 127 printf("All rights reserved\n"); 128 sdev = make_dev(&my_devsw, 0, UID_ROOT, GID_WHEEL, 0600, "cdev"); 129 break; /* Success*/ 130 131 case MOD_UNLOAD: 132 printf("Unloaded kld character device driver\n"); 133 destroy_dev(sdev); 134 break; /* Success*/ 135 136 default: /* we only understand load/unload*/ 137 err = EINVAL; 138 break; 139 } 140 141 return(err); 142 } 143 144 /* Now declare the module to the system */ 145 146 DEV_MODULE(cdev, cdev_load, NULL); 147