| /xnu-11215/iokit/DriverKit/ |
| H A D | OSAction.iig | 10 * may not be used to create, or enable the creation or redistribution of,
43 * OSAction is an object that represents a callback to be be invoked.
112 * @discussion After cancellation, the action can only be freed. It cannot be reactivated.
113 * @param handler Handler block to be invoked after any callbacks have completed.
123 * @param handler Handler block to be invoked on no more references.
130 * @brief Mark this OSAction to be waited for later with Wait().
131 * @discussion This call should be made before any possible invocation of the action.
143 * if necessary the action should be canceled before calling EndWait().
144 * @param token Opaque value to be passed from an earlier call to WillWait().
153 * @brief Wait for the action to be invoked.
[all …]
|
| H A D | IOUserClient.iig | 10 * may not be used to create, or enable the creation or redistribution of,
83 * @discussion Any argument may be passed as NULL if not passed by the caller.
94 * the data to be returned, and the OSData instance will be released by the OS.
131 * if true completion field must be set,
132 * if false must be zero,
187 * Any argument may be passed as NULL if not passed by the caller.
195 * implementation may be called with a non-NULL argument to check
220 * @param status An IOReturn status value to be sent.
221 * @param asyncData An array of scalar data to be sent.
252 * kIOMemoryDirectionIn memory described will be writable
[all …]
|
| H A D | IOInterruptDispatchSource.iig | 10 * may not be used to create, or enable the creation or redistribution of,
71 …urceContinuousTime time values sent to the InterruptOccurred() method will be in mach_continuous_t…
73 * @param source Created source with +1 retain count to be released by the caller.
86 * @param interruptType The interrupt type for the interrupt source will be stored here.
87 * kIOInterruptTypeEdge will be returned for edge-trigggered sources.
88 * kIOInterruptTypeLevel will be returned for level-trigggered sources.
89 …* Other flags may be returned depending on the provider, for example PCI flags for me…
106 … action OSAction instance specifying the callback method. The OSAction object will be retained
117 …* @param handler Optional block to be executed after the interrupt has been disabled and any…
128 * @discussion After cancellation, the source can only be freed. It cannot be reactivated.
[all …]
|
| H A D | IOServiceNotificationDispatchSource.iig | 10 * may not be used to create, or enable the creation or redistribution of,
57 * @param source Created source with +1 retain count to be released by the caller.
76 …* @param handler Optional block to be executed after the interrupt has been disabled and any…
87 * @discussion After cancellation, the source can only be freed. It cannot be reactivated.
88 * @param handler Handler block to be invoked after any callbacks have completed.
96 … action OSAction instance specifying the callback method. The OSAction object will be retained
109 * It should be retained by the block code if used beyond the invocation.
110 * @param block to be invoked with each notification
|
| H A D | IOEventLink.iig | 10 * may not be used to create, or enable the creation or redistribution of,
76 …* Once the remote eventlink port has been sent to the driver, the driver should be notified with a…
92 * user client, the old IOEventLink will be replaced.
95 … * @param eventLink Created IOEventLink with +1 retain count to be released by the caller.
105 * @discussion This is not meant to be used directly.
133 … When the calling thread wakes up, the amount of signals consumed by the wait will be written here.
171 …* @discussion The event link must be activated before it can be signaled or waited on. This is no…
179 * @discussion The eventlink should be activated before this call. This is not real-time safe.
195 …* @discussion This releases the kernel reference to the IOEventLink, allowing the name to be used…
196 …* IOEventLink. This method should be called after the client has configured the event…
[all …]
|
| H A D | IOServiceStateNotificationDispatchSource.iig | 10 * may not be used to create, or enable the creation or redistribution of,
50 * @param items Array of state item names to be notified about.
54 * @param source Created source with +1 retain count to be released by the caller.
64 …* @param handler Optional block to be executed after the interrupt has been disabled and any…
75 * @discussion After cancellation, the source can only be freed. It cannot be reactivated.
76 * @param handler Handler block to be invoked after any callbacks have completed.
84 … action OSAction instance specifying the callback method. The OSAction object will be retained
|
| H A D | IOExtensiblePaniclog.iig | 10 * may not be used to create, or enable the creation or redistribution of,
64 * @brief This function is to be called to create IOExtensiblePaniclog object.
65 * @discussion First function to be called.
70 * @param options Options to be passed while creating the handle
100 * @param data Data to be inserted
101 * @param len The length to be copied.
112 * @param data Data to be inserted
113 * @param len The length to be copied.
132 …* After claiming the buffer, YieldBuffer() has to be called to set the used_len of th…
145 * @discussion After this function call, InsertData() and AppendData() can be called.
|
| H A D | IOWorkGroup.iig | 10 * may not be used to create, or enable the creation or redistribution of,
60 …* Once the workgroup port has been sent to the driver, the driver should be notified with a user-d…
78 … * @param workgroup Created IOWorkGroup with +1 retain count to be released by the caller.
87 * @brief Set the port for this workgroup. This should not be called directly.
98 …* @discussion Join() and Leave() require the caller to pass a token. This token should be allocat…
107 …ore calling this method, the caller must allocate a token. This token must be passed to this metho…
126 …* @discussion This releases the kernel reference to the IOWorkGroup, allowing the name to be used…
127 …* IOWorkGroup. This method should be called after the client has configured the event…
128 …* call. After invalidation, the IOWorkGroup can no longer be configured through the I…
|
| H A D | IODispatchQueue.iig | 10 * may not be used to create, or enable the creation or redistribution of,
127 * @brief Schedule a block to be executed on the queue asynchronously.
128 …* @discussion Schedules work to be done on the queue without waiting for it to complete. The queu…
142 * @brief Schedule a block to be executed concurrently & asynchronously.
143 * @discussion Schedules work to be done on the queue without waiting for it to complete, and
145 * retained until the block completes. May only be used with a queue created with
174 * @param output printf like output function. The address of IOLog is suitable to be used.
189 * The caller must be currently running on the queue to call Sleep().
203 * The caller must be currently running on the queue to call Sleep().
220 * The caller must be currently running on the queue.
[all …]
|
| H A D | OSObject.iig | 10 * may not be used to create, or enable the creation or redistribution of,
138 * DRIVERKIT_ macros below can be used to describe the ownership semantics
140 * The attributes propagate with inheritance, but can be overriden.
149 * - Functions and methods that have "Get" in their name are assumed to be
156 * The semantics implied by the naming convention described above can be
162 * can be also applied to out parameters, in which case they specify
164 * Behavior of out parameters of non-void functions can be additionally
182 * DRIVERKIT_CONSUMED attribute can be applied to parameters.
193 * DRIVERKIT_CONSUMES_THIS attribute can be applied to C++ methods.
231 * be used in code that gets compiled for both platforms.
[all …]
|
| H A D | IODataQueueDispatchSource.iig | 10 * may not be used to create, or enable the creation or redistribution of,
48 * @param source Created source with +1 retain count to be released by the caller.
73 … action OSAction instance specifying the callback method. The OSAction object will be retained
85 … action OSAction instance specifying the callback method. The OSAction object will be retained
97 …* @param handler Optional block to be executed after the interrupt has been disabled and any…
108 * @discussion After cancellation, the source can only be freed. It cannot be reactivated.
109 * @param handler Handler block to be invoked after any callbacks have completed.
125 … * @param callback to invoked if the queue is non-empty with the next entry to be dequeued.
157 * It should be initialized to false before a series of calls to this method,
171 * It should be initialized to false before a series of calls to this method,
[all …]
|
| H A D | IODMACommand.iig | 10 * may not be used to create, or enable the creation or redistribution of,
78 * IODMACommand allows a mapping for DMA to be created from an IOMemoryDescriptor.
81 * IODMACommand allows a mapping for DMA to be created from an IOMemoryDescriptor.
82 * The IODMACommand instance represents the mapping and should be kept prepared for the
102 * @param device The device (typically an IOPCIDevice instance that will be
109 * It should be retained until the map is no longer required.
158 * @param memory Returned IOMemoryDescriptor of the preparation. This should be
170 * @param options Flags for the operation to be performed
|
| /xnu-11215/doc/allocators/ |
| H A D | api-basics.md | 49 is to be passed:
52 - `Z_NOWAIT` can be used to require a fully non blocking behavior, which can be
86 - the allocation must be per-cpu,
109 must be restructured to fit, for security reasons.
121 are also provided but should typically rarely be used.
135 when this isn't possible, a zone should be considered.
149 then the array element type **must not** be only data.
151 If those rules can't be followed, then the allocation must be split with
265 and <tt>type_t</tt> can't be a primitive type.
288 and non-POD types should be used seldomly.
[all …]
|
| H A D | read-only.md | 8 "read-only" allocations. Data allocated from a read-only zone can only be
39 be written into memory once and seldom changed thereafter. We can therefore
43 Data under the control of the Read-Only Allocator can be read from just as
44 cheaply and easily as other data, but writing to it must be done through the
45 relatively expensive `zalloc_ro_mut` function. By insisting that data be
53 To make best use of the Read-Only Allocator, some simple advice should be
57 themselves, or be protected by PAC.
84 Read-only zones cannot be created after lockdown. To create a new read-only
85 zone, a new identifier must be added to the `zone_reserved_id_t` enumeration
86 and it must be created by passing `ZC_READONLY` through either `ZONE_INIT` or
|
| /xnu-11215/doc/building/ |
| H A D | xnu_build_consolidation.md | 18 Although this effort could be extended to KEXTs, and hence lead to shared KernelCaches across devic…
20 required KEXTs are completely different in the first place, the kernel still needs to be linked
21 appropriately with different sets of KEXTs and hence KernelCaches cannot be shared.
31 * Addresses of PIO registers that are to be accessed from the XNU side.
38 All of these problems can be solved through a mix of relying more heavily on device tree informatio…
40 extensions provide r/o registers that can be checked at runtime to discover supported features as w…
48 `caches_asm.s`. The ARM architecture provides the `CCSIDR_EL1` register, which can be used in conju…
90 feature, and the ARM ARM specifies how it can be discovered). For Apple-specific features, these ar…
92 ml_feature_supported(), that may be used to check for the presence of a feature at runtime.
125 to be queried at runtime through the `ml_` API.
[all …]
|
| /xnu-11215/tests/ |
| H A D | test_sysctl_kern_procargs_25397314.m | 61 T_LOG("procargs data should be %lu bytes", preflightSize);
72 T_ASSERT_LE(bufferSize, allocSize, "returned buffer size should be less than allocated size");
76 T_ASSERT_EQ(bufferSize, preflightSize, "buffer size should be the same as preflight size");
263 T_ASSERT_NOTNULL(procargs->executablePath, "executable path should be non-null");
264 T_ASSERT_GT([procargs->executablePath length], 0, "executable path should not be empty");
269 T_ASSERT_NOTNULL(procargs->executablePath, "executable path should be non-null");
270 T_ASSERT_GT([procargs->executablePath length], 0, "executable path should not be empty");
278 T_ASSERT_NOTNULL(procargs->executablePath, "executable path should be non-null");
279 T_ASSERT_GT([procargs->executablePath length], 0, "executable path should not be empty");
308 T_ASSERT_NOTNULL(procargs->executablePath, "executable path should be non-null");
[all …]
|
| /xnu-11215/doc/primitives/ |
| H A D | atomics.md | 44 - an *explicit* variant where memory orderings can be specified,
96 functions do not need to be marked `_Atomic` or `volatile`
103 2. `os_atomic_*` cannot be coalesced by the compiler:
108 orderings must be provided and can express either memory orders
126 `<stdatomic.h>` functions may be used if:
134 be aware that a direct access to this variable will
137 The *consume* memory ordering should not be used
142 and these functions should not be used in new code.
235 will always be `expected`, however in case of failure it will be filled with
300 before the loop should be used in this way:
[all …]
|
| /xnu-11215/bsd/miscfs/devfs/ |
| H A D | README | 9 expect it to be highly useless for a while,
21 with that node. The back node itself can be considered to be
24 to in the code as the dev_name. The devnode can be considered the inode.
43 the nodes can be moved around within that plane (or deleted).
61 Information that is to be shared between these mounts is stored
66 it is easily recovered.. Particularly as there will eventually be
89 The front nodes may be moved to other directories (including
102 a mount -u might be considered to be a request to 'refresh' the
115 4/ I'm pretty sure my use of vnodes is bad and it may be 'losing'
|
| /xnu-11215/osfmk/mach/ |
| H A D | vm_map.defs | 122 * or wherever space can be found (if anywhere is TRUE),
159 * that may be given in the current protection.
191 * range must be aligned on a virtual page boundary,
192 * and must be a multiple of pages in extent. The
213 * range must be aligned on a virtual page boundary,
214 * and must be a multiple of pages in extent. The
226 * ranges must be aligned on a virtual page boundary,
227 * and must be multiples of pages in extent. The
281 * page boundary, be at or beyond the address specified, and
284 * will be rounded up to an integral number of virtual pages.
[all …]
|
| H A D | mach_vm.defs | 106 * or wherever space can be found (controlled by flags),
162 * that may be given in the current protection.
212 * range must be aligned on a virtual page boundary,
213 * and must be a multiple of pages in extent. The
242 * range must be aligned on a virtual page boundary,
243 * and must be a multiple of pages in extent. The
259 * ranges must be aligned on a virtual page boundary,
260 * and must be multiples of pages in extent. The
330 * page boundary, be at or beyond the address specified, and
333 * will be rounded up to an integral number of virtual pages.
[all …]
|
| H A D | mach_port.defs | 117 * The right must be one of
134 * The right must be one of
176 * The right must be one of
194 * The resulting user ref count can't be negative.
216 * queue will be peeked.
286 * MACH_NOTIFY_PORT_DESTROYED: must be zero.
289 * If zero, then name can't be dead.
331 * ref and the name may be available for recycling.
332 * msgt_name must be one of
385 * The right must be
[all …]
|
| /xnu-11215/doc/observability/ |
| H A D | mt_stackshot.md | 21 a CPU is derecommended due to thermal limits or otherwise, it will still be
24 On AMP systems, a suitable P-core is chosen to be the “main” CPU, and begins
25 populating queues of tasks to be put into the stackshot and collecting bits of
26 global state (On SMP systems, the initiating CPU is always assigned to be the
62 size. Should the buffer be too small, stackshot will try again with a bigger
85 one should be ahead of time. Because of this, allocate kcdata buffers in
124 CPU which can be seen from a debugger.
131 easily, but for now, it can be examined in lldb with `showpcpu -V
140 stackshot will not be taken.
156 - It might be more elegant to give stackshot its own IPI flavor instead of
[all …]
|
| /xnu-11215/doc/lifecycle/ |
| H A D | hibernation.md | 18 devices) where operations may be conducted from a single-threaded
54 to the first block of the file. (has to be done here because writing to nvram
64 regions that need to be included in the hibernation image (for example, the
78 state such that polled I/Os can be issued.
89 * All pages are assumed to be saved (as part of the wired image) unless
108 other pieces of memory must also be written unmodified to the hibernation
112 regions to be stored in this phase. This routine also calculates an HMAC
113 that can be used by the booter to validate this content.
115 hibernation image should be entirely self-contained; these are the only
155 only be invoked on a critical battery event.
[all …]
|
| /xnu-11215/doc/vm/ |
| H A D | sanitize.md | 10 by providing a set of APIs that can be used to perform consistent, thorough
41 Functions callable from userspace should be fully sanitized. Functions
61 1. rewrite an error code to be a different error code.
64 Not all changed error codes are (or could be) rewritten.
237 contain the basic blocks that could be chained to meet your specific
245 were supposed to be sanitized by the function.
311 may also be used to generate new golden files. Test results may also be
368 should be tested. The trials should be exhaustive for small values, and
379 name must be unique within a single test.
386 to be tested. If there is an existing VM API with similar setup or
[all …]
|
| /xnu-11215/tools/lldbmacros/ |
| H A D | README.md | 64 These could be very handy in printing important information from structures easily.
171 - remember that the ideal type of object to be passed around is core.value
172 - Anything you 'print' will be relayed to lldb terminal output.
174 …d any custom options they would be in cmd_options dict. the format is `{'-<optionflag>':'<value>'}…
237 [ remember that the ideal type of object to be passed around is core.value ]
239 …5. return a string that would be printed by the caller. When lldb makes a call back it expects a s…
345 a - int, value to be added. can be 0
346 b - int/float, value to be added.
355 * Function params should always be lower_case and be word separated with '_'
417 …debugging is particularly tricky. Many parts of memory may not be readable. There could be failure…
[all …]
|