1 /* 2 * Copyright (c) 2003-2004 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 #ifndef LIBKERN_SYSCTL_H 30 #define LIBKERN_SYSCTL_H 31 32 #include <sys/cdefs.h> 33 34 __BEGIN_DECLS 35 36 #include <sys/types.h> 37 38 /* 39 * These are the support HW selectors for sysctlbyname. Parameters that are byte counts or frequencies are 64 bit numbers. 40 * All other parameters are 32 bit numbers. 41 * 42 * hw.memsize - The number of bytes of physical memory in the system. 43 * 44 * hw.ncpu - The maximum number of processors that could be available this boot. 45 * Use this value for sizing of static per processor arrays; i.e. processor load statistics. 46 * 47 * hw.activecpu - The number of processors currently available for executing threads. 48 * Use this number to determine the number threads to create in SMP aware applications. 49 * This number can change when power management modes are changed. 50 * 51 * hw.physicalcpu - The number of physical processors available in the current power management mode. 52 * hw.physicalcpu_max - The maximum number of physical processors that could be available this boot 53 * 54 * hw.logicalcpu - The number of logical processors available in the current power management mode. 55 * hw.logicalcpu_max - The maximum number of logical processors that could be available this boot 56 * 57 * hw.tbfrequency - This gives the time base frequency used by the OS and is the basis of all timing services. 58 * In general is is better to use mach's or higher level timing services, but this value 59 * is needed to convert the PPC Time Base registers to real time. 60 * 61 * hw.cpufrequency - These values provide the current, min and max cpu frequency. The min and max are for 62 * hw.cpufrequency_max - all power management modes. The current frequency is the max frequency in the current mode. 63 * hw.cpufrequency_min - All frequencies are in Hz. 64 * 65 * hw.busfrequency - These values provide the current, min and max bus frequency. The min and max are for 66 * hw.busfrequency_max - all power management modes. The current frequency is the max frequency in the current mode. 67 * hw.busfrequency_min - All frequencies are in Hz. 68 * 69 * hw.cputype - These values provide the mach-o cpu type and subtype. A complete list is in <mach/machine.h> 70 * hw.cpusubtype - These values should be used to determine what processor family the running cpu is from so that 71 * the best binary can be chosen, or the best dynamic code generated. They should not be used 72 * to determine if a given processor feature is available. 73 * hw.cputhreadtype - This value will be present if the processor supports threads. Like hw.cpusubtype this selector 74 * should not be used to infer features, and only used to name the processors thread architecture. 75 * The values are defined in <mach/machine.h> 76 * 77 * hw.byteorder - Gives the byte order of the processor. 4321 for big endian, 1234 for little. 78 * 79 * hw.pagesize - Gives the size in bytes of the pages used by the processor and VM system. 80 * 81 * hw.cachelinesize - Gives the size in bytes of the processor's cache lines. 82 * This value should be use to control the strides of loops that use cache control instructions 83 * like dcbz, dcbt or dcbst. 84 * 85 * hw.l1dcachesize - These values provide the size in bytes of the L1, L2 and L3 caches. If a cache is not present 86 * hw.l1icachesize - then the selector will return and error. 87 * hw.l2cachesize - 88 * hw.l3cachesize - 89 * 90 * 91 * These are the selectors for optional processor features. Selectors that return errors are not support on the system. 92 * Supported features will return 1 if they are recommended or 0 if they are supported but are not expected to help performance. 93 * Future versions of these selectors may return larger values as necessary so it is best to test for non zero. 94 * 95 * hw.optional.floatingpoint - Floating Point Instructions 96 * hw.optional.altivec - AltiVec Instructions 97 * hw.optional.graphicsops - Graphics Operations 98 * hw.optional.64bitops - 64-bit Instructions 99 * hw.optional.fsqrt - HW Floating Point Square Root Instruction 100 * hw.optional.stfiwx - Store Floating Point as Integer Word Indexed Instructions 101 * hw.optional.dcba - Data Cache Block Allocate Instruction 102 * hw.optional.datastreams - Data Streams Instructions 103 * hw.optional.dcbtstreams - Data Cache Block Touch Steams Instruction Form 104 * 105 */ 106 107 /* 108 * Sysctl handling 109 */ 110 #ifdef XNU_KERNEL_PRIVATE 111 int kernel_sysctlbyname(const char *, void *, size_t *, void *, size_t); 112 #else 113 int sysctlbyname(const char *, void *, size_t *, void *, size_t); 114 #endif 115 116 __END_DECLS 117 118 #endif /* LIBKERN_SYSCTL_H */ 119