BuildMachineOSBuild 23A344017 CFBundleDevelopmentRegion en CFBundleExecutable CPUTrace CFBundleIdentifier com.apple.AppleTracingSupport.CPUTraceProvider CFBundleInfoDictionaryVersion 6.0 CFBundleName CPUTrace CFBundlePackageType BNDL CFBundleShortVersionString 1.0 CFBundleSupportedPlatforms MacOSX CFBundleVersion 69 DTCompiler com.apple.compilers.llvm.clang.1_0 DTPlatformBuild 25E223 DTPlatformName macosx DTPlatformVersion 26.4 DTSDKBuild 25E223 DTSDKName macosx26.4.internal DTXcode 2630 DTXcodeBuild 17E6107 Documentation Description AppleProcessorTrace (aka CPUTrace) provides a precise record of every instruction executed, on all cores/threads, over a window of time. You can then see precisely where each cycle was spent across user and/or kernel space. Options Description List of systems to be traced. Defaults to only tracing XNU. Option systems Description Enable (1) or disable (0) streaming to filesystem. Defaults to enabled. Option stream Description Enable (1) or disable (0) throttling a workload to reduce trace packet loss. Defaults to disabled. Option throttle Description Enable (1) or disable (0) capturing addresses. Records the address every time there is a load or store instruction. Defaults to disabled. Option address Description Rate-limit writes to the filesystem with a user-provided limit expressed in MB/s. When the hardware generates trace packets at a rate higher than the limit, data is discarded. This option requires --CPUTrace:stream to be enabled. By default, rate limiting is disabled. Option rate-limit Description Enable (1=ringbuffer, 2=ringbuffer-memory, 3=ringbuffer-filesystem) or disable (0) wraparound mode. Defaults to disabled. Option wrap Description Enable (1) or disable (0) production trace. Defaults to disabled. Option prod Description Enable (1) or disable (0) driver trace. Defaults to enabled. Option driver Description Record a process specified by pid_t. Specifying 0 for the process id will limit tracing to the kernel. Option process-id Description Enable (1) or disable (0) collecting all of the referenced symbols as part of the unified Symbols schema for the trace. Defaults to enabled. Option collect-symbols Description Enable (1) or disable (0) copying images. This option causes a significant trace size increase. When the `decode` option is disabled, this makes the final trace portable to other machines. Option copy-images Description Enable (1) or disable (0) decoding the trace on-device. This makes the final trace smaller and faster to open, but takes time. Defaults to enabled. Option decode Description Compresses results while decoding, achieving 3-5x size reduction. Value must be a choice of an algorithm: LZ4, LZ4_RAW or LZFSE, Only valid when decode=1 is set. Option decode-compression Description Size of the virtual ringbuffer (memory, filesystem) in megabytes. Defaults to 0. Option wrap-size Description Size limit trace can use for recording in megabytes. Once reach the limit, data recording will stop. Defaults to 0 - unlimited. Option size-limit Description Dynamic trace buffer size in megabytes. Defaults to 0 - system picks an appropriate size. Option trace-buffer-size Description Enable (1) or disable (0) CPMU trace. Defaults to enabled. Option cpmu Synopsis Collect HW Processor Trace data alongside SW events LSMinimumSystemVersion 26.4 NSPrincipalClass CPUTraceProvider