OLD | NEW |
(Empty) | |
| 1 /* |
| 2 * Copyright (c) 1999 Apple Computer, Inc. All rights reserved. |
| 3 * |
| 4 * @APPLE_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. Please obtain a copy of the License at |
| 10 * http://www.opensource.apple.com/apsl/ and read it before using this |
| 11 * file. |
| 12 * |
| 13 * The Original Code and all software distributed under the License are |
| 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER |
| 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, |
| 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, |
| 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. |
| 18 * Please see the License for the specific language governing rights and |
| 19 * limitations under the License. |
| 20 * |
| 21 * @APPLE_LICENSE_HEADER_END@ |
| 22 */ |
| 23 #ifndef _MACH_O_ARCH_H_ |
| 24 #define _MACH_O_ARCH_H_ |
| 25 /* |
| 26 * Copyright (c) 1997 Apple Computer, Inc. |
| 27 * |
| 28 * Functions that deal with information about architectures. |
| 29 * |
| 30 */ |
| 31 |
| 32 #include <stdint.h> |
| 33 #include <mach/machine.h> |
| 34 #include <architecture/byte_order.h> |
| 35 |
| 36 /* The NXArchInfo structs contain the architectures symbolic name |
| 37 * (such as "ppc"), its CPU type and CPU subtype as defined in |
| 38 * mach/machine.h, the byte order for the architecture, and a |
| 39 * describing string (such as "PowerPC"). |
| 40 * There will both be entries for specific CPUs (such as ppc604e) as |
| 41 * well as generic "family" entries (such as ppc). |
| 42 */ |
| 43 typedef struct { |
| 44 const char *name; |
| 45 cpu_type_t cputype; |
| 46 cpu_subtype_t cpusubtype; |
| 47 enum NXByteOrder byteorder; |
| 48 const char *description; |
| 49 } NXArchInfo; |
| 50 |
| 51 #if __cplusplus |
| 52 extern "C" { |
| 53 #endif /* __cplusplus */ |
| 54 |
| 55 /* NXGetAllArchInfos() returns a pointer to an array of all known |
| 56 * NXArchInfo structures. The last NXArchInfo is marked by a NULL name. |
| 57 */ |
| 58 extern const NXArchInfo *NXGetAllArchInfos(void); |
| 59 |
| 60 /* NXGetLocalArchInfo() returns the NXArchInfo for the local host, or NULL |
| 61 * if none is known. |
| 62 */ |
| 63 extern const NXArchInfo *NXGetLocalArchInfo(void); |
| 64 |
| 65 /* NXGetArchInfoFromName() and NXGetArchInfoFromCpuType() return the |
| 66 * NXArchInfo from the architecture's name or cputype/cpusubtype |
| 67 * combination. A cpusubtype of CPU_SUBTYPE_MULTIPLE can be used |
| 68 * to request the most general NXArchInfo known for the given cputype. |
| 69 * NULL is returned if no matching NXArchInfo can be found. |
| 70 */ |
| 71 extern const NXArchInfo *NXGetArchInfoFromName(const char *name); |
| 72 extern const NXArchInfo *NXGetArchInfoFromCpuType(cpu_type_t cputype, |
| 73 cpu_subtype_t cpusubtype); |
| 74 |
| 75 /* NXFindBestFatArch() is passed a cputype and cpusubtype and a set of |
| 76 * fat_arch structs and selects the best one that matches (if any) and returns |
| 77 * a pointer to that fat_arch struct (or NULL). The fat_arch structs must be |
| 78 * in the host byte order and correct such that the fat_archs really points to |
| 79 * enough memory for nfat_arch structs. It is possible that this routine could |
| 80 * fail if new cputypes or cpusubtypes are added and an old version of this |
| 81 * routine is used. But if there is an exact match between the cputype and |
| 82 * cpusubtype and one of the fat_arch structs this routine will always succeed. |
| 83 */ |
| 84 extern struct fat_arch *NXFindBestFatArch(cpu_type_t cputype, |
| 85 cpu_subtype_t cpusubtype, |
| 86 struct fat_arch *fat_archs, |
| 87 uint32_t nfat_archs); |
| 88 |
| 89 /* NXCombineCpuSubtypes() returns the resulting cpusubtype when combining two |
| 90 * different cpusubtypes for the specified cputype. If the two cpusubtypes |
| 91 * can't be combined (the specific subtypes are mutually exclusive) -1 is |
| 92 * returned indicating it is an error to combine them. This can also fail and |
| 93 * return -1 if new cputypes or cpusubtypes are added and an old version of |
| 94 * this routine is used. But if the cpusubtypes are the same they can always |
| 95 * be combined and this routine will return the cpusubtype pass in. |
| 96 */ |
| 97 extern cpu_subtype_t NXCombineCpuSubtypes(cpu_type_t cputype, |
| 98 cpu_subtype_t cpusubtype1, |
| 99 cpu_subtype_t cpusubtype2); |
| 100 |
| 101 #if __cplusplus |
| 102 } |
| 103 #endif /* __cplusplus */ |
| 104 |
| 105 #endif /* _MACH_O_ARCH_H_ */ |
OLD | NEW |