1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #include "chrome/common/chrome_switches.h" 6 7 #include "base/base_switches.h" 8 #include "base/command_line.h" 9 10 namespace switches { 11 12 // ----------------------------------------------------------------------------- 13 // Can't find the switch you are looking for? Try looking in: 14 // ash/ash_switches.cc 15 // base/base_switches.cc 16 // chromeos/chromeos_switches.cc 17 // etc. 18 // 19 // When commenting your switch, please use the same voice as surrounding 20 // comments. Imagine "This switch..." at the beginning of the phrase, and it'll 21 // all work out. 22 // ----------------------------------------------------------------------------- 23 24 // Allows choosing an existing managed user profile during the managed 25 // user creation flow. 26 const char kAllowCreateExistingManagedUsers[] = 27 "allow-create-existing-managed-users"; 28 29 // Allows third-party content included on a page to prompt for a HTTP basic 30 // auth username/password pair. 31 const char kAllowCrossOriginAuthPrompt[] = "allow-cross-origin-auth-prompt"; 32 33 // On ChromeOS, file:// access is disabled except for certain whitelisted 34 // directories. This switch re-enables file:// for testing. 35 const char kAllowFileAccess[] = "allow-file-access"; 36 37 // Allows non-https URL for background_page for hosted apps. 38 const char kAllowHTTPBackgroundPage[] = "allow-http-background-page"; 39 40 // Allow non-secure origins to use the screen capture API. 41 const char kAllowHttpScreenCapture[] = "allow-http-screen-capture"; 42 43 // Specifies comma-separated list of extension ids or hosts to grant 44 // access to CRX file system APIs. 45 const char kAllowNaClCrxFsAPI[] = "allow-nacl-crxfs-api"; 46 47 // Specifies comma-separated list of extension ids or hosts to grant 48 // access to file handle APIs. 49 const char kAllowNaClFileHandleAPI[] = "allow-nacl-file-handle-api"; 50 51 // Specifies comma-separated list of extension ids or hosts to grant 52 // access to TCP/UDP socket APIs. 53 const char kAllowNaClSocketAPI[] = "allow-nacl-socket-api"; 54 55 // Don't block outdated plugins. 56 const char kAllowOutdatedPlugins[] = "allow-outdated-plugins"; 57 58 // By default, an https page cannot run JavaScript, CSS or plug-ins from http 59 // URLs. This provides an override to get the old insecure behavior. 60 const char kAllowRunningInsecureContent[] = "allow-running-insecure-content"; 61 62 // Prevents Chrome from requiring authorization to run certain widely installed 63 // but less commonly used plug-ins. 64 const char kAlwaysAuthorizePlugins[] = "always-authorize-plugins"; 65 66 // Specifies that the extension-app with the specified id should be launched 67 // according to its configuration. 68 const char kAppId[] = "app-id"; 69 70 // Specifies that the associated value should be launched in "application" 71 // mode. 72 const char kApp[] = "app"; 73 74 // Flag to enable apps_devtool app. 75 const char kAppsDevtool[] = "apps-devtool"; 76 77 // Specifies the initial size for application windows launched with --app. 78 // --app-window-size=w,h 79 const char kAppWindowSize[] = "app-window-size"; 80 81 // Overrides the apps checkout URL, which is used to determine when to expose 82 // some private APIs. 83 const char kAppsCheckoutURL[] = "apps-checkout-url"; 84 85 // The URL that the webstore APIs download extensions from. 86 // Note: the URL must contain one '%s' for the extension ID. 87 const char kAppsGalleryDownloadURL[] = "apps-gallery-download-url"; 88 89 // A setting to cause extension/app installs from the webstore skip the normal 90 // confirmation dialog. A value of 'accept' means to always act as if the dialog 91 // was accepted, and 'cancel' means to always act as if the dialog was 92 // cancelled. 93 const char kAppsGalleryInstallAutoConfirmForTests[] = 94 "apps-gallery-install-auto-confirm-for-tests"; 95 96 // The URL to use for the gallery link in the app launcher. 97 const char kAppsGalleryURL[] = "apps-gallery-url"; 98 99 // The update url used by gallery/webstore extensions. 100 const char kAppsGalleryUpdateURL[] = "apps-gallery-update-url"; 101 102 // Value of GAIA auth code for --force-app-mode. 103 const char kAppModeAuthCode[] = "app-mode-auth-code"; 104 105 // Value of OAuth2 refresh token for --force-app-mode. 106 const char kAppModeOAuth2Token[] = "app-mode-oauth-token"; 107 108 // Whether to always use the new app install bubble when installing an app. 109 const char kAppsNewInstallBubble[] = "apps-new-install-bubble"; 110 111 // Disable throbber for extension apps. 112 const char kAppsNoThrob[] = "apps-no-throb"; 113 114 // Experimental native frame support for packaged apps. 115 const char kAppsUseNativeFrame[] = "apps-use-native-frame"; 116 117 // Enables overriding the path for the default authentication extension. 118 const char kAuthExtensionPath[] = "auth-ext-path"; 119 120 // Whitelist of servers that Negotiate will generate delegated Kerberos tickets 121 // for. 122 const char kAuthNegotiateDelegateWhitelist[] = 123 "auth-negotiate-delegate-whitelist"; 124 125 // HTTP authentication schemes to enable. This is a comma-separated list of 126 // authentication schemes (basic, digest, ntlm, and negotiate). By default all 127 // schemes are enabled. The primary use of this command line flag is to help 128 // triage authentication-related issues reported by end-users. 129 const char kAuthSchemes[] = "auth-schemes"; 130 131 // Whitelist of servers which NTLM and Negotiate can automatically authenticate 132 // with using the default credentials of the currently logged in user. 133 const char kAuthServerWhitelist[] = "auth-server-whitelist"; 134 135 // A flag that is used to tell Chrome that it was launched automatically at 136 // computer startup and not by some user action. 137 const char kAutoLaunchAtStartup[] = "auto-launch-at-startup"; 138 139 // The value of this switch tells the app to listen for and broadcast 140 // automation-related messages on IPC channel with the given ID. 141 const char kAutomationClientChannelID[] = "automation-channel"; 142 143 // Causes the automation provider to reinitialize its IPC channel instead of 144 // shutting down when a client disconnects. 145 const char kAutomationReinitializeOnChannelError[] = 146 "automation-reinitialize-on-channel-error"; 147 148 // Similar to kNoFirstRun, but also drops the First Run beacon so that first run 149 // will not occur in subsequent runs either. 150 const char kCancelFirstRun[] = "cancel-first-run"; 151 152 // How often (in seconds) to check for updates. Should only be used for testing 153 // purposes. 154 const char kCheckForUpdateIntervalSec[] = "check-for-update-interval"; 155 156 // Checks the cloud print connector policy, informing the service process if 157 // the policy is set to disallow the connector, then quits. 158 const char kCheckCloudPrintConnectorPolicy[] = 159 "check-cloud-print-connector-policy"; 160 161 // Run Chrome in Chrome Frame mode. This means that Chrome expects to be run 162 // as a dependent process of the Chrome Frame plugin. 163 const char kChromeFrame[] = "chrome-frame"; 164 165 // Tells chrome to load the specified version of chrome.dll on Windows. If this 166 // version cannot be loaded, Chrome will exit. 167 const char kChromeVersion[] = "chrome-version"; 168 169 // Comma-separated list of SSL cipher suites to disable. 170 const char kCipherSuiteBlacklist[] = "cipher-suite-blacklist"; 171 172 // Clears the token service before using it. This allows simulating the 173 // expiration of credentials during testing. 174 const char kClearTokenService[] = "clear-token-service"; 175 176 // The maximum amount of delay in ms between receiving a cloud policy 177 // invalidation and fetching the policy. A random delay up to this value is used 178 // to prevent Chrome clients from overwhelming the cloud policy server when a 179 // policy which affects many users is changed. 180 const char kCloudPolicyInvalidationDelay[] = "cloud-policy-invalidation-delay"; 181 182 // Used with kCloudPrintFile. Tells Chrome to delete the file when finished 183 // displaying the print dialog. 184 const char kCloudPrintDeleteFile[] = "cloud-print-delete-file"; 185 186 // Tells chrome to display the cloud print dialog and upload the specified file 187 // for printing. 188 const char kCloudPrintFile[] = "cloud-print-file"; 189 190 // Specifies the mime type to be used when uploading data from the file 191 // referenced by cloud-print-file. Defaults to "application/pdf" if 192 // unspecified. 193 const char kCloudPrintFileType[] = "cloud-print-file-type"; 194 195 // Used with kCloudPrintFile to specify a JSON print ticket for the resulting 196 // print job. Defaults to null if unspecified. 197 const char kCloudPrintPrintTicket[] = "cloud-print-print-ticket"; 198 199 // Used with kCloudPrintFile to specify a title for the resulting print job. 200 const char kCloudPrintJobTitle[] = "cloud-print-job-title"; 201 202 // Setup cloud print proxy for provided printers. This does not start 203 // service or register proxy for autostart. 204 const char kCloudPrintSetupProxy[] = "cloud-print-setup-proxy"; 205 206 // The URL of the cloud print service to use, overrides any value stored in 207 // preferences, and the default. Only used if the cloud print service has been 208 // enabled (see enable-cloud-print). 209 const char kCloudPrintServiceURL[] = "cloud-print-service"; 210 211 // Comma-separated options to troubleshoot the component updater. Only valid 212 // for the browser process. 213 const char kComponentUpdater[] = "component-updater"; 214 215 // Causes the browser process to inspect loaded and registered DLLs for known 216 // conflicts and warn the user. 217 const char kConflictingModulesCheck[] = "conflicting-modules-check"; 218 219 // Toggles a new version of the content settings dialog in options. 220 const char kContentSettings2[] = "new-content-settings"; 221 222 // The Country we should use. This is normally obtained from the operating 223 // system during first run and cached in the preferences afterwards. This is a 224 // string value, the 2 letter code from ISO 3166-1. 225 const char kCountry[] = "country"; 226 227 // Comma-separated list of BrowserThreads that cause browser process to crash 228 // if the given browser thread is not responsive. UI,IO,DB,FILE,CACHE are the 229 // list of BrowserThreads that are supported. 230 // 231 // For example: 232 // --crash-on-hang-threads=UI:3:18,IO:3:18 --> Crash the browser if UI or IO 233 // is not responsive for 18 seconds and the number of browser threads that 234 // are responding is less than or equal to 3. 235 const char kCrashOnHangThreads[] = "crash-on-hang-threads"; 236 237 // Some platforms like ChromeOS default to empty desktop. 238 // Browser tests may need to add this switch so that at least one browser 239 // instance is created on startup. 240 // TODO(nkostylev): Investigate if this switch could be removed. 241 // (http://crbug.com/148675) 242 const char kCreateBrowserOnStartupForTests[] = 243 "create-browser-on-startup-for-tests"; 244 245 // Enables a frame context menu item that toggles the frame in and out of glass 246 // mode (Windows Vista and up only). 247 const char kDebugEnableFrameToggle[] = "debug-enable-frame-toggle"; 248 249 // Adds debugging entries such as Inspect Element to context menus of packed 250 // apps. 251 const char kDebugPackedApps[] = "debug-packed-apps"; 252 253 // Enables support to debug printing subsystem. 254 const char kDebugPrint[] = "debug-print"; 255 256 // Specifies the URL at which to fetch configuration policy from the device 257 // management backend. Specifying this switch turns on managed policy from the 258 // device management backend. 259 const char kDeviceManagementUrl[] = "device-management-url"; 260 261 // Triggers a plethora of diagnostic modes. 262 const char kDiagnostics[] = "diagnostics"; 263 264 // Sets the output format for diagnostic modes enabled by diagnostics flag. 265 const char kDiagnosticsFormat[] = "diagnostics-format"; 266 267 // Tells the diagnostics mode to do the requested recovery step(s). 268 const char kDiagnosticsRecovery[] = "diagnostics-recovery"; 269 270 // If set, the app list will be disabled at startup. Note this doesn't prevent 271 // the app list from running, it just makes Chrome think the app list hasn't 272 // been enabled (as in kEnableAppList) yet. 273 const char kDisableAppList[] = "disable-app-list"; 274 275 // Disables the experimental asynchronous DNS client. 276 const char kDisableAsyncDns[] = "disable-async-dns"; 277 278 // Disables CNAME lookup of the host when generating the Kerberos SPN for a 279 // Negotiate challenge. See HttpAuthHandlerNegotiate::CreateSPN for more 280 // background. 281 const char kDisableAuthNegotiateCnameLookup[] = 282 "disable-auth-negotiate-cname-lookup"; 283 284 // Disables background mode (background apps will not keep chrome running in 285 // the background). 286 const char kDisableBackgroundMode[] = "disable-background-mode"; 287 288 // Disable several subsystems which run network requests in the background. 289 // This is for use when doing network performance testing to avoid noise in the 290 // measurements. 291 const char kDisableBackgroundNetworking[] = "disable-background-networking"; 292 293 // Disables more strict popup blocking. 294 const char kDisableBetterPopupBlocking[] = "disable-better-popup-blocking"; 295 296 // Disables the bundled PPAPI version of Flash. 297 const char kDisableBundledPpapiFlash[] = "disable-bundled-ppapi-flash"; 298 299 // Disables the bookmark autocomplete provider (BookmarkProvider). 300 const char kDisableBookmarkAutocompleteProvider[] = 301 "disable-bookmark-autocomplete-provider"; 302 303 // Disables the client-side phishing detection feature. Note that even if 304 // client-side phishing detection is enabled, it will only be active if the 305 // user has opted in to UMA stats and SafeBrowsing is enabled in the 306 // preferences. 307 const char kDisableClientSidePhishingDetection[] = 308 "disable-client-side-phishing-detection"; 309 310 const char kDisableComponentUpdate[] = "disable-component-update"; 311 312 // Disables establishing certificate revocation information by downloading a 313 // set of CRLs rather than performing on-line checks. 314 const char kDisableCRLSets[] = "disable-crl-sets"; 315 316 // Disables the custom JumpList on Windows 7. 317 const char kDisableCustomJumpList[] = "disable-custom-jumplist"; 318 319 // Disables installation of default apps on first run. This is used during 320 // automated testing. 321 const char kDisableDefaultApps[] = "disable-default-apps"; 322 323 // Disables retrieval of PAC URLs from DHCP as per the WPAD standard. 324 const char kDisableDhcpWpad[] = "disable-dhcp-wpad"; 325 326 // Force-disables DNS probes on main frame DNS errors. 327 const char kDisableDnsProbes[] = "disable-dns-probes"; 328 329 // Disable extensions. 330 const char kDisableExtensions[] = "disable-extensions"; 331 332 // Disable checking for user opt-in for extensions that want to inject script 333 // into file URLs (ie, always allow it). This is used during automated testing. 334 const char kDisableExtensionsFileAccessCheck[] = 335 "disable-extensions-file-access-check"; 336 337 // Disable the net::URLRequestThrottlerManager functionality for 338 // requests originating from extensions. 339 const char kDisableExtensionsHttpThrottling[] = 340 "disable-extensions-http-throttling"; 341 342 // Disable mandatory enforcement of web_accessible_resources in extensions. 343 const char kDisableExtensionsResourceWhitelist[] = 344 "disable-extensions-resource-whitelist"; 345 346 // Disable Instant extended API. 347 const char kDisableInstantExtendedAPI[] = "disable-instant-extended-api"; 348 349 // Disables improved SafeBrowsing download protection. 350 const char kDisableImprovedDownloadProtection[] = 351 "disable-improved-download-protection"; 352 353 // Don't resolve hostnames to IPv6 addresses. This can be used when debugging 354 // issues relating to IPv6, but shouldn't otherwise be needed. Be sure to file 355 // bugs if something isn't working properly in the presence of IPv6. This flag 356 // can be overidden by the "enable-ipv6" flag. 357 const char kDisableIPv6[] = "disable-ipv6"; 358 359 // Disables IP Pooling within the networks stack (SPDY only). When a connection 360 // is needed for a domain which shares an IP with an existing connection, 361 // attempt to use the existing connection. 362 const char kDisableIPPooling[] = "disable-ip-pooling"; 363 364 // Disable always using the local NTP for the first NTP load of a new window. 365 const char kDisableLocalFirstLoadNTP[] = "disable-local-first-load-ntp"; 366 367 // Disable the behavior that the second click on a launcher item (the click when 368 // the item is already active) minimizes the item. 369 const char kDisableMinimizeOnSecondLauncherItemClick[] = 370 "disable-minimize-on-second-launcher-item-click"; 371 372 // Disables the menu on the NTP for accessing sessions from other devices. 373 const char kDisableNTPOtherSessionsMenu[] = "disable-ntp-other-sessions-menu"; 374 375 // Disables omnibox auto-completion when IME is active. 376 const char kDisableOmniboxAutoCompletionForIme[] = 377 "disable-omnibox-auto-completion-for-ime"; 378 379 // Disable using a public suffix based domain matching for autofill of 380 // passwords. 381 const char kDisablePasswordAutofillPublicSuffixDomainMatching[] = 382 "disable-password-autofill-public-suffix-domain-matching"; 383 384 // Disable pop-up blocking. 385 const char kDisablePopupBlocking[] = "disable-popup-blocking"; 386 387 // Disable speculative TCP/IP preconnection. 388 const char kDisablePreconnect[] = "disable-preconnect"; 389 390 // Disable prerendering based on local browsing history. 391 const char kDisablePrerenderLocalPredictor[] = 392 "disable-prerender-local-predictor"; 393 394 // Normally when the user attempts to navigate to a page that was the result of 395 // a post we prompt to make sure they want to. This switch may be used to 396 // disable that check. This switch is used during automated testing. 397 const char kDisablePromptOnRepost[] = "disable-prompt-on-repost"; 398 399 // Disables support for the QUIC protocol. 400 const char kDisableQuic[] = "disable-quic"; 401 402 // Disables support for the HTTPS over QUIC protocol. This is a temporary 403 // testing flag. This only has an effect if QUIC protocol is enabled. 404 const char kDisableQuicHttps[] = "disable-quic-https"; 405 406 // Prevents the URLs of BackgroundContents from being remembered and 407 // re-launched when the browser restarts. 408 const char kDisableRestoreBackgroundContents[] = 409 "disable-restore-background-contents"; 410 411 // Disables restoring session state (cookies, session storage, etc.) when 412 // restoring the browsing session. 413 const char kDisableRestoreSessionState[] = "disable-restore-session-state"; 414 415 // Disables throttling prints initiated by scripts. 416 const char kDisableScriptedPrintThrottling[] = 417 "disable-scripted-print-throttling"; 418 419 // Disables syncing browser data to a Google Account. 420 const char kDisableSync[] = "disable-sync"; 421 422 // Disables syncing of app settings. 423 const char kDisableSyncAppSettings[] = "disable-sync-app-settings"; 424 425 // Disables syncing of apps. 426 const char kDisableSyncApps[] = "disable-sync-apps"; 427 428 // Disables syncing of autofill. 429 const char kDisableSyncAutofill[] = "disable-sync-autofill"; 430 431 // Disables syncing of autofill Profile. 432 const char kDisableSyncAutofillProfile[] = "disable-sync-autofill-profile"; 433 434 // Disables syncing of bookmarks. 435 const char kDisableSyncBookmarks[] = "disable-sync-bookmarks"; 436 437 // Disables syncing of dictionary. 438 const char kDisableSyncDictionary[] = "disable-sync-dictionary"; 439 440 // Disables syncing extension settings. 441 const char kDisableSyncExtensionSettings[] = "disable-sync-extension-settings"; 442 443 // Disables syncing of extensions. 444 const char kDisableSyncExtensions[] = "disable-sync-extensions"; 445 446 // Disables syncing of favicons. 447 const char kDisableSyncFavicons[] = "disable-sync-favicons"; 448 449 // Disables syncing browser passwords. 450 const char kDisableSyncPasswords[] = "disable-sync-passwords"; 451 452 // Disables syncing of preferences. 453 const char kDisableSyncPreferences[] = "disable-sync-preferences"; 454 455 // Disables syncing of priority preferences. 456 const char kDisableSyncPriorityPreferences[] = 457 "disable-sync-priority-preferences"; 458 459 // Disable syncing custom search engines. 460 const char kDisableSyncSearchEngines[] = "disable-sync-search-engines"; 461 462 // Disable synced notifications. 463 const char kDisableSyncSyncedNotifications[] = 464 "disable-sync-synced-notifications"; 465 466 // Disables syncing browser sessions. Will override kEnableSyncTabs. 467 const char kDisableSyncTabs[] = "disable-sync-tabs"; 468 469 // Disables syncing of themes. 470 const char kDisableSyncThemes[] = "disable-sync-themes"; 471 472 // Disables syncing browser typed urls. 473 const char kDisableSyncTypedUrls[] = "disable-sync-typed-urls"; 474 475 // Allows disabling of translate from the command line to assist with automated 476 // browser testing (e.g. Selenium/WebDriver). Normal browser users should 477 // disable translate with the preference. 478 const char kDisableTranslate[] = "disable-translate"; 479 480 // Disables TLS Channel ID extension. 481 const char kDisableTLSChannelID[] = "disable-tls-channel-id"; 482 483 // Disables the backend service for web resources. 484 const char kDisableWebResources[] = "disable-web-resources"; 485 486 // Some tests seem to require the application to close when the last 487 // browser window is closed. Thus, we need a switch to force this behavior 488 // for ChromeOS Aura, disable "zero window mode". 489 // TODO(pkotwicz): Investigate if this bug can be removed. 490 // (http://crbug.com/119175) 491 const char kDisableZeroBrowsersOpenForTests[] = 492 "disable-zero-browsers-open-for-tests"; 493 494 // Use a specific disk cache location, rather than one derived from the 495 // UserDatadir. 496 const char kDiskCacheDir[] = "disk-cache-dir"; 497 498 // Forces the maximum disk space to be used by the disk cache, in bytes. 499 const char kDiskCacheSize[] = "disk-cache-size"; 500 501 const char kDnsLogDetails[] = "dns-log-details"; 502 503 // Disables prefetching of DNS information. 504 const char kDnsPrefetchDisable[] = "dns-prefetch-disable"; 505 506 // Enables the <adview> tag in packaged apps. 507 const char kEnableAdview[] = "enable-adview"; 508 509 // If set, the app list will be enabled as if enabled from CWS. 510 const char kEnableAppList[] = "enable-app-list"; 511 512 // Enables specifying a "src" attribute on <adview> elements 513 // (for testing purposes, to skip the whitelist). 514 const char kEnableAdviewSrcAttribute[] = "enable-adview-src-attribute"; 515 516 // Enables the <window-controls> tag in platform apps. 517 const char kEnableAppWindowControls[] = "enable-app-window-controls"; 518 519 // Enables the experimental asynchronous DNS client. 520 const char kEnableAsyncDns[] = "enable-async-dns"; 521 522 // Enables the inclusion of non-standard ports when generating the Kerberos SPN 523 // in response to a Negotiate challenge. See 524 // HttpAuthHandlerNegotiate::CreateSPN for more background. 525 const char kEnableAuthNegotiatePort[] = "enable-auth-negotiate-port"; 526 527 // Enable using a public suffix based domain matching for autofill of passwords. 528 const char kEnablePasswordAutofillPublicSuffixDomainMatching[] = 529 "enable-password-autofill-public-suffix-domain-matching"; 530 531 // Enables the pre- and auto-login features. When a user signs in to sync, the 532 // browser's cookie jar is pre-filled with GAIA cookies. When the user visits a 533 // GAIA login page, an info bar can help the user login. 534 const char kEnableAutologin[] = "enable-autologin"; 535 536 // Enables the benchmarking extensions. 537 const char kEnableBenchmarking[] = "enable-benchmarking"; 538 539 // Enables pushing cloud policy to Chrome using an invalidation service. 540 const char kEnableCloudPolicyPush[] = "enable-cloud-policy-push"; 541 542 // This applies only when the process type is "service". Enables the Cloud 543 // Print Proxy component within the service process. 544 const char kEnableCloudPrintProxy[] = "enable-cloud-print-proxy"; 545 546 // Enables fetching and storing cloud policy for components. This currently 547 // supports policy for extensions on Chrome OS. 548 const char kEnableComponentCloudPolicy[] = "enable-component-cloud-policy"; 549 550 // Enables fetching the user's contacts from Google and showing them in the 551 // Chrome OS apps list. 552 const char kEnableContacts[] = "enable-contacts"; 553 554 // Enables device discovery. 555 const char kEnableDeviceDiscovery[] = "enable-device-discovery"; 556 557 // If true devtools experimental settings are enabled. 558 const char kEnableDevToolsExperiments[] = "enable-devtools-experiments"; 559 560 // Force-enables DNS probes on main frame DNS errors. (The user must still 561 // opt in to "Use web service to resolve navigation errors".) 562 const char kEnableDnsProbes[] = "enable-dns-probes"; 563 564 // Enables extensions to be easily installed from sites other than the web 565 // store. Without this flag, they can still be installed, but must be manually 566 // dragged onto chrome://extensions/. 567 const char kEasyOffStoreExtensionInstall[] = 568 "easy-off-store-extension-install"; 569 570 // Enables logging for extension activity. 571 const char kEnableExtensionActivityLogging[] = 572 "enable-extension-activity-logging"; 573 574 const char kEnableExtensionActivityLogTesting[] = 575 "enable-extension-activity-log-testing"; 576 577 // Enables or disables showing extensions in the action box. 578 const char kExtensionsInActionBox[] = "extensions-in-action-box"; 579 580 // Enable the fast unload controller, which speeds up tab/window close by 581 // running a tab's onunload js handler independently of the GUI - 582 // crbug.com/142458 . 583 const char kEnableFastUnload[] = "enable-fast-unload"; 584 585 // By default, cookies are not allowed on file://. They are needed for testing, 586 // for example page cycler and layout tests. See bug 1157243. 587 const char kEnableFileCookies[] = "enable-file-cookies"; 588 589 // Enables Google Now integration. 590 const char kEnableGoogleNowIntegration[] = "enable-google-now-integration"; 591 592 // Enable HTTP/2 draft 04. This is a temporary testing flag. 593 const char kEnableHttp2Draft04[] = "enable-http2-draft-04"; 594 595 // Enable Instant extended API. On mobile, this merely enables query extraction, 596 // not the rest of the instant-extended functionality. 597 const char kEnableInstantExtendedAPI[] = "enable-instant-extended-api"; 598 599 // Enables IPv6 support, even if probes suggest that it may not be fully 600 // supported. Some probes may require internet connections, and this flag will 601 // allow support independent of application testing. This flag overrides 602 // "disable-ipv6" which appears elswhere in this file. 603 const char kEnableIPv6[] = "enable-ipv6"; 604 605 /// Enables the IPC fuzzer for reliability testing 606 const char kEnableIPCFuzzing[] = "enable-ipc-fuzzing"; 607 608 // Enables IP Pooling within the networks stack (SPDY only). When a connection 609 // is needed for a domain which shares an IP with an existing connection, 610 // attempt to use the existing connection. 611 const char kEnableIPPooling[] = "enable-ip-pooling"; 612 613 // Enable always using the local NTP for the first NTP load of a new window. 614 const char kEnableLocalFirstLoadNTP[] = "enable-local-first-load-ntp"; 615 616 // Enables support for user profiles that are managed by another user and can 617 // have restrictions applied. 618 const char kEnableManagedUsers[] = "enable-managed-users"; 619 620 // Make the values returned to window.performance.memory more granular and more 621 // up to date. Without this flag, the memory information is still available, but 622 // it is bucketized and updated less frequently. 623 const char kEnableMemoryInfo[] = "enable-memory-info"; 624 625 // Enables metrics recording and reporting in the browser startup sequence, as 626 // if this was an official Chrome build where the user allowed metrics 627 // reporting. This is used for testing only. 628 const char kEnableMetricsReportingForTesting[] = 629 "enable-metrics-reporting-for-testing"; 630 631 // Runs the Native Client inside the renderer process and enables GPU plugin 632 // (internally adds lEnableGpuPlugin to the command line). 633 const char kEnableNaCl[] = "enable-nacl"; 634 635 // Enables the network-related benchmarking extensions. 636 const char kEnableNetBenchmarking[] = "enable-net-benchmarking"; 637 638 // Enables NPN and SPDY. In case server supports SPDY, browser will use SPDY. 639 const char kEnableNpn[] = "enable-npn"; 640 641 // Enables NPN with HTTP. It means NPN is enabled but SPDY won't be used. 642 // HTTP is still used for all requests. 643 const char kEnableNpnHttpOnly[] = "enable-npn-http"; 644 645 // Enables omnibox auto-completion when IME is active. The auto-completion for 646 // IME is shown in the same style as the normal(non-IME) auto-completion. 647 const char kEnableOmniboxAutoCompletionForIme[] = 648 "enable-omnibox-auto-completion-for-ime"; 649 650 // Enables panels (always on-top docked pop-up windows). 651 const char kEnablePanels[] = "enable-panels"; 652 653 // Enables password generation when we detect that the user is going through 654 // account creation. 655 const char kEnablePasswordGeneration[] = "enable-password-generation"; 656 657 // Enables the usage of Portable Native Client. 658 const char kEnablePnacl[] = "enable-pnacl"; 659 660 // Disables the installation of Portable Native Client. 661 const char kDisablePnaclInstall[] = "disable-pnacl-install"; 662 663 // Enables tracking of tasks in profiler for viewing via about:profiler. 664 // To predominantly disable tracking (profiling), use the command line switch: 665 // --enable-profiling=0 666 // Some tracking will still take place at startup, but it will be turned off 667 // during chrome_browser_main. 668 const char kEnableProfiling[] = "enable-profiling"; 669 670 // Enables support for the QUIC protocol. This is a temporary testing flag. 671 const char kEnableQuic[] = "enable-quic"; 672 673 // Enables support for the HTTPS over QUIC protocol. This is a temporary 674 // testing flag. This only has an effect if QUIC protocol is enabled. 675 const char kEnableQuicHttps[] = "enable-quic-https"; 676 677 // Enables the Quickoffoce/Chrome document viewer rather than the editor. 678 const char kEnableQuickofficeViewing[] = "enable-quickoffice-viewing"; 679 680 // Enables support in chrome://settings to reset settings in your profile 681 // that are often touched by malware. 682 const char kEnableResetProfileSettings[] = "enable-reset-profile-settings"; 683 684 // Enables content settings based on host *and* plug-in in the user 685 // preferences. 686 const char kEnableResourceContentSettings[] = 687 "enable-resource-content-settings"; 688 689 // Enables save password prompt bubble. 690 const char kEnableSavePasswordBubble[] = "enable-save-password-bubble"; 691 692 // Controls the support for SDCH filtering (dictionary based expansion of 693 // content). By default SDCH filtering is enabled. To disable SDCH filtering, 694 // use "--enable-sdch=0" as command line argument. SDCH is currently only 695 // supported server-side for searches on google.com. 696 const char kEnableSdch[] = "enable-sdch"; 697 698 // Enables support of sticky keys. 699 const char kEnableStickyKeys[] = "enable-sticky-keys"; 700 701 // Disables support of sticky keys. 702 const char kDisableStickyKeys[] = "disable-sticky-keys"; 703 704 // Disable SPDY/3.1. This is a temporary testing flag. 705 const char kDisableSpdy31[] = "disable-spdy31"; 706 707 // Enable SPDY/4 alpha 2. This is a temporary testing flag. 708 const char kEnableSpdy4a2[] = "enable-spdy4a2"; 709 710 // Enable SPDY CREDENTIAL frame support. This is a temporary testing flag. 711 const char kEnableSpdyCredentialFrames[] = "enable-spdy-credential-frames"; 712 713 // Enables auto correction for misspelled words. 714 const char kEnableSpellingAutoCorrect[] = "enable-spelling-auto-correct"; 715 716 // Enables sending user feedback to spelling service. 717 const char kEnableSpellingServiceFeedback[] = 718 "enable-spelling-service-feedback"; 719 720 // Enables the stacked tabstrip. 721 const char kEnableStackedTabStrip[] = "enable-stacked-tab-strip"; 722 723 // Enables experimental suggestions pane in New Tab page. 724 const char kEnableSuggestionsTabPage[] = "enable-suggestions-ntp"; 725 726 // Enables synced notifications. 727 const char kEnableSyncSyncedNotifications[] = 728 "enable-sync-synced-notifications"; 729 730 // Enables context menu for selecting groups of tabs. 731 const char kEnableTabGroupsContextMenu[] = "enable-tab-groups-context-menu"; 732 733 // Enables fanciful thumbnail processing. Used with NTP for 734 // instant-extended-api, where thumbnails are generally smaller. 735 const char kEnableThumbnailRetargeting[] = "enable-thumbnail-retargeting"; 736 737 // Enables Translate settings in chrome://settings/languages. 738 const char kEnableTranslateSettings[] = "enable-translate-settings"; 739 740 // Enables unrestricted SSL 3.0 fallback. 741 // With this switch, SSL 3.0 fallback will be enabled for all sites. 742 // Without this switch, SSL 3.0 fallback will be disabled for a site 743 // pinned to the Google pin list (indicating that it is a Google site). 744 // Note: until http://crbug/237055 is resolved, unrestricted SSL 3.0 745 // fallback is always enabled, with or without this switch. 746 const char kEnableUnrestrictedSSL3Fallback[] = 747 "enable-unrestricted-ssl3-fallback"; 748 749 // Enables Alternate-Protocol when the port is user controlled (> 1024). 750 const char kEnableUserAlternateProtocolPorts[] = 751 "enable-user-controlled-alternate-protocol-ports"; 752 753 // Spawns threads to watch for excessive delays in specified message loops. 754 // User should set breakpoints on Alarm() to examine problematic thread. 755 // 756 // Usage: -enable-watchdog=[ui][io] 757 // 758 // Order of the listed sub-arguments does not matter. 759 const char kEnableWatchdog[] = "enable-watchdog"; 760 761 // Uses WebSocket over SPDY. 762 const char kEnableWebSocketOverSpdy[] = "enable-websocket-over-spdy"; 763 764 // Explicitly allows additional ports using a comma-separated list of port 765 // numbers. 766 const char kExplicitlyAllowedPorts[] = "explicitly-allowed-ports"; 767 768 // The time in seconds that an extension event page can be idle before it 769 // is shut down. 770 const char kEventPageIdleTime[] = "event-page-idle-time"; 771 772 // The time in seconds that an extension event page has between being notified 773 // of its impending unload and that unload happening. 774 const char kEventPageSuspendingTime[] = "event-page-unloading-time"; 775 776 // Marks a renderer as extension process. 777 const char kExtensionProcess[] = "extension-process"; 778 779 // Frequency in seconds for Extensions auto-update. 780 const char kExtensionsUpdateFrequency[] = "extensions-update-frequency"; 781 782 // Additional query params to insert in the search and instant URLs. Useful for 783 // testing. 784 const char kExtraSearchQueryParams[] = "extra-search-query-params"; 785 786 // Fakes the channel of the browser for purposes of Variations filtering. This 787 // is to be used for testing only. Possible values are "stable", "beta", "dev" 788 // and "canary". Note that this only applies if the browser's reported channel 789 // is UNKNOWN. 790 const char kFakeVariationsChannel[] = "fake-variations-channel"; 791 792 // If this flag is present then this command line is being delegated to an 793 // already running chrome process via the fast path, ie: before chrome.dll is 794 // loaded. It is useful to tell the difference for tracking purposes. 795 const char kFastStart[] = "fast-start"; 796 797 // These two flags are added around the switches about:flags adds to the 798 // command line. This is useful to see which switches were added by about:flags 799 // on about:version. They don't have any effect. 800 const char kFlagSwitchesBegin[] = "flag-switches-begin"; 801 const char kFlagSwitchesEnd[] = "flag-switches-end"; 802 803 // Alternative feedback server to use when submitting user feedback 804 const char kFeedbackServer[] = "feedback-server"; 805 806 // The file descriptor limit is set to the value of this switch, subject to the 807 // OS hard limits. Useful for testing that file descriptor exhaustion is 808 // handled gracefully. 809 const char kFileDescriptorLimit[] = "file-descriptor-limit"; 810 811 // Forces application mode. This hides certain system UI elements and forces 812 // the app to be installed if it hasn't been already. 813 const char kForceAppMode[] = "force-app-mode"; 814 815 // Displays the First Run experience when the browser is started, regardless of 816 // whether or not it's actually the First Run (this overrides kNoFirstRun and 817 // kCancelFirstRun). 818 const char kForceFirstRun[] = "force-first-run"; 819 820 // Tries to load cloud policy for every signed in user, regardless of whether 821 // they are a dasher user or not. Used to allow any GAIA account to be used for 822 // testing the cloud policy framework. 823 const char kForceLoadCloudPolicy[] = "force-load-cloud-policy"; 824 825 // Enables using GAIA information to populate profile name and icon. 826 const char kGaiaProfileInfo[] = "gaia-profile-info"; 827 828 // Specifies an alternate URL to use for speaking to Google. Useful for testing. 829 const char kGoogleBaseURL[] = "google-base-url"; 830 831 // Specifies an alternate URL to use for retrieving the search domain for 832 // Google. Useful for testing. 833 const char kGoogleSearchDomainCheckURL[] = "google-search-domain-check-url"; 834 835 // Specifies a custom name for the GSSAPI library to load. 836 const char kGSSAPILibraryName[] = "gssapi-library-name"; 837 838 // These flags show the man page on Linux. They are equivalent to each 839 // other. 840 const char kHelp[] = "help"; 841 const char kHelpShort[] = "h"; 842 843 // Makes Windows happy by allowing it to show "Enable access to this program" 844 // checkbox in Add/Remove Programs->Set Program Access and Defaults. This only 845 // shows an error box because the only way to hide Chrome is by uninstalling 846 // it. 847 const char kHideIcons[] = "hide-icons"; 848 849 // Disables full history sync. 850 const char kHistoryDisableFullHistorySync[] = "disable-full-history-sync"; 851 852 // Enables grouping websites by domain and filtering them by period. 853 const char kHistoryEnableGroupByDomain[] = "enable-grouped-history"; 854 855 // Specifies which page will be displayed in newly-opened tabs. We need this 856 // for testing purposes so that the UI tests don't depend on what comes up for 857 // http://google.com. 858 const char kHomePage[] = "homepage"; 859 860 // Comma-separated list of rules that control how hostnames are mapped. 861 // 862 // For example: 863 // "MAP * 127.0.0.1" --> Forces all hostnames to be mapped to 127.0.0.1 864 // "MAP *.google.com proxy" --> Forces all google.com subdomains to be 865 // resolved to "proxy". 866 // "MAP test.com [::1]:77 --> Forces "test.com" to resolve to IPv6 loopback. 867 // Will also force the port of the resulting 868 // socket address to be 77. 869 // "MAP * baz, EXCLUDE www.google.com" --> Remaps everything to "baz", 870 // except for "www.google.com". 871 // 872 // These mappings apply to the endpoint host in a net::URLRequest (the TCP 873 // connect and host resolver in a direct connection, and the CONNECT in an http 874 // proxy connection, and the endpoint host in a SOCKS proxy connection). 875 const char kHostRules[] = "host-rules"; 876 877 // The maximum number of concurrent host resolve requests (i.e. DNS) to allow 878 // (not counting backup attempts which would also consume threads). 879 // --host-resolver-retry-attempts must be set to zero for this to be exact. 880 const char kHostResolverParallelism[] = "host-resolver-parallelism"; 881 882 // The maximum number of retry attempts to resolve the host. Set this to zero 883 // to disable host resolver retry attempts. 884 const char kHostResolverRetryAttempts[] = "host-resolver-retry-attempts"; 885 886 // Causes net::URLFetchers to ignore requests for SSL client certificates, 887 // causing them to attempt an unauthenticated SSL/TLS session. This is intended 888 // for use when testing various service URLs (eg: kPromoServerURL, kSbURLPrefix, 889 // kSyncServiceURL, etc) 890 const char kIgnoreUrlFetcherCertRequests[] = 891 "ignore-urlfetcher-cert-requests"; 892 893 // Causes the browser to launch directly in incognito mode. 894 const char kIncognito[] = "incognito"; 895 896 // Causes Chrome to attempt to get metadata from the webstore for the 897 // app/extension ID given, and then prompt the user to download and install it. 898 const char kInstallFromWebstore[] = "install-from-webstore"; 899 900 // Causes Chrome to load this URL instead of chrome://newtab for New Tab pages. 901 const char kInstantNewTabURL[] = "instant-new-tab-url"; 902 903 // Marks a renderer as an Instant process. 904 const char kInstantProcess[] = "instant-process"; 905 906 // Used for testing - keeps browser alive after last browser window closes. 907 const char kKeepAliveForTest[] = "keep-alive-for-test"; 908 909 // Enable Kiosk mode. 910 const char kKioskMode[] = "kiosk"; 911 912 // Print automatically in kiosk mode. |kKioskMode| must be set as well. 913 // See http://crbug.com/31395. 914 const char kKioskModePrinting[] = "kiosk-printing"; 915 916 // Causes Chrome to attempt to get metadata from the webstore for the 917 // given item, and then prompt the user to download and install it. 918 const char kLimitedInstallFromWebstore[] = "limited-install-from-webstore"; 919 920 // Comma-separated list of directories with component extensions to load. 921 const char kLoadComponentExtension[] = "load-component-extension"; 922 923 // If present, disables the loading and application of cloud policy for 924 // signed-in users. 925 const char kDisableCloudPolicyOnSignin[] = "disable-cloud-policy-on-signin"; 926 927 // Loads an extension from the specified directory. 928 const char kLoadExtension[] = "load-extension"; 929 930 // Makes Chrome default browser 931 const char kMakeDefaultBrowser[] = "make-default-browser"; 932 933 // Used to authenticate requests to the Sync service for managed users. Setting 934 // this switch also causes Sync to be set up for a managed user. 935 const char kManagedUserSyncToken[] = "managed-user-sync-token"; 936 937 // Forces the maximum disk space to be used by the media cache, in bytes. 938 const char kMediaCacheSize[] = "media-cache-size"; 939 940 // Enables dynamic loading of the Memory Profiler DLL, which will trace all 941 // memory allocations during the run. 942 const char kMemoryProfiling[] = "memory-profile"; 943 944 // Enables histograming of tasks served by MessageLoop. See 945 // about:histograms/Loop for results, which show frequency of messages on each 946 // thread, including APC count, object signalling count, etc. 947 const char kMessageLoopHistogrammer[] = "message-loop-histogrammer"; 948 949 // Enables the recording of metrics reports but disables reporting. In contrast 950 // to kDisableMetrics, this executes all the code that a normal client would 951 // use for reporting, except the report is dropped rather than sent to the 952 // server. This is useful for finding issues in the metrics code during UI and 953 // performance tests. 954 const char kMetricsRecordingOnly[] = "metrics-recording-only"; 955 956 // Enables multiprofile Chrome. 957 const char kMultiProfiles[] = "multi-profiles"; 958 959 // List of native messaging hosts outside of the default location. Used for 960 // tests. The value must be comma-separate lists of key-value pairs separated 961 // equal sign. E.g. "host1=/path/to/host1/manifest.json,host2=/path/host2.json". 962 const char kNativeMessagingHosts[] = "native-messaging-hosts"; 963 964 // Sets the base logging level for the net log. Log 0 logs the most data. 965 // Intended primarily for use with --log-net-log. 966 const char kNetLogLevel[] = "net-log-level"; 967 968 // Use new profile management system, including profile sign-out and new 969 // choosers. 970 const char kNewProfileManagement[] = "new-profile-management"; 971 972 // Disables the default browser check. Useful for UI/browser tests where we 973 // want to avoid having the default browser info-bar displayed. 974 const char kNoDefaultBrowserCheck[] = "no-default-browser-check"; 975 976 // By default, an https page can load images, fonts or frames from an http 977 // page. This switch overrides this to block this lesser mixed-content problem. 978 const char kNoDisplayingInsecureContent[] = "no-displaying-insecure-content"; 979 980 // Don't record/playback events when using record & playback. 981 const char kNoEvents[] = "no-events"; 982 983 // Disables all experiments set on about:flags. Does not disable about:flags 984 // itself. Useful if an experiment makes chrome crash at startup: One can start 985 // chrome with --no-experiments, disable the problematic lab at about:flags and 986 // then restart chrome without this switch again. 987 const char kNoExperiments[] = "no-experiments"; 988 989 // Skip First Run tasks, whether or not it's actually the First Run. Overridden 990 // by kForceFirstRun. 991 // Also drops the First Run beacon so that First Run will not occur in 992 // subsequent runs as well. 993 const char kNoFirstRun[] = "no-first-run"; 994 995 // Support a separate switch that enables the v8 playback extension. 996 // The extension causes javascript calls to Date.now() and Math.random() 997 // to return consistent values, such that subsequent loads of the same 998 // page will result in consistent js-generated data and XHR requests. 999 // Pages may still be able to generate inconsistent data from plugins. 1000 const char kNoJsRandomness[] = "no-js-randomness"; 1001 1002 // Whether or not the browser should warn if the profile is on a network share. 1003 // This flag is only relevant for Windows currently. 1004 const char kNoNetworkProfileWarning[] = "no-network-profile-warning"; 1005 1006 // Don't send hyperlink auditing pings 1007 const char kNoPings[] = "no-pings"; 1008 1009 // Don't use a proxy server, always make direct connections. Overrides any 1010 // other proxy server flags that are passed. 1011 const char kNoProxyServer[] = "no-proxy-server"; 1012 1013 // Disables the service process from adding itself as an autorun process. This 1014 // does not delete existing autorun registrations, it just prevents the service 1015 // from registering a new one. 1016 const char kNoServiceAutorun[] = "no-service-autorun"; 1017 1018 // Does not automatically open a browser window on startup (used when 1019 // launching Chrome for the purpose of hosting background apps). 1020 const char kNoStartupWindow[] = "no-startup-window"; 1021 1022 // Disables checking whether we received an acknowledgment when registering 1023 // a supervised user. Also disables the timeout during registration that waits 1024 // for the ack. Useful when debugging against a server that does not 1025 // support notifications. 1026 const char kNoManagedUserAcknowledgmentCheck[] = 1027 "no-managed-user-acknowledgment-check"; 1028 1029 // Specifies the maximum number of threads to use for running the Proxy 1030 // Autoconfig (PAC) script. 1031 const char kNumPacThreads[] = "num-pac-threads"; 1032 1033 // When the option to block third-party cookies is enabled, only block 1034 // third-party cookies from being set. 1035 const char kOnlyBlockSettingThirdPartyCookies[] = 1036 "only-block-setting-third-party-cookies"; 1037 1038 // Launches URL in new browser window. 1039 const char kOpenInNewWindow[] = "new-window"; 1040 1041 // Simulates an organic Chrome install. 1042 const char kOrganicInstall[] = "organic"; 1043 1044 // Force use of QUIC for requests to the specified origin. 1045 const char kOriginToForceQuicOn[] = "origin-to-force-quic-on"; 1046 1047 // The time that a new chrome process which is delegating to an already running 1048 // chrome process started. (See ProcessSingleton for more details.) 1049 const char kOriginalProcessStartTime[] = "original-process-start-time"; 1050 1051 // Packages an extension to a .crx installable file from a given directory. 1052 const char kPackExtension[] = "pack-extension"; 1053 1054 // Optional PEM private key to use in signing packaged .crx. 1055 const char kPackExtensionKey[] = "pack-extension-key"; 1056 1057 // Specifies the path to the user data folder for the parent profile. 1058 const char kParentProfile[] = "parent-profile"; 1059 1060 // Launches PerformanceMonitor at startup, which will gather statistics about 1061 // Chrome's CPU and memory usage, page load times, startup times, and network 1062 // usage, and will also store information about events which may be of interest, 1063 // such as extension-related occurrences and crashes. Optionally, this may be 1064 // run with an integer value representing the interval between the timed 1065 // metric gatherings, measured in seconds (if invalid or not provided, the 1066 // default interval is used). 1067 const char kPerformanceMonitorGathering[] = "performance-monitor-gathering"; 1068 1069 // Read previously recorded data from the cache. Only cached data is read. 1070 // See kRecordMode. 1071 const char kPlaybackMode[] = "playback-mode"; 1072 1073 // Overrides the path to the location that PNaCl is installed. 1074 const char kPnaclDir[] = "pnacl-dir"; 1075 1076 // Forces the PPAPI version of Flash (if it's being used) to run in the 1077 // renderer process rather than in a separate plugin process. 1078 const char kPpapiFlashInProcess[] = "ppapi-flash-in-process"; 1079 1080 // Use the PPAPI (Pepper) Flash found at the given path. 1081 const char kPpapiFlashPath[] = "ppapi-flash-path"; 1082 1083 // Report the given version for the PPAPI (Pepper) Flash. The version should be 1084 // numbers separated by '.'s (e.g., "12.3.456.78"). If not specified, it 1085 // defaults to "10.2.999.999". 1086 const char kPpapiFlashVersion[] = "ppapi-flash-version"; 1087 1088 // Triggers prerendering of pages from suggestions in the omnibox. Only has an 1089 // effect when Instant is either disabled or restricted to search, and when 1090 // prerender is enabled. 1091 const char kPrerenderFromOmnibox[] = "prerender-from-omnibox"; 1092 // These are the values the kPrerenderFromOmnibox switch may have, as in 1093 // "--prerender-from-omnibox=auto". auto: Allow field trial selection. 1094 const char kPrerenderFromOmniboxSwitchValueAuto[] = "auto"; 1095 // disabled: No prerendering. 1096 const char kPrerenderFromOmniboxSwitchValueDisabled[] = "disabled"; 1097 // enabled: Guaranteed prerendering. 1098 const char kPrerenderFromOmniboxSwitchValueEnabled[] = "enabled"; 1099 // Controls speculative prerendering of pages, and content prefetching. Both 1100 // are dispatched from <link rel=prefetch href=...> elements. 1101 const char kPrerenderMode[] = "prerender"; 1102 // These are the values the kPrerenderMode switch may have, as in 1103 // "--prerender=auto". 1104 // auto: Allow field trial selection in both prerender and prefetch. 1105 const char kPrerenderModeSwitchValueAuto[] = "auto"; 1106 // disabled: No prerendering or prefetching. 1107 const char kPrerenderModeSwitchValueDisabled[] = "disabled"; 1108 // enabled: Both prerendering and prefetching. 1109 const char kPrerenderModeSwitchValueEnabled[] = "enabled"; 1110 // prefetch_only: No prerendering, but enables prefetching. 1111 const char kPrerenderModeSwitchValuePrefetchOnly[] = "prefetch_only"; 1112 1113 // Enable conversion from vector to raster for any page. 1114 const char kPrintRaster[] = "print-raster"; 1115 1116 // Outputs the product version information and quit. Used as an internal api to 1117 // detect the installed version of Chrome on Linux. 1118 const char kProductVersion[] = "product-version"; 1119 1120 // Selects directory of profile to associate with the first browser launched. 1121 const char kProfileDirectory[] = "profile-directory"; 1122 1123 // Starts the sampling based profiler for the browser process at startup. This 1124 // will only work if chrome has been built with the gyp variable profiling=1. 1125 // The output will go to the value of kProfilingFile. 1126 const char kProfilingAtStart[] = "profiling-at-start"; 1127 1128 // Specifies a location for profiling output. This will only work if chrome has 1129 // been built with the gyp variable profiling=1. 1130 // 1131 // {pid} if present will be replaced by the pid of the process. 1132 // {count} if present will be incremented each time a profile is generated 1133 // for this process. 1134 // The default is chrome-profile-{pid}. 1135 const char kProfilingFile[] = "profiling-file"; 1136 1137 // Specifies a path for the output of task-level profiling which can be loaded 1138 // and viewed in about:profiler. 1139 const char kProfilingOutputFile[] = "profiling-output-file"; 1140 1141 // Controls whether profile data is periodically flushed to a file. Normally 1142 // the data gets written on exit but cases exist where chrome doesn't exit 1143 // cleanly (especially when using single-process). A time in seconds can be 1144 // specified. 1145 const char kProfilingFlush[] = "profiling-flush"; 1146 1147 // Specifies a custom URL for fetching NTP promo data. 1148 const char kPromoServerURL[] = "promo-server-url"; 1149 1150 // Should we prompt the user before allowing external extensions to install? 1151 // Default is yes. 1152 const char kPromptForExternalExtensions[] = "prompt-for-external-extensions"; 1153 1154 // Forces proxy auto-detection. 1155 const char kProxyAutoDetect[] = "proxy-auto-detect"; 1156 1157 // Specifies a list of hosts for whom we bypass proxy settings and use direct 1158 // connections. Ignored if --proxy-auto-detect or --no-proxy-server are also 1159 // specified. This is a comma-separated list of bypass rules. See: 1160 // "net/proxy/proxy_bypass_rules.h" for the format of these rules. 1161 const char kProxyBypassList[] = "proxy-bypass-list"; 1162 1163 // Uses the pac script at the given URL 1164 const char kProxyPacUrl[] = "proxy-pac-url"; 1165 1166 // Uses a specified proxy server, overrides system settings. This switch only 1167 // affects HTTP and HTTPS requests. 1168 const char kProxyServer[] = "proxy-server"; 1169 1170 // Adds a "Purge memory" button to the Task Manager, which tries to dump as 1171 // much memory as possible. This is mostly useful for testing how well the 1172 // MemoryPurger functionality works. 1173 // 1174 // NOTE: This is only implemented for Views. 1175 const char kPurgeMemoryButton[] = "purge-memory-button"; 1176 1177 // Capture resource consumption information through page cycling and output the 1178 // data to the specified file. 1179 const char kRecordStats[] = "record-stats"; 1180 1181 // Chrome supports a playback and record mode. Record mode saves *everything* 1182 // to the cache. Playback mode reads data exclusively from the cache. This 1183 // allows us to record a session into the cache and then replay it at will. 1184 // See also kPlaybackMode. 1185 const char kRecordMode[] = "record-mode"; 1186 1187 // Uses custom front-end URL for the remote debugging. 1188 const char kRemoteDebuggingFrontend[] = "remote-debugging-frontend"; 1189 1190 // Enables remote debugging of Chrome for Android via raw USB. 1191 const char kRemoteDebuggingRawUSB[] = "remote-debugging-raw-usb"; 1192 1193 // Enables print preview in the renderer. This flag is generated internally by 1194 // Chrome and does nothing when directly passed to the browser. 1195 const char kRendererPrintPreview[] = "renderer-print-preview"; 1196 1197 // Forces a reset of the one-time-randomized FieldTrials on this client, also 1198 // known as the Chrome Variations state. 1199 const char kResetVariationState[] = "reset-variation-state"; 1200 1201 // Indicates the last session should be restored on startup. This overrides the 1202 // preferences value and is primarily intended for testing. The value of this 1203 // switch is the number of tabs to wait until loaded before 'load completed' is 1204 // sent to the ui_test. 1205 const char kRestoreLastSession[] = "restore-last-session"; 1206 1207 // Disable saving pages as HTML-only, disable saving pages as HTML Complete 1208 // (with a directory of sub-resources). Enable only saving pages as MHTML. 1209 // See http://crbug.com/120416 for how to remove this switch. 1210 const char kSavePageAsMHTML[] = "save-page-as-mhtml"; 1211 1212 // URL prefix used by safebrowsing to fetch hash, download data and report 1213 // malware. 1214 const char kSbURLPrefix[] = "safebrowsing-url-prefix"; 1215 1216 // If present, safebrowsing only performs update when 1217 // SafeBrowsingProtocolManager::ForceScheduleNextUpdate() is explicitly called. 1218 // This is used for testing only. 1219 const char kSbDisableAutoUpdate[] = "safebrowsing-disable-auto-update"; 1220 1221 // TODO(lzheng): Remove this flag once the feature works fine 1222 // (http://crbug.com/74848). 1223 // 1224 // Disables safebrowsing feature that checks download url and downloads 1225 // content's hash to make sure the content are not malicious. 1226 const char kSbDisableDownloadProtection[] = 1227 "safebrowsing-disable-download-protection"; 1228 1229 // Disables safebrowsing feature that checks for blacklisted extensions. 1230 const char kSbDisableExtensionBlacklist[] = 1231 "safebrowsing-disable-extension-blacklist"; 1232 1233 // Disables safebrowsing feature that provides a side-effect free whitelist. 1234 const char kSbDisableSideEffectFreeWhitelist[] = 1235 "safebrowsing-disable-side-effect-free-whitelist"; 1236 1237 // URL to send safebrowsing download feedback reports to. 1238 const char kSbDownloadFeedbackURL[] = "safebrowsing-download-feedback-url"; 1239 1240 // Enable safebrowsing download feedback. 1241 const char kSbEnableDownloadFeedback[] = 1242 "safebrowsing-enable-download-feedback"; 1243 1244 // Enables or disables extension scripts badges in the location bar. 1245 const char kScriptBadges[] = "script-badges"; 1246 1247 // Enable or diable the "script bubble" icon in the URL bar that tells you how 1248 // many extensions are running scripts on a page. 1249 const char kScriptBubble[] = "script-bubble"; 1250 1251 // Causes the process to run as a service process. 1252 const char kServiceProcess[] = "service"; 1253 1254 // Sets a token in the token service, for testing. 1255 const char kSetToken[] = "set-token"; 1256 1257 // If true the app list will be shown. 1258 const char kShowAppList[] = "show-app-list"; 1259 1260 // See kHideIcons. 1261 const char kShowIcons[] = "show-icons"; 1262 1263 // If true the alignment of the shelf can be changed. 1264 const char kShowShelfAlignmentMenu[] = "show-launcher-alignment-menu"; 1265 1266 // Marks a renderer as the signin process. 1267 const char kSigninProcess[] = "signin-process"; 1268 1269 // Does not show an infobar when an extension attaches to a page using 1270 // chrome.debugger page. Required to attach to extension background pages. 1271 const char kSilentDebuggerExtensionAPI[] = "silent-debugger-extension-api"; 1272 1273 // Changes the DCHECKS to dump memory and continue instead of displaying error 1274 // dialog. This is valid only in Release mode when --enable-dcheck is 1275 // specified. 1276 const char kSilentDumpOnDCHECK[] = "silent-dump-on-dcheck"; 1277 1278 // Causes Chrome to launch without opening any windows by default. Useful if 1279 // one wishes to use Chrome as an ash server. 1280 const char kSilentLaunch[] = "silent-launch"; 1281 1282 // Simulates an update being available. 1283 const char kSimulateUpgrade[] = "simulate-upgrade"; 1284 1285 // Simulates a critical update being available. 1286 const char kSimulateCriticalUpdate[] = "simulate-critical-update"; 1287 1288 // Simulates that current version is outdated. 1289 const char kSimulateOutdated[] = "simulate-outdated"; 1290 1291 // Replaces the buffered data source for <audio> and <video> with a simplified 1292 // resource loader that downloads the entire resource into memory. 1293 1294 // Origin for which SpdyProxy authentication is supported. 1295 const char kSpdyProxyAuthOrigin[] = "spdy-proxy-auth-origin"; 1296 1297 // Speculative resource prefetching. 1298 const char kSpeculativeResourcePrefetching[] = 1299 "speculative-resource-prefetching"; 1300 1301 // Speculative resource prefetching is disabled. 1302 const char kSpeculativeResourcePrefetchingDisabled[] = "disabled"; 1303 1304 // Speculative resource prefetching will only learn about resources that need to 1305 // be prefetched but will not prefetch them. 1306 const char kSpeculativeResourcePrefetchingLearning[] = "learning"; 1307 1308 // Speculative resource prefetching is enabled. 1309 const char kSpeculativeResourcePrefetchingEnabled[] = "enabled"; 1310 1311 // Specifies the URL where spelling service feedback data will be sent instead 1312 // of the default URL. This switch is for temporary testing only. 1313 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by 1314 // August 2013. 1315 const char kSpellingServiceFeedbackUrl[] = "spelling-service-feedback-url"; 1316 1317 // Specifies the number of seconds between sending batches of feedback to 1318 // spelling service. The default is 30 minutes. The mininum is 5 seconds. This 1319 // switch is for temporary testing only. 1320 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by 1321 // August 2013. 1322 const char kSpellingServiceFeedbackIntervalSeconds[] = 1323 "spelling-service-feedback-interval-seconds"; 1324 1325 // Specifies the maximum SSL/TLS version ("ssl3", "tls1", "tls1.1", or 1326 // "tls1.2"). 1327 const char kSSLVersionMax[] = "ssl-version-max"; 1328 1329 // Specifies the minimum SSL/TLS version ("ssl3", "tls1", "tls1.1", or 1330 // "tls1.2"). 1331 const char kSSLVersionMin[] = "ssl-version-min"; 1332 1333 // Starts the browser maximized, regardless of any previous settings. 1334 const char kStartMaximized[] = "start-maximized"; 1335 1336 // Controls the width of time-of-day filters on the 'suggested' ntp page, in 1337 // minutes. 1338 const char kSuggestionNtpFilterWidth[] = "suggestion-ntp-filter-width"; 1339 1340 // Enables a normal distribution dropoff to the relevancy of visits with respect 1341 // to the time of day. 1342 const char kSuggestionNtpGaussianFilter[] = "suggestion-ntp-gaussian-filter"; 1343 1344 // Enables a linear dropoff to the relevancy of visits with respect to the time 1345 // of day. 1346 const char kSuggestionNtpLinearFilter[] = "suggestion-ntp-linear-filter"; 1347 1348 // Allows insecure XMPP connections for sync (for testing). 1349 const char kSyncAllowInsecureXmppConnection[] = 1350 "sync-allow-insecure-xmpp-connection"; 1351 1352 // Invalidates any login info passed into sync's XMPP connection. 1353 const char kSyncInvalidateXmppLogin[] = "sync-invalidate-xmpp-login"; 1354 1355 // This flag causes sync to retry very quickly (see polling_constants.h) the 1356 // when it encounters an error, as the first step towards exponential backoff. 1357 const char kSyncShortInitialRetryOverride[] = 1358 "sync-short-initial-retry-override"; 1359 1360 // Overrides the default host:port used for sync notifications. 1361 const char kSyncNotificationHostPort[] = "sync-notification-host-port"; 1362 1363 // Overrides the default server used for profile sync. 1364 const char kSyncServiceURL[] = "sync-url"; 1365 1366 // Makes the sync code to throw an unrecoverable error after initialization. 1367 // Useful for testing unrecoverable error scenarios. 1368 const char kSyncThrowUnrecoverableError[] = "sync-throw-unrecoverable-error"; 1369 1370 1371 // Tries to connect to XMPP using SSLTCP first (for testing). 1372 const char kSyncTrySsltcpFirstForXmpp[] = "sync-try-ssltcp-first-for-xmpp"; 1373 1374 // Enables deferring sync backend initialization until user initiated changes 1375 // occur. 1376 const char kSyncEnableDeferredStartup[] = "sync-enable-deferred-startup"; 1377 1378 // Disables use of OAuth2 token in sync components and reverts behavior to 1379 // ClientLogin token. 1380 const char kSyncDisableOAuth2Token[] = "sync-disable-oauth2-token"; 1381 1382 // Enables feature to avoid unnecessary GetUpdate requests. 1383 const char kSyncEnableGetUpdateAvoidance[] = 1384 "sync-enable-get-update-avoidance"; 1385 1386 // Enables directory support for sync filesystem 1387 const char kSyncfsEnableDirectoryOperation[] = 1388 "enable-syncfs-directory-operation"; 1389 1390 // Enables tab dragging to create a real browser. 1391 const char kTabBrowserDragging[] = "enable-tab-browser-dragging"; 1392 1393 // Passes the name of the current running automated test to Chrome. 1394 const char kTestName[] = "test-name"; 1395 1396 // Type of the current test harness ("browser" or "ui"). 1397 const char kTestType[] = "test-type"; 1398 1399 // Tells the app to listen for and broadcast testing-related messages on IPC 1400 // channel with the given ID. 1401 const char kTestingChannelID[] = "testing-channel"; 1402 1403 // Enables tracking the amount of non-idle time spent viewing pages. 1404 const char kTrackActiveVisitTime[] = "track-active-visit-time"; 1405 1406 // Overrides the default server used for Google Translate. 1407 const char kTranslateScriptURL[] = "translate-script-url"; 1408 1409 // Overrides security-origin with which Translate runs in an isolated world. 1410 const char kTranslateSecurityOrigin[] = "translate-security-origin"; 1411 1412 // Disables same-origin check on HTTP resources pushed via a SPDY proxy. 1413 // The value is the host:port of the trusted proxy. 1414 const char kTrustedSpdyProxy[] = "trusted-spdy-proxy"; 1415 1416 // Experimental. Shows a dialog asking the user to try chrome. This flag is to 1417 // be used only by the upgrade process. 1418 const char kTryChromeAgain[] = "try-chrome-again"; 1419 1420 // Uninstalls an extension with the specified extension id. 1421 const char kUninstallExtension[] = "uninstall-extension"; 1422 1423 // Runs un-installation steps that were done by chrome first-run. 1424 const char kUninstall[] = "uninstall"; 1425 1426 // Overrides per-origin quota settings to unlimited storage for any 1427 // apps/origins. This should be used only for testing purpose. 1428 const char kUnlimitedStorage[] = "unlimited-storage"; 1429 1430 // Uses Spdy for the transport protocol instead of HTTP. This is a temporary 1431 // testing flag. 1432 const char kUseSpdy[] = "use-spdy"; 1433 1434 // Disables use of the spelling web service and only provides suggestions. 1435 // This will only work if asynchronous spell checking is not disabled. 1436 const char kUseSpellingSuggestions[] = "use-spelling-suggestions"; 1437 1438 // Sets the maximum concurrent streams over a SPDY session. 1439 const char kMaxSpdyConcurrentStreams[] = "max-spdy-concurrent-streams"; 1440 1441 // Specifies the user data directory, which is where the browser will look for 1442 // all of its state. 1443 const char kUserDataDir[] = "user-data-dir"; 1444 1445 // Examines a .crx for validity and prints the result. 1446 const char kValidateCrx[] = "validate-crx"; 1447 1448 // Uses experimental simple cache backend if possible. 1449 const char kUseSimpleCacheBackend[] = "use-simple-cache-backend"; 1450 1451 // Specifies a custom URL for the server which reports variation data to the 1452 // client. Specifying this switch enables the Variations service on 1453 // unofficial builds. See variations_service.cc. 1454 const char kVariationsServerURL[] = "variations-server-url"; 1455 1456 // Prints version information and quits. 1457 const char kVersion[] = "version"; 1458 1459 // Cycle through a series of URLs listed in the specified file. 1460 const char kVisitURLs[] = "visit-urls"; 1461 1462 // Adds the given extension ID to all the permission whitelists. 1463 const char kWhitelistedExtensionID[] = "whitelisted-extension-id"; 1464 1465 // Specify the initial window position: --window-position=x,y 1466 const char kWindowPosition[] = "window-position"; 1467 1468 // Specify the initial window size: --window-size=w,h 1469 const char kWindowSize[] = "window-size"; 1470 1471 // Uses WinHTTP to fetch and evaluate PAC scripts. Otherwise the default is to 1472 // use Chromium's network stack to fetch, and V8 to evaluate. 1473 const char kWinHttpProxyResolver[] = "winhttp-proxy-resolver"; 1474 1475 #if defined(ENABLE_PLUGIN_INSTALLATION) 1476 // Specifies a custom URL for fetching plug-ins metadata. Used for testing. 1477 const char kPluginsMetadataServerURL[] = "plugins-metadata-server-url"; 1478 #endif 1479 1480 #if defined(OS_ANDROID) || defined(OS_IOS) 1481 // Enable SPDY proxy. 1482 const char kEnableSpdyProxyAuth[] = "enable-spdy-proxy-auth"; 1483 #endif // defined(OS_ANDROID) || defined(OS_IOS) 1484 1485 #if defined(OS_ANDROID) 1486 // Enables the new NTP. 1487 const char kEnableNewNTP[] = "enable-new-ntp"; 1488 1489 // Pops the translate infobar if possible. 1490 const char kEnableTranslate[] = "enable-translate"; 1491 1492 // Registers for cloud policy using the BROWSER client type instead of the 1493 // ANDROID_BROWSER type. This enables skipping the server whitelist. 1494 // TODO(joaodasilva): remove this. http://crbug.com/248527 1495 const char kFakeCloudPolicyType[] = "fake-cloud-policy-type"; 1496 1497 // Uses the tablet specific UI components when available. 1498 const char kTabletUI[] = "tablet-ui"; 1499 #endif 1500 1501 #if defined(USE_ASH) 1502 const char kAshDisableTabScrubbing[] = "ash-disable-tab-scrubbing"; 1503 const char kOpenAsh[] = "open-ash"; 1504 #endif 1505 1506 #if defined(OS_POSIX) 1507 // Used for turning on Breakpad crash reporting in a debug environment where 1508 // crash reporting is typically compiled but disabled. 1509 const char kEnableCrashReporterForTesting[] = 1510 "enable-crash-reporter-for-testing"; 1511 1512 #if !defined(OS_MACOSX) && !defined(OS_CHROMEOS) 1513 // Specifies which password store to use (detect, default, gnome, kwallet). 1514 const char kPasswordStore[] = "password-store"; 1515 #endif 1516 #endif // OS_POSIX 1517 1518 #if defined(OS_MACOSX) 1519 // Forcibly disables Lion-style on newer OSes, to allow developers to test the 1520 // older, SnowLeopard-style fullscreen. 1521 const char kDisableSystemFullscreenForTesting[] = 1522 "disable-system-fullscreen-for-testing"; 1523 1524 // Enables the app list OSX .app shim, for showing the app list. If the flag is 1525 // not present, Chrome will check if the shim exists at startup, and delete it 1526 // if it does. 1527 const char kEnableAppListShim[] = "enable-app-list-shim"; 1528 1529 // Enable to allow creation and launch of app shims for platform apps. 1530 const char kEnableAppShims[] = "enable-app-shims"; 1531 1532 // Enables the tabs expose feature ( http://crbug.com/50307 ). 1533 const char kEnableExposeForTabs[] = "enable-expose-for-tabs"; 1534 1535 // Enables a simplified fullscreen UI on Mac. 1536 const char kEnableSimplifiedFullscreen[] = "enable-simplified-fullscreen"; 1537 1538 // Performs Keychain reauthorization from the command line on behalf of a 1539 // special Keychain reauthorization stub executable. Used during auto-update. 1540 const char kKeychainReauthorize[] = "keychain-reauthorize"; 1541 1542 // A process type (switches::kProcessType) that relaunches the browser. See 1543 // chrome/browser/mac/relauncher.h. 1544 const char kRelauncherProcess[] = "relauncher"; 1545 1546 // Uses mock keychain for testing purposes, which prevents blocking dialogs 1547 // from causing timeouts. 1548 const char kUseMockKeychain[] = "use-mock-keychain"; 1549 #endif 1550 1551 #if defined(OS_WIN) 1552 // For the DelegateExecute verb handler to launch Chrome in metro mode on 1553 // Windows 8 and higher. Used when relaunching metro Chrome. 1554 const char kForceImmersive[] = "force-immersive"; 1555 1556 // For the DelegateExecute verb handler to launch Chrome in desktop mode on 1557 // Windows 8 and higher. Used when relaunching metro Chrome. 1558 const char kForceDesktop[] = "force-desktop"; 1559 1560 // Allows for disabling the overlapped I/O for TCP reads. 1561 // Possible values are "on" or "off". 1562 // The default is "on" which matches the existing behavior. 1563 // "off" switches to use non-blocking reads and WSAEventSelect. 1564 const char kOverlappedRead[] = "overlapped-reads"; 1565 1566 // Relaunches metro Chrome on Windows 8 and higher using a given shortcut. 1567 const char kRelaunchShortcut[] = "relaunch-shortcut"; 1568 1569 // Waits for the given handle to be signaled before relaunching metro Chrome on 1570 // Windows 8 and higher. 1571 const char kWaitForMutex[] = "wait-for-mutex"; 1572 1573 // Indicates that chrome was launched to service a search request in Windows 8. 1574 const char kWindows8Search[] = "windows8-search"; 1575 1576 #endif 1577 1578 #if defined(OS_WIN) && defined(USE_AURA) 1579 // Requests that Chrome connect to the running Metro viewer process. 1580 const char kViewerConnect[] = "viewer-connect"; 1581 1582 // Requests that Chrome launch the Metro viewer process via the given appid 1583 // (which is assumed to be registered as default browser) and synchronously 1584 // connect to it. 1585 const char kViewerLaunchViaAppId[] = "viewer-launch-via-appid"; 1586 #endif 1587 1588 #ifndef NDEBUG 1589 // Enables overriding the path of file manager extension. 1590 const char kFileManagerExtensionPath[] = "filemgr-ext-path"; 1591 1592 // Enables overriding the path of image loader extension. 1593 const char kImageLoaderExtensionPath[] = "image-loader-ext-path"; 1594 #endif // NDEBUG 1595 1596 // Controls print preview in the browser process. 1597 #if defined(GOOGLE_CHROME_BUILD) 1598 // Disables print preview (For testing, and for users who don't like us. :[ ) 1599 const char kDisablePrintPreview[] = "disable-print-preview"; 1600 #else 1601 // Enables print preview (Force enable on Chromium, which normally does not 1602 // have the PDF viewer required for print preview.) 1603 const char kEnablePrintPreview[] = "enable-print-preview"; 1604 #endif 1605 1606 // ----------------------------------------------------------------------------- 1607 // DO NOT ADD YOUR CRAP TO THE BOTTOM OF THIS FILE. 1608 // 1609 // You were going to just dump your switches here, weren't you? Instead, please 1610 // put them in alphabetical order above, or in order inside the appropriate 1611 // ifdef at the bottom. The order should match the header. 1612 // ----------------------------------------------------------------------------- 1613 1614 } // namespace switches 1615