Package oracle.pgx.config
Class EnterpriseSchedulerFlagsConfigBuilder
- java.lang.Object
-
- oracle.pgx.config.EnterpriseSchedulerFlagsConfigBuilder
-
@Generated({"common/config/src/templates/ConfigBuilder.stg","common/config/config.gradle"}) public final class EnterpriseSchedulerFlagsConfigBuilder extends java.lang.Object
Builder forEnterpriseSchedulerFlagsConfig
.
-
-
Constructor Summary
Constructors Constructor Description EnterpriseSchedulerFlagsConfigBuilder()
Constructs an empty EnterpriseSchedulerFlagsConfigBuilderEnterpriseSchedulerFlagsConfigBuilder(java.util.Map<EnterpriseSchedulerFlagsConfig.Field,java.lang.Object> values)
Constructs a EnterpriseSchedulerFlagsConfigBuilder initialized with the values from the given mapEnterpriseSchedulerFlagsConfigBuilder(EnterpriseSchedulerFlagsConfig config)
Constructs a EnterpriseSchedulerFlagsConfigBuilder initialized with the values from the given configEnterpriseSchedulerFlagsConfigBuilder(EnterpriseSchedulerFlagsConfigBuilder builder)
Constructs a EnterpriseSchedulerFlagsConfigBuilder initialized with the values from the given builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description EnterpriseSchedulerFlagsConfig
build()
Builds the EnterpriseSchedulerFlagsConfig with aparentPath
ofnull
.EnterpriseSchedulerFlagsConfig
build(java.lang.String parentPath)
Builds the EnterpriseSchedulerFlagsConfig.static EnterpriseSchedulerFlagsConfig
buildEnterpriseSchedulerFlagsConfig(java.util.function.Consumer<EnterpriseSchedulerFlagsConfigBuilder> builderSetup)
Builds aEnterpriseSchedulerFlagsConfig
in-placeEnterpriseSchedulerFlagsConfigBuilder
clear()
Clears all values from the builderjava.util.Map<EnterpriseSchedulerFlagsConfig.Field,java.lang.Object>
getValues()
EnterpriseSchedulerFlagsConfigBuilder
putAll(java.util.Map<EnterpriseSchedulerFlagsConfig.Field,java.lang.Object> values)
Puts all values from the given map into this builder.EnterpriseSchedulerFlagsConfigBuilder
putAll(EnterpriseSchedulerFlagsConfig config)
Puts all values from the given config into this builderEnterpriseSchedulerFlagsConfigBuilder
setEnableDebugSignal(boolean enableDebugSignal)
[Internal use only] Iftrue
, outputs a dump of internal state upon receiving a SIGQUIT signal.EnterpriseSchedulerFlagsConfigBuilder
setFixThreadsUsedFromMain(boolean fixThreadsUsedFromMain)
[Internal use only] Iftrue
fix threads used by work spawned by the main thread so that 0..N are used for an N-thread job.EnterpriseSchedulerFlagsConfigBuilder
setLogToStderr(boolean logToStderr)
Iftrue
log to stderr.EnterpriseSchedulerFlagsConfigBuilder
setMarkLoopForProfiling(java.lang.String markLoopForProfiling)
[Internal use only] ID for any additional loop to profile.EnterpriseSchedulerFlagsConfigBuilder
setOverrideCoresPerSocket(int overrideCoresPerSocket)
[Internal use only] Over-ride the core-to-socket allocation, treating a fixed number of cores as a socket for the purposes of the per-socket combining structures.EnterpriseSchedulerFlagsConfigBuilder
setOverrideMemoryPlacement(boolean overrideMemoryPlacement)
[Internal use only] Over-ride memory placement tags and use the OS defaults instead.EnterpriseSchedulerFlagsConfigBuilder
setSelectPerformanceCounters(java.lang.String selectPerformanceCounters)
[Internal use only] Perf counter configuration string.EnterpriseSchedulerFlagsConfigBuilder
setSelectPerformanceCountersJobRegions(int selectPerformanceCountersJobRegions)
[Internal use only] Issue a region per job automatically.EnterpriseSchedulerFlagsConfigBuilder
setSelectPerformanceCountersLibrary(int selectPerformanceCountersLibrary)
[Internal use only] Perf counter library.EnterpriseSchedulerFlagsConfigBuilder
setSelectPerformanceCountersPcmShowCodes(int selectPerformanceCountersPcmShowCodes)
[Internal use only] Show PCM perf counter codes.EnterpriseSchedulerFlagsConfigBuilder
setSelectPerformanceCountersShowStats(int selectPerformanceCountersShowStats)
[Internal use only] Perf counter per-thread statistics.EnterpriseSchedulerFlagsConfigBuilder
setSelectRegionPerformanceCounters(java.lang.String selectRegionPerformanceCounters)
[Internal use only] Region perf counter configuration string.EnterpriseSchedulerFlagsConfigBuilder
setShowAllocations(boolean showAllocations)
Iftrue
show memory allocation information.EnterpriseSchedulerFlagsConfigBuilder
setShowDebug(boolean showDebug)
[Internal use only] Iftrue
enable debug output.EnterpriseSchedulerFlagsConfigBuilder
setShowDeterministicOutput(boolean showDeterministicOutput)
[Internal use only] Iftrue
omit thread IDs in debug output (set to true for determinism in regression tests)EnterpriseSchedulerFlagsConfigBuilder
setShowEnvironment(boolean showEnvironment)
Iftrue
show version numbers and main environment settings at startup.EnterpriseSchedulerFlagsConfigBuilder
setShowLogging(boolean showLogging)
Iftrue
enable summary logging -- this is available even in non-debug builds and includes information such as the machine h/w information obtained at start-up, and per-job / per-loop* information about the workload.EnterpriseSchedulerFlagsConfigBuilder
setShowProfiling(boolean showProfiling)
Iftrue
show profiling information.EnterpriseSchedulerFlagsConfigBuilder
setShowSchedulerState(boolean showSchedulerState)
Iftrue
dump scheduler state on each update.EnterpriseSchedulerFlagsConfigBuilder
setShowWarnings(boolean showWarnings)
Iftrue
enable warnings.EnterpriseSchedulerFlagsConfigBuilder
setSpinOnExit(boolean spinOnExit)
[Internal use only] Iftrue
spin after execution, rather than exiting.EnterpriseSchedulerFlagsConfigBuilder
setUseOpenmpThreadPool(boolean useOpenmpThreadPool)
[Internal use only] Iftrue
, use OpenMP based thread pool.java.io.InputStream
toInputStream()
java.lang.String
toString()
-
-
-
Constructor Detail
-
EnterpriseSchedulerFlagsConfigBuilder
public EnterpriseSchedulerFlagsConfigBuilder()
Constructs an empty EnterpriseSchedulerFlagsConfigBuilder
-
EnterpriseSchedulerFlagsConfigBuilder
public EnterpriseSchedulerFlagsConfigBuilder(java.util.Map<EnterpriseSchedulerFlagsConfig.Field,java.lang.Object> values)
Constructs a EnterpriseSchedulerFlagsConfigBuilder initialized with the values from the given map- Parameters:
values
- a map containing configuration values
-
EnterpriseSchedulerFlagsConfigBuilder
public EnterpriseSchedulerFlagsConfigBuilder(EnterpriseSchedulerFlagsConfig config)
Constructs a EnterpriseSchedulerFlagsConfigBuilder initialized with the values from the given config- Parameters:
config
- the configuration to take the values from
-
EnterpriseSchedulerFlagsConfigBuilder
public EnterpriseSchedulerFlagsConfigBuilder(EnterpriseSchedulerFlagsConfigBuilder builder)
Constructs a EnterpriseSchedulerFlagsConfigBuilder initialized with the values from the given builder- Parameters:
builder
- the builder to take the values from
-
-
Method Detail
-
buildEnterpriseSchedulerFlagsConfig
public static EnterpriseSchedulerFlagsConfig buildEnterpriseSchedulerFlagsConfig(java.util.function.Consumer<EnterpriseSchedulerFlagsConfigBuilder> builderSetup)
Builds aEnterpriseSchedulerFlagsConfig
in-place- Parameters:
builderSetup
- a consumer to setup a newly createdEnterpriseSchedulerFlagsConfig
-
putAll
public EnterpriseSchedulerFlagsConfigBuilder putAll(java.util.Map<EnterpriseSchedulerFlagsConfig.Field,java.lang.Object> values)
Puts all values from the given map into this builder.- Parameters:
values
- the values to put in the builder
-
putAll
public EnterpriseSchedulerFlagsConfigBuilder putAll(EnterpriseSchedulerFlagsConfig config)
Puts all values from the given config into this builder- Parameters:
config
- the config to take the values from
-
clear
public EnterpriseSchedulerFlagsConfigBuilder clear()
Clears all values from the builder
-
build
public EnterpriseSchedulerFlagsConfig build(java.lang.String parentPath)
Builds the EnterpriseSchedulerFlagsConfig.- Parameters:
parentPath
- if not null, resolves relative paths against this parentPath- Returns:
- an instance of EnterpriseSchedulerFlagsConfig
-
build
public EnterpriseSchedulerFlagsConfig build()
Builds the EnterpriseSchedulerFlagsConfig with aparentPath
ofnull
.- Returns:
- An instance of EnterpriseSchedulerFlagsConfig
- See Also:
build(String)
-
toInputStream
public java.io.InputStream toInputStream()
- Returns:
- an
InputStream
representing the config
-
getValues
public java.util.Map<EnterpriseSchedulerFlagsConfig.Field,java.lang.Object> getValues()
- Returns:
- the raw config values
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
setShowLogging
public EnterpriseSchedulerFlagsConfigBuilder setShowLogging(boolean showLogging)
Iftrue
enable summary logging -- this is available even in non-debug builds and includes information such as the machine h/w information obtained at start-up, and per-job / per-loop* information about the workload.
-
setShowWarnings
public EnterpriseSchedulerFlagsConfigBuilder setShowWarnings(boolean showWarnings)
Iftrue
enable warnings. These are non-fatal errors -- e.g., if a NUMA-aware allocation cannot be placed on the intended socket.
-
setShowEnvironment
public EnterpriseSchedulerFlagsConfigBuilder setShowEnvironment(boolean showEnvironment)
Iftrue
show version numbers and main environment settings at startup.
-
setShowProfiling
public EnterpriseSchedulerFlagsConfigBuilder setShowProfiling(boolean showProfiling)
Iftrue
show profiling information.
-
setShowSchedulerState
public EnterpriseSchedulerFlagsConfigBuilder setShowSchedulerState(boolean showSchedulerState)
Iftrue
dump scheduler state on each update.
-
setShowAllocations
public EnterpriseSchedulerFlagsConfigBuilder setShowAllocations(boolean showAllocations)
Iftrue
show memory allocation information.
-
setLogToStderr
public EnterpriseSchedulerFlagsConfigBuilder setLogToStderr(boolean logToStderr)
Iftrue
log to stderr. Iffalse
log using PGX's default logging facility.
-
setShowDebug
public EnterpriseSchedulerFlagsConfigBuilder setShowDebug(boolean showDebug)
[Internal use only] Iftrue
enable debug output. This is only available in debug builds.
-
setUseOpenmpThreadPool
public EnterpriseSchedulerFlagsConfigBuilder setUseOpenmpThreadPool(boolean useOpenmpThreadPool)
[Internal use only] Iftrue
, use OpenMP based thread pool. If false use pthreads based thread pool.
-
setOverrideCoresPerSocket
public EnterpriseSchedulerFlagsConfigBuilder setOverrideCoresPerSocket(int overrideCoresPerSocket)
[Internal use only] Over-ride the core-to-socket allocation, treating a fixed number of cores as a socket for the purposes of the per-socket combining structures. This is for experimental use on processors like the M7 with core clusters. If0
use h/w information
-
setOverrideMemoryPlacement
public EnterpriseSchedulerFlagsConfigBuilder setOverrideMemoryPlacement(boolean overrideMemoryPlacement)
[Internal use only] Over-ride memory placement tags and use the OS defaults instead. Iftrue
use OS defaults, iffalse
use workload tags
-
setMarkLoopForProfiling
public EnterpriseSchedulerFlagsConfigBuilder setMarkLoopForProfiling(java.lang.String markLoopForProfiling)
[Internal use only] ID for any additional loop to profile. If set, the format is name:idx, e.g. "FooBar:1" for the first execution of the FooBar loop, or "XXYZ" for all executions of the XXYZ loop.
-
setSelectPerformanceCounters
public EnterpriseSchedulerFlagsConfigBuilder setSelectPerformanceCounters(java.lang.String selectPerformanceCounters)
[Internal use only] Perf counter configuration string.
-
setSelectRegionPerformanceCounters
public EnterpriseSchedulerFlagsConfigBuilder setSelectRegionPerformanceCounters(java.lang.String selectRegionPerformanceCounters)
[Internal use only] Region perf counter configuration string.
-
setSelectPerformanceCountersLibrary
public EnterpriseSchedulerFlagsConfigBuilder setSelectPerformanceCountersLibrary(int selectPerformanceCountersLibrary)
[Internal use only] Perf counter library.
-
setSelectPerformanceCountersPcmShowCodes
public EnterpriseSchedulerFlagsConfigBuilder setSelectPerformanceCountersPcmShowCodes(int selectPerformanceCountersPcmShowCodes)
[Internal use only] Show PCM perf counter codes.
-
setSelectPerformanceCountersJobRegions
public EnterpriseSchedulerFlagsConfigBuilder setSelectPerformanceCountersJobRegions(int selectPerformanceCountersJobRegions)
[Internal use only] Issue a region per job automatically.
-
setSelectPerformanceCountersShowStats
public EnterpriseSchedulerFlagsConfigBuilder setSelectPerformanceCountersShowStats(int selectPerformanceCountersShowStats)
[Internal use only] Perf counter per-thread statistics.
-
setShowDeterministicOutput
public EnterpriseSchedulerFlagsConfigBuilder setShowDeterministicOutput(boolean showDeterministicOutput)
[Internal use only] Iftrue
omit thread IDs in debug output (set to true for determinism in regression tests)
-
setSpinOnExit
public EnterpriseSchedulerFlagsConfigBuilder setSpinOnExit(boolean spinOnExit)
[Internal use only] Iftrue
spin after execution, rather than exiting. This provides an opportunity to attach a debugger or to inspect the placement of threads or of memory.
-
setEnableDebugSignal
public EnterpriseSchedulerFlagsConfigBuilder setEnableDebugSignal(boolean enableDebugSignal)
[Internal use only] Iftrue
, outputs a dump of internal state upon receiving a SIGQUIT signal.
-
setFixThreadsUsedFromMain
public EnterpriseSchedulerFlagsConfigBuilder setFixThreadsUsedFromMain(boolean fixThreadsUsedFromMain)
[Internal use only] Iftrue
fix threads used by work spawned by the main thread so that 0..N are used for an N-thread job. This aids comparison with OpenMP. If this is not set then threads will be chosen dynamically by the runtime system.
-
-