xref: /xnu-10063.121.3/iokit/IOKit/IOReturn.h (revision 2c2f96dc2b9a4408a43d3150ae9c105355ca3daa)
1 /*
2  * Copyright (c) 1998-2002 Apple Computer, 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  * HISTORY
30  */
31 
32 /*
33  * Core IOReturn values. Others may be family defined.
34  */
35 
36 #ifndef __IOKIT_IORETURN_H
37 #define __IOKIT_IORETURN_H
38 
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42 
43 #ifndef XNU_PLATFORM_DriverKit
44 
45 #include <mach/error.h>
46 
47 #else  /* XNU_PLATFORM_DriverKit */
48 
49 #ifdef DRIVERKIT_PRIVATE
50 
51 #include <mach/error.h>
52 
53 #else  /* DRIVERKIT_PRIVATE */
54 
55 typedef int             kern_return_t;
56 
57 #define KERN_SUCCESS                    0
58 
59 /*
60  *	error number layout as follows:
61  *
62  *	hi		                       lo
63  *	| system(6) | subsystem(12) | code(14) |
64  */
65 
66 #define err_none                (kern_return_t)0
67 #define ERR_SUCCESS             (kern_return_t)0
68 
69 #define err_system(x)           ((signed)((((unsigned)(x))&0x3f)<<26))
70 #define err_sub(x)              (((x)&0xfff)<<14)
71 
72 #define err_get_system(err)     (((err)>>26)&0x3f)
73 #define err_get_sub(err)        (((err)>>14)&0xfff)
74 #define err_get_code(err)       ((err)&0x3fff)
75 
76 #define err_max_system          0x3f
77 
78 #define system_emask            (err_system(err_max_system))
79 #define sub_emask               (err_sub(0xfff))
80 #define code_emask              (0x3fff)
81 
82 #endif  /* DRIVERKIT_PRIVATE */
83 
84 #endif /* XNU_PLATFORM_DriverKit */
85 
86 typedef kern_return_t           IOReturn;
87 
88 #ifndef sys_iokit
89 #define sys_iokit                         err_system(0x38)
90 #endif /* sys_iokit */
91 #define sub_iokit_common                  err_sub(0)
92 #define sub_iokit_usb                     err_sub(1)
93 #define sub_iokit_firewire                err_sub(2)
94 #define sub_iokit_block_storage           err_sub(4)
95 #define sub_iokit_graphics                err_sub(5)
96 #define sub_iokit_networking              err_sub(6)
97 #define sub_iokit_bluetooth               err_sub(8)
98 #define sub_iokit_pmu                     err_sub(9)
99 #define sub_iokit_acpi                    err_sub(10)
100 #define sub_iokit_smbus                   err_sub(11)
101 #define sub_iokit_ahci                    err_sub(12)
102 #define sub_iokit_powermanagement         err_sub(13)
103 #define sub_iokit_hidsystem               err_sub(14)
104 #define sub_iokit_scsi                    err_sub(16)
105 #define sub_iokit_usbaudio                err_sub(17)
106 #define sub_iokit_wirelesscharging        err_sub(18)
107 //#define sub_iokit_pccard                err_sub(21)
108 #ifdef PRIVATE
109 #define sub_iokit_nvme                    err_sub(28)
110 #endif
111 #define sub_iokit_thunderbolt             err_sub(29)
112 #define sub_iokit_graphics_acceleration   err_sub(30)
113 #define sub_iokit_keystore                err_sub(31)
114 #ifdef PRIVATE
115 #define sub_iokit_smc                     err_sub(32)
116 #endif
117 #define sub_iokit_apfs                    err_sub(33)
118 #define sub_iokit_acpiec                  err_sub(34)
119 #define sub_iokit_timesync_avb            err_sub(35)
120 
121 #define sub_iokit_platform                err_sub(0x2A)
122 #define sub_iokit_audio_video             err_sub(0x45)
123 #define sub_iokit_cec                     err_sub(0x46)
124 #define sub_iokit_arc                     err_sub(0x47)
125 #define sub_iokit_baseband                err_sub(0x80)
126 #define sub_iokit_HDA                     err_sub(0xFE)
127 #define sub_iokit_hsic                    err_sub(0x147)
128 #define sub_iokit_sdio                    err_sub(0x174)
129 #define sub_iokit_wlan                    err_sub(0x208)
130 #define sub_iokit_appleembeddedsleepwakehandler  err_sub(0x209)
131 #define sub_iokit_appleppm                err_sub(0x20A)
132 
133 #define sub_iokit_vendor_specific         err_sub(-2)
134 #define sub_iokit_reserved                err_sub(-1)
135 
136 #define iokit_common_err(return )          (sys_iokit|sub_iokit_common|return)
137 #define iokit_family_err(sub, return )      (sys_iokit|sub|return)
138 #define iokit_vendor_specific_err(return ) (sys_iokit|sub_iokit_vendor_specific|return)
139 
140 #define kIOReturnSuccess         KERN_SUCCESS            // OK
141 #define kIOReturnError           iokit_common_err(0x2bc) // general error
142 #define kIOReturnNoMemory        iokit_common_err(0x2bd) // can't allocate memory
143 #define kIOReturnNoResources     iokit_common_err(0x2be) // resource shortage
144 #define kIOReturnIPCError        iokit_common_err(0x2bf) // error during IPC
145 #define kIOReturnNoDevice        iokit_common_err(0x2c0) // no such device
146 #define kIOReturnNotPrivileged   iokit_common_err(0x2c1) // privilege violation
147 #define kIOReturnBadArgument     iokit_common_err(0x2c2) // invalid argument
148 #define kIOReturnLockedRead      iokit_common_err(0x2c3) // device read locked
149 #define kIOReturnLockedWrite     iokit_common_err(0x2c4) // device write locked
150 #define kIOReturnExclusiveAccess iokit_common_err(0x2c5) // exclusive access and
151                                                          //   device already open
152 #define kIOReturnBadMessageID    iokit_common_err(0x2c6) // sent/received messages
153                                                          //   had different msg_id
154 #define kIOReturnUnsupported     iokit_common_err(0x2c7) // unsupported function
155 #define kIOReturnVMError         iokit_common_err(0x2c8) // misc. VM failure
156 #define kIOReturnInternalError   iokit_common_err(0x2c9) // internal error
157 #define kIOReturnIOError         iokit_common_err(0x2ca) // General I/O error
158 //#define kIOReturn???Error      iokit_common_err(0x2cb) // ???
159 #define kIOReturnCannotLock      iokit_common_err(0x2cc) // can't acquire lock
160 #define kIOReturnNotOpen         iokit_common_err(0x2cd) // device not open
161 #define kIOReturnNotReadable     iokit_common_err(0x2ce) // read not supported
162 #define kIOReturnNotWritable     iokit_common_err(0x2cf) // write not supported
163 #define kIOReturnNotAligned      iokit_common_err(0x2d0) // alignment error
164 #define kIOReturnBadMedia        iokit_common_err(0x2d1) // Media Error
165 #define kIOReturnStillOpen       iokit_common_err(0x2d2) // device(s) still open
166 #define kIOReturnRLDError        iokit_common_err(0x2d3) // rld failure
167 #define kIOReturnDMAError        iokit_common_err(0x2d4) // DMA failure
168 #define kIOReturnBusy            iokit_common_err(0x2d5) // Device Busy
169 #define kIOReturnTimeout         iokit_common_err(0x2d6) // I/O Timeout
170 #define kIOReturnOffline         iokit_common_err(0x2d7) // device offline
171 #define kIOReturnNotReady        iokit_common_err(0x2d8) // not ready
172 #define kIOReturnNotAttached     iokit_common_err(0x2d9) // device not attached
173 #define kIOReturnNoChannels      iokit_common_err(0x2da) // no DMA channels left
174 #define kIOReturnNoSpace         iokit_common_err(0x2db) // no space for data
175 //#define kIOReturn???Error      iokit_common_err(0x2dc) // ???
176 #define kIOReturnPortExists      iokit_common_err(0x2dd) // port already exists
177 #define kIOReturnCannotWire      iokit_common_err(0x2de) // can't wire down
178                                                          //   physical memory
179 #define kIOReturnNoInterrupt     iokit_common_err(0x2df) // no interrupt attached
180 #define kIOReturnNoFrames        iokit_common_err(0x2e0) // no DMA frames enqueued
181 #define kIOReturnMessageTooLarge iokit_common_err(0x2e1) // oversized msg received
182                                                          //   on interrupt port
183 #define kIOReturnNotPermitted    iokit_common_err(0x2e2) // not permitted
184 #define kIOReturnNoPower         iokit_common_err(0x2e3) // no power to device
185 #define kIOReturnNoMedia         iokit_common_err(0x2e4) // media not present
186 #define kIOReturnUnformattedMedia iokit_common_err(0x2e5)// media not formatted
187 #define kIOReturnUnsupportedMode iokit_common_err(0x2e6) // no such mode
188 #define kIOReturnUnderrun        iokit_common_err(0x2e7) // data underrun
189 #define kIOReturnOverrun         iokit_common_err(0x2e8) // data overrun
190 #define kIOReturnDeviceError     iokit_common_err(0x2e9) // the device is not working properly!
191 #define kIOReturnNoCompletion    iokit_common_err(0x2ea) // a completion routine is required
192 #define kIOReturnAborted         iokit_common_err(0x2eb) // operation aborted
193 #define kIOReturnNoBandwidth     iokit_common_err(0x2ec) // bus bandwidth would be exceeded
194 #define kIOReturnNotResponding   iokit_common_err(0x2ed) // device not responding
195 #define kIOReturnIsoTooOld       iokit_common_err(0x2ee) // isochronous I/O request for distant past!
196 #define kIOReturnIsoTooNew       iokit_common_err(0x2ef) // isochronous I/O request for distant future
197 #define kIOReturnNotFound        iokit_common_err(0x2f0) // data was not found
198 #define kIOReturnInvalid         iokit_common_err(0x1)   // should never be seen
199 
200 #ifdef __cplusplus
201 }
202 #endif
203 
204 #endif /* ! __IOKIT_IORETURN_H */
205