Return to myHandler.m CVS log

Up to [Apple Darwin 0.x] / driverkit / Examples / loadable / Kernel

Annotation of driverkit/Examples/loadable/Kernel/myHandler.m, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Copyright (c) 1999 Apple Computer, Inc. All rights reserved.
                      3:  *
                      4:  * @APPLE_LICENSE_HEADER_START@
                      5:  * 
                      6:  * Portions Copyright (c) 1999 Apple Computer, Inc.  All Rights
                      7:  * Reserved.  This file contains Original Code and/or Modifications of
                      8:  * Original Code as defined in and that are subject to the Apple Public
                      9:  * Source License Version 1.1 (the "License").  You may not use this file
                     10:  * except in compliance with the License.  Please obtain a copy of the
                     11:  * License at http://www.apple.com/publicsource and read it before using
                     12:  * this file.
                     13:  * 
                     14:  * The Original Code and all software distributed under the License are
                     15:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
                     16:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
                     17:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
                     18:  * FITNESS FOR A PARTICULAR PURPOSE OR NON- INFRINGEMENT.  Please see the
                     19:  * License for the specific language governing rights and limitations
                     20:  * under the License.
                     21:  * 
                     22:  * @APPLE_LICENSE_HEADER_END@
                     23:  */
                     24: /*
                     25:  * Simple loadable kernel Handler example.
                     26:  *
                     27:  * This Handler accepts one message, setDevicePort(). This is how the
                     28:  * user-level module, XXX, passes the device port obtained from Config
                     29:  * down to a kernel-level IODevice.
                     30:  */
                     31: #import <kernserv/kern_server_types.h>
                     32: #import <kernserv/printf.h>
                     33: #import <mach/mig_errors.h>
                     34: #import "myDevice.h"
                     35: #import "myHandlerHandler.h"
                     36: #import <driverkit/kernelDriver.h>
                     37: #import <driverkit/generalFuncs.h>
                     38: 
                     39: kern_return_t setDevicePort(void *arg, port_t devicePort);
                     40: kern_return_t initDevice(void *arg);
                     41: kern_return_t shutDown(void *arg);
                     42: 
                     43: static id myDeviceId;
                     44: 
                     45: /*
                     46:  * Create the struct used by mig-generated code to convert from 
                     47:  * message to setDevicePort() callout.
                     48:  */
                     49: myHandler_t myHandlerStruct = {
                     50:        0,
                     51:        100,
                     52:        setDevicePort,
                     53:        initDevice,
                     54:        shutDown
                     55: };
                     56: 
                     57: /*
                     58:  * Allocate an instance variable to be used by the kernel server interface
                     59:  * routines for initializing and accessing this service.
                     60:  */
                     61: kern_server_t myHandlerInstance;
                     62: 
                     63: /*
                     64:  * Stamp our arival.
                     65:  */
                     66: void myHandlerInit(void)
                     67: {
                     68:        printf("myHandler initialized\n");
                     69: }
                     70: 
                     71: /*
                     72:  * Notify the world that we're going away.
                     73:  */
                     74: void myHandlerSignoff(void)
                     75: {
                     76:        printf("myHandler unloaded\n");
                     77: }
                     78: 
                     79: kern_return_t setDevicePort(
                     80:        void *arg,              // what's this?
                     81:        port_t devicePort)
                     82: {
                     83: #if    0
                     84:        port_t devicePortIOTask = convertPortToIOTask(devicePort);
                     85: #else  0
                     86:        port_t devicePortIOTask = IOConvertPort(devicePort,
                     87:                IO_CurrentTask, IO_KernelIOTask);
                     88: #endif 0
                     89:        IOLog("myHandler setDevicePort: devicePort %d; %d in IOTask space\n", 
                     90:                devicePort, devicePortIOTask);
                     91:        myDeviceId = [myDevice alloc];
                     92:        [myDeviceId setDevicePort:devicePortIOTask];
                     93:        return KERN_SUCCESS;
                     94: }
                     95: 
                     96: kern_return_t initDevice(void *arg)
                     97: {
                     98:        IOLog("myHandler initDevice\n");
                     99:        [myDeviceId init];
                    100:        return KERN_SUCCESS;
                    101: }
                    102: 
                    103: kern_return_t shutDown(void *arg)
                    104: {
                    105:        IOLog("myHandler shutDown\n");
                    106:        [myDeviceId shutDown];
                    107:        [myDevice free];
                    108:        return KERN_SUCCESS;
                    109: }

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.