Return to ioThread.h CVS log

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

Annotation of driverkit/Examples/ioThread/ioThread.h, revision 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:  * ioThread.h  
        !            26:  */
        !            27:  
        !            28: #import <mach/mach.h>
        !            29: #import <kernserv/queue.h>
        !            30: #import <machkit/NXLock.h>
        !            31: #import <libc.h>
        !            32: #import <driverkit/IODevice.h>
        !            33: #import <driverkit/generalFuncs.h>
        !            34: 
        !            35: /*
        !            36:  * Commands to be passed to I/O thread.
        !            37:  */
        !            38: typedef enum {
        !            39:        IOC_GETNUM,             // get a number from stdin
        !            40:        IOC_PRINTNUM,           // print a number
        !            41:        IOC_QUIT                // exit
        !            42: } ioCmd_t;
        !            43: 
        !            44: /*
        !            45:  * This struct is the means by which exported methods pass commands to the
        !            46:  * I/O thread.
        !            47:  */
        !            48: 
        !            49: typedef struct {
        !            50:        id              cmdLock;        // NXConditionLock. Clients await
        !            51:                                        //   completion notification via 
        !            52:                                        //   this lock.
        !            53:        ioCmd_t         cmd;            // operation to perform
        !            54:        int             aNumber;        // some data
        !            55:        queue_chain_t   link;           // for enqueueing on ioQueue
        !            56: } cmdBuf_t;
        !            57: 
        !            58: /*
        !            59:  * Condition values for cmdLock.
        !            60:  */
        !            61: #define CMD_BUSY       0
        !            62: #define CMD_COMPLETE   1
        !            63: 
        !            64: /*
        !            65:  * Simple driver class.
        !            66:  */
        !            67: @interface MyDevice:IODevice
        !            68: {
        !            69:        id              ioQueueLock;    // NXConditionLock. Protects ioQueue;
        !            70:                                        //   the ioThread awaits input via 
        !            71:                                        //   this lock.
        !            72:        queue_head_t    ioQueue;        // queue of cmdBuf_t's
        !            73:        IOThread        ioThread;
        !            74: }      
        !            75: 
        !            76: /*
        !            77:  * Condition values for ioQueueLock.
        !            78:  */
        !            79: #define QUEUE_EMPTY    0
        !            80: #define QUEUE_FULL     1               // at least one element in queue
        !            81: 
        !            82: /*
        !            83:  * Initialization.
        !            84:  */
        !            85: - myDeviceInit;
        !            86: 
        !            87: /*
        !            88:  * Exported run-time methods.
        !            89:  */
        !            90: - (int)getNumber;                      // have I/O thread get a number 
        !            91:                                        //    from user
        !            92: - (void)printNumber : (int)ack;        // have I/O thread print a number
        !            93: - free;
        !            94: 
        !            95: @end
        !            96: 

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