< Previous PageNext Page >

Symbolic Names

Each symbolic name describes what the parameter represents and lists its descriptive name.

bufferSwapCount

The total number of buffer swaps (or blits) that the GPU perform. (Buffer Swaps)

clientGLWaitTime

The amount of time, in nanoseconds, that the CPU waits while the client (user-level) OpenGL driver waits for a hardware time stamp to arrive (usually for making texture modifications or waiting for a fence to complete). (CPU Wait in User Code)

command2DBytes

The number of bytes sent using 2D graphics contexts. (2D Command Data)

commandBytes

The number of bytes sent using all graphics contexts (2D, OpenGL, DVD). (Total Command Data)

commandDVDBytes

The number of bytes sent using DVD contexts. (DVD Command Data)

commandGLBytes

The number of bytes sent using OpenGL contexts. (OpenGL Command Data)

context2DCount

The total number of 2D contexts in use on the GPU. (2D Contexts)

context2DSwitchCount

The total number of context switches to a 2D context on the GPU. (2D Context Switches)

contextDVDCount

The total number of DVD contexts in use on the GPU. (DVD Contexts)

contextDVDSwitchCount

The total number of context switches to a DVD context on the GPU. (DVD Context Switches)

contextGLCount

The total number of OpenGL contexts in use on the GPU. (OpenGL Contexts)

contextGLSwitchCount

The total number of context switches to an OpenGL context on the GPU. (OpenGL Context Switches)

dataBufferCount

The total number of extra OpenGL data buffers allocated. (OpenGL Data Buffers)

dataGLBytes

The number of bytes used for extra OpenGL command traffic (usually vertex data). Not used by all drivers in all modes. (Extra OpenGL Data)

finish2DWaitTime

The amount of time, in nanoseconds, that the CPU waits for all 2D commands issued on a single context to complete. (CPU Wait for 2D Operations to Finish)

finishAll2DWaitTime

The amount of time, in nanoseconds, that the CPU waits for all GPU operations to complete and then to be idle. Generally, only the window server waits for this state. (CPU Wait for Operations to Finish)

finishDVDWaitTime

The amount of time, in nanoseconds, that the CPU waits for all DVD commands issued on a single context to complete. (CPU Wait for DVD Operations to Finish)

finishGLWaitTime

The amount of time, in nanoseconds, that the CPU waits for all OpenGL commands issued on a single context to complete. This is essentially the time spent in glFinish. (CPU Wait for OpenGL Operations to Finish)

freeCommandBuffer2DWaitTime

The amount of time, in nanoseconds, that the CPU waits for a 2D command buffer to become available. (CPU Wait for Free 2D Command Buffer)

freeCommandBufferGLWaitTime

The amount of time, in nanoseconds, that the CPU waits for an OpenGL command buffer to become available. (CPU Wait for Free OpenGL Command Buffer)

freeContextBuffer2DWaitTime

The amount of time, in nanoseconds, that the CPU waits for a 2D context-switching buffer to become available. (CPU Wait for Free 2D Context Switch Buffer)

freeContextBufferDVDWaitTime

The amount of time, in nanoseconds, that the CPU waits for a DVD context-switching buffer to become available. (CPU Wait for Free DVD Context Switch Buffer)

freeContextBufferGLWaitTime

The amount of time, in nanoseconds, that the CPU waits for an OpenGL context-switching buffer to become available. (CPU Wait for Free OpenGL Context Switch Buffer)

freeDataBufferGLWaitTime

The amount of time, in nanoseconds, that the CPU waits for an OpenGL data buffer to become available. (CPU Wait for Free OpenGL Data Buffer)

gartCacheBytes

The minimum amount of data, in bytes, that a driver tries to keep mapped into AGP Graphics Address Remapping Table (GART). (Target Minimum Mapped AGP Memory)

gartFreeBytes

The total number of free bytes in the AGP Graphics Address Remapping Table (GART). (Current Free AGP Memory)

gartMapInBytes

The number of bytes that are mapped into the AGP Graphics Address Remapping Table (GART) or equivalent hardware. (AGP Data Mapped)

gartMapOutBytes

The number of bytes that are unmapped from the AGP Graphics Address Remapping Table (GART) (or equivalent hardware). (AGP Data Unmapped)

gartSizeBytes

The total size, in bytes, of the AGP Graphics Address Remapping Table (GART). (Current AGP Memory)

gartUsedBytes

The total number of bytes mapped into AGP Graphics Address Remapping Table (GART). (Current Mapped AGP Memory)

hardwareSubmitWaitTime

The amount of time, in nanoseconds, that the CPU waits before being able to submit a new batch of commands to the GPU. (CPU Wait to Submit Commands)

hardwareWaitTime

The amount of time, in nanoseconds, that the CPU stalled while waiting on the GPU for any reason. (CPU Wait for GPU)

lastReadStamp

The last time stamp read back from the GPU, as an absolute time value. (Last Read GPU time)

removeFromGARTWaitTime

The amount of time, in nanoseconds, the CPU waits for the GPU to finish an operation on a buffer that needs to be removed from the Graphics Address Remapping Table (GART). (CPU Wait for Mapped AGP Buffer Removal)

submitStamp

The last submitted time stamp to the GPU, as an absolute time value. (Last GPU Submission Time)

surfaceCount

The total number of surfaces allocated by the GPU.(Surfaces)

surfaceCopyInWaitTime

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU can page a surface in to VRAM. (CPU Wait to perform VRAM Surface Page-on)

surfaceCopyOutWaitTime

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU can page a surface out of VRAM. (CPU Wait to perform VRAM Surface Page-off)

surfacePageInBytes

The number of bytes transferred due to surface page-on operations. (Surface Page On Data (Non-AGP))

surfacePageOffBytes

The number of bytes transferred due to surface page-off operations. (Surface Page Off Data (Non-AGP))

surfaceReadLockIdleWaitTime

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU may read from a surface. (CPU Wait to perform Surface Read)

surfaceSetShapeIdleWaitTime

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU may change the dimensions of a surface. (CPU Wait to perform Surface Resize)

surfaceWriteLockIdleWaitTime

The amount of time, in nanoseconds, that the CPU waits for the GPU to become idle so that the CPU may write to a surface. (CPU Wait to perform Surface Write)

swapBytes

The number of bytes sent by swap commands. (Swap Data)

swapComplete2DWaitTime

The amount of time, in nanoseconds, that the CPU waits for a previously issued 2D buffer swap to complete. (CPU Wait for 2D Swap to Complete)

swapCompleteDVDWaitTime

The amount of time, in nanoseconds, that the CPU waits for a previously issued DVD buffer swap to complete. (CPU Wait for DVD Swap to Complete)

swapCompleteGLWaitTime

The amount of time, in nanoseconds, that the CPU waits for a previously issued OpenGL buffer swap to complete. (CPU Wait for OpenGL Swap to Complete)

textureCount

The total number of kernel textures allocated by the GPU. (Textures)

texturePageInBytes

The number of bytes transferred for texture page-ins. Textures mapped using AGP will not show up here. (Texture Page On Data (Non-AGP))

texturePageInWaitTime

The amount of time, in nanoseconds, that the CPU waits for a texture upload command to be completed by the GPU. This is the that the CPU could use for updating and reloading a texture. Typically, there is very little, if any time, spent waiting here. (CPU Texture Page-on Wait)

texturePageOffWaitTime

The amount of time, in nanoseconds, that the CPU waits for the GPU to finish activity. This is the that the CPU could use to modify a texture prior to paging the texture. This metric applies only if the texture must be paged using the CPU and not using direct memory access (DMA). (CPU Texture Page-off Wait (non-DMA))

texturePageOutBytes

The number of bytes transferred for texture page-off operations. Under most conditions, textures are not paged off but are simply thrown away since a backup exists in system memory. Texture page-off traffic usually happens when VRAM pressure forces a page-off of a texture that only has valid data in VRAM, such as a texture created using the function glCopyTexImage, or modified using the functions glCopyTexSubImage or glTexSubImage. (Texture Page Off Data (Non-AGP))

textureWaitTime

The amount of time, in nanoseconds, that the CPU waits for a texture upload to complete before the buffer can be modified. This particular metric tracks usage only by 2D contexts, and is somewhat obsolete. (CPU Texture Upload Wait (2D context only))

vramFreeBytes

The total number of bytes of free VRAM. This parameter is vendor specific and not available for all drivers. (Current Free Video Memory)

vramLargestFree

The largest free contiguous chunk of VRAM, in bytes. This parameter is vendor specific and not available for all drivers. (Current Largest Free Video Memory Block)

vramUsedBytes

The total number of bytes of VRAM in use. This parameter is vendor specific and not available for all drivers. (Current Video Memory in Use)



< Previous PageNext Page >


© 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-12-04)