Cluster and Node Configuration (Tokens)
| Token Name | Type | Default Value | Accepted Values | Category | Description |
|---|---|---|---|---|---|
| BeFrameRateFreq | FLOAT | 60 | -FLOAT_MAX to FLOAT_MAX, inclusive | Cluster and Node Configuration | The average frameloop rate (in Hz) of the COMM and DRAW thread frameloops. NOTE: This is NOT NECESSARILY the SwapBuffers rate! - Normally, BeFrameRateFreq matches the GPU scan-out rate (VBlank rate, Swap rate, etc.) for the monitor or display device. However for Serial MultiViewport, BeFrameRateFreq == 2X the GPU scan-out rate. This because each frameloop produces a 1 of 2 subframes for display (1/2 of the window contents), and SwapBuffers is only called every 'other' frameloop to present both. With Serial MV, even though the COMM and DRAW rates are very irregular from frameloop to frameloop, the average rate of subframe rendering (aka BeFrameRateFreq) is 2X the GPU scan-out rate. |
| CommThreadAffinityMask | UNSIGNED LONG | 0 | 0 to 4.29497e+09, inclusive | Cluster and Node Configuration | CPU processor affinity mask for COMM, NET PAGER, SENSORHOST, TRACKER, and GUI threads (if LockCPUs ON). |
| DriverYield | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Enable driver yield mode. |
| FeFrameRateFreq | FLOAT | 60 | -FLOAT_MAX to FLOAT_MAX, inclusive | Cluster and Node Configuration | |
| HighPriorityThreads | ENUM | ON | OFF, ON, TIME_CRITICAL | Cluster and Node Configuration | Enable time critical priority settings. |
| HostReturnSampleTime | FLOAT | 0 | 0 to 16, inclusive | Cluster and Node Configuration | |
| HostSampleTime | FLOAT | 0 | 0 to 16, inclusive | Cluster and Node Configuration | |
| HostTimeControl | ENUM | ICD_UPDATE_TIME | HOST_FRAME_COUNTER, HOST_TIME_STAMP, ICD_UPDATE_TIME, SYSTEM_TIME | Cluster and Node Configuration | Sets the time control used for the IG. Replaces the old ICD exe_host_time_control. |
| Hyperthreading | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Previously enabled a hack to force the number of threads supported by the system CPU(s) to <= 2 (when Hyperthreading and DualCore = OFF and NumIsectThread <= 1). |
| InsideCloudReturnMaster | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | |
| Insomnia | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | For a deskside Nova run, don't sleep. Sleeping plays nice with the host machine, but also makes getting benchmark numbers more difficult. |
| IsectThreadAffinityMask | UNSIGNED LONG | 0 | 0 to 4.29497e+09, inclusive | Cluster and Node Configuration | CPU processor affinity mask for ISECT threads(s) (if LockCPUs ON). |
| LaptopMode | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Laptop mode enabled. |
| LockCPUMask | UNSIGNED LONG | 65520 | 0 to ULLONG_MAX, inclusive | Cluster and Node Configuration | CPU processor affinity mask for all process threads (used in "LockCPUs CPUMASK" and "LockCPUs FEPAGER" modes). |
| LockCPUs | ENUM | OFF | OFF, ON, FEPAGER, CPUMASK | Cluster and Node Configuration | Enable CPU processor affinity mask setting for application threads. ON: Sets thread affinity masks to {Main, Comm, Sea, Isect, Pager} ThreadAffinityMask. CPUMASK or FEPAGER: Sets thread affinity masks to LockCPUMask. |
| LowLatencyFrontEnd | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Enable frontend low latency mode. ON: Use LowLatencyFrontEndFreq. OFF: Use FeFrameRateFreq. |
| LowLatencyFrontEndFreq | FLOAT | 120 | 0 to 960, inclusive | Cluster and Node Configuration | |
| MainThreadAffinityMask | UNSIGNED LONG | 0 | 0 to 4.29497e+09, inclusive | Cluster and Node Configuration | CPU processor affinity mask for MAIN thread (if LockCPUs ON). |
| MissedFrameReset | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Clear out missed frame counter on resets. |
| MpModel | ENUM | CLUSTER | STANDALONE, CLUSTER | Cluster and Node Configuration | |
| MpNetPager | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Spawn a separate thread for the net pager (always false). |
| MpPager | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Spawn a separate thread for the disk pager (TRUE on deskside and radar). |
| MpSensorHostSync | BOOL | ON | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Force integral sensorhost to sync with main thread. |
| MpTrackerInterface | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | If set, spawns a separate thread on FRONTEND / STANDALONE nodes to load and call the head tracker DLL in. See also MpTrackerSync. |
| MpTrackerSync | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Force FRONTEND head tracker thread to sync with main thread. |
| PagerNet | STRING | 192.168.1.0:0 | Cluster and Node Configuration | ||
| PagerNetMaxClients | UNSIGNED INT | 1 | 0 to UINT_MAX, inclusive | Cluster and Node Configuration | Total number of pager clients (not deleted for parser backward compatibility with existing CFG files). |
| PagerThreadAffinityMask | UNSIGNED LONG | 0 | 0 to 4.29497e+09, inclusive | Cluster and Node Configuration | CPU processor affinity mask for PAGER and RESOURCE PAGER thread (if LockCPUs ON). |
| RecordedHostTimeStamps | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Indicates timestamps from host are pre-recorded and should be offset. |
| SeaThreadAffinityMask | UNSIGNED LONG | 0 | 0 to 4.29497e+09, inclusive | Cluster and Node Configuration | CPU processor affinity mask for SEA thread(s) (if LockCPUs ON). |
| SeaThreads | INT | 2 | INT_MIN to INT_MAX, inclusive | Cluster and Node Configuration | Controls the number of threads used to update waves in the uber. 2 indicates wave updates are run in a separate thread, and that two additional threads may be used for updating waves when WaveGenerationMode is not LEGACY. 1 indicates wave updates are run in a separate thread, and that one additional thread may be used for updating waves when WaveGenerationMode is not LEGACY. 0 indicates that waves update in the comms thread. Defaults to 2. |
| SharedStreamPreloadWait | FLOAT | 180 | -FLOAT_MAX to FLOAT_MAX, inclusive | Cluster and Node Configuration | The time during init before the deadlock prevention starts emptying this process' view of a shared stream FIFO. |
| SharedStreamTimeout | FLOAT | 5 | -FLOAT_MAX to FLOAT_MAX, inclusive | Cluster and Node Configuration | The timeout allowed before the deadlock prevention starts emptying this process' view of a shared stream FIFO. |
| SharedTileManagerFifoDepth | INT | 100 | INT_MIN to INT_MAX, inclusive | Cluster and Node Configuration | The depth of the substream queues in the shared memory tile manager. |
| SharedTileManagerScratchShmName | STRING | sharedTileManagerScratch | N/A | Cluster and Node Configuration | The name used for the shared streams named shared memory. |
| SleepStepDisable | ENUM | SINGLE | OFF, ON, SINGLE, DOUBLE | Cluster and Node Configuration | |
| SpinMode | ENUM | SPINMODE_OFF | SPINMODE_OFF, SPINMODE_SPIN, SPINMODE_SLEEP, SPINMODE_YIELD, SPINMODE_SLEEP_ONE | Cluster and Node Configuration | Enables time-killing before SWAP. OFF: No wait. SPIN: Busy - wait until (frame period) ms have passed since SOF. SLEEP: Sleep until (frame period) ms have passed since SOF. YIELD: Yield the CPU, allowing another thread of equal priority to run. SLEEP_ONE: Sleep for 1.0ms. |
| SyncPagerThread | BOOL | ON | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | |
| SyncResourcePagerThread | BOOL | ON | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Must be "true" to avoid resource pager thread eating 100% CPU in an idle loop. |
| TerrainMeshPageMode | ENUM | NET | LOCAL, LOCALFIFO, NET | Cluster and Node Configuration | |
| UberNet | STRING | 192.168.1.0:0 | N/A | Cluster and Node Configuration | |
| UberNetMaxClients | UNSIGNED INT | 1 | 0 to UINT_MAX, inclusive | Cluster and Node Configuration | Total number of uber clients. |
| UberSampleTime | FLOAT | 8 | 0 to 16, inclusive | Cluster and Node Configuration | COMM thread frame time offset (in msec) since last COMM thread start-of-frame after a Swapbuffers (normally every one). Disabled if == 0 or node type is STANDALONE, FRONTEND, If > 0.0, causes COMM thread to stall in updateCommBuffers() after the Uber Prebuild before Uber NetRcv+Extrap and Uber Build until the specified number of msec have elapsed. NOTE: For Serial Multiviewport, UberSampleTime specifies the wait time for the 1st subframe after a Swap. The wait time for the 2nd is implicitly UberSampleTime + 1000/BeFrameRateFreq, where BeFrameRateFreq is the subframe rate. |
| UberSendTime | FLOAT | 0 | 0 to 16, inclusive | Cluster and Node Configuration | Time in milliseconds that the front end will wait within its frame to multi-cast the uber data to the back end nodes. |
| UseSynceBarriers | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Cluster and Node Configuration | Enables use of efficient in-process thread sync (in place of 100% busy-waits). This can greatly reduce CPU core utilization on cluster-on-deskside systems like nucleus. |