microsoft
/
BuildXL
зеркало из https://github.com/microsoft/BuildXL.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность

Merged PR 798919: Make Flags.md allign with command line 

There are a bunch of other discrepancies between BuildXL's command line and the names given to consts in strings.resx, which is what is used to generate Flags.md.

The script that generates Flags.md works directly off of strings.resx. I doubt a pass was ever down when that script was created to ensure strings.resx actually matched up with the command line. This change would be better if it included some guardrails to prevent the two from skewing again in the future, but I don't think the cost/benefit is there so I'm just doing a one-time cleanup pass.
This commit is contained in:
Michael Pysson 2024-08-07 19:10:26 +00:00
Родитель 8e76c518cd
Коммит 0988189e50
3 изменённых файлов: 108 добавлений и 126 удалений
Показать статистику Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы

74
Documentation/Wiki/Flags.md
Просмотреть файл

@ -7,15 +7,11 @@ This page lists flags that can be used to configure BuildXL.
| AdditionalConfigFile | Additional configuration files that can contain module definitions (short form: /ac) |
| AdminRequiredProcessExecutionMode | Mode for running processes that required admin privilege. Allowed values are 'Internal' (BuildXL starts the process as an immediate child process), 'ExternalTool' (BuildXL starts a sandboxed process executor tool as a child process, and in turn the tool starts the admin-required process as its child process), 'ExternalVM' (BuildXL sends command to VM to execute a sandboxed process executor tool in VM, and in turn the tool starts the admin-required process as its child process) . For Internal and ExternalTool, the process will be run with the same elevation level as BuildXL. For ExternalVM, the process will be run with the elevation level in the VM. Defaults to 'Internal'. |
| AdoConsoleMaxIssuesToLog | Specifies the maximum number of issues(errors and warnings) in the ADO console. |
| AllowCopySymlink | When enabled, allow copying symlink. Defaults to true. |
| AllowDuplicateTemporaryDirectory | When enabled, pips with duplicate temporary directories are allowed. Defaults to false. |
| AllowFetchingCachedGraphFromContentCache | Allow fetching cached graph from content cache. Defaults to on. |
| AllowInternalDetoursErrorNotificationFile | When enabled, the detoured processes will store internal errors in a special file. If this file contains data at the end of pip execution, the pip (build) will fail. Defaults to on. |
| AllowMissingOutputs | When specified, suppresses errors for specified-but-not-produced outputs with the given name. May be specified more than once. Using this option results in an unsafe configuration (for diagnostic purposes only). Defaults to false. |
| AllowMissingSpecs | When enabled, missing module and spec files will be logged as verbose events rather than errors during workspace generation. |
| AlwaysRemoteInjectDetoursFrom32BitProcess | Always use remote detours injection when launching processes from a 32-bit process. Defaults to true. |
| AnalyzeDependencyViolations | When enabled, file monitoring violations will be analyzed to emit additional warnings about high-level dependency problems (examples include double-writes and read-write races). Defaults to on. |
| AssumeCleanOutputs | When enabled, BuildXL assumes there are no stale outputs from previous builds. |
| AugmentingPathSetCommonalityFactor | Used to compute the number of times (i.e. {augmentingPathSetCommonalityFactor} * {pathSetThreshold}) an entry must appear among paths in the observed path set in order to be included in the common path set. Value must be (0, 1] |
| BreakOnUnexpectedFileAccess | Break into the debugger when {ShortProductName} detects that a tool accesses a file that was not declared in the specification dependencies. This option is useful when developing a new tool or SDKs using these tools. Defaults to off. |
| BuildLockPolling | Number of seconds to wait for an executing build to finish before polling again for completion. Defaults to 15 sec. |
@ -36,23 +32,21 @@ This page lists flags that can be used to configure BuildXL.
| CleanTempDirectories | Cleans per pip temp directories after the pip successfully exits to save disk space. Defaults to on. |
| Color | Use colors for warnings and errors. Defaults to using colors. |
| CompressGraphFiles | When enabled, graph files are compressed. |
| ConfigFile | Configuration file that determines {ShortProductName}'s behavior (short form: /c) |
| Config | Configuration file that determines {ShortProductName}'s behavior (short form: /c) |
| ConsoleVerbosity | Sets the console logging verbosity. Allowed values are 'Off', 'Error', 'Warning', 'Informational' and 'Verbose', and the single-character prefixes of those values. Defaults to Informational. (short form: /cv) |
| CustomLog | Sets a custom log file for a specific set of event IDs. Event list should be comma separated integers excluding the DX prefix. |
| Debug_LoadGraph | Loads a cached build graph stored under the given fingerprint (40 digit hex string, no delimiters), path to cached graph directory, or canonical name. |
| DebuggerBreakOnExit | Whether to break at the end of the evaluation phase. Defaults to off. |
| DebuggerPort | TCP/IP port for the {ShortScriptName} debugger to listen on. Defaults to 41177. |
| DebugIgnoreChangeJournal | If disabled, {ShortProductName} will not use the NTFS / ReFS change journal for caching or incremental builds. This is an unsafe configuration (for diagnostic purposes only). Defaults to on. |
| DebugScript | Whether to launch {ShortScriptName} debugger on start. Intended to be used by IDEs only (if you pass this option when running form command line, {ShortScriptName} evaluator will just wait forever). Defaults to off. |
| DependencySelection | Specifies additional pips to run based on dependency information of pips matched in filter. May be: empty (all dependencies) or "+" (dependencies and dependents). |
| DeterminismProbeUsage | DeterminismProbe feature was removed, this option will do nothing |
| Diagnostic | Enables diagnostic logging for a functional area. This option may be specified multiple times. Areas: Scheduler, Parser, Storage, Transformers, Engine, Viewer, PipExecutor, PipInputAssertions, ChangeJournalService, HostApplication, CommonInfrastructure, CacheInteraction, HybridInterop. (short form: /diag) |
| DisableConHostSharing | Disables sharing of the Windows ConHost process between pips. Defaults to sharing enabled. |
| DisableCycleDetection | Disables cycle detection during evaluation. Defaults to off. |
| DisableDetours | When enabled, {ShortProductName} will not detour any processes. This might lead to incorrect builds because any file accesses will not be enforced. |
| DisableGraphPostValidation | Disables post validation of graph construction. Defaults to on. |
| DiskSpaceForPip | Specify the required minimum available disk space in Gigabytes. Default value set to 0GB (disabled). Pips will fail if the specified amount of disk space in unavailable. |
| DistributedBuildOrchestratorLocation | Specifies the IP address or host name and TCP port of the orchestrator machine to which a worker will connect to join a build session. This argument is redundant if the orchestratro is invoked with /distributedBuildWorker specified for this worker. (short form: /dbo) |
| DistributedBuildRole | Specifies the role the node plays in the distributed build: None, Orchestrator, or Worker. This argument is required for executing a distributed build. (short form: /dbr) |
| DistributedBuildServicePort | Specifies the TCP port of a locally running distributed build service (orchestrator or worker) which peers can connect to during a distributed build. This argument is required for executing a distributed build. (short form: /dbsp) |
| DistributedBuildWorker | Specifies the IP address or host name and TCP port of remote worker build services which this process can dispatch work to during a distributed build (can specify multiple). This argument is redundant if the corresponding worker is invoked with /distributedBuildOrchestratorLocation specified. (short form: /dbw) |
| DistributedBuildWorkerSourceMaterialization | Enables materialization of source files on distributed workers. NOTE: Source files are required to be present in the worker's remote or local cache. |
| DumpFailedPips | When enabled, the runtime dump pip lite analyzer will log information regarding failed pips under Out/Logs/FailedPips for debugging. |
| DumpFailedPipsLogLimit | Sets the maximum number of log files that are allowed to be generated by the dump pip lite analyzer (default 50). |
| DumpFailedPipsWithDynamicData | Enable this option to dump observed file accesses and processes with the dump pip lite analyzer (requires /logObservedFileAccesses+ and/or /logProcesses+ to be set as well). |
@ -64,12 +58,11 @@ This page lists flags that can be used to configure BuildXL.
| EnableLinuxPTraceSandbox | Enables the ptrace sandbox on Linux when a statically linked binary is detected. Note that this will have a negative impact on performance, but is necessary to ensure correctness on some Linux builds. |
| EnablePlugins | When enabled, plugins are allowed to be loaded. Defaults to off. |
| EnableProcessRemoting | Enable process remoting via AnyBuild. Defaults to off. |
| EnableWorkerSourceFileMaterialization | Enables materialization of source files on distributed workers. NOTE: Source files are required to be present in the worker's remote or local cache. |
| EnforceAccessPoliciesOnDirectoryCreation | Indicates whether {ShortProductName} should enforce access policies on CreateDirectory for paths under writable mounts as well as the cases when the directory already exists. Defaults to off. |
| EnforceFileAccesses | Whether {ShortProductName} is to monitor file accesses of individual tools at all. Disabling monitoring results in an unsafe configuration (for diagnostic purposes only). Defaults to on. |
| EnforceFullReparsePointsUnderPath | Enforce that files accessed which begin with the given path will enforce reparse points underneath said path. All transitive reparse points encountered after enforcing and resolving the first one are also enforced, regardless of path. |
| EngineCacheDirectory | Allows overriding where engine state will be cached. If unset, it will be stored in a subdirectory of the artifact cache. |
| Environment | Environment build is running in. Allowed values '{0}'. |
| ExistingDirectoryProbesAsEnumerations | When enabled, {ShortProductName} will report existing directory probes as enumerations. This might lead to cases where pips will be executed even when there is no need for it. |
| ExitOnNewGraph | When enabled, exit early if a new graph needs to be created. This differs from phase:schedule because it doesn't actually create the graph. |
| Experimental__0 | Enables an experimental feature (short form: /exp). Available experimental features: {0} |
| ExplicitlyReportDirectoryProbes | When enabled, detours will explicitly report directory probes. Note that this may result in an increased amount of DFAs. |
@ -88,24 +81,12 @@ This page lists flags that can be used to configure BuildXL.
| FingerprintSalt | Salts fingerprints used for caching. May be specified multiple times and values concatenate with delimiter. Empty value clears previous values. '*' is unique each run. |
| FlushPageCacheToFileSystemOnStoringOutputsToCache | Flush page cache to file system on storing outputs to cache. Defaults to off. |
| ForceAddExecutionPermission | When set to true, it enables the execution permission for the root process of process pips in Linux builds. Defaults to true. |
| ForceSkipDependencies | Specifies that dependencies of processes requested in the filter should be skipped as long as all the inputs are present. |
| ForwardWorkerLog | Configure additional verbose event IDs that workers will forward to the orchestrator, in addition to warnings and errors (which are always forwarded). |
| GenerateCgManifest | Generates a cgmanifest.json file at the specified path. This file contains the names and versions for all Nuget packages used within BuildXL, and is used for Component Governance during CloudBuild. |
| HardExitOnErrorInDetours | When enabled, detours will exit the process on Detours error with a special exit code. Defaults to on. |
| Help | Display this usage message (Short form: /?). See verbose help with /help:verbose. See DX code specific help with /help:1234. |
| HonorDirectoryCasingOnDisk | When true, casing of directories for dynamic outputs will match the ones found on disk when a pip is done executing (as opposed to using the casing of the first time the path is mentioned in the build). Useful on Windows when tools are case sensitive. Defaults to false. |
| IgnoreDynamicWritesOnAbsentProbes | When enabled, {ShortProductName} will not flag as violations absent path probes that coexist with writes under output directories for those same paths. |
| IgnoreFullReparsePointResolving | When enabled, {ShortProductName} will not fully resolve paths containing any sort of reparse point. This might lead to incorrect builds because some file accesses will not be enforced or tracked at all. |
| IgnoreGetFinalPathNameByHandle | When enabled, {ShortProductName} will not intercept GetFinalPathNameByHandle calls. This may lead to failures when using subst because non-subst paths will be used. Defaults to off. |
| IgnoreNonCreateFileReparsePoints | When enabled, {ShortProductName} will not follow symlinks for access validation and reporting for API's outisde of CreateFile, NtCreate, and OpenFile. This might lead to incorrect builds because some file accesses will not be enforced. Defaults to off. |
| IgnoreNonExistentProbes | When enabled, {ShortProductName} will not report non existent probes, that are not in sealed directories. This might lead to incorrect builds because some file accesses will not be enforced and validated. Certain calls to GetFileAttribute method for non existing files will not be reported to {ShortProductName}. |
| IgnoreNtCreateFile | When enabled, {ShortProductName} will not intercept NtCreateFile calls. This might lead to incorrect builds because some file accesses will not be enforced. |
| IgnorePreloadedDlls | When enabled, {ShortProductName} will not report Dlls loaded before Detours was started. This might lead to incorrect builds because some file accesses will not be enforced. |
| IgnoreReparsePoints | When enabled, {ShortProductName} will not track reparse points. This might lead to incorrect builds because some file accesses will not be enforced. Any reparse points (symlinks and mount points) will not be followed. |
| IgnoreSetFileInformationByHandle | When enabled, {ShortProductName} will not detour the SetFileInformationByHandle API. This might lead to incorrect builds because some file accesses will not be enforced. |
| IgnoreZwCreateOpenQueryFamily | When enabled, {ShortProductName} will not intercept ZwCreateFile, ZwOpenFile, and ZwQueryDirectoryFile calls. This might lead to incorrect builds because some file accesses will not be enforced. This flag is off by default. |
| IgnoreZwOtherFileInformation | When enabled, {ShortProductName} will not detour the ZwLinkFileInformation, ZwFileNameFileInformation, ZwDispositionFileInformation, ZwModeFileInformation APIs. This might lead to incorrect builds because some file accesses will not be enforced. Defaults to off - the functions are detoured. |
| IgnoreZwRenameFileInformation | When enabled, {ShortProductName} will not detour the ZwRenameFileInformation API. This might lead to incorrect builds because some file accesses will not be enforced. |
| Incremental | When enabled, artifacts are built incrementally based on which source files have changed. Defaults to on. |
| IncrementalScheduling | When enabled, scheduling is performed incrementally. Defaults to off. |
| InferNonExistenceBasedOnParentPathInRealFileSystem | Infers the non-existence of a path based on the parent path when checking the real file system in file system view. Defaults to on. |
@ -114,13 +95,12 @@ This page lists flags that can be used to configure BuildXL.
| Interactive | When enabled indicates that {ShortProductName} is allowed to interact with the user either via console or popups. A common use case is to allow front ends like nuget to display authentication prompts in case the user is not authenticated. |
| LaunchDebugger | Launches the debugger during boot (in the server process if applicable). |
| LimitPathSetsOnCacheLookup | Limits the number of path sets to be checked during cache lookup. Once the limit is reached, the pip is determined to have a cache miss. Defaults to off. The number of path sets can also be set. Defaults to 0 (off). |
| LoadGraph | Loads a cached build graph stored under the given fingerprint (40 digit hex string, no delimiters), path to cached graph directory, or canonical name. |
| LogCatalog | Records the set of spec files added to the catalog. Defaults to off. |
| LogCounters | Collects various performance counters and logs phase specific aggregations. Defaults to on. |
| LogExecution | Logs an execution trace to the default trace file in the same folder as the main log file. Defaults to on. |
| LogFileEnforcementTables | Records the file enforcement access tables for individual pips to the log. Defaults to off. |
| LogFileAccessTables | Records the file enforcement access tables for individual pips to the log. Defaults to off. |
| LogMemory | Collects actual memory usage when collection performance counters. This has a negaitve performance impact and should only be used when analyzing memory consumption. Defaults to off. |
| LogObservedAccesses | Records the files observed to be accessed by individual pips to the log. Defaults to off. |
| LogObservedFileAccesses | Records the files observed to be accessed by individual pips to the log. Defaults to off. |
| LogOutput | Specifies how process standard error and standard output should be reported. Allowed values are 'TruncatedOutputOnError', 'FullOutputAlways', 'FullOutputOnError', 'FullOutputOnWarningOrError'. Default is 'TruncatedOutputOnError'. |
| LogPipStaticFingerprintTexts | Log pip static fingerprint texts. Defaults to off. |
| LogPrefix | The prefix to add to all log file names (default: {ShortProductName}) |
@ -153,7 +133,8 @@ This page lists flags that can be used to configure BuildXL.
| MaxRamUtilizationPercentage | Specifies the maximum machine wide RAM utilization allowed before the scheduler will stop scheduling more work to allow resources to be freed. Defaults to 85%. |
| MaxRelativeOutputDirectoryLength | Directories under the object directory root will get shortened to avoid too long path names. Defaults to 64 characters for relative output directories. |
| MaxTypeCheckingConcurrency | Specifies the maximum concurrency level type checking phase. Defaults to /maxFrontEndConcurrency - 25% more than the total number of processors in the current machine. |
| MinAvailableRam | This flag is deprecated. |
| MinAvailableRamMb | This flag is deprecated. |
| MinimumDiskSpaceForPipsGb | Specify the required minimum available disk space in Gigabytes. Default value set to 0GB (disabled). Pips will fail if the specified amount of disk space in unavailable. |
| MsBuild_EnableBinLogTracing | Controls whether MSBuild binlog tracing should be enabled for the build. The binlog is placed in the logs directory for each MSBuild project as 'msbuild.binlog'. WARNING: This option increases build I/O and should only be used temporarily to avoid increased build times. |
| MsBuild_EnableEngineTracing | Controls whether MSBuild engine/scheduler tracing should be enabled for the build. WARNING: Use this option only temporarily as it will significantly increase build times. |
| MsBuild_LogVerbosity | Activates MSBuild file logging for each MSBuild project file to 'msbuild.log' in the log directory, using the specified MSBuild log verbosity. WARNING: This option adds I/O overhead to your build, since MSBuild console logging is already enabled and captured, and use of Detailed or Diagnostic levels should only be used temporarily to avoid significantly increased build times. |
@ -162,10 +143,9 @@ This page lists flags that can be used to configure BuildXL.
| NoLogo | Suppress copyright message |
| NormalizeReadTimestamps | When enabled, all file reads seen by processes will have normalized timestamps across builds. When disabled, the actual timestamps will be allowed to flow through to processes, so long as they are newer than the static timestamp used to enforce rewrite ordering (2002). Defaults to on. |
| NoWarn | Disable specific warning messages. These messages will still be logged in the main log file. |
| NumberofFailedPipRetry | Specify the number of times a pip failing due to worker failures, should be retried on another worker. Default value set to 0 (disabled). |
| NumRemoteAgentLeases | Static number of remote agent leases. Only applicable when /enableProcessRemoting is set to true. Defaults to 2 * /maxProc. |
| Obj | Specifies the root directory for primary build outputs (short form: /o) |
| OptimizedAstConversion | When enabled, optimized AST conversion by disabling some analyses and skipping some AST constructs. By disabling analyses linter policies are not enforced. The types in the resulting AST are stripped away as they are not needed for evaluation. Defauts to off. |
| NumRetryFailedPipsOnAnotherWorker | Specify the number of times a pip failing due to worker failures, should be retried on another worker. Default value set to 0 (disabled). |
| ObjectDirectory | Specifies the root directory for primary build outputs (short form: /o) |
| OrchestratorCpuMultiplier | Specifies the cpu queue limit in terms of a multiplier of the normal limit when at least one remote worker gets connected. Defaults to 0. |
| OutputMaterializationExclusionRoot | Specifies one or more roots to be excluded from output materialization. NOTE: Files needed for execution are always materialized even if under this root. |
| Paths | Paths to output files or spec files which determine what gets built. This is a shorthand for a full filter expression. |
@ -180,14 +160,13 @@ This page lists flags that can be used to configure BuildXL.
| PipWarningTimeoutMultiplier | Multiplier applied to the warning timeout for individual processes. Setting a multiplier greater than one will increase the warning timeout accordingly for all pips, even those with an explicit non-default warning timeout set. |
| PluginPaths | Specify a list of plugin paths that be loaded - each path is seperated by ";'. Defaults to empty list |
| PosixDeleteMode | Controls the applicability of file/directory deletion using POSIX delete. Allowed values are NoRun, RunFirst, and RunLast. Defaults for Windows is RunLast, and for Unix is RunFirst |
| PreserveOutputs | When enabled, {ShortProductName} will preserve the existing state of Process pip output files instead of deleting them before starting the process. This may lead to incorrect builds depending on how the process behaves when prior outputs are present. Specify "/unsafe_preserveOutputs:Reset" to reset the salt added to cached processes run with preserved outputs. |
| ProcessCanRunRemoteTags | Tags for processes that can run remotely when process remoting is enabled. When unspecified, every process can be remoted, unless it has a tag specified in /processMustRunLocalTags. |
| ProcessMustRunLocalTags | Tags for processes that must run locally when process remoting is enabled. When unspecified, it is assumed to be empty. |
| ProcessRetries | Number of retries for process execution if the process exits with exit codes that allow for retries. Defaults to 0. |
| ProfileReportDestination | Destination file of the profiling report. Default is '{0}' and it is generated in the current directory. Only considered if /profileScript is specified. |
| ProfileScript | Runs a profiler for {ShortScriptName} evaluation, generating a TSV file with profiling information. |
| Property | Specifies a property that overrides an allowed environment variable (short form: /p) |
| Qualifiers | Qualifiers controlling what flavor to build (short form: /q) |
| Qualifier | Qualifiers controlling what flavor to build (short form: /q) |
| RelatedActivityId | An external related ETW activity identifier. The top level {ShortProductName} activity will be logged as a child of this one. |
| RemoteAgentWaitTimeSec | The amount of wait time in seconds for getting a remote agent to execute process pip remotely when /enableProcessRemoting is set to true. Defaults to 2s. |
| RemoteTelemetry | When enabled, sends telemetry information for remote collection. Defaults to off. |
@ -201,9 +180,6 @@ This page lists flags that can be used to configure BuildXL.
| SandboxKind | Specifies the sandbox kind. Allowed values are 'None' (no sandboxing), 'Default' (default sandboxing), 'WinDetours', 'MacOsKext'. Default is 'Default'. |
| ScanChangeJournal | Scans volume change journals to determine spec file changes for graph reuse check. Defaults to on. |
| ScanChangeJournalTimeLimitInSec | Time limit in second for scanning volume change journal. Set to -1 for no limit. Defaults to 30 seconds. |
| ScriptDebugScript | Whether to launch {ShortScriptName} debugger on start. Intended to be used by IDEs only (if you pass this option when running form command line, {ShortScriptName} evaluator will just wait forever). Defaults to off. |
| ScriptDebugScriptBreakOnExit | Whether to break at the end of the evaluation phase. Defaults to off. |
| ScriptDebugScriptPort | TCP/IP port for the {ShortScriptName} debugger to listen on. Defaults to 41177. |
| ScriptShowLargest | Indicates whether {ShortProductName} should log information about the largest {ShortScriptName} files. Defaults to off. |
| ScriptShowSlowest | Indicates whether {ShortProductName} should log information about the slowest {ShortScriptName} elements by phase. Defaults to off. |
| ScriptTypeCheck | Type checks specifications. Defaults to on. |
@ -232,7 +208,29 @@ This page lists flags that can be used to configure BuildXL.
| TranslateDirectory | Specify translation of directories before access policy is applied - the fromPath is replaced with toPath in the names of paths accessed. Make sure to add the trailing path separators. Valid from/to path separators are '<' and ' and '::'. Recommended separator is '::'. Defaults to no directory translation is done. |
| TreatAbsentDirectoryAsExistentUnderOpaque | Treats absent directory as existent when it is probed and the path is under an opaque directory. Defaults to true. |
| TreatDirectoryAsAbsentFileOnHashingInputContent | Treats directory as absent file on hashing the content of input |
| UnexpectedFileAccessesAreErrors | When enabled, if {ShortProductName} detects that a tool accesses a file that was not declared in the specification dependencies, it is treated as an error instead of a warning. Turning this option off results in an unsafe configuration (for diagnostic purposes only). Defaults to on. |
| Unsafe_AllowCopySymlink | When enabled, allow copying symlink. Defaults to true. |
| Unsafe_AllowDuplicateTemporaryDirectory | When enabled, pips with duplicate temporary directories are allowed. Defaults to false. |
| Unsafe_AssumeCleanOutputs | When enabled, BuildXL assumes there are no stale outputs from previous builds. |
| Unsafe_DisableCycleDetection | Disables cycle detection during evaluation. Defaults to off. |
| Unsafe_DisableDetours | When enabled, {ShortProductName} will not detour any processes. This might lead to incorrect builds because any file accesses will not be enforced. |
| Unsafe_DisableGraphPostValidation | Disables post validation of graph construction. Defaults to on. |
| Unsafe_ExistingDirectoryProbesAsEnumerations | When enabled, {ShortProductName} will report existing directory probes as enumerations. This might lead to cases where pips will be executed even when there is no need for it. |
| Unsafe_ForceSkipDeps | Specifies that dependencies of processes requested in the filter should be skipped as long as all the inputs are present. |
| Unsafe_IgnoreDynamicWritesOnAbsentProbes | When enabled, {ShortProductName} will not flag as violations absent path probes that coexist with writes under output directories for those same paths. |
| Unsafe_IgnoreFullReparsePointResolving | When enabled, {ShortProductName} will not fully resolve paths containing any sort of reparse point. This might lead to incorrect builds because some file accesses will not be enforced or tracked at all. |
| Unsafe_IgnoreGetFinalPathNameByHandle | When enabled, {ShortProductName} will not intercept GetFinalPathNameByHandle calls. This may lead to failures when using subst because non-subst paths will be used. Defaults to off. |
| Unsafe_IgnoreNonCreateFileReparsePoints | When enabled, {ShortProductName} will not follow symlinks for access validation and reporting for API's outisde of CreateFile, NtCreate, and OpenFile. This might lead to incorrect builds because some file accesses will not be enforced. Defaults to off. |
| Unsafe_IgnoreNtCreateFile | When enabled, {ShortProductName} will not intercept NtCreateFile calls. This might lead to incorrect builds because some file accesses will not be enforced. |
| Unsafe_IgnorePreloadedDlls | When enabled, {ShortProductName} will not report Dlls loaded before Detours was started. This might lead to incorrect builds because some file accesses will not be enforced. |
| Unsafe_IgnoreReparsePoints | When enabled, {ShortProductName} will not track reparse points. This might lead to incorrect builds because some file accesses will not be enforced. Any reparse points (symlinks and mount points) will not be followed. |
| Unsafe_IgnoreSetFileInformationByHandle | When enabled, {ShortProductName} will not detour the SetFileInformationByHandle API. This might lead to incorrect builds because some file accesses will not be enforced. |
| Unsafe_IgnoreZwCreateOpenQueryFamily | When enabled, {ShortProductName} will not intercept ZwCreateFile, ZwOpenFile, and ZwQueryDirectoryFile calls. This might lead to incorrect builds because some file accesses will not be enforced. This flag is off by default. |
| Unsafe_IgnoreZwOtherFileInformation | When enabled, {ShortProductName} will not detour the ZwLinkFileInformation, ZwFileNameFileInformation, ZwDispositionFileInformation, ZwModeFileInformation APIs. This might lead to incorrect builds because some file accesses will not be enforced. Defaults to off - the functions are detoured. |
| Unsafe_IgnoreZwRenameFileInformation | When enabled, {ShortProductName} will not detour the ZwRenameFileInformation API. This might lead to incorrect builds because some file accesses will not be enforced. |
| Unsafe_MonitorFileAccesses | Whether {ShortProductName} is to monitor file accesses of individual tools at all. Disabling monitoring results in an unsafe configuration (for diagnostic purposes only). Defaults to on. |
| Unsafe_OptimizedAstConversion | When enabled, optimized AST conversion by disabling some analyses and skipping some AST constructs. By disabling analyses linter policies are not enforced. The types in the resulting AST are stripped away as they are not needed for evaluation. Defauts to off. |
| Unsafe_PreserveOutputs | When enabled, {ShortProductName} will preserve the existing state of Process pip output files instead of deleting them before starting the process. This may lead to incorrect builds depending on how the process behaves when prior outputs are present. Specify "/unsafe_preserveOutputs:Reset" to reset the salt added to cached processes run with preserved outputs. |
| Unsafe_UnexpectedFileAccessesAreErrors | When enabled, if {ShortProductName} detects that a tool accesses a file that was not declared in the specification dependencies, it is treated as an error instead of a warning. Turning this option off results in an unsafe configuration (for diagnostic purposes only). Defaults to on. |
| UpdateFileContentTableByScanningChangeJournal | When enabled, file content table is updated during the scanning of change journal. Defaults to on. |
| UseCustomPipDescriptionOnConsole | Indicates whether pip descriptions should be shortened to (semi-stable hash, customer-supplied pip description) when reporting errors and warnings on the console. Defaults to on. |
| UseExtraThreadToDrainNtClose | When enabled, the draining of the {ShortProductName} handle cache happens on a different thread than the one that called the NtClose. Handles to be cleaned are collected in a thread safe, non-locking list and removed from the cache usinga different thread. Defaults to on. |

82
Public/Src/App/Bxl/HelpText.cs
Просмотреть файл

@ -42,7 +42,7 @@ namespace BuildXL
#region Build
hw.WriteOption(
"/config:<file>",
Strings.HelpText_DisplayHelp_ConfigFile);
Strings.HelpText_DisplayHelp_Config);
hw.WriteOption(
"/additionalConfigFile:<file>*",
@ -51,11 +51,11 @@ namespace BuildXL
hw.WriteOption(
"/qualifier:<qualifier list>",
Strings.HelpText_DisplayHelp_Qualifiers);
Strings.HelpText_DisplayHelp_Qualifier);
hw.WriteOption(
"/objectDirectory:<output directory>",
Strings.HelpText_DisplayHelp_Obj);
Strings.HelpText_DisplayHelp_ObjectDirectory);
hw.WriteOption(
"/tempDirectory:<temp directory>",
@ -255,12 +255,12 @@ namespace BuildXL
hw.WriteOption(
"/logFileAccessTables[+|-]",
Strings.HelpText_DisplayHelp_LogFileEnforcementTables,
Strings.HelpText_DisplayHelp_LogFileAccessTables,
HelpLevel.Verbose);
hw.WriteOption(
"/logObservedFileAccesses[+|-]",
Strings.HelpText_DisplayHelp_LogObservedAccesses,
Strings.HelpText_DisplayHelp_LogObservedFileAccesses,
HelpLevel.Verbose);
hw.WriteOption(
@ -479,11 +479,6 @@ namespace BuildXL
Strings.HelpText_DisplayHelp_CompressGraphFiles,
HelpLevel.Verbose);
hw.WriteOption(
"/determinismProbe[+|-]",
Strings.HelpText_DisplayHelp_DeterminismProbeUsage,
HelpLevel.Verbose);
hw.WriteOption(
"/engineCacheDirectory:<engine cache directory>",
Strings.HelpText_DisplayHelp_EngineCacheDirectory,
@ -575,7 +570,7 @@ namespace BuildXL
#region ExecutionControl
hw.WriteOption(
"/unsafe_AllowDuplicateTemporaryDirectory[+|-]",
Strings.HelpText_DisplayHelp_AllowDuplicateTemporaryDirectory);
Strings.HelpText_DisplayHelp_Unsafe_AllowDuplicateTemporaryDirectory);
hw.WriteOption(
"/incremental[+|-]",
@ -684,7 +679,7 @@ namespace BuildXL
hw.WriteOption(
"/minAvailableRamMb:<number>",
Strings.HelpText_DisplayHelp_MinAvailableRam,
Strings.HelpText_DisplayHelp_MinAvailableRamMb,
HelpLevel.Verbose);
hw.WriteOption(
@ -782,7 +777,7 @@ namespace BuildXL
hw.WriteOption(
"/unsafe_forceSkipDeps[+|-]",
Strings.HelpText_DisplayHelp_ForceSkipDependencies,
Strings.HelpText_DisplayHelp_Unsafe_ForceSkipDeps,
HelpLevel.Verbose);
hw.WriteOption(
@ -812,7 +807,7 @@ namespace BuildXL
hw.WriteOption(
"/unsafe_AllowCopySymlink[+|-]",
Strings.HelpText_DisplayHelp_AllowCopySymlink,
Strings.HelpText_DisplayHelp_Unsafe_AllowCopySymlink,
HelpLevel.Verbose);
hw.WriteOption(
@ -969,7 +964,7 @@ namespace BuildXL
hw.WriteOption(
"/enableWorkerSourceFileMaterialization[+|-]",
Strings.HelpText_DisplayHelp_DistributedBuildWorkerSourceMaterialization,
Strings.HelpText_DisplayHelp_EnableWorkerSourceFileMaterialization,
HelpLevel.Verbose);
hw.WriteOption(
@ -1038,11 +1033,6 @@ namespace BuildXL
Strings.HelpText_DisplayHelp_BreakOnUnexpectedFileAccess,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_AllowMissingOutput:<filename>",
Strings.HelpText_DisplayHelp_AllowMissingOutputs,
HelpLevel.Verbose);
hw.WriteOption(
"/TranslateDirectory:<fromPath>::<toPath>",
Strings.HelpText_DisplayHelp_TranslateDirectory,
@ -1050,46 +1040,46 @@ namespace BuildXL
hw.WriteOption(
"/unsafe_MonitorFileAccesses[+|-]",
Strings.HelpText_DisplayHelp_EnforceFileAccesses);
Strings.HelpText_DisplayHelp_Unsafe_MonitorFileAccesses);
hw.WriteOption(
"/unsafe_IgnoreZwRenameFileInformation[+|-]",
Strings.HelpText_DisplayHelp_IgnoreZwRenameFileInformation,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreZwRenameFileInformation,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreZwOtherFileInformation[+|-]",
Strings.HelpText_DisplayHelp_IgnoreZwOtherFileInformation,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreZwOtherFileInformation,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreNonCreateFileReparsePoints[+|-]",
Strings.HelpText_DisplayHelp_IgnoreNonCreateFileReparsePoints,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreNonCreateFileReparsePoints,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreSetFileInformationByHandle[+|-]",
Strings.HelpText_DisplayHelp_IgnoreSetFileInformationByHandle,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreSetFileInformationByHandle,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreReparsePoints[+|-]",
Strings.HelpText_DisplayHelp_IgnoreReparsePoints,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreReparsePoints,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreFullReparsePointResolving[+|-]",
Strings.HelpText_DisplayHelp_IgnoreFullReparsePointResolving,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreFullReparsePointResolving,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnorePreloadedDlls[+|-]",
Strings.HelpText_DisplayHelp_IgnorePreloadedDlls,
Strings.HelpText_DisplayHelp_Unsafe_IgnorePreloadedDlls,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreDynamicWritesOnAbsentProbes[+|-|:IgnoreNothing|:IgnoreDirectoryProbes|:IgnoreFileProbes|:IgnoreAll]",
Strings.HelpText_DisplayHelp_IgnoreDynamicWritesOnAbsentProbes,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreDynamicWritesOnAbsentProbes,
HelpLevel.Verbose);
hw.WriteOption(
@ -1099,7 +1089,7 @@ namespace BuildXL
hw.WriteOption(
"/unsafe_DisableDetours[+|-]",
Strings.HelpText_DisplayHelp_DisableDetours,
Strings.HelpText_DisplayHelp_Unsafe_DisableDetours,
HelpLevel.Verbose);
hw.WriteOption(
@ -1124,42 +1114,42 @@ namespace BuildXL
hw.WriteOption(
"/unsafe_ExistingDirectoryProbesAsEnumerations[+|-]",
Strings.HelpText_DisplayHelp_ExistingDirectoryProbesAsEnumerations,
Strings.HelpText_DisplayHelp_Unsafe_ExistingDirectoryProbesAsEnumerations,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_ignoreGetFinalPathNameByHandle[+|-]",
Strings.HelpText_DisplayHelp_IgnoreGetFinalPathNameByHandle,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreGetFinalPathNameByHandle,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreNtCreateFile[+|-]",
Strings.HelpText_DisplayHelp_IgnoreNtCreateFile,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreNtCreateFile,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_IgnoreZwCreateOpenQueryFamily[+|-]",
Strings.HelpText_DisplayHelp_IgnoreZwCreateOpenQueryFamily,
Strings.HelpText_DisplayHelp_Unsafe_IgnoreZwCreateOpenQueryFamily,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_OptimizedAstConversion[+|-]",
Strings.HelpText_DisplayHelp_OptimizedAstConversion,
Strings.HelpText_DisplayHelp_Unsafe_OptimizedAstConversion,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_PreserveOutputs[+|-|:Reset]",
Strings.HelpText_DisplayHelp_PreserveOutputs,
Strings.HelpText_DisplayHelp_Unsafe_PreserveOutputs,
HelpLevel.Verbose);
hw.WriteOption(
"/unsafe_UnexpectedFileAccessesAreErrors[+|-]",
Strings.HelpText_DisplayHelp_UnexpectedFileAccessesAreErrors,
Strings.HelpText_DisplayHelp_Unsafe_UnexpectedFileAccessesAreErrors,
HelpLevel.Verbose);
hw.WriteOption(
"/debug_LoadGraph:<fingerprint | path | name>",
Strings.HelpText_DisplayHelp_LoadGraph,
Strings.HelpText_DisplayHelp_Debug_LoadGraph,
HelpLevel.Verbose);
hw.WriteOption(
@ -1173,17 +1163,17 @@ namespace BuildXL
#region DScript
hw.WriteOption(
"/debugScript[+|-]",
Strings.HelpText_DisplayHelp_ScriptDebugScript);
Strings.HelpText_DisplayHelp_DebugScript);
hw.WriteOption(
"/debuggerBreakOnExit[+|-]",
Strings.HelpText_DisplayHelp_ScriptDebugScriptBreakOnExit);
Strings.HelpText_DisplayHelp_DebuggerBreakOnExit);
hw.WriteOption(
"/debuggerPort",
Strings.HelpText_DisplayHelp_ScriptDebugScriptPort);
Strings.HelpText_DisplayHelp_DebuggerPort);
hw.WriteOption(
"/unsafe_disableCycleDetection[+|-]",
Strings.HelpText_DisplayHelp_DisableCycleDetection);
Strings.HelpText_DisplayHelp_Unsafe_DisableCycleDetection);
hw.WriteOption(
"/maxFrontEndConcurrency:<number of processes>",
@ -1296,7 +1286,7 @@ namespace BuildXL
hw.WriteOption(
"/unsafe_DisableGraphPostValidation[+|-]",
Strings.HelpText_DisplayHelp_DisableGraphPostValidation);
Strings.HelpText_DisplayHelp_Unsafe_DisableGraphPostValidation);
hw.WriteOption(
"/logPipStaticFingerprintTexts[+|-]",
@ -1307,10 +1297,10 @@ namespace BuildXL
Strings.HelpText_DisplayHelp_PosixDeleteMode);
hw.WriteOption("/minimumDiskSpaceForPipsGb:<int representing disk space in Gigabyte>",
Strings.HelpText_DisplayHelp_DiskSpaceForPip);
Strings.HelpText_DisplayHelp_MinimumDiskSpaceForPipsGb);
hw.WriteOption("/numRetryFailedPipsOnAnotherWorker:<int>",
Strings.HelpText_DisplayHelp_NumberofFailedPipRetry);
Strings.HelpText_DisplayHelp_NumRetryFailedPipsOnAnotherWorker);
hw.WriteOption("/enablePlugins[+|-]",
Strings.HelpText_DisplayHelp_EnablePlugins,
@ -1330,7 +1320,7 @@ namespace BuildXL
hw.WriteOption(
"/unsafe_AssumeCleanOutputs[+|-]",
Strings.HelpText_DisplayHelp_AssumeCleanOutputs,
Strings.HelpText_DisplayHelp_Unsafe_AssumeCleanOutputs,
HelpLevel.Verbose);
hw.WriteOption(

78
Public/Src/App/Bxl/Strings.resx
Просмотреть файл

@ -120,10 +120,10 @@
<data name="HelpText_DisplayHelp_BuildBanner" xml:space="preserve">
<value>BUILD</value>
</data>
<data name="HelpText_DisplayHelp_ConfigFile" xml:space="preserve">
<data name="HelpText_DisplayHelp_Config" xml:space="preserve">
<value>Configuration file that determines {ShortProductName}'s behavior (short form: /c)</value>
</data>
<data name="HelpText_DisplayHelp_Qualifiers" xml:space="preserve">
<data name="HelpText_DisplayHelp_Qualifier" xml:space="preserve">
<value>Qualifiers controlling what flavor to build (short form: /q)</value>
</data>
<data name="HelpText_DisplayHelp_Paths" xml:space="preserve">
@ -222,7 +222,7 @@
<data name="Args_ParseWarningList_ExpectingValidWarningNumbers" xml:space="preserve">
<value>Expecting valid warning numbers for the /{0} argument but was given '{1}'.</value>
</data>
<data name="HelpText_DisplayHelp_Obj" xml:space="preserve">
<data name="HelpText_DisplayHelp_ObjectDirectory" xml:space="preserve">
<value>Specifies the root directory for primary build outputs (short form: /o)</value>
</data>
<data name="HelpText_DisplayHelp_Property" xml:space="preserve">
@ -249,7 +249,7 @@
<data name="HelpText_DisplayHelp_CacheDirectory" xml:space="preserve">
<value>Specifies the root directory for the incremental artifact cache (short form: /cd)</value>
</data>
<data name="HelpText_DisplayHelp_AllowDuplicateTemporaryDirectory" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_AllowDuplicateTemporaryDirectory" xml:space="preserve">
<value>When enabled, pips with duplicate temporary directories are allowed. Defaults to false.</value>
</data>
<data name="HelpText_DisplayHelp_Incremental" xml:space="preserve">
@ -267,34 +267,34 @@
<data name="App_Main_Snapshot" xml:space="preserve">
<value> Snapshot: {0}</value>
</data>
<data name="HelpText_DisplayHelp_LogObservedAccesses" xml:space="preserve">
<data name="HelpText_DisplayHelp_LogObservedFileAccesses" xml:space="preserve">
<value>Records the files observed to be accessed by individual pips to the log. Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_LogFileEnforcementTables" xml:space="preserve">
<data name="HelpText_DisplayHelp_LogFileAccessTables" xml:space="preserve">
<value>Records the file enforcement access tables for individual pips to the log. Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_UnexpectedFileAccessesAreErrors" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_UnexpectedFileAccessesAreErrors" xml:space="preserve">
<value>When enabled, if {ShortProductName} detects that a tool accesses a file that was not declared in the specification dependencies, it is treated as an error instead of a warning. Turning this option off results in an unsafe configuration (for diagnostic purposes only). Defaults to on.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreZwRenameFileInformation" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreZwRenameFileInformation" xml:space="preserve">
<value>When enabled, {ShortProductName} will not detour the ZwRenameFileInformation API. This might lead to incorrect builds because some file accesses will not be enforced.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreZwOtherFileInformation" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreZwOtherFileInformation" xml:space="preserve">
<value>When enabled, {ShortProductName} will not detour the ZwLinkFileInformation, ZwFileNameFileInformation, ZwDispositionFileInformation, ZwModeFileInformation APIs. This might lead to incorrect builds because some file accesses will not be enforced. Defaults to off - the functions are detoured.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreNonCreateFileReparsePoints" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreNonCreateFileReparsePoints" xml:space="preserve">
<value>When enabled, {ShortProductName} will not follow symlinks for access validation and reporting for API's outisde of CreateFile, NtCreate, and OpenFile. This might lead to incorrect builds because some file accesses will not be enforced. Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreSetFileInformationByHandle" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreSetFileInformationByHandle" xml:space="preserve">
<value>When enabled, {ShortProductName} will not detour the SetFileInformationByHandle API. This might lead to incorrect builds because some file accesses will not be enforced.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreReparsePoints" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreReparsePoints" xml:space="preserve">
<value>When enabled, {ShortProductName} will not track reparse points. This might lead to incorrect builds because some file accesses will not be enforced. Any reparse points (symlinks and mount points) will not be followed.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreFullReparsePointResolving" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreFullReparsePointResolving" xml:space="preserve">
<value>When enabled, {ShortProductName} will not fully resolve paths containing any sort of reparse point. This might lead to incorrect builds because some file accesses will not be enforced or tracked at all.</value>
</data>
<data name="HelpText_DisplayHelp_IgnorePreloadedDlls" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnorePreloadedDlls" xml:space="preserve">
<value>When enabled, {ShortProductName} will not report Dlls loaded before Detours was started. This might lead to incorrect builds because some file accesses will not be enforced.</value>
</data>
<data name="Args_SandboxKind_WrongPlatform" xml:space="preserve">
@ -303,19 +303,19 @@
<data name="HelpText_DisplayHelp_SandboxKind" xml:space="preserve">
<value>Specifies the sandbox kind. Allowed values are 'None' (no sandboxing), 'Default' (default sandboxing), 'WinDetours', 'MacOsKext'. Default is 'Default'.</value>
</data>
<data name="HelpText_DisplayHelp_DisableDetours" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_DisableDetours" xml:space="preserve">
<value>When enabled, {ShortProductName} will not detour any processes. This might lead to incorrect builds because any file accesses will not be enforced.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreNonExistentProbes" xml:space="preserve">
<value>When enabled, {ShortProductName} will not report non existent probes, that are not in sealed directories. This might lead to incorrect builds because some file accesses will not be enforced and validated. Certain calls to GetFileAttribute method for non existing files will not be reported to {ShortProductName}.</value>
</data>
<data name="HelpText_DisplayHelp_ExistingDirectoryProbesAsEnumerations" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_ExistingDirectoryProbesAsEnumerations" xml:space="preserve">
<value>When enabled, {ShortProductName} will report existing directory probes as enumerations. This might lead to cases where pips will be executed even when there is no need for it.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreNtCreateFile" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreNtCreateFile" xml:space="preserve">
<value>When enabled, {ShortProductName} will not intercept NtCreateFile calls. This might lead to incorrect builds because some file accesses will not be enforced.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreZwCreateOpenQueryFamily" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreZwCreateOpenQueryFamily" xml:space="preserve">
<value>When enabled, {ShortProductName} will not intercept ZwCreateFile, ZwOpenFile, and ZwQueryDirectoryFile calls. This might lead to incorrect builds because some file accesses will not be enforced. This flag is off by default.</value>
</data>
<data name="App_Main_Cache" xml:space="preserve">
@ -549,9 +549,6 @@
<data name="App_RootMapping_CantApplyRootMappings" xml:space="preserve">
<value>Unable to apply root mappings.</value>
</data>
<data name="HelpText_DisplayHelp_AllowMissingOutputs" xml:space="preserve">
<value>When specified, suppresses errors for specified-but-not-produced outputs with the given name. May be specified more than once. Using this option results in an unsafe configuration (for diagnostic purposes only). Defaults to false.</value>
</data>
<data name="HelpText_DisplayHelp_TranslateDirectory" xml:space="preserve">
<value>Specify translation of directories before access policy is applied - the fromPath is replaced with toPath in the names of paths accessed. Make sure to add the trailing path separators. Valid from/to path separators are '&lt;' and ' and '::'. Recommended separator is '::'. Defaults to no directory translation is done.</value>
</data>
@ -564,9 +561,6 @@
<data name="HelpText_DisplayHelp_CacheSpecs" xml:space="preserve">
<value>Caches build specification files to a single large file to improve read performance on spinning disks. When unset the behavior is dynamic based on whether root configuration file is on a drive that is detected to have a seek penalty. May be forced on or off using the flag.</value>
</data>
<data name="HelpText_DisplayHelp_DeterminismProbeUsage" xml:space="preserve">
<value>DeterminismProbe feature was removed, this option will do nothing</value>
</data>
<data name="HelpText_DisplayHelp_LogProcesses" xml:space="preserve">
<value>Records all launched processes, including nested processes, of each pip to the log. Defaults to off.</value>
</data>
@ -610,7 +604,7 @@
<value>Invalid graph identifier '{0}' specified. Graph identifier must be a 40 digit hex string (no delimiters).
Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
</data>
<data name="HelpText_DisplayHelp_LoadGraph" xml:space="preserve">
<data name="HelpText_DisplayHelp_Debug_LoadGraph" xml:space="preserve">
<value>Loads a cached build graph stored under the given fingerprint (40 digit hex string, no delimiters), path to cached graph directory, or canonical name.</value>
</data>
<data name="HelpText_DisplayHelp_EngineCacheDirectory" xml:space="preserve">
@ -658,13 +652,13 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_ScriptBanner" xml:space="preserve">
<value>{ShortScriptName}</value>
</data>
<data name="HelpText_DisplayHelp_ScriptDebugScript" xml:space="preserve">
<data name="HelpText_DisplayHelp_DebugScript" xml:space="preserve">
<value>Whether to launch {ShortScriptName} debugger on start. Intended to be used by IDEs only (if you pass this option when running form command line, {ShortScriptName} evaluator will just wait forever). Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_ScriptDebugScriptBreakOnExit" xml:space="preserve">
<data name="HelpText_DisplayHelp_DebuggerBreakOnExit" xml:space="preserve">
<value>Whether to break at the end of the evaluation phase. Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_ScriptDebugScriptPort" xml:space="preserve">
<data name="HelpText_DisplayHelp_DebuggerPort" xml:space="preserve">
<value>TCP/IP port for the {ShortScriptName} debugger to listen on. Defaults to 41177.</value>
</data>
<data name="HelpText_DisplayHelp_ScriptTypeCheck" xml:space="preserve">
@ -712,10 +706,10 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="App_Vs_InstallPlugin" xml:space="preserve">
<value>{0} does not have the latest {ShortProductName} plugin installed. Before opening VS, please install the latest version ({1}) per the {ShortProductName} wiki</value>
</data>
<data name="HelpText_DisplayHelp_ForceSkipDependencies" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_ForceSkipDeps" xml:space="preserve">
<value>Specifies that dependencies of processes requested in the filter should be skipped as long as all the inputs are present.</value>
</data>
<data name="HelpText_DisplayHelp_PreserveOutputs" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_PreserveOutputs" xml:space="preserve">
<value>When enabled, {ShortProductName} will preserve the existing state of Process pip output files instead of deleting them before starting the process. This may lead to incorrect builds depending on how the process behaves when prior outputs are present. Specify "/unsafe_preserveOutputs:Reset" to reset the salt added to cached processes run with preserved outputs.</value>
</data>
<data name="HelpText_DisplayHelp_NormalizeReadTimestamps" xml:space="preserve">
@ -736,10 +730,10 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_TreatDirectoryAsAbsentFileOnHashingInputContent" xml:space="preserve">
<value>Treats directory as absent file on hashing the content of input</value>
</data>
<data name="HelpText_DisplayHelp_DisableCycleDetection" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_DisableCycleDetection" xml:space="preserve">
<value>Disables cycle detection during evaluation. Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_EnforceFileAccesses" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_MonitorFileAccesses" xml:space="preserve">
<value>Whether {ShortProductName} is to monitor file accesses of individual tools at all. Disabling monitoring results in an unsafe configuration (for diagnostic purposes only). Defaults to on.</value>
</data>
<data name="HelpText_DisplayHelp_VS" xml:space="preserve">
@ -757,7 +751,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_MaxRamUtilizationPercentage" xml:space="preserve">
<value>Specifies the maximum machine wide RAM utilization allowed before the scheduler will stop scheduling more work to allow resources to be freed. Defaults to 85%.</value>
</data>
<data name="HelpText_DisplayHelp_MinAvailableRam" xml:space="preserve">
<data name="HelpText_DisplayHelp_MinAvailableRamMb" xml:space="preserve">
<value>This flag is deprecated.</value>
</data>
<data name="App_ServerKilled" xml:space="preserve">
@ -796,7 +790,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_FancyConsoleMaxStatusPips" xml:space="preserve">
<value>Maximum number of concurrently executing pips to render in Fancy Console view. Defaults to 5.</value>
</data>
<data name="HelpText_DisplayHelp_AllowCopySymlink" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_AllowCopySymlink" xml:space="preserve">
<value>When enabled, allow copying symlink. Defaults to true.</value>
</data>
<data name="Args_Malformed_RelatedActivityGuid" xml:space="preserve">
@ -817,7 +811,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_ProfileScript" xml:space="preserve">
<value>Runs a profiler for {ShortScriptName} evaluation, generating a TSV file with profiling information.</value>
</data>
<data name="HelpText_DisplayHelp_DistributedBuildWorkerSourceMaterialization" xml:space="preserve">
<data name="HelpText_DisplayHelp_EnableWorkerSourceFileMaterialization" xml:space="preserve">
<value>Enables materialization of source files on distributed workers. NOTE: Source files are required to be present in the worker's remote or local cache.</value>
</data>
<data name="HelpText_DisplayHelp_ValidateDistribution" xml:space="preserve">
@ -829,7 +823,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_MaxTypeCheckingConcurrency" xml:space="preserve">
<value>Specifies the maximum concurrency level type checking phase. Defaults to /maxFrontEndConcurrency - 25% more than the total number of processors in the current machine.</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreGetFinalPathNameByHandle" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreGetFinalPathNameByHandle" xml:space="preserve">
<value>When enabled, {ShortProductName} will not intercept GetFinalPathNameByHandle calls. This may lead to failures when using subst because non-subst paths will be used. Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_LogProcessDetouringStatus" xml:space="preserve">
@ -886,7 +880,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_UseFileContentTablePathMappings" xml:space="preserve">
<value>Use file content table path mappings to avoid opening handles for hashing files already in the table. Defaults to off.</value>
</data>
<data name="HelpText_DisplayHelp_DisableGraphPostValidation" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_DisableGraphPostValidation" xml:space="preserve">
<value>Disables post validation of graph construction. Defaults to on.</value>
</data>
<data name="DX_Help_Link_Prefix" xml:space="preserve">
@ -955,7 +949,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_LaunchDebugger" xml:space="preserve">
<value>Launches the debugger during boot (in the server process if applicable).</value>
</data>
<data name="HelpText_DisplayHelp_IgnoreDynamicWritesOnAbsentProbes" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_IgnoreDynamicWritesOnAbsentProbes" xml:space="preserve">
<value>When enabled, {ShortProductName} will not flag as violations absent path probes that coexist with writes under output directories for those same paths.</value>
</data>
<data name="HelpText_DisplayHelp_StoreFingerprintsWithMode" xml:space="preserve">
@ -979,7 +973,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="Args_AdminRequiredProcessExecutionMode_NotSupportedOnNonWindows" xml:space="preserve">
<value>Admin-required process execution mode '{0}' is not supported on non-Windows OS</value>
</data>
<data name="HelpText_DisplayHelp_OptimizedAstConversion" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_OptimizedAstConversion" xml:space="preserve">
<value>When enabled, optimized AST conversion by disabling some analyses and skipping some AST constructs. By disabling analyses linter policies are not enforced. The types in the resulting AST are stripped away as they are not needed for evaluation. Defauts to off.</value>
</data>
<data name="HelpText_DisplayHelp_Interactive" xml:space="preserve">
@ -1003,7 +997,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_ValidateCgManifest" xml:space="preserve">
<value>Validates the cgmanifest.json file at the specified path. This file should contain up-to-date names and versions of all Nuget packages used within BuildXL for Component Governance. Any mismatch will cause the Build to fail. Updated file can be created using the /generateCgManifestForNugets:&lt;path&gt;</value>
</data>
<data name="HelpText_DisplayHelp_DiskSpaceForPip" xml:space="preserve">
<data name="HelpText_DisplayHelp_MinimumDiskSpaceForPipsGb" xml:space="preserve">
<value>Specify the required minimum available disk space in Gigabytes. Default value set to 0GB (disabled). Pips will fail if the specified amount of disk space in unavailable.</value>
</data>
<data name="HelpText_DisplayHelp_CacheMissDiffFormat" xml:space="preserve">
@ -1012,7 +1006,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_CacheOnly" xml:space="preserve">
<value>Only processes cache hits. Any pips that are cache misses will skip execution. Skipped pips will not cause the build session to fail.</value>
</data>
<data name="HelpText_DisplayHelp_NumberofFailedPipRetry" xml:space="preserve">
<data name="HelpText_DisplayHelp_NumRetryFailedPipsOnAnotherWorker" xml:space="preserve">
<value>Specify the number of times a pip failing due to worker failures, should be retried on another worker. Default value set to 0 (disabled).</value>
</data>
<data name="HelpText_DisplayHelp_PathSetAugmentationMonitoring" xml:space="preserve">
@ -1102,7 +1096,7 @@ Example: ad2d42d2ec5d2ca0c0b7ad65402d07c7ef40b91e</value>
<data name="HelpText_DisplayHelp_StopOnFirstInternalError" xml:space="preserve">
<value>Stops the build engine the first time an internal error is generated by {ShortProductName}. Defaults to off for single machine builds.</value>
</data>
<data name="HelpText_DisplayHelp_AssumeCleanOutputs" xml:space="preserve">
<data name="HelpText_DisplayHelp_Unsafe_AssumeCleanOutputs" xml:space="preserve">
<value>When enabled, BuildXL assumes there are no stale outputs from previous builds.</value>
</data>
<data name="HelpText_DisplayHelp_EnableLinuxPTraceSandbox" xml:space="preserve">