// Copyright (c) 2009 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include "chrome/common/chrome_switches.h" #include "base/base_switches.h" namespace switches { // Can't find the switch you are looking for? try looking in // base/base_switches.cc instead. // Suppresses hang monitor dialogs in renderer processes. const char kDisableHangMonitor[] = "disable-hang-monitor"; // Completely disables UMA metrics system. const char kDisableMetrics[] = "disable-metrics"; // Enables the recording of metrics reports but disables reporting. // In contrast to kDisableMetrics, this executes all the code that a normal // client would use for reporting, except the report is dropped rather than sent // to the server. This is useful for finding issues in the metrics code during // UI and performance tests. const char kMetricsRecordingOnly[] = "metrics-recording-only"; // Causes the browser process to throw an assertion on startup. const char kBrowserAssertTest[] = "assert-test"; // Causes the renderer process to throw an assertion on launch. const char kRendererAssertTest[] = "renderer-assert-test"; // Causes the browser process to crash on startup. const char kBrowserCrashTest[] = "crash-test"; // Causes the renderer process to crash on launch. const char kRendererCrashTest[] = "renderer-crash-test"; // Causes the renderer process to display a dialog on launch. const char kRendererStartupDialog[] = "renderer-startup-dialog"; // Causes the plugin process to display a dialog on launch. const char kPluginStartupDialog[] = "plugin-startup-dialog"; // Specifies a command that should be used to launch the plugin process. Useful // for running the plugin process through purify or quantify. Ex: // --plugin-launcher="path\to\purify /Run=yes" const char kPluginLauncher[] = "plugin-launcher"; // The value of this switch tells the app to listen for and broadcast // testing-related messages on IPC channel with the given ID. const char kTestingChannelID[] = "testing-channel"; // The value of this switch specifies which page will be displayed // in newly-opened tabs. We need this for testing purposes so // that the UI tests don't depend on what comes up for http://google.com. const char kHomePage[] = "homepage"; // Causes the process to run as renderer instead of as browser. const char kRendererProcess[] = "renderer"; // Causes the process to run as a renderer zygote. const char kZygoteProcess[] = "zygote"; // Path to the exe to run for the renderer and plugin subprocesses. const char kBrowserSubprocessPath[] = "browser-subprocess-path"; // Causes the process to run as a plugin subprocess. const char kPluginProcess[] = "plugin"; // Causes the process to run as a worker subprocess. const char kWorkerProcess[] = "worker"; // Causes the process to run as a NativeClient's sel_ldr subprocess. const char kNaClProcess[] = "nacl"; // Causes the process to run as a utility subprocess. const char kUtilityProcess[] = "utility"; // Causes the process to run as a profile import subprocess. const char kProfileImportProcess[] = "profile-import"; // Runs the renderer and plugins in the same process as the browser const char kSingleProcess[] = "single-process"; // Runs each set of script-connected tabs (i.e., a BrowsingInstance) in its own // renderer process. We default to using a renderer process for each // site instance (i.e., group of pages from the same registered domain with // script connections to each other). const char kProcessPerTab[] = "process-per-tab"; // Runs a single process for each site (i.e., group of pages from the same // registered domain) the user visits. We default to using a renderer process // for each site instance (i.e., group of pages from the same registered // domain with script connections to each other). const char kProcessPerSite[] = "process-per-site"; // Runs plugins inside the renderer process const char kInProcessPlugins[] = "in-process-plugins"; // Runs the renderer outside the sandbox. const char kNoSandbox[] = "no-sandbox"; // Disables the alternate window station for the renderer. const char kDisableAltWinstation[] = "disable-winsta"; // Runs the plugin processes inside the sandbox. const char kSafePlugins[] = "safe-plugins"; // Excludes these plugins from the plugin sandbox. // This is a comma-separated list of plugin library names. const char kTrustedPlugins[] = "trusted-plugins"; // Runs the security test for the sandbox. const char kTestSandbox[] = "test-sandbox"; // Specifies the user data directory, which is where the browser will look // for all of its state. const char kUserDataDir[] = "user-data-dir"; // Specifies the plugin data directory, which is where plugins (Gears // specifically) will store its state. const char kPluginDataDir[] = "plugin-data-dir"; // Use a specific disk cache location, rather than one derived from the // UserDatadir. const char kDiskCacheDir[] = "disk-cache-dir"; // Forces the maximum disk space to be used by the disk cache, in bytes. const char kDiskCacheSize[] = "disk-cache-size"; // Forces the maximum disk space to be used by the media cache, in bytes. const char kMediaCacheSize[] = "media-cache-size"; // Whether the multiple profiles feature based on the user-data-dir flag is // enabled or not. const char kEnableUserDataDirProfiles[] = "enable-udd-profiles"; // Specifies the path to the user data folder for the parent profile. const char kParentProfile[] = "parent-profile"; // Specifies that the associated value should be launched in "application" mode. const char kApp[] = "app"; // Specifies if the dom_automation_controller_ needs to be bound in the // renderer. This binding happens on per-frame basis and hence can potentially // be a performance bottleneck. One should only enable it when automating // dom based tests. const char kDomAutomationController[] = "dom-automation"; // Tells the plugin process the path of the plugin to load const char kPluginPath[] = "plugin-path"; // A string used to override the default user agent with a custom one. const char kUserAgent[] = "user-agent"; // Specifies the flags passed to JS engine const char kJavaScriptFlags[] = "js-flags"; // The Country we should use. This is normally obtained from the operating // system during first run and cached in the preferences afterwards. This is a // string value, the 2 letter code from ISO 3166-1. const char kCountry[] = "country"; // Will add kWaitForDebugger to every child processes. If a value is passed, it // will be used as a filter to determine if the child process should have the // kWaitForDebugger flag passed on or not. const char kWaitForDebuggerChildren[] = "wait-for-debugger-children"; // Will filter log messages to show only the messages that are prefixed // with the specified value const char kLogFilterPrefix[] = "log-filter-prefix"; // Force logging to be enabled. Logging is disabled by default in release // builds. const char kEnableLogging[] = "enable-logging"; // Force logging to be disabled. Logging is enabled by default in debug // builds. const char kDisableLogging[] = "disable-logging"; // Sets the minimum log level. Valid values are from 0 to 3: // INFO = 0, WARNING = 1, LOG_ERROR = 2, LOG_FATAL = 3. const char kLoggingLevel[] = "log-level"; // Make plugin processes log their sent and received messages to LOG(INFO). const char kLogPluginMessages[] = "log-plugin-messages"; // Dump any accumualted histograms to the log when browser terminates (requires // logging to be enabled to really do anything). Used by developers and test // scripts. const char kDumpHistogramsOnExit[] = "dump-histograms-on-exit"; // enable remote debug / automation shell on the specified port const char kRemoteShellPort[] = "remote-shell-port"; // Runs un-installation steps that were done by chrome first-run. const char kUninstall[] = "uninstall"; // Number of entries to show in the omnibox popup. const char kOmniBoxPopupCount[] = "omnibox-popup-count"; // The value of this switch tells the app to listen for and broadcast // automation-related messages on IPC channel with the given ID. const char kAutomationClientChannelID[] = "automation-channel"; // Indicates the last session should be restored on startup. This overrides // the preferences value and is primarily intended for testing. The value of // this switch is the number of tabs to wait until loaded before // 'load completed' is sent to the ui_test. const char kRestoreLastSession[] = "restore-last-session"; // Chrome supports a playback and record mode. Record mode saves *everything* // to the cache. Playback mode reads data exclusively from the cache. This // allows us to record a session into the cache and then replay it at will. const char kRecordMode[] = "record-mode"; const char kPlaybackMode[] = "playback-mode"; // Don't record/playback events when using record & playback. const char kNoEvents[] = "no-events"; // Support a separate switch that enables the v8 playback extension. // The extension causes javascript calls to Date.now() and Math.random() // to return consistent values, such that subsequent loads of the same // page will result in consistent js-generated data and XHR requests. // Pages may still be able to generate inconsistent data from plugins. const char kNoJsRandomness[] = "no-js-randomness"; // Make Windows happy by allowing it to show "Enable access to this program" // checkbox in Add/Remove Programs->Set Program Access and Defaults. This // only shows an error box because the only way to hide Chrome is by // uninstalling it. const char kHideIcons[] = "hide-icons"; const char kShowIcons[] = "show-icons"; // Make Chrome default browser const char kMakeDefaultBrowser[] = "make-default-browser"; // Don't resolve hostnames to IPv6 addresses. const char kDisableIPv6[] = "disable-ipv6"; // Use a specified proxy server, overrides system settings. This switch only // affects HTTP and HTTPS requests. const char kProxyServer[] = "proxy-server"; // Don't use a proxy server, always make direct connections. Overrides any // other proxy server flags that are passed. const char kNoProxyServer[] = "no-proxy-server"; // Specify a list of hosts for whom we bypass proxy settings and use direct // connections. Ignored if --proxy-auto-detect or --no-proxy-server are // also specified. // TODO(robertshield): Specify host format. const char kProxyBypassList[] = "proxy-bypass-list"; // Force proxy auto-detection. const char kProxyAutoDetect[] = "proxy-auto-detect"; // Use the pac script at the given URL const char kProxyPacUrl[] = "proxy-pac-url"; // Use WinHTTP to fetch and evaluate PAC scripts. Otherwise the default is // to use Chromium's network stack to fetch, and V8 to evaluate. const char kWinHttpProxyResolver[] = "winhttp-proxy-resolver"; // Chrome will support prefetching of DNS information. Until this becomes // the default, we'll provide a command line switch. extern const char kDnsLogDetails[] = "dns-log-details"; extern const char kDnsPrefetchDisable[] = "dns-prefetch-disable"; #if defined(OS_LINUX) // A temporary switch before we implement the client certificate selection UI. // When an SSL server requests client authentication, select a client // certificate automatically. // WARNING: This switch has privacy issues because it reveals the user's // identity to any server that requests a client certificate without the // user's consent. const char kAutoSSLClientAuth[] = "auto-ssl-client-auth"; #endif // Enables support to debug printing subsystem. const char kDebugPrint[] = "debug-print"; // Prints the pages on the screen. const char kPrint[] = "print"; // Browser flag to disable the web inspector for all renderers. const char kDisableDevTools[] = "disable-dev-tools"; // Enable web inspector for all windows, even if they're part of the browser. // Allows us to use our dev tools to debug browser windows itself. const char kAlwaysEnableDevTools[] = "always-enable-dev-tools"; // Enable experimental timeline API. const char kEnableExtensionTimelineApi[] = "enable-extension-timeline-api"; // Used to set the value of SessionRestore::num_tabs_to_load_. See // session_restore.h for details. const char kTabCountToLoadOnSessionRestore[]= "tab-count-to-load-on-session-restore"; // Enable dynamic loading of the Memory Profiler DLL, which will trace // all memory allocations during the run. const char kMemoryProfiling[] = "memory-profile"; // Adds a "Purge memory" button to the Task Manager, which tries to dump as much // memory as possible. This is mostly useful for testing how well the // MemoryPurger functionality (which is normally triggered on Suspend) works. // // NOTE: This is only implemented for Views. const char kPurgeMemoryButton[] = "purge-memory-button"; // By default, cookies are not allowed on file://. They are needed in for // testing, for example page cycler and layout tests. See bug 1157243. const char kEnableFileCookies[] = "enable-file-cookies"; // Start the browser maximized, regardless of any previous settings. const char kStartMaximized[] = "start-maximized"; // Spawn threads to watch for excessive delays in specified message loops. // User should set breakpoints on Alarm() to examine problematic thread. // Usage: -enable-watchdog=[ui][io] // Order of the listed sub-arguments does not matter. const char kEnableWatchdog[] = "enable-watchdog"; // Display the First Run experience when the browser is started, regardless of // whether or not it's actually the first run. const char kFirstRun[] = "first-run"; // Bypass the First Run experience when the browser is started, regardless of // whether or not it's actually the first run. Overrides kFirstRun in case // you're for some reason tempted to pass them both. const char kNoFirstRun[] = "no-first-run"; #if defined(OS_POSIX) // Bypass the error dialog when the profile lock couldn't be attained. // This switch is used during automated testing. const char kNoProcessSingletonDialog[] = "no-process-singleton-dialog"; #endif // Enable histograming of tasks served by MessageLoop. See about:histograms/Loop // for results, which show frequency of messages on each thread, including APC // count, object signalling count, etc. const char kMessageLoopHistogrammer[] = "message-loop-histogrammer"; // Perform importing from another browser. The value associated with this // setting encodes the target browser and what items to import. const char kImport[] = "import"; // Change the DCHECKS to dump memory and continue instead of displaying error // dialog. This is valid only in Release mode when --enable-dcheck is // specified. const char kSilentDumpOnDCHECK[] = "silent-dump-on-dcheck"; // Normally when the user attempts to navigate to a page that was the result of // a post we prompt to make sure they want to. This switch may be used to // disable that check. This switch is used during automated testing. const char kDisablePromptOnRepost[] = "disable-prompt-on-repost"; // Disable pop-up blocking. const char kDisablePopupBlocking[] = "disable-popup-blocking"; // Don't execute JavaScript (browser JS like the new tab page still runs). const char kDisableJavaScript[] = "disable-javascript"; // Don't enforce the same-origin policy. (Used by people testing their sites.) const char kDisableWebSecurity[] = "disable-web-security"; // Prevent Java from running. const char kDisableJava[] = "disable-java"; // Prevent plugins from running. const char kDisablePlugins[] = "disable-plugins"; // Prevent images from loading. const char kDisableImages[] = "disable-images"; // Enable remote web font support. SVG font should always work whether // this option is specified or not. const char kEnableRemoteFonts[] = "enable-remote-fonts"; // Use the low fragmentation heap for the CRT. const char kUseLowFragHeapCrt[] = "use-lf-heap"; // Runs the Native Client inside the renderer process. const char kInternalNaCl[] = "internal-nacl"; #ifndef NDEBUG // Debug only switch to specify which gears plugin dll to load. const char kGearsPluginPathOverride[] = "gears-plugin-path"; #endif // Enable the fastback page cache. const char kEnableFastback[] = "enable-fastback"; // Disable syncing bookmarks to a Google Account. const char kDisableSync[] = "disable-sync"; // Use the SyncerThread implementation that matches up with the old pthread // impl semantics, but using Chrome synchronization primitives. The only // difference between this and the default is that we now have no timeout on // Stop(). Should only use if you experience problems with the default. const char kSyncerThreadTimedStop[] = "syncer-thread-timed-stop"; // Enable support for SDCH filtering (dictionary based expansion of content). // Optional argument is *the* only domain name that will have SDCH suppport. // Default is "-enable-sdch" to advertise SDCH on all domains. // Sample usage with argument: "-enable-sdch=.google.com" // SDCH is currently only supported server-side for searches on google.com. const char kSdchFilter[] = "enable-sdch"; // Enable user script support. const char kEnableUserScripts[] = "enable-user-scripts"; // Disable extensions. const char kDisableExtensions[] = "disable-extensions"; // Frequency in seconds for Extensions auto-update. const char kExtensionsUpdateFrequency[] = "extensions-update-frequency"; // Load an extension from the specified directory. const char kLoadExtension[] = "load-extension"; // Package an extension to a .crx installable file from a given directory. const char kPackExtension[] = "pack-extension"; // Optional PEM private key is to use in signing packaged .crx. const char kPackExtensionKey[] = "pack-extension-key"; // Show extensions on top with toolbar. const char kShowExtensionsOnTop[] = "show-extensions-on-top"; // Load an NPAPI plugin from the specified path. const char kLoadPlugin[] = "load-plugin"; // directory to locate user scripts in as an over-ride of the default const char kUserScriptsDir[] = "user-scripts-dir"; // Causes the browser to launch directly in incognito mode. const char kIncognito[] = "incognito"; // Turns on the accessibility in the renderer. Off by default until // http://b/issue?id=1432077 is fixed. const char kEnableRendererAccessibility[] = "enable-renderer-accessibility"; // Pass the name of the current running automated test to Chrome. const char kTestName[] = "test-name"; // On POSIX only: the contents of this flag are prepended to the renderer // command line. Useful values might be "valgrind" or "xterm -e gdb --args". const char kRendererCmdPrefix[] = "renderer-cmd-prefix"; // On POSIX only: the contents of this flag are prepended to the utility // process command line. Useful values might be "valgrind" or "xterm -e gdb // --args". const char kUtilityCmdPrefix[] = "utility-cmd-prefix"; // On Windows only: use the old WinInet-based ftp implemetation. const char kWininetFtp[] = "wininet-ftp"; // Enable Native Web Worker support const char kEnableNativeWebWorkers[] = "enable-native-web-workers"; // Causes the worker process allocation to use as many processes as cores. const char kWebWorkerProcessPerCore[] = "web-worker-process-per-core"; // Causes workers to run together in one process, depending on their domains. // Note this is duplicated in webworkerclient_impl.cc const char kWebWorkerShareProcesses[] = "web-worker-share-processes"; // Enables the bookmark menu. const char kBookmarkMenu[] = "bookmark-menu"; // Enables experimental features for Spellchecker. Right now, the first // experimental feature is auto spell correct, which corrects words which are // misppelled by typing the word with two consecutive letters swapped. The // features that will be added next are: // 1 - Allow multiple spellcheckers to work simultaneously. // 2 - Allow automatic detection of spell check language. // TODO(sidchat): Implement the above fetaures to work under this flag. const char kExperimentalSpellcheckerFeatures[] = "experimental-spellchecker-features"; // Enables StatsTable, logging statistics to a global named shared memory table. const char kEnableStatsTable[] = "enable-stats-table"; // Replaces the audio IPC layer for