iokit/IOKit/IOMapper.h

   1 /*
   2  * Copyright (c) 1998-2016 Apple Inc. All rights reserved.
   3  *
   4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. The rights granted to you under the License
  10  * may not be used to create, or enable the creation or redistribution of,
  11  * unlawful or unlicensed copies of an Apple operating system, or to
  12  * circumvent, violate, or enable the circumvention or violation of, any
  13  * terms of an Apple operating system software license agreement.
  14  *
  15  * Please obtain a copy of the License at
  16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
  17  *
  18  * The Original Code and all software distributed under the License are
  19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  23  * Please see the License for the specific language governing rights and
  24  * limitations under the License.
  25  *
  26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  27  */
  28
  29 #ifndef __IOKIT_IOMAPPER_H
  30 #define __IOKIT_IOMAPPER_H
  31
  32 #include <sys/cdefs.h>
  33
  34 __BEGIN_DECLS
  35 #include <IOKit/IOTypes.h>
  36 #include <mach/vm_types.h>
  37
  38 // These are C accessors to the system mapper for non-IOKit clients
  39 ppnum_t IOMapperIOVMAlloc(unsigned pages);
  40 void IOMapperIOVMFree(ppnum_t addr, unsigned pages);
  41 ppnum_t IOMapperInsertPage(ppnum_t addr, unsigned offset, ppnum_t page);
  42
  43 __END_DECLS
  44
  45 #if __cplusplus
  46
  47 #include <IOKit/IOService.h>
  48 #include <IOKit/IOMemoryDescriptor.h>
  49 #include <IOKit/IODMACommand.h>
  50
  51 class OSData;
  52
  53 extern const OSSymbol * gIOMapperIDKey;
  54
  55 class IOMapper : public IOService
  56 {
  57         OSDeclareAbstractStructors(IOMapper);
  58
  59 // Give the platform expert access to setMapperRequired();
  60         friend class IOPlatformExpert;
  61         friend class IOMemoryDescriptor;
  62         friend class IOGeneralMemoryDescriptor;
  63
  64 private:
  65         enum SystemMapperState {
  66                 kNoMapper  = 0,
  67                 kUnknown   = 1,
  68                 kHasMapper = 2, // Any other value is pointer to a live mapper
  69                 kWaitMask  = 3,
  70         };
  71 protected:
  72 #ifdef XNU_KERNEL_PRIVATE
  73         uint64_t   __reservedA[6];
  74         kern_allocation_name_t fAllocName;
  75         uint32_t   __reservedB;
  76         uint32_t   fPageSize;
  77 #else
  78         uint64_t __reserved[8];
  79 #endif
  80         bool fIsSystem;
  81
  82         static void setMapperRequired(bool hasMapper);
  83         static void waitForSystemMapper();
  84
  85         virtual bool initHardware(IOService *provider) = 0;
  86
  87 public:
  88         virtual bool start(IOService *provider) APPLE_KEXT_OVERRIDE;
  89         virtual void free() APPLE_KEXT_OVERRIDE;
  90
  91 // To get access to the system mapper IOMapper::gSystem
  92         static IOMapper *gSystem;
  93
  94         static void
  95         checkForSystemMapper()
  96         {
  97                 if ((uintptr_t) gSystem & kWaitMask) {
  98                         waitForSystemMapper();
  99                 }
 100         }
 101
 102         static IOMapper * copyMapperForDevice(IOService * device);
 103         static IOMapper * copyMapperForDeviceWithIndex(IOService * device, unsigned int index);
 104
 105 // { subclasses
 106
 107         virtual uint64_t getPageSize(void) const = 0;
 108
 109         virtual IOReturn iovmMapMemory(IOMemoryDescriptor          * memory,
 110             uint64_t                      descriptorOffset,
 111             uint64_t                      length,
 112             uint32_t                      mapOptions,
 113             const IODMAMapSpecification * mapSpecification,
 114             IODMACommand                * dmaCommand,
 115             const IODMAMapPageList      * pageList,
 116             uint64_t                    * mapAddress,
 117             uint64_t                    * mapLength) = 0;
 118
 119         virtual IOReturn iovmUnmapMemory(IOMemoryDescriptor * memory,
 120             IODMACommand       * dmaCommand,
 121             uint64_t             mapAddress,
 122             uint64_t             mapLength) = 0;
 123
 124         virtual IOReturn iovmInsert(uint32_t options,
 125             uint64_t mapAddress,
 126             uint64_t offset,
 127             uint64_t physicalAddress,
 128             uint64_t length) = 0;
 129
 130         virtual uint64_t mapToPhysicalAddress(uint64_t mappedAddress) = 0;
 131
 132 // }
 133
 134 private:
 135         OSMetaClassDeclareReservedUnused(IOMapper, 0);
 136         OSMetaClassDeclareReservedUnused(IOMapper, 1);
 137         OSMetaClassDeclareReservedUnused(IOMapper, 2);
 138         OSMetaClassDeclareReservedUnused(IOMapper, 3);
 139         OSMetaClassDeclareReservedUnused(IOMapper, 4);
 140         OSMetaClassDeclareReservedUnused(IOMapper, 5);
 141         OSMetaClassDeclareReservedUnused(IOMapper, 6);
 142         OSMetaClassDeclareReservedUnused(IOMapper, 7);
 143         OSMetaClassDeclareReservedUnused(IOMapper, 8);
 144         OSMetaClassDeclareReservedUnused(IOMapper, 9);
 145         OSMetaClassDeclareReservedUnused(IOMapper, 10);
 146         OSMetaClassDeclareReservedUnused(IOMapper, 11);
 147         OSMetaClassDeclareReservedUnused(IOMapper, 12);
 148         OSMetaClassDeclareReservedUnused(IOMapper, 13);
 149         OSMetaClassDeclareReservedUnused(IOMapper, 14);
 150         OSMetaClassDeclareReservedUnused(IOMapper, 15);
 151 };
 152
 153 #endif /* __cplusplus */
 154
 155 #endif /* !__IOKIT_IOMAPPER_H */