X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/d7e50217d7adf6e52786a38bcaa4cd698cb9a79e..cc8bc92ae4a8e9f1a1ab61bf83d34ad8150b3405:/iokit/IOKit/IOBufferMemoryDescriptor.h
diff --git a/iokit/IOKit/IOBufferMemoryDescriptor.h b/iokit/IOKit/IOBufferMemoryDescriptor.h
index 810c087a7..6e6f051b9 100644
--- a/iokit/IOKit/IOBufferMemoryDescriptor.h
+++ b/iokit/IOKit/IOBufferMemoryDescriptor.h
@@ -1,16 +1,19 @@
/*
- * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 1998-2016 Apple Inc. All rights reserved.
*
- * @APPLE_LICENSE_HEADER_START@
- *
- * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved.
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
*
* This file contains Original Code and/or Modifications of Original Code
* as defined in and that are subject to the Apple Public Source License
* Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
+ *
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
*
* The Original Code and all software distributed under the License are
* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
@@ -20,7 +23,7 @@
* Please see the License for the specific language governing rights and
* limitations under the License.
*
- * @APPLE_LICENSE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
#ifndef _IOBUFFERMEMORYDESCRIPTOR_H
#define _IOBUFFERMEMORYDESCRIPTOR_H
@@ -30,23 +33,39 @@
enum {
kIOMemoryPhysicallyContiguous = 0x00000010,
kIOMemoryPageable = 0x00000020,
+ kIOMemoryPurgeable = 0x00000040,
+ kIOMemoryHostPhysicallyContiguous = 0x00000080,
kIOMemorySharingTypeMask = 0x000f0000,
kIOMemoryUnshared = 0x00000000,
kIOMemoryKernelUserShared = 0x00010000,
+ // shared IOMemoryDescriptor options for IOBufferMemoryDescriptor:
+ kIOBufferDescriptorMemoryFlags = kIOMemoryDirectionMask
+#ifdef XNU_KERNEL_PRIVATE
+ | kIOMemoryAutoPrepare
+#endif
+ | kIOMemoryThreadSafe
+ | kIOMemoryClearEncrypt
+ | kIOMemoryMapperNone
+ | kIOMemoryUseReserve
};
-#define _IOBUFFERMEMORYDESCRIPTOR_INTASKWITHOPTIONS_ 1
+#define _IOBUFFERMEMORYDESCRIPTOR_INTASKWITHOPTIONS_ 1
+#define _IOBUFFERMEMORYDESCRIPTOR_HOSTPHYSICALLYCONTIGUOUS_ 1
+/*!
+ @class IOBufferMemoryDescriptor
+ @abstract Provides a simple memory descriptor that allocates its own buffer memory.
+*/
class IOBufferMemoryDescriptor : public IOGeneralMemoryDescriptor
{
OSDeclareDefaultStructors(IOBufferMemoryDescriptor);
-protected:
+private:
/*! @struct ExpansionData
@discussion This structure will be used to expand the capablilties of this class in the future.
*/
struct ExpansionData {
- vm_map_t map;
+ IOMemoryMap * map;
};
/*! @var reserved
@@ -58,18 +77,34 @@ protected:
vm_size_t _capacity;
vm_offset_t _alignment;
IOOptionBits _options;
- IOPhysicalAddress * _physAddrs;
- unsigned _physSegCount;
+private:
+ uintptr_t _internalReserved;
+ unsigned _internalFlags;
private:
+#ifndef __LP64__
virtual bool initWithOptions(
IOOptionBits options,
vm_size_t capacity,
vm_offset_t alignment,
- task_t inTask);
+ task_t inTask) APPLE_KEXT_DEPRECATED; /* use withOptions() instead */
+#endif /* !__LP64__ */
- OSMetaClassDeclareReservedUsed(IOBufferMemoryDescriptor, 0);
+public:
+ virtual bool initWithPhysicalMask(
+ task_t inTask,
+ IOOptionBits options,
+ mach_vm_size_t capacity,
+ mach_vm_address_t alignment,
+ mach_vm_address_t physicalMask);
+
+#ifdef __LP64__
+ OSMetaClassDeclareReservedUnused(IOBufferMemoryDescriptor, 0);
OSMetaClassDeclareReservedUnused(IOBufferMemoryDescriptor, 1);
+#else /* !__LP64__ */
+ OSMetaClassDeclareReservedUsed(IOBufferMemoryDescriptor, 0);
+ OSMetaClassDeclareReservedUsed(IOBufferMemoryDescriptor, 1);
+#endif /* !__LP64__ */
OSMetaClassDeclareReservedUnused(IOBufferMemoryDescriptor, 2);
OSMetaClassDeclareReservedUnused(IOBufferMemoryDescriptor, 3);
OSMetaClassDeclareReservedUnused(IOBufferMemoryDescriptor, 4);
@@ -86,39 +121,7 @@ private:
OSMetaClassDeclareReservedUnused(IOBufferMemoryDescriptor, 15);
protected:
- virtual void free();
-
- virtual bool initWithAddress( void * address, /* not supported */
- IOByteCount withLength,
- IODirection withDirection );
-
- virtual bool initWithAddress( vm_address_t address, /* not supported */
- IOByteCount withLength,
- IODirection withDirection,
- task_t withTask );
-
- virtual bool initWithPhysicalAddress(
- IOPhysicalAddress address, /* not supported */
- IOByteCount withLength,
- IODirection withDirection );
-
- virtual bool initWithPhysicalRanges(
- IOPhysicalRange * ranges, /* not supported */
- UInt32 withCount,
- IODirection withDirection,
- bool asReference = false );
-
- virtual bool initWithRanges( IOVirtualRange * ranges, /* not supported */
- UInt32 withCount,
- IODirection withDirection,
- task_t withTask,
- bool asReference = false );
-
- IOGeneralMemoryDescriptor::withAddress; /* not supported */
- IOGeneralMemoryDescriptor::withPhysicalAddress; /* not supported */
- IOGeneralMemoryDescriptor::withPhysicalRanges; /* not supported */
- IOGeneralMemoryDescriptor::withRanges; /* not supported */
- IOGeneralMemoryDescriptor::withSubRange; /* not supported */
+ virtual void free() APPLE_KEXT_OVERRIDE;
public:
@@ -129,25 +132,33 @@ public:
* hold capacity bytes. The descriptor's length is initially set to the
* capacity.
*/
+#ifndef __LP64__
virtual bool initWithOptions( IOOptionBits options,
vm_size_t capacity,
- vm_offset_t alignment);
+ vm_offset_t alignment) APPLE_KEXT_DEPRECATED; /* use withOptions() instead */
+#endif /* !__LP64__ */
static IOBufferMemoryDescriptor * withOptions( IOOptionBits options,
vm_size_t capacity,
vm_offset_t alignment = 1);
/*! @function inTaskWithOptions
- @abstract Create a memory buffer with memory descriptor for that buffer. Added in Mac OS X 10.2.
- @discussion This method allocates a memory buffer with a given size and alignment in the task's address space specified, and returns a memory descriptor instance representing the memory. It is recommended memory allocated for I/O or sharing via mapping be created via IOBufferMemoryDescriptor. Options passed with the request specify the kind of memory to be allocated - pageablity and sharing are specified with option bits. This function may block and so should not be called from interrupt level or while a simple lock is held.
+ @abstract Creates a memory buffer with memory descriptor for that buffer.
+ @discussion Added in Mac OS X 10.2, this method allocates a memory buffer with a given size and alignment in the task's address space specified, and returns a memory descriptor instance representing the memory. It is recommended that memory allocated for I/O or sharing via mapping be created via IOBufferMemoryDescriptor. Options passed with the request specify the kind of memory to be allocated - pageablity and sharing are specified with option bits. This function may block and so should not be called from interrupt level or while a simple lock is held.
@param inTask The task the buffer will be allocated in.
- @param options Options for the allocation:
- kIOMemoryPhysicallyContiguous - pass to request memory be physically contiguous. This option is heavily discouraged. The request may fail if memory is fragmented, may cause large amounts of paging activity, and may take a very long time to execute.
- kIOMemoryPageable - pass to request memory be non-wired - the default for kernel allocated memory is wired.
- kIOMemoryKernelUserShared - pass to request memory that will be mapped into both the kernel and client applications.
+ @param options Options for the allocation:
+ kIODirectionOut, kIODirectionIn - set the direction of the I/O transfer.
+ kIOMemoryPhysicallyContiguous - pass to request memory be physically contiguous. This option is heavily discouraged. The request may fail if memory is fragmented, may cause large amounts of paging activity, and may take a very long time to execute.
+ kIOMemoryPageable - pass to request memory be non-wired - the default for kernel allocated memory is wired.
+ kIOMemoryPurgeable - pass to request memory that may later have its purgeable state set with IOMemoryDescriptor::setPurgeable. Only supported for kIOMemoryPageable allocations.
+ kIOMemoryKernelUserShared - pass to request memory that will be mapped into both the kernel and client applications.
+ kIOMapInhibitCache - allocate memory with inhibited cache setting.
+ kIOMapWriteThruCache - allocate memory with writethru cache setting.
+ kIOMapCopybackCache - allocate memory with copyback cache setting.
+ kIOMapWriteCombineCache - allocate memory with writecombined cache setting.
@param capacity The number of bytes to allocate.
@param alignment The minimum required alignment of the buffer in bytes - 1 is the default for no required alignment. For example, pass 256 to get memory allocated at an address with bits 0-7 zero.
- @result An instance of class IOBufferMemoryDescriptor. To be released by the caller, which will free the memory desriptor and associated buffer. */
+ @result Returns an instance of class IOBufferMemoryDescriptor to be released by the caller, which will free the memory desriptor and associated buffer. */
static IOBufferMemoryDescriptor * inTaskWithOptions(
task_t inTask,
@@ -155,6 +166,28 @@ public:
vm_size_t capacity,
vm_offset_t alignment = 1);
+/*! @function inTaskWithPhysicalMask
+ @abstract Creates a memory buffer with memory descriptor for that buffer.
+ @discussion Added in Mac OS X 10.5, this method allocates a memory buffer with a given size and alignment in the task's address space specified, and returns a memory descriptor instance representing the memory. It is recommended that memory allocated for I/O or sharing via mapping be created via IOBufferMemoryDescriptor. Options passed with the request specify the kind of memory to be allocated - pageablity and sharing are specified with option bits. This function may block and so should not be called from interrupt level or while a simple lock is held.
+ @param inTask The task the buffer will be mapped in. Pass NULL to create memory unmapped in any task (eg. for use as a DMA buffer).
+ @param options Options for the allocation:
+ kIODirectionOut, kIODirectionIn - set the direction of the I/O transfer.
+ kIOMemoryPhysicallyContiguous - pass to request memory be physically contiguous. This option is heavily discouraged. The request may fail if memory is fragmented, may cause large amounts of paging activity, and may take a very long time to execute.
+ kIOMemoryKernelUserShared - pass to request memory that will be mapped into both the kernel and client applications.
+ kIOMapInhibitCache - allocate memory with inhibited cache setting.
+ kIOMapWriteThruCache - allocate memory with writethru cache setting.
+ kIOMapCopybackCache - allocate memory with copyback cache setting.
+ kIOMapWriteCombineCache - allocate memory with writecombined cache setting.
+ @param capacity The number of bytes to allocate.
+ @param physicalMask The buffer will be allocated with pages such that physical addresses will only have bits set present in physicalMask. For example, pass 0x00000000FFFFFFFFULL for a buffer to be accessed by hardware that has 32 address bits.
+ @result Returns an instance of class IOBufferMemoryDescriptor to be released by the caller, which will free the memory desriptor and associated buffer. */
+
+ static IOBufferMemoryDescriptor * inTaskWithPhysicalMask(
+ task_t inTask,
+ IOOptionBits options,
+ mach_vm_size_t capacity,
+ mach_vm_address_t physicalMask);
+
/*
* withCapacity:
*
@@ -166,16 +199,12 @@ public:
vm_size_t capacity,
IODirection withDirection,
bool withContiguousMemory = false);
- /*
- * initWithBytes:
- *
- * Initialize a new IOBufferMemoryDescriptor preloaded with bytes (copied).
- * The descriptor's length and capacity are set to the input buffer's size.
- */
+#ifndef __LP64__
virtual bool initWithBytes(const void * bytes,
vm_size_t withLength,
IODirection withDirection,
- bool withContiguousMemory = false);
+ bool withContiguousMemory = false) APPLE_KEXT_DEPRECATED; /* use withBytes() instead */
+#endif /* !__LP64__ */
/*
* withBytes:
@@ -239,6 +268,11 @@ public:
* will not copy past the end of the memory descriptor's current capacity.
*/
virtual bool appendBytes(const void *bytes, vm_size_t withLength);
+
+#ifndef __LP64__
+ virtual void * getVirtualSegment(IOByteCount offset,
+ IOByteCount * length) APPLE_KEXT_OVERRIDE APPLE_KEXT_DEPRECATED; /* use getBytesNoCopy() instead */
+#endif /* !__LP64__ */
};
#endif /* !_IOBUFFERMEMORYDESCRIPTOR_H */