/* * Loadable kernel module skeleton driver * 11 July 1995 Andrew McRae * *------------------------------------------------------------------------- * * Copyright (c) 1995 Andrew McRae. 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. The name of the author may not be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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 #include #include #include #include #include #include #include #include #include #include #include #include #include /* * This defines the lkm_misc module use by modload * to define the module name. */ MOD_MISC(skel); static int skelinit(struct pccard_devinfo *); /* init device */ static void skelunload(struct pccard_devinfo *); /* Disable driver */ static int skelintr(struct pccard_devinfo *); /* Interrupt handler */ static struct pccard_device skel_info = { "skel", skelinit, skelunload, skelintr, 0, /* Attributes - presently unused */ &net_imask /* Interrupt mask for device */ }; DATA_SET(pccarddrv_set, skel_info); static int opened; /* Rather minimal device state... */ /* * Module handler that processes loads and unloads. * Once the module is loaded, the add driver routine is called * to register the driver. * If an unload is requested the remove driver routine is * called to deregister the driver before unloading. */ static int skel_handle(lkmtp, cmd) struct lkm_table *lkmtp; int cmd; { int i; struct lkm_misc *args = lkmtp->private.lkm_misc; int err = 0; /* default = success*/ switch( cmd) { case LKM_E_LOAD: /* * Now register the driver */ pccard_add_driver(&skel_info); break; /* Success*/ /* * Attempt to deregister the driver. */ case LKM_E_UNLOAD: pccard_remove_driver(&skel_info); break; /* Success*/ default: /* we only understand load/unload*/ err = EINVAL; break; } return( err); } /* * 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 "MOD_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). */ int skel(lkmtp, cmd, ver) struct lkm_table *lkmtp; int cmd; int ver; { MOD_DISPATCH(skel,lkmtp,cmd,ver,skel_handle,skel_handle,nosys) } /* * Skeleton driver entry points for PCCARD configuration. */ /* * Initialize the device. */ static int skelinit(struct pccard_devinfo *devi) { int unit = devi->isahd.id_unit; if (opened & (1 << unit)) return(EBUSY); opened |= 1 << unit; printf("%s%d: init\n", devi->drv->name, unit); printf("%s%d: irq %d iobase 0x%x maddr 0x%x memlen %d\n", devi->drv->name, unit, devi->isahd.id_irq, devi->isahd.id_iobase, devi->isahd.id_maddr, devi->isahd.id_msize); return(0); } /* * The device entry is being removed. Shut it down, * and turn off interrupts etc. Not called unless * the device was successfully installed. */ static void skelunload(struct pccard_devinfo *devi) { int unit = devi->isahd.id_unit; printf("%s%d: unload\n", devi->drv->name, unit); opened &= ~(1 << unit); } /* * Interrupt handler. * Returns true if the interrupt is for us. */ static int skelintr(struct pccard_devinfo *devi) { return(0); }