// Copyright (c) 2011 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.
// -----------------------------------------------------------------------------
// Activate (make foreground) myself on launch. Helpful when Chrome
// is launched on the command line (e.g. by Selenium). Only needed on Mac.
const char kActivateOnLaunch[] = "activate-on-launch";
// On ChromeOS, file:// access is disabled except for certain whitelisted
// directories. This switch re-enables file:// for testing.
const char kAllowFileAccess[] = "allow-file-access";
// Allow non-https URL for background_page for hosted apps.
const char kAllowHTTPBackgroundPage[] = "allow-http-background-page";
// Don't block outdated plugins.
const char kAllowOutdatedPlugins[] = "allow-outdated-plugins";
// Allows injecting extensions and user scripts on the extensions
// gallery site. Normally prevented for security reasons, but can be
// useful for automation testing of the gallery.
const char kAllowScriptingGallery[] = "allow-scripting-gallery";
// This prevents Chrome from requiring authorization to run certain widely
// installed but less commonly used plug-ins.
const char kAlwaysAuthorizePlugins[] = "always-authorize-plugins";
// 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";
// Specifies that the associated value should be launched in "application" mode.
const char kApp[] = "app";
// Specifies that the extension-app with the specified id should be launched
// according to its configuration.
const char kAppId[] = "app-id";
// Override the apps checkout URL, which is used to determine when to expose
// some private APIs.
const char kAppsCheckoutURL[] = "apps-checkout-url";
// Specifying this flag allows the webstorePrivate APIs to return browser (aka
// sync) login tokens to be used for auto-login in the Web Store (normally they
// do not).
const char kAppsGalleryReturnTokens[] = "apps-gallery-return-tokens";
// The URL to use for the gallery link in the app launcher.
const char kAppsGalleryURL[] = "apps-gallery-url";
// The update url used by gallery/webstore extensions.
const char kAppsGalleryUpdateURL[] = "apps-gallery-update-url";
// Disable throbber for extension apps.
const char kAppsNoThrob[] = "apps-no-throb";
// Whitelist of servers that Negotiate will generate delegated Kerberos tickets
// for.
const char kAuthNegotiateDelegateWhitelist[] =
"auth-negotiate-delegate-whitelist";
// HTTP authentication schemes to enable. This is a comma separated list
// of authentication schemes (basic, digest, ntlm, and negotiate). By default
// all schemes are enabled. The primary use of this command line flag is to help
// triage autentication-related issues reported by end-users.
const char kAuthSchemes[] = "auth-schemes";
// Whitelist of servers which NTLM and Negotiate can automatically authenticate
// with using the default credentials of the currently logged in user.
const char kAuthServerWhitelist[] = "auth-server-whitelist";
// 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";
// When the option to block third-party cookies from being set is enabled,
// also block third-party cookies from being read.
const char kBlockReadingThirdPartyCookies[] =
"block-reading-third-party-cookies";
// Causes the browser process to throw an assertion on startup.
const char kBrowserAssertTest[] = "assert-test";
// Causes the browser process to crash on startup.
const char kBrowserCrashTest[] = "crash-test";
// How often (in seconds) to check for updates. Should only be used for
// testing purposes.
const char kCheckForUpdateIntervalSec[] = "check-for-update-interval";
// Run Chrome in Chrome Frame mode. This means that Chrome expects to be run
// as a dependent process of the Chrome Frame plugin.
const char kChromeFrame[] = "chrome-frame";
// Tells chrome to load the specified version of chrome.dll on Windows. If
// this version cannot be loaded, Chrome will exit.
const char kChromeVersion[] = "chrome-version";
// The unique id to be used for this cloud print proxy instance.
const char kCloudPrintProxyId[] = "cloud-print-proxy-id";
// Tells chrome to display the cloud print dialog and upload the
// specified file for printing.
const char kCloudPrintFile[] = "cloud-print-file";
// Used with kCloudPrintFile to specify a title for the resulting print
// job.
const char kCloudPrintJobTitle[] = "cloud-print-job-title";
// Specifies the mime type to be used when uploading data from the
// file referenced by cloud-print-file.
// Defaults to "application/pdf" if unspecified.
const char kCloudPrintFileType[] = "cloud-print-file-type";
// The URL of the cloud print service to use, overrides any value
// stored in preferences, and the default. Only used if the cloud
// print service has been enabled (see enable-cloud-print).
const char kCloudPrintServiceURL[] = "cloud-print-service";
// Causes the browser process to inspect loaded and registered DLLs for
// known conflicts and warn the user.
const char kConflictingModulesCheck[] = "conflicting-modules-check";
// 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";
// If enabled, tries to load inspector files from disk (allows reloading of
// devtool files without having to restart the browser).
const char kDebugDevTools[] = "debug-devtools";
// Enables support to debug printing subsystem.
const char kDebugPrint[] = "debug-print";
// Specifies the URL at which to fetch configuration policy from the device
// management backend. Specifying this switch turns on managed policy from the
// device management backend.
const char kDeviceManagementUrl[] = "device-management-url";
// Triggers a pletora of diagnostic modes.
const char kDiagnostics[] = "diagnostics";
// Disables the hardware acceleration of 3D CSS and animation.
const char kDisableAcceleratedLayers[] = "disable-accelerated-layers";
// Disables GPU accelerated video display.
const char kDisableAcceleratedVideo[] = "disable-accelerated-video";
// Disables the alternate window station for the renderer.
const char kDisableAltWinstation[] = "disable-winsta";
// Replaces the audio IPC layer for <audio> and <video> with a mock audio
// device, useful when using remote desktop or machines without sound cards.
// This is temporary until we fix the underlying problem.
// Disable CNAME lookup of the host when generating the Kerberos SPN for a
// Negotiate challenge. See HttpAuthHandlerNegotiate::CreateSPN
// for more background.
const char kDisableAuthNegotiateCnameLookup[] =
"disable-auth-negotiate-cname-lookup";
// Disable background mode (background apps will not keep chrome running in the
// background).
const char kDisableBackgroundMode[] = "disable-background-mode";
// Disable several subsystems which run network requests in the background.
// This is for use when doing network performance testing to avoid noise
// in the measurements.
const char kDisableBackgroundNetworking[] = "disable-background-networking";
// Disables blocked content warning animation. Currently shows animation for
// blocked pop-ups only.
const char kDisableBlockContentAnimation[] =
"disable-blocked-content-animation";
// This switch is used to disable the client-side phishing detection feature.
// Note that even if client-side phishing detection is enabled, it will only
// be active if the user has opted in to UMA stats and SafeBrowsing is enabled
// in the preferences.
const char kDisableClientSidePhishingDetection[] =
"disable-client-side-phishing-detection";
// Disables establishing a backup TCP connection if a specified timeout is
// exceeded.
const char kDisableConnectBackupJobs[] = "disable-connect-backup-jobs";
// Disables the custom JumpList on Windows 7.
const char kDisableCustomJumpList[] = "disable-custom-jumplist";
// Browser flag to disable the web inspector for all renderers.
const char kDisableDevTools[] = "disable-dev-tools";
// Disable extensions.
const char kDisableExtensions[] = "disable-extensions";
// Disable checking for user opt-in for extensions that want to inject script
// into file URLs (ie, always allow it). This is used during automated testing.
const char kDisableExtensionsFileAccessCheck[] =
"disable-extensions-file-access-check";
// Disables the sandbox for the built-in flash player.
const char kDisableFlashSandbox[] = "disable-flash-sandbox";
// Suppresses hang monitor dialogs in renderer processes. This may allow slow
// unload handlers on a page to prevent the tab from closing, but the Task
// Manager can be used to terminate the offending process in this case.
const char kDisableHangMonitor[] = "disable-hang-monitor";
// Disable the use of the HistoryQuickProvider for autocomplete results.
const char kDisableHistoryQuickProvider[] = "disable-history-quick-provider";
// Disable the use of the HistoryURLProvider for autocomplete results.
const char kDisableHistoryURLProvider[] = "disable-history-url-provider";
// Disables HTML5 Forms interactive validation.
const char kDisableInteractiveFormValidation[] =
"disable-interactive-form-validation";
// Disable the internal Flash Player.
const char kDisableInternalFlash[] = "disable-internal-flash";
// Don't resolve hostnames to IPv6 addresses. This can be used when debugging
// issues relating to IPv6, but shouldn't otherwise be needed. Be sure to
// file bugs if something isn't working properly in the presence of IPv6.
// This flag can be overidden by the "enable-ipv6" flag.
const char kDisableIPv6[] = "disable-ipv6";
// Disables IP Pooling within the networks stack (SPDY only). When a connection
// is needed for a domain which shares an IP with an existing connection,
// attempt to use the existing connection.
const char kDisableIPPooling[] = "disable-ip-pooling";
// Disable speculative TCP/IP preconnection.
const char kDisablePreconnect[] = "disable-preconnect";
// Whether we should prevent the new tab page from showing the first run
// notification.
const char kDisableNewTabFirstRun[] = "disable-new-tab-first-run";
// 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 remote web font support. SVG font should always work whether
// this option is specified or not.
const char kDisableRemoteFonts[] = "disable-remote-fonts";
// Turns off the accessibility in the renderer.
const char kDisableRendererAccessibility[] = "disable-renderer-accessibility";
// Prevents the URLs of BackgroundContents from being remembered and re-launched
// when the browser restarts.
const char kDisableRestoreBackgroundContents[] =
"disable-restore-background-contents";
// Disable site-specific tailoring to compatibility issues in WebKit.
const char kDisableSiteSpecificQuirks[] = "disable-site-specific-quirks";
// Disable False Start in SSL and TLS connections.
const char kDisableSSLFalseStart[] = "disable-ssl-false-start";
// Disable syncing browser data to a Google Account.
const char kDisableSync[] = "disable-sync";
// Disable syncing of apps.
const char kDisableSyncApps[] = "disable-sync-apps";
// Disable syncing of autofill.
const char kDisableSyncAutofill[] = "disable-sync-autofill";
// Disable syncing of autofill Profile.
const char kDisableSyncAutofillProfile[] = "disable-sync-autofill-profile";
// Disable syncing of bookmarks.
const char kDisableSyncBookmarks[] = "disable-sync-bookmarks";
// Disable syncing of extensions.
const char kDisableSyncExtensions[] = "disable-sync-extensions";
// Disable syncing browser passwords.
const char kDisableSyncPasswords[] = "disable-sync-passwords";
// Disable syncing of preferences.
const char kDisableSyncPreferences[] = "disable-sync-preferences";
// Disable syncing of themes.
const char kDisableSyncThemes[] = "disable-sync-themes";
// TabCloseableStateWatcher disallows closing of tabs and browsers under certain
// situations on ChromeOS. Some tests expect tabs or browsers to close, so we
// need a switch to disable the watcher.
const char kDisableTabCloseableStateWatcher[] =
"disable-tab-closeable-state-watcher";
// Allow disabling of translate from the command line to assist with
// automated browser testing (e.g. Selenium/WebDriver). Normal
// browser users should disable translate with the preference.
const char kDisableTranslate[] = "disable-translate";
// Disables the backend service for web resources.
const char kDisableWebResources[] = "disable-web-resources";
// Don't enforce the same-origin policy. (Used by people testing their sites.)
const char kDisableWebSecurity[] = "disable-web-security";
// Disable WebKit's XSSAuditor. The XSSAuditor mitigates reflective XSS.
const char kDisableXSSAuditor[] = "disable-xss-auditor";
// 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";
const char kDnsLogDetails[] = "dns-log-details";
// Disables prefetching of DNS information.
const char kDnsPrefetchDisable[] = "dns-prefetch-disable";
// Use the specified DNS server for raw DNS resolution.
const char kDnsServer[] = "dns-server";
// Specifies if the |DOMAutomationController| 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.
// Also enables sending/receiving renderer automation messages through the
// |AutomationRenderViewHelper|.
// TODO(kkania): Rename this to enable-renderer-automation after moving the
// |DOMAutomationController| to the |AutomationRenderViewHelper|.
const char kDomAutomationController[] = "dom-automation";
// 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 displaying net log events on the command line.
extern const char kLogNetLog[] = "log-net-log";
// Enable gpu-accelerated 2d canvas.
const char kEnableAccelerated2dCanvas[] = "enable-accelerated-2d-canvas";
// Enables the hardware acceleration of plugins.
const char kEnableAcceleratedPlugins[] = "enable-accelerated-plugins";
// Enables AeroPeek for each tab. (This switch only works on Windows 7).
const char kEnableAeroPeekTabs[] = "enable-aero-peek-tabs";
// Enable the inclusion of non-standard ports when generating the Kerberos SPN
// in response to a Negotiate challenge. See HttpAuthHandlerNegotiate::CreateSPN
// for more background.
const char kEnableAuthNegotiatePort[] = "enable-auth-negotiate-port";
// At this point, even if client-side phishing detection is enabled we will not,
// by default, display an interstitial if we detected a phishing site. Once
// we are confident that the false-positive rate is as low as expected we can
// remove this flag.
const char kEnableClientSidePhishingInterstitial[] =
"enable-client-side-phishing-interstitial";
// This flag enables UI for clearing server data. Temporarily in place
// until there's a server endpoint deployed.
const char kEnableClearServerData[] = "enable-clear-server-data";
// Enable click-to-play for blocked plug-ins.
const char kEnableClickToPlay[] = "enable-click-to-play";
// This applies only when the process type is "service". Enables the
// Cloud Print Proxy component within the service process.
const char kEnableCloudPrintProxy[] = "enable-cloud-print-proxy";
// Enables the Cloud Print dialog hosting code.
const char kEnableCloudPrint[] = "enable-cloud-print";
// Enables compositing to texture instead of display.
const char kEnableCompositeToTexture[] = "enable-composite-to-texture";
// Enables establishing a backup TCP connection if a specified timeout is
// exceeded.
const char kEnableConnectBackupJobs[] = "enable-connect-backup-jobs";
// Enables web developers to create apps for Chrome without using crx packages.
const char kEnableCrxlessWebApps[] = "enable-crxless-web-apps";
// Enable DNS side checking of certificates. Still experimental, should only
// be used by developers at the current time.
const char kEnableDNSCertProvenanceChecking[] =
"enable-dns-cert-provenance-checking";
const char kEnableDNSSECCerts[] = "enable-dnssec-certs";
// Enables app manifest features that are in development.
const char kEnableExperimentalAppManifests[] =
"enable-experimental-app-manifests";
// Enables extension APIs that are in development.
const char kEnableExperimentalExtensionApis[] =
"enable-experimental-extension-apis";
// Enable experimental timeline API.
const char kEnableExtensionTimelineApi[] = "enable-extension-timeline-api";
// Enable the fastback page cache.
const char kEnableFastback[] = "enable-fastback";
// By default, cookies are not allowed on file://. They are needed for
// testing, for example page cycler and layout tests. See bug 1157243.
const char kEnableFileCookies[] = "enable-file-cookies";
// Enable the use of the HistoryQuickProvider for autocomplete results.
const char kEnableHistoryQuickProvider[] = "enable-history-quick-provider";
// Enable the JavaScript Full Screen API.
const char kEnableFullScreen[] = "enable-fullscreen";
// Enable the in-browser thumbnailing, which is more efficient than the
// in-renderer thumbnailing, as we can use more information to determine
// if we need to update thumbnails.
const char kEnableInBrowserThumbnailing[] = "enable-in-browser-thumbnailing";
// Enable IPv6 support, even if probes suggest that it may not be fully
// supported. Some probes may require internet connections, and this flag will
// allow support independent of application testing.
// This flag overrides "disable-ipv6" which appears elswhere in this file.
const char kEnableIPv6[] = "enable-ipv6";
// Enables IP Pooling within the networks stack (SPDY only). When a connection
// is needed for a domain which shares an IP with an existing connection,
// attempt to use the existing connection.
const char kEnableIPPooling[] = "enable-ip-pooling";
// Allows reporting memory info (JS heap size) to page.
const char kEnableMemoryInfo[] = "enable-memory-info";
// Runs the Native Client inside the renderer process and enables GPU plugin
// (internally adds lEnableGpuPlugin to the command line).
const char kEnableNaCl[] = "enable-nacl";
// Enables debugging via RSP over a socket.
const char kEnableNaClDebug[] = "enable-nacl-debug";
// This applies only when the process type is "service". Enables the
// Chromoting Host Process within the service process.
const char kEnableRemoting[] = "enable-remoting";
// Enable content settings based on host *and* plug-in.
const char kEnableResourceContentSettings[] =
"enable-resource-content-settings";
// Enable panels (always on-top docked pop-up windows).
const char kEnablePanels[] = "enable-panels";
// Enable speculative TCP/IP preconnection.
const char kEnablePreconnect[] = "enable-preconnect";
// Enable print preview (work in progress).
const char kEnablePrintPreview[] = "enable-print-preview";
// Enable the IsSearchProviderInstalled and InstallSearchProvider with an extra
// parameter to indicate if the provider should be the default.
const char kEnableSearchProviderApiV2[] = "enable-search-provider-api-v2";
// Enables 0-RTT HTTPS handshakes.
const char kEnableSnapStart[] = "enable-snap-start";
// Enable syncing browser data to a Google Account.
const char kEnableSync[] = "enable-sync";
// Enable syncing browser autofill.
const char kEnableSyncAutofill[] = "enable-sync-autofill";
// Enable syncing browser sessions.
const char kEnableSyncSessions[] = "enable-sync-sessions";
// Enables context menu for selecting groups of tabs.
const char kEnableTabGroupsContextMenu[] = "enable-tab-groups-context-menu";
// Enable syncing browser typed urls.
const char kEnableSyncTypedUrls[] = "enable-sync-typed-urls";
// Enable use of experimental TCP sockets API for sending data in the
// SYN packet.
const char kEnableTcpFastOpen[] = "enable-tcp-fastopen";
// Enables the option to show tabs as a vertical stack down the side of the
// browser window.
const char kEnableVerticalTabs[] = "enable-vertical-tabs";
// 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";
// 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";
// Explicitly allow additional ports using a comma separated list of port
// numbers.
const char kExplicitlyAllowedPorts[] = "explicitly-allowed-ports";
// Frequency in seconds for Extensions auto-update.
const char kExtensionsUpdateFrequency[] = "extensions-update-frequency";
// These two flags are added around the switches about:flags adds to the
// command line. This is useful to see which switches were added by about:flags
// on about:version. They don't have any effect.
const char kFlagSwitchesBegin[] = "flag-switches-begin";
const char kFlagSwitchesEnd[] = "flag-switches-end";
// Alternative feedback server to use when submitting user feedback
const char kFeedbackServer[] = "feedback-server";
// The file descriptor limit is set to the value of this switch, subject to the
// OS hard limits. Useful for testing that file descriptor exhaustion is handled
// gracefully.
const char kFileDescriptorLimit[] = "file-descriptor-limit";
// If true opening a url from the omnibox attepts to focus an existing tab.
const char kFocusExistingTabOnOpen[] = "focus-existing-tab-on-open";
// 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";
// Forces the apps/webstore promo to be shown, independent of whether it has
// timed out, etc. Useful for testing.
const char kForceAppsPromoVisible[] = "force-apps-promo-visible";
// If accelerated compositing is supported, always enter compositing mode for
// the base layer even when compositing is not strictly required.
const char kForceCompositingMode[] = "force-compositing-mode";
// Force renderer accessibility to be on instead of enabling it on demand when
// a screen reader is detected. The disable-renderer-accessibility switch
// overrides this if present.
const char kForceRendererAccessibility[] = "force-renderer-accessibility";
// Specifies a custom name for the GSSAPI library to load.
const char kGSSAPILibraryName[] = "gssapi-library-name";
// These flags show the man page on Linux. They are equivalent to each
// other.
const char kHelp[] = "help";
const char kHelpShort[] = "h";
// 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";
// 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";
// Comma separated list of rules that control how hostnames are mapped.
//
// For example:
// "MAP * 127.0.0.1" --> Forces all hostnames to be mapped to 127.0.0.1
// "MAP *.google.com proxy" --> Forces all google.com subdomains to be
// resolved to "proxy".
// "MAP test.com [::1]:77 --> Forces "test.com" to resolve to IPv6 loopback.
// Will also force the port of the resulting
// socket address to be 77.
// "MAP * baz, EXCLUDE www.google.com" --> Remaps everything to "baz",
// except for "www.google.com".
//
// These mappings apply to the endpoint host in a net::URLRequest (the TCP
// connect and host resolver in a direct connection, and the CONNECT in an http
// proxy connection, and the endpoint host in a SOCKS proxy connection).
const char kHostRules[] = "host-rules";
// The maximum number of concurrent host resolve requests (i.e. DNS) to allow.
const char kHostResolverParallelism[] = "host-resolver-parallelism";
// These mappings only apply to the host resolver.
const char kHostResolverRules[] = "host-resolver-rules";
// Ignores GPU blacklist.
const char kIgnoreGpuBlacklist[] = "ignore-gpu-blacklist";
// Perform importing from another browser. The value associated with this
// setting encodes the target browser and what items to import.
const char kImport[] = "import";
// Perform bookmark importing from an HTML file. The value associated with this
// setting encodes the file path. It may be used jointly with kImport.
const char kImportFromFile[] = "import-from-file";
// Causes the browser to launch directly in incognito mode.
const char kIncognito[] = "incognito";
// URL to use for instant. If specified this overrides the url from the
// TemplateURL.
const char kInstantURL[] = "instant-url";
// Used for testing - keeps browser alive after last browser window closes.
const char kKeepAliveForTest[] = "keep-alive-for-test";
// Load an extension from the specified directory.
const char kLoadExtension[] = "load-extension";
// Load the opencryptoki library into NSS at startup. This is only
// needed temporarily for developers who need to work on WiFi/VPN
// certificate code.
// TODO(gspencer): Remove this switch once cryptohomed work is finished:
// http://crosbug.com/12295 and http://crosbug.com/12304
const char kLoadOpencryptoki[] = "load-opencryptoki";
// Uninstall an extension with the specified extension id.
const char kUninstallExtension[] = "uninstall-extension";
// Make Chrome default browser
const char kMakeDefaultBrowser[] = "make-default-browser";
// Forces the maximum disk space to be used by the media cache, in bytes.
const char kMediaCacheSize[] = "media-cache-size";
// Enable dynamic loading of the Memory Profiler DLL, which will trace
// all memory allocations during the run.
const char kMemoryProfiling[] = "memory-profile";
// 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";
// 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";
// The minimum version of Flash that implements the NPP_ClearSiteData API.
const char kMinClearSiteDataFlashVersion[] = "min-clearsitedata-flash-version";
// Enables multiprofile Chrome.
const char kMultiProfiles[] = "multi-profiles";
// Sets the default IP address (interface) for the stub (normally 127.0.0.1).
const char kNaClDebugIP[] = "nacl-debug-ip";
// Sets the default port range for debugging.
const char kNaClDebugPorts[] = "nacl-debug-ports";
// Causes the process to run as a NativeClient broker
// (used for launching NaCl loader processes on 64-bit Windows).
const char kNaClBrokerProcess[] = "nacl-broker";
// Causes the Native Client process to display a dialog on launch.
const char kNaClStartupDialog[] = "nacl-startup-dialog";
// Use the latest incarnation of the new tab page.
const char kNewTabPage4[] = "new-tab-page-4";
// Disables the default browser check. Useful for UI/browser tests where we
// want to avoid having the default browser info-bar displayed.
const char kNoDefaultBrowserCheck[] = "no-default-browser-check";
// Don't record/playback events when using record & playback.
const char kNoEvents[] = "no-events";
// Disables all experiments set on about:flags. Does not disable about:flags
// itself. Useful if an experiment makes chrome crash at startup: One can start
// chrome with --no-experiments, disable the problematic lab at about:flags and
// then restart chrome without this switch again.
const char kNoExperiments[] = "no-experiments";
// 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";
// Don't send hyperlink auditing pings
const char kNoPings[] = "no-pings";
// 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";
// Disables the service process from adding itself as an autorun process. This
// does not delete existing autorun registrations, it just prevents the service
// from registering a new one.
const char kNoServiceAutorun[] = "no-service-autorun";
// Does not automatically open a browser window on startup (used when launching
// Chrome for the purpose of hosting background apps).
const char kNoStartupWindow[] = "no-startup-window";
// Show a desktop notification that the cloud print token has expired and
// that user needs to re-authenticate.
const char kNotifyCloudPrintTokenExpired[] = "notify-cp-token-expired";
// Specifies the maximum number of threads to use for running the Proxy
// Autoconfig (PAC) script.
const char kNumPacThreads[] = "num-pac-threads";
// Launch URL in new browser window.
const char kOpenInNewWindow[] = "new-window";
// Simulate an organic Chrome install.
const char kOrganicInstall[] = "organic";
// 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";
// Specifies the path to the user data folder for the parent profile.
const char kParentProfile[] = "parent-profile";
// Forces the PPAPI version of Flash (if it's being used) to run in the
// renderer process rather than in a separate plugin process.
const char kPpapiFlashInProcess[] = "ppapi-flash-in-process";
// Controls speculative prerendering of pages, and content prefetching. Both
// are dispatched from <link rel=prefetch href=...> elements.
const char kPrerender[] = "prerender";
// These are the values the switch may have, as in "--prerender=auto".
// auto: Allow field trial selection in both prerender and prefetch.
const char kPrerenderSwitchValueAuto[] = "auto";
// disabled: No prerendering or prefetching.
const char kPrerenderSwitchValueDisabled[] = "disabled";
// enabled: Both prerendering and prefetching.
const char kPrerenderSwitchValueEnabled[] = "enabled";
// prefetch_only: No prerendering, but enable prefetching.
const char kPrerenderSwitchValuePrefetchOnly[] = "prefetch_only";
// Prints the pages on the screen.
const char kPrint[] = "print";
// Output the product version information and quit. Used as an internal api to
// detect the installed version of Chrome on Linux.
const char kProductVersion[] = "product-version";
// Starts the sampling based profiler for the browser process at
// startup. This will only work if chrome has been built with
// the gyp variable profiling=1. The output will go to the value
// of kProfilingFile.
const char kProfilingAtStart[] = "profiling-at-start";
// Specifies a location for profiling output. This will only work if chrome
// has been built with the gyp variable profiling=1.
// {pid} if present will be replaced by the pid of the process.
// {count} if present will be incremented each time a profile is generated
// for this process.
// The default is chrome-profile-{pid}.
const char kProfilingFile[] = "profiling-file";
// Controls whether profile data is periodically flushed to a file.
// Normally the data gets written on exit but cases exist where chrome
// doesn't exit cleanly (especially when using single-process).
// A time in seconds can be specified.
const char kProfilingFlush[] = "profiling-flush";
// Force proxy auto-detection.
const char kProxyAutoDetect[] = "proxy-auto-detect";
// 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.
// This is a comma separated list of bypass rules. See:
// "net/proxy/proxy_bypass_rules.h" for the format of these rules.
const char kProxyBypassList[] = "proxy-bypass-list";
// Use the pac script at the given URL
const char kProxyPacUrl[] = "proxy-pac-url";
// Use a specified proxy server, overrides system settings. This switch only
// affects HTTP and HTTPS requests.
const char kProxyServer[] = "proxy-server";
// 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 works.
//
// NOTE: This is only implemented for Views.
const char kPurgeMemoryButton[] = "purge-memory-button";
// Reload pages that have been killed when they are next focused by the user.
const char kReloadKilledTabs[] = "reload-killed-tabs";
// Enable remote debug over HTTP on the specified port.
const char kRemoteDebuggingPort[] = "remote-debugging-port";
// Enable remote debug / automation shell on the specified port.
const char kRemoteShellPort[] = "remote-shell-port";
// 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";
// URL prefix used by safebrowsing to fetch hash, download data and
// report malware.
const char kSbInfoURLPrefix[] = "safebrowsing-info-url-prefix";
// URL prefix used by safebrowsing to get MAC key.
const char kSbMacKeyURLPrefix[] = "safebrowsing-mackey-url-prefix";
// If present, safebrowsing only performs update when
// SafeBrowsingProtocolManager::ForceScheduleNextUpdate() is explicitly called.
// This is used for testing only.
const char kSbDisableAutoUpdate[] = "safebrowsing-disable-auto-update";
// TODO(lzheng): Remove this flag once the feature works fine
// (http://crbug.com/74848).
// This flag disables safebrowsing feature that checks download url and download
// content's hash to make sure the content are not malicious.
const char kSbDisableDownloadProtection[] =
"safebrowsing-disable-download-protection";
// 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";
// Enables the showing of an info-bar instructing user they can search directly
// from the omnibox.
const char kSearchInOmniboxHint[] = "search-in-omnibox-hint";
// The LSID of the account to use for the service process.
const char kServiceAccountLsid[] = "service-account-lsid";
// See kHideIcons.
const char kShowIcons[] = "show-icons";
// Renders a border around composited Render Layers to help debug and study
// layer compositing.
const char kShowCompositedLayerBorders[] = "show-composited-layer-borders";
// Draws a textual dump of the compositor layer tree to help debug and study
// layer compositing.
const char kShowCompositedLayerTree[] = "show-composited-layer-tree";
// Draws a FPS indicator
const char kShowFPSCounter[] = "show-fps-counter";
// 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";
// Replaces the buffered data source for <audio> and <video> with a simplified
// resource loader that downloads the entire resource into memory.
// Start the browser maximized, regardless of any previous settings.
const char kStartMaximized[] = "start-maximized";
// Allow insecure XMPP connections for sync (for testing).
const char kSyncAllowInsecureXmppConnection[] =
"sync-allow-insecure-xmpp-connection";
// Invalidate any login info passed into sync's XMPP connection.
const char kSyncInvalidateXmppLogin[] = "sync-invalidate-xmpp-login";
// 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";
// Override the default notification method for sync.
const char kSyncNotificationMethod[] = "sync-notification-method";
// Override the default host used for sync notifications. Can be either
// "host" or "host:port".
const char kSyncNotificationHost[] = "sync-notification-host";
// Override the default server used for profile sync.
const char kSyncServiceURL[] = "sync-url";
// Try to connect to XMPP using SSLTCP first (for testing).
const char kSyncTrySsltcpFirstForXmpp[] = "sync-try-ssltcp-first-for-xmpp";
// Pass the name of the current running automated test to Chrome.
const char kTestName[] = "test-name";
// Runs the security test for the NaCl loader sandbox.
const char kTestNaClSandbox[] = "test-nacl-sandbox";
// Pass the type of the current test harness ("browser" or "ui")
const char kTestType[] = "test-type";
// 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";
// Excludes these plugins from the plugin sandbox.
// This is a comma-separated list of plugin library names.
const char kTrustedPlugins[] = "trusted-plugins";
// Experimental. Shows a dialog asking the user to try chrome. This flag
// is to be used only by the upgrade process.
const char kTryChromeAgain[] = "try-chrome-again";
// Runs un-installation steps that were done by chrome first-run.
const char kUninstall[] = "uninstall";
// Use Spdy for the transport protocol instead of HTTP.
// This is a temporary testing flag.
const char kUseSpdy[] = "use-spdy";
// Ignore certificate related errors.
const char kIgnoreCertificateErrors[] = "ignore-certificate-errors";
// Set the maximum SPDY sessions per domain.
const char kMaxSpdySessionsPerDomain[] = "max-spdy-sessions-per-domain";
// Set the maximum concurrent streams over a SPDY session.
const char kMaxSpdyConcurrentStreams[] = "max-spdy-concurrent-streams";
// Specifies the user data directory, which is where the browser will look
// for all of its state.
const char kUserDataDir[] = "user-data-dir";
// directory to locate user scripts in as an over-ride of the default
const char kUserScriptsDir[] = "user-scripts-dir";
// 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";
// Print version information and quit.
const char kVersion[] = "version";
// 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";
#if defined(OS_CHROMEOS)
// Enable DOM based login screens.
const char kDOMLogin[] = "dom-login";
// Enables device policy support on ChromeOS.
const char kEnableDevicePolicy[] = "enable-device-policy";
// Enable all 802.1X EAP Wi-Fi connection modes, like EAP-TLS and LEAP.
// TODO(jamescook): Remove this when all major 802.1X modes are supported
// through the full network stack, specifically those that require TPM and
// client-side certificates.
const char kEnableExperimentalEap[] = "enable-experimental-eap";
// Enables VPN support on ChromeOS.
const char kEnableVPN[] = "enable-vpn";
// Enable the redirection of viewable document requests to the Google
// Document Viewer.
const char kEnableGView[] = "enable-gview";
// Should we show the image based login?
const char kEnableLoginImages[] = "enable-login-images";
// Enable Chrome-as-a-login-manager behavior.
const char kLoginManager[] = "login-manager";
// Allows to override the first login screen. The value should be the name
// of the first login screen to show (see
// chrome/browser/chromeos/login/login_wizard_view.cc for actual names).
// Ignored if kLoginManager is not specified.
// TODO(avayvod): Remove when the switch is no longer needed for testing.
const char kLoginScreen[] = "login-screen";
// Allows control over the initial login screen size. Pass width,height.
const char kLoginScreenSize[] = "login-screen-size";
// Attempts to load libcros and validate it, then exits. A nonzero return code
// means the library could not be loaded correctly.
const char kTestLoadLibcros[] = "test-load-libcros";
// Specifies the profile to use once a chromeos user is logged in.
const char kLoginProfile[] = "login-profile";
// Specifies the user which is already logged in.
const char kLoginUser[] = "login-user";
// Specifies a password to be used to login (along with login-user).
const char kLoginPassword[] = "login-password";
// Allows to emulate situation when user logins with new password.
const char kLoginUserWithNewPassword[] = "login-user-with-new-password";
// Attempts to perform Chrome OS offline and online login in parallel.
const char kParallelAuth[] = "parallel-auth";
// Use the frame layout used in chromeos.
const char kChromeosFrame[] = "chromeos-frame";
// Use the given language for UI in the input method candidate window.
const char kCandidateWindowLang[] = "lang";
// Indicates that the browser is in "browse without sign-in" (Guest session)
// mode. Should completely disable extensions, sync and bookmarks.
const char kGuestSession[] = "bwsi";
// Indicates that stub implementations of the libcros library should be used.
// This is typically used to test the chromeos build of chrome on the desktop.
const char kStubCros[] = "stub-cros";
// URL of the html page for Screen Saver.
const char kScreenSaverUrl[] = "screen-saver-url";
// Flag to trigger ChromeOS system log compression during feedback submit.
const char kCompressSystemFeedback[] = "compress-sys-feedback";
// Flag to skip loading ChromeOS specific component extensions. This one is
// needed to prevent these component interfering with the some of the tests.
// TODO(zelidrag): http://crosbug.com/14463 - we should remove this switch once
// get rid of ChromeOS component extensions with background pages.
const char kSkipChromeOSComponents[] = "skip-chromeos-components";
// Forces usage of libcros stub implementation. For testing purposes, this
// switch separates chrome code from the rest of ChromeOS.
const char kForceStubLibcros[] = "force-stub-libcros";
// Enables Advanced File System.
const char kEnableAdvancedFileSystem[] = "enable-advanced-fs";
#endif
#if defined(OS_LINUX)
// Specify the amount the trackpad should scroll by.
const char kScrollPixels[] = "scroll-pixels";
#endif
#if defined(OS_MACOSX) || defined(OS_WIN)
// Use the system SSL library (Secure Transport on Mac, SChannel on Windows)
// instead of NSS for SSL.
const char kUseSystemSSL[] = "use-system-ssl";
#endif
#if defined(OS_POSIX)
// A flag, generated internally by Chrome for renderer and other helper process
// command lines on Linux and Mac. It tells the helper process to enable crash
// dumping and reporting, because helpers cannot access the profile or other
// files needed to make this decision.
const char kEnableCrashReporter[] = "enable-crash-reporter";
// 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";
#if !defined(OS_MACOSX) && !defined(OS_CHROMEOS)
// Specifies which password store to use (detect, default, gnome, kwallet).
const char kPasswordStore[] = "password-store";
#endif
#endif
#if defined(OS_MACOSX)
// Enables the tabs expose feature ( http://crbug.com/50307 ).
const char kEnableExposeForTabs[] = "enable-expose-for-tabs";
#endif
#if !defined(OS_MACOSX)
// Enable Kiosk mode.
const char kKioskMode[] = "kiosk";
#endif
// Enables the experimental global gnome menu.
#if defined(TOOLKIT_GTK)
extern const char kGlobalGnomeMenu[] = "global-gnome-menu";
#endif
// Enables debug paint in views framework. Enabling this causes the damaged
// region being painted to flash in red.
#if defined(TOOLKIT_VIEWS)
const char kDebugViewsPaint[] = "debug-views-paint";
#endif
// Debug only switch to prevent the mouse cursor from disappearing when
// touch is enabled
#if defined(TOUCH_UI)
const char kKeepMouseCursor[] = "keep-mouse-cursor";
#endif
#ifndef NDEBUG
// Clear the token service before using it. This allows simulating
// the expiration of credentials during testing.
const char kClearTokenService[] = "clear-token-service";
// Sets a token in the token service, for testing.
const char kSetToken[] = "set-token";
// Debug only switch to specify which websocket live experiment host to be used.
// If host is specified, it also makes initial delay shorter (5 min to 5 sec)
// to make it faster to test websocket live experiment code.
const char kWebSocketLiveExperimentHost[] = "websocket-live-experiment-host";
// Debug only switch to give access to all private extension APIs to
// any non-component extension that is requesting it.
const char kExposePrivateExtensionApi[] = "expose-private-extension-api";
#endif
#if defined(HAVE_XINPUT2)
// Tells chrome to interpret events from these devices as touch events. Only
// available with XInput 2 (i.e. X server 1.8 or above). The id's of the devices
// can be retrieved from 'xinput list'.
const char kTouchDevices[] = "touch-devices";
#endif
// -----------------------------------------------------------------------------
// DO NOT ADD YOUR CRAP TO THE BOTTOM OF THIS FILE.
//
// You were going to just dump your switches here, weren't you? Instead,
// please put them in alphabetical order above, or in order inside the
// appropriate ifdef at the bottom. The order should match the header.
// -----------------------------------------------------------------------------
} // namespace switches