Upstream version 11.40.277.0
[platform/framework/web/crosswalk.git] / src / chrome / common / chrome_switches.cc
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 third-party content included on a page to prompt for a HTTP basic
25 // auth username/password pair.
26 const char kAllowCrossOriginAuthPrompt[]    = "allow-cross-origin-auth-prompt";
27
28 // On ChromeOS, file:// access is disabled except for certain whitelisted
29 // directories. This switch re-enables file:// for testing.
30 const char kAllowFileAccess[]               = "allow-file-access";
31
32 // Allow non-secure origins to use the screen capture API and the desktopCapture
33 // extension API.
34 const char kAllowHttpScreenCapture[] = "allow-http-screen-capture";
35
36 #if defined(ENABLE_PLUGINS)
37 // Specifies comma-separated list of extension ids or hosts to grant
38 // access to CRX file system APIs.
39 const char kAllowNaClCrxFsAPI[]             = "allow-nacl-crxfs-api";
40
41 // Specifies comma-separated list of extension ids or hosts to grant
42 // access to file handle APIs.
43 const char kAllowNaClFileHandleAPI[]        = "allow-nacl-file-handle-api";
44
45 // Specifies comma-separated list of extension ids or hosts to grant
46 // access to TCP/UDP socket APIs.
47 const char kAllowNaClSocketAPI[]            = "allow-nacl-socket-api";
48 #endif
49
50 // Don't block outdated plugins.
51 const char kAllowOutdatedPlugins[]          = "allow-outdated-plugins";
52
53 // By default, an https page cannot run JavaScript, CSS or plug-ins from http
54 // URLs. This provides an override to get the old insecure behavior.
55 const char kAllowRunningInsecureContent[]   = "allow-running-insecure-content";
56
57 // Specifies the threshold to be used when determining of an Alternate-Protocol
58 // advertisement will be honored. If the advertised probability is larger
59 // than the threshold, then it will be honored.
60 const char kAlternateProtocolProbabilityThreshold[] =
61     "alternate-protocol-probability-threshold";
62
63 // Prevents Chrome from requiring authorization to run certain widely installed
64 // but less commonly used plug-ins.
65 const char kAlwaysAuthorizePlugins[]        = "always-authorize-plugins";
66
67 // Specifies that the extension-app with the specified id should be launched
68 // according to its configuration.
69 const char kAppId[]                         = "app-id";
70
71 // Specifies that the associated value should be launched in "application"
72 // mode.
73 const char kApp[]                           = "app";
74
75 // Specifies an URL to use for app list start page.
76 const char kAppListStartPageURL[]           = "app-list-start-page-url";
77
78 // Overrides the apps checkout URL, which is used to determine when to expose
79 // some private APIs.
80 const char kAppsCheckoutURL[]               = "apps-checkout-url";
81
82 // The URL that the webstore APIs download extensions from.
83 // Note: the URL must contain one '%s' for the extension ID.
84 const char kAppsGalleryDownloadURL[]        = "apps-gallery-download-url";
85
86 // The URL to use for the gallery link in the app launcher.
87 const char kAppsGalleryURL[]                = "apps-gallery-url";
88
89 // The update url used by gallery/webstore extensions.
90 const char kAppsGalleryUpdateURL[]          = "apps-gallery-update-url";
91
92 // Value of GAIA auth code for --force-app-mode.
93 const char kAppModeAuthCode[]               = "app-mode-auth-code";
94
95 // Value of OAuth2 refresh token for --force-app-mode.
96 const char kAppModeOAuth2Token[]            = "app-mode-oauth-token";
97
98 // Enables overriding the path for the default authentication extension.
99 const char kAuthExtensionPath[]             = "auth-ext-path";
100
101 // Whitelist of servers that Negotiate will generate delegated Kerberos tickets
102 // for.
103 const char kAuthNegotiateDelegateWhitelist[] =
104     "auth-negotiate-delegate-whitelist";
105
106 // HTTP authentication schemes to enable. This is a comma-separated list of
107 // authentication schemes (basic, digest, ntlm, and negotiate). By default all
108 // schemes are enabled. The primary use of this command line flag is to help
109 // triage authentication-related issues reported by end-users.
110 const char kAuthSchemes[]                   = "auth-schemes";
111
112 // Whitelist of servers which NTLM and Negotiate can automatically authenticate
113 // with using the default credentials of the currently logged in user.
114 const char kAuthServerWhitelist[]           = "auth-server-whitelist";
115
116 // A flag that is used to tell Chrome that it was launched automatically at
117 // computer startup and not by some user action.
118 const char kAutoLaunchAtStartup[]           = "auto-launch-at-startup";
119
120 // This flag makes Chrome auto-select the provided choice when an extension asks
121 // permission to start desktop capture. Should only be used for tests. For
122 // instance, --auto-select-desktop-capture-source="Entire screen" will
123 // automatically select to share the entire screen in English locales.
124 const char kAutoSelectDesktopCaptureSource[] =
125     "auto-select-desktop-capture-source";
126
127 // Certificate Transparency: Uses the provided log(s) for checking Signed
128 // Certificate Timestamps provided with certificates.
129 // The switch's value is:
130 //   log_description:log_key,log_description:log_key,...
131 // where
132 //   log_description is a textual description of the log.
133 //   log_key is a Base64'd DER-encoded SubjectPublicKeyInfo of the log's
134 //   public key.
135 // Multiple logs can be specified by repeating description:key pairs,
136 // separated by a comma.
137 const char kCertificateTransparencyLog[] =
138     "certificate-transparency-log";
139
140 // How often (in seconds) to check for updates. Should only be used for testing
141 // purposes.
142 const char kCheckForUpdateIntervalSec[]     = "check-for-update-interval";
143
144 // Checks the cloud print connector policy, informing the service process if
145 // the policy is set to disallow the connector, then quits.
146 const char kCheckCloudPrintConnectorPolicy[] =
147     "check-cloud-print-connector-policy";
148
149 // Comma-separated list of SSL cipher suites to disable.
150 const char kCipherSuiteBlacklist[]          = "cipher-suite-blacklist";
151
152 // Tells chrome to display the cloud print dialog and upload the specified file
153 // for printing.
154 const char kCloudPrintFile[]                = "cloud-print-file";
155
156 // Specifies the mime type to be used when uploading data from the file
157 // referenced by cloud-print-file. Defaults to "application/pdf" if
158 // unspecified.
159 const char kCloudPrintFileType[]            = "cloud-print-file-type";
160
161 // Used with kCloudPrintFile to specify a JSON print ticket for the resulting
162 // print job. Defaults to null if unspecified.
163 const char kCloudPrintPrintTicket[]         = "cloud-print-print-ticket";
164
165 // Used with kCloudPrintFile to specify a title for the resulting print job.
166 const char kCloudPrintJobTitle[]            = "cloud-print-job-title";
167
168 // Setup cloud print proxy for provided printers. This does not start
169 // service or register proxy for autostart.
170 const char kCloudPrintSetupProxy[]          = "cloud-print-setup-proxy";
171
172 // Comma-separated list of BrowserThreads that cause browser process to crash
173 // if the given browser thread is not responsive. UI,IO,DB,FILE,CACHE are the
174 // list of BrowserThreads that are supported.
175 //
176 // For example:
177 //    --crash-on-hang-threads=UI:3:18,IO:3:18 --> Crash the browser if UI or IO
178 //      is not responsive for 18 seconds and the number of browser threads that
179 //      are responding is less than or equal to 3.
180 const char kCrashOnHangThreads[]            = "crash-on-hang-threads";
181
182 // Some platforms like ChromeOS default to empty desktop.
183 // Browser tests may need to add this switch so that at least one browser
184 // instance is created on startup.
185 // TODO(nkostylev): Investigate if this switch could be removed.
186 // (http://crbug.com/148675)
187 const char kCreateBrowserOnStartupForTests[] =
188     "create-browser-on-startup-for-tests";
189
190 // Enables a frame context menu item that toggles the frame in and out of glass
191 // mode (Windows Vista and up only).
192 const char kDebugEnableFrameToggle[]        = "debug-enable-frame-toggle";
193
194 // Adds debugging entries such as Inspect Element to context menus of packed
195 // apps.
196 const char kDebugPackedApps[]               = "debug-packed-apps";
197
198 // Triggers a plethora of diagnostic modes.
199 const char kDiagnostics[]                   = "diagnostics";
200
201 // Sets the output format for diagnostic modes enabled by diagnostics flag.
202 const char kDiagnosticsFormat[]             = "diagnostics-format";
203
204 // Tells the diagnostics mode to do the requested recovery step(s).
205 const char kDiagnosticsRecovery[]           = "diagnostics-recovery";
206
207 // When kEnableSettingsWindow is used, About is shown as an overlay in Settings
208 // instead of as a separate page, unless this flag is specified.
209 const char kDisableAboutInSettings[]        = "disable-about-in-settings";
210
211 // Disables the experimental asynchronous DNS client.
212 const char kDisableAsyncDns[]               = "disable-async-dns";
213
214 // Disables CNAME lookup of the host when generating the Kerberos SPN for a
215 // Negotiate challenge. See HttpAuthHandlerNegotiate::CreateSPN for more
216 // background.
217 const char kDisableAuthNegotiateCnameLookup[] =
218     "disable-auth-negotiate-cname-lookup";
219
220 // Disable several subsystems which run network requests in the background.
221 // This is for use when doing network performance testing to avoid noise in the
222 // measurements.
223 const char kDisableBackgroundNetworking[]   = "disable-background-networking";
224
225 // Disables the bundled PPAPI version of Flash.
226 const char kDisableBundledPpapiFlash[]      = "disable-bundled-ppapi-flash";
227
228 // Disable hardware encoding support for Cast Streaming.
229 const char kDisableCastStreamingHWEncoding[] =
230     "disable-cast-streaming-hw-encoding";
231
232 // Disables the client-side phishing detection feature. Note that even if
233 // client-side phishing detection is enabled, it will only be active if the
234 // user has opted in to UMA stats and SafeBrowsing is enabled in the
235 // preferences.
236 const char kDisableClientSidePhishingDetection[] =
237     "disable-client-side-phishing-detection";
238
239 // Disable default component extensions with background pages - useful for
240 // performance tests where these pages may interfere with perf results.
241 const char kDisableComponentExtensionsWithBackgroundPages[] =
242     "disable-component-extensions-with-background-pages";
243
244 const char kDisableComponentUpdate[]        = "disable-component-update";
245
246 // Disables installation of default apps on first run. This is used during
247 // automated testing.
248 const char kDisableDefaultApps[]            = "disable-default-apps";
249
250 // Disables device discovery notifications.
251 const char kDisableDeviceDiscoveryNotifications[] =
252     "disable-device-discovery-notifications";
253
254 // Disables Domain Reliability Monitoring.
255 const char kDisableDomainReliability[]      = "disable-domain-reliability";
256
257 // Disable extensions.
258 const char kDisableExtensions[]             = "disable-extensions";
259
260 // Disable checking for user opt-in for extensions that want to inject script
261 // into file URLs (ie, always allow it). This is used during automated testing.
262 const char kDisableExtensionsFileAccessCheck[] =
263     "disable-extensions-file-access-check";
264
265 // Disable the net::URLRequestThrottlerManager functionality for
266 // requests originating from extensions.
267 const char kDisableExtensionsHttpThrottling[] =
268     "disable-extensions-http-throttling";
269
270 // Don't resolve hostnames to IPv6 addresses. This can be used when debugging
271 // issues relating to IPv6, but shouldn't otherwise be needed. Be sure to file
272 // bugs if something isn't working properly in the presence of IPv6. This flag
273 // can be overidden by the "enable-ipv6" flag.
274 const char kDisableIPv6[]                   = "disable-ipv6";
275
276 // Disable the behavior that the second click on a launcher item (the click when
277 // the item is already active) minimizes the item.
278 const char kDisableMinimizeOnSecondLauncherItemClick[] =
279     "disable-minimize-on-second-launcher-item-click";
280
281 // Disables the menu on the NTP for accessing sessions from other devices.
282 const char kDisableNTPOtherSessionsMenu[]   = "disable-ntp-other-sessions-menu";
283
284 // Disables the Material Design NTP.
285 const char kDisableMaterialDesignNTP[]      = "disable-material-design-ntp";
286
287 // Disable auto-reload of error pages if offline.
288 const char kDisableOfflineAutoReload[]       = "disable-offline-auto-reload";
289
290 // Disable only auto-reloading error pages when the tab is visible.
291 const char kDisableOfflineAutoReloadVisibleOnly[] =
292     "disable-offline-auto-reload-visible-only";
293
294 // Disable the origin chip.
295 const char kDisableOriginChip[]             = "disable-origin-chip";
296
297 // Disable the setting to prompt the user for their OS account password before
298 // revealing plaintext passwords in the password manager.
299 const char kDisablePasswordManagerReauthentication[] =
300     "disable-password-manager-reauthentication";
301
302 // Enables searching for people from the apps list search box.
303 const char kDisablePeopleSearch[]           = "disable-people-search";
304
305 // Don't use bubbles for content permissions requests instead of infobars.
306 const char kDisablePermissionsBubbles[]      = "disable-permissions-bubbles";
307
308 // Disable pop-up blocking.
309 const char kDisablePopupBlocking[]          = "disable-popup-blocking";
310
311 // Disable speculative TCP/IP preconnection.
312 const char kDisablePreconnect[]             = "disable-preconnect";
313
314 // Disable prerendering based on local browsing history.
315 const char kDisablePrerenderLocalPredictor[] =
316     "disable-prerender-local-predictor";
317
318 // Disables print preview (For testing, and for users who don't like us. :[ )
319 const char kDisablePrintPreview[]           = "disable-print-preview";
320
321 // Normally when the user attempts to navigate to a page that was the result of
322 // a post we prompt to make sure they want to. This switch may be used to
323 // disable that check. This switch is used during automated testing.
324 const char kDisablePromptOnRepost[]         = "disable-prompt-on-repost";
325
326 // Disables support for the QUIC protocol.
327 const char kDisableQuic[]                   = "disable-quic";
328
329 // Disable use of pacing of QUIC packets.
330 // This only has an effect if QUIC protocol is enabled.
331 const char kDisableQuicPacing[]             = "disable-quic-pacing";
332
333 // Disable use of Chromium's port selection for the ephemeral port via bind().
334 // This only has an effect if QUIC protocol is enabled.
335 const char kDisableQuicPortSelection[]      = "disable-quic-port-selection";
336
337 // Prevents the save password bubble from being enabled.
338 const char kDisableSavePasswordBubble[] = "disable-save-password-bubble";
339
340 // Disables the "search button in omnibox" experiment.
341 const char kDisableSearchButtonInOmnibox[]  =
342     "disable-search-button-in-omnibox";
343
344 // Disables using bubbles for session restore request.
345 const char kDisableSessionCrashedBubble[] = "disable-session-crashed-bubble";
346
347 // Disables the suggestions service.
348 const char kDisableSuggestionsService[]     = "disable-suggestions-service";
349
350 // Disables the supervised user host blacklist.
351 const char kDisableSupervisedUserBlacklist[] =
352     "disable-supervised-user-blacklist";
353
354 // Disables SafeSites filtering for supervised users.
355 const char kDisableSupervisedUserSafeSites[] =
356     "disable-supervised-user-safesites";
357
358 // Disables syncing browser data to a Google Account.
359 const char kDisableSync[]                   = "disable-sync";
360
361 // Disable synced notifications.
362 const char kDisableSyncSyncedNotifications[] =
363     "disable-sync-synced-notifications";
364
365 // Disables syncing one or more sync data types that are on by default.
366 // See sync/internal_api/public/base/model_type.h for possible types. Types
367 // should be comma separated, and follow the naming convention for string
368 // representation of model types, e.g.:
369 // --disable-synctypes='Typed URLs, Bookmarks, Autofill Profiles'
370 const char kDisableSyncTypes[]              = "disable-sync-types";
371
372 // Disables the backend service for web resources.
373 const char kDisableWebResources[]           = "disable-web-resources";
374
375 // Some tests seem to require the application to close when the last
376 // browser window is closed. Thus, we need a switch to force this behavior
377 // for ChromeOS Aura, disable "zero window mode".
378 // TODO(pkotwicz): Investigate if this bug can be removed.
379 // (http://crbug.com/119175)
380 const char kDisableZeroBrowsersOpenForTests[] =
381     "disable-zero-browsers-open-for-tests";
382
383 // Use a specific disk cache location, rather than one derived from the
384 // UserDatadir.
385 const char kDiskCacheDir[]                  = "disk-cache-dir";
386
387 // Forces the maximum disk space to be used by the disk cache, in bytes.
388 const char kDiskCacheSize[]                 = "disk-cache-size";
389
390 const char kDnsLogDetails[]                 = "dns-log-details";
391
392 // Disables prefetching of DNS information.
393 const char kDnsPrefetchDisable[]            = "dns-prefetch-disable";
394
395 // Requests that a running browser process dump its collected histograms to a
396 // given file. The file is overwritten if it exists.
397 const char kDumpBrowserHistograms[]         = "dump-browser-histograms";
398
399 // Overrides the path of Easy Unlock component app.
400 extern const char kEasyUnlockAppPath[]      = "easy-unlock-app-path";
401
402 // If set, the app list will be enabled as if enabled from CWS.
403 const char kEnableAppList[]                 = "enable-app-list";
404
405 // Enable OS integration for Chrome app file associations.
406 const char kEnableAppsFileAssociations[]    = "enable-apps-file-associations";
407
408 // Enables the experimental asynchronous DNS client.
409 const char kEnableAsyncDns[]                = "enable-async-dns";
410
411 // Enables the inclusion of non-standard ports when generating the Kerberos SPN
412 // in response to a Negotiate challenge. See
413 // HttpAuthHandlerNegotiate::CreateSPN for more background.
414 const char kEnableAuthNegotiatePort[]       = "enable-auth-negotiate-port";
415
416 // Enables the benchmarking extensions.
417 const char kEnableBenchmarking[]            = "enable-benchmarking";
418
419 // Enables client hints, which adds hints about browser state to HTTP requests.
420 const char kEnableClientHints[]             = "enable-client-hints";
421
422 // Enables the multi-level undo system for bookmarks.
423 const char kEnableBookmarkUndo[]            = "enable-bookmark-undo";
424
425 // This applies only when the process type is "service". Enables the Cloud
426 // Print Proxy component within the service process.
427 const char kEnableCloudPrintProxy[]         = "enable-cloud-print-proxy";
428
429 // If true devtools experimental settings are enabled.
430 const char kEnableDevToolsExperiments[]     = "enable-devtools-experiments";
431
432 // Enable device discovery notifications.
433 const char kEnableDeviceDiscoveryNotifications[] =
434     "enable-device-discovery-notifications";
435
436 // Enables the DOM distiller.
437 const char kEnableDomDistiller[]               = "enable-dom-distiller";
438
439 // Enables Domain Reliability Monitoring.
440 const char kEnableDomainReliability[]          = "enable-domain-reliability";
441
442 // Enable Enhanced Bookmarks.
443 const char kEnhancedBookmarksExperiment[] = "enhanced-bookmarks-experiment";
444
445 // Enables experimentation with ephemeral apps, which are launched without
446 // installing in Chrome.
447 const char kEnableEphemeralApps[]           = "enable-ephemeral-apps";
448
449 // Enables experimental hotword detection features. These features include
450 // using a new component extension for performing hotword detection, new UI
451 // flows, and always-on detection.
452 const char kEnableExperimentalHotwording[]  = "enable-experimental-hotwording";
453
454 // Enables logging for extension activity.
455 const char kEnableExtensionActivityLogging[] =
456     "enable-extension-activity-logging";
457
458 const char kEnableExtensionActivityLogTesting[] =
459     "enable-extension-activity-log-testing";
460
461 // Enable the fast unload controller, which speeds up tab/window close by
462 // running a tab's onunload js handler independently of the GUI -
463 // crbug.com/142458 .
464 const char kEnableFastUnload[]         = "enable-fast-unload";
465
466 // Enables IPv6 support, even if probes suggest that it may not be fully
467 // supported. Some probes may require internet connections, and this flag will
468 // allow support independent of application testing. This flag overrides
469 // "disable-ipv6" which appears elswhere in this file.
470 const char kEnableIPv6[]                    = "enable-ipv6";
471
472 // Enables experimentation with launching ephemeral apps via hyperlinks.
473 const char kEnableLinkableEphemeralApps[]   = "enable-linkable-ephemeral-apps";
474
475 // Runs the Native Client inside the renderer process and enables GPU plugin
476 // (internally adds lEnableGpuPlugin to the command line).
477 const char kEnableNaCl[]                    = "enable-nacl";
478
479 // Enables the network-related benchmarking extensions.
480 const char kEnableNetBenchmarking[]         = "enable-net-benchmarking";
481
482 // Enables the Material Design NTP.
483 const char kEnableMaterialDesignNTP[]       = "enable-material-design-ntp";
484
485 // Enables NPN with HTTP. It means NPN is enabled but SPDY won't be used.
486 // HTTP is still used for all requests.
487 const char kEnableNpnHttpOnly[]             = "enable-npn-http";
488
489 // Enable auto-reload of error pages if offline.
490 const char kEnableOfflineAutoReload[]       = "enable-offline-auto-reload";
491
492 // Only auto-reload error pages when the tab is visible.
493 const char kEnableOfflineAutoReloadVisibleOnly[] =
494     "enable-offline-auto-reload-visible-only";
495
496 // Enable/Disable offering a "Load stale copy" option to the user if offline.
497 const char kEnableOfflineLoadStaleCache[]   = "enable-offline-load-stale-cache";
498 const char kDisableOfflineLoadStaleCache[]  =
499     "disable-offline-load-stale-cache";
500
501 // Controls which branch of the origin chip in location bar experiment is
502 // enabled.
503 //
504 // We're using independent flags here (as opposed to a common flag with
505 // different values) to be able to enable/disable the entire experience
506 // associated with this feature server-side from the FieldTrial (the complete
507 // experience includes other flag changes as well). It is not currently possible
508 // to do that with "flag=value" flags.
509 const char kEnableOriginChipAlways[]        = "enable-origin-chip-always";
510 const char kEnableOriginChipOnSrp[]         = "enable-origin-chip-on-srp";
511
512 // Enables panels (always on-top docked pop-up windows).
513 const char kEnablePanels[]                  = "enable-panels";
514
515 // Enables presenting plugin placeholder content as shadow DOM.
516 const char kEnablePluginPlaceholderShadowDom[] =
517     "enable-plugin-placeholder-shadow-dom";
518
519 // Enables the Power overlay in Settings.
520 const char kEnablePowerOverlay[]            = "enable-power-overlay";
521
522 // Enables showing unregistered printers in print preview
523 const char kEnablePrintPreviewRegisterPromos[] =
524     "enable-print-preview-register-promos";
525
526 // Enable Privet storage.
527 const char kEnablePrivetStorage[]           = "enable-privet-storage";
528
529 // Enables tracking of tasks in profiler for viewing via about:profiler.
530 // To predominantly disable tracking (profiling), use the command line switch:
531 // --enable-profiling=0
532 // Some tracking will still take place at startup, but it will be turned off
533 // during chrome_browser_main.
534 const char kEnableProfiling[]               = "enable-profiling";
535
536 // Enables query in the omnibox.
537 const char kEnableQueryExtraction[]         = "enable-query-extraction";
538
539 // Enables support for the QUIC protocol.  This is a temporary testing flag.
540 const char kEnableQuic[]                    = "enable-quic";
541
542 // Disable use of pacing of QUIC packets.
543 // This only has an effect if QUIC protocol is enabled.
544 const char kEnableQuicPacing[]              = "enable-quic-pacing";
545
546 // Enable use of Chromium's port selection for the ephemeral port via bind().
547 // This only has an effect if QUIC protocol is enabled.
548 const char kEnableQuicPortSelection[]       = "enable-quic-port-selection";
549
550 // Enables context-sensitive reader mode button in the toolbar.
551 const char kEnableReaderModeToolbarIcon[] =
552     "enable-reader-mode-toolbar-icon";
553
554 // Enables save password prompt bubble.
555 const char kEnableSavePasswordBubble[]      = "enable-save-password-bubble";
556
557 // Enables SDCH for https schemes.
558 const char kEnableSdchOverHttps[] = "enable-sdch-over-https";
559
560 // Controls which branch of the "search button in omnibox" experiment is
561 // enabled.
562 //
563 // We're using independent flags here (as opposed to a common flag with
564 // different values) to be able to enable/disable the entire experience
565 // associated with this feature server-side from the FieldTrial (the complete
566 // experience includes other flag changes as well). It is not currently possible
567 // to do that with "flag=value" flags.
568 const char kEnableSearchButtonInOmniboxAlways[] =
569     "enable-search-button-in-omnibox-always";
570 const char kEnableSearchButtonInOmniboxForStr[] =
571     "enable-search-button-in-omnibox-for-str";
572 const char kEnableSearchButtonInOmniboxForStrOrIip[] =
573     "enable-search-button-in-omnibox-for-str-or-iip";
574
575 // Enables using bubbles for session restore request instead of infobars.
576 const char kEnableSessionCrashedBubble[] = "enable-session-crashed-bubble";
577
578 // Enables the deprecated window.showModalDialog API. This is slated for
579 // removal.
580 const char kEnableShowModalDialog[] = "enable-show-modal-dialog";
581
582 // Enable or disable settings in a separate browser window per profile
583 // (see SettingsWindowEnabled() below).
584 const char kEnableSettingsWindow[]           = "enable-settings-window";
585 const char kDisableSettingsWindow[]          = "disable-settings-window";
586
587 // Enable SPDY/4, aka HTTP/2. This is a temporary testing flag.
588 const char kEnableSpdy4[]                   = "enable-spdy4";
589
590 // Enables a feature that holds back some SSLConnectJobs in order to
591 // minimize the number of full SSL handshakes completed.
592 const char kEnableSSLConnectJobWaiting[] = "enable-ssl-connect-job-waiting";
593
594 // Enables implementation of the Cache-Control: stale-while-revalidate directive
595 // which permits servers to allow the use of stale resources while revalidation
596 // proceeds in the background.
597 const char kEnableStaleWhileRevalidate[]    = "enable-stale-while-revalidate";
598
599 // Enables an experimental hosted app experience.
600 const char kEnableStreamlinedHostedApps[]   = "enable-streamlined-hosted-apps";
601
602 // Enables the suggestions service.
603 const char kEnableSuggestionsService[]      = "enable-suggestions-service";
604
605 // Enables the supervised user host blacklist.
606 const char kEnableSupervisedUserBlacklist[] =
607     "enable-supervised-user-blacklist";
608
609 // Enables SafeSites filtering for supervised users.
610 const char kEnableSupervisedUserSafeSites[] =
611     "enable-supervised-user-safesites";
612
613 // Enables synced notifications.
614 const char kEnableSyncSyncedNotifications[] =
615     "enable-sync-synced-notifications";
616
617 // Enables synced articles.
618 const char kEnableSyncArticles[]            = "enable-sync-articles";
619
620 // Enables user control over muting tab audio from the tab strip.
621 const char kEnableTabAudioMuting[]  = "enable-tab-audio-muting";
622
623 // Enables fanciful thumbnail processing. Used with NTP for
624 // instant-extended-api, where thumbnails are generally smaller.
625 const char kEnableThumbnailRetargeting[]   = "enable-thumbnail-retargeting";
626
627 // Enables Translate experimental new UX which replaces the infobar.
628 const char kEnableTranslateNewUX[]         = "enable-translate-new-ux";
629
630 // Enables Alternate-Protocol when the port is user controlled (> 1024).
631 const char kEnableUserAlternateProtocolPorts[] =
632     "enable-user-controlled-alternate-protocol-ports";
633
634 // Uses WebSocket over SPDY.
635 const char kEnableWebSocketOverSpdy[]       = "enable-websocket-over-spdy";
636
637 // Enables the Website Settings page on the Settings page.
638 const char kEnableWebsiteSettingsManager[]  = "enable-website-settings-manager";
639
640 // Explicitly allows additional ports using a comma-separated list of port
641 // numbers.
642 const char kExplicitlyAllowedPorts[]        = "explicitly-allowed-ports";
643
644 // Values for the kExtensionContentVerification flag.
645 // See ContentVerifierDelegate::Mode for more explanation.
646 const char kExtensionContentVerificationBootstrap[] = "bootstrap";
647 const char kExtensionContentVerificationEnforceStrict[] = "enforce_strict";
648 const char kExtensionContentVerificationEnforce[] = "enforce";
649
650 // Name of the command line flag to force content verification to be on in one
651 // of various modes.
652 const char kExtensionContentVerification[] = "extension-content-verification";
653
654 // Turns on extension install verification if it would not otherwise have been
655 // turned on.
656 const char kExtensionsInstallVerification[] = "extensions-install-verification";
657
658 // Specifies a comma-separated list of extension ids that should be forced to
659 // be treated as not from the webstore when doing install verification.
660 const char kExtensionsNotWebstore[] = "extensions-not-webstore";
661
662 // Frequency in seconds for Extensions auto-update.
663 const char kExtensionsUpdateFrequency[]     = "extensions-update-frequency";
664
665 // Fakes the channel of the browser for purposes of Variations filtering. This
666 // is to be used for testing only. Possible values are "stable", "beta", "dev"
667 // and "canary". Note that this only applies if the browser's reported channel
668 // is UNKNOWN.
669 const char kFakeVariationsChannel[]         = "fake-variations-channel";
670
671 // If this flag is present then this command line is being delegated to an
672 // already running chrome process via the fast path, ie: before chrome.dll is
673 // loaded. It is useful to tell the difference for tracking purposes.
674 const char kFastStart[]            = "fast-start";
675
676 // These two flags are added around the switches about:flags adds to the
677 // command line. This is useful to see which switches were added by about:flags
678 // on about:version. They don't have any effect.
679 const char kFlagSwitchesBegin[]             = "flag-switches-begin";
680 const char kFlagSwitchesEnd[]               = "flag-switches-end";
681
682 // Forces application mode. This hides certain system UI elements and forces
683 // the app to be installed if it hasn't been already.
684 const char kForceAppMode[]                  = "force-app-mode";
685
686 // Displays the First Run experience when the browser is started, regardless of
687 // whether or not it's actually the First Run (this overrides kNoFirstRun).
688 const char kForceFirstRun[]                 = "force-first-run";
689
690 // Forces additional Chrome Variation Ids that will be sent in X-Client-Data
691 // header, specified as a 64-bit encoded list of numeric experiment ids. Ids
692 // prefixed with the character "t" will be treated as Trigger Variation Ids.
693 const char kForceVariationIds[]             = "force-variation-ids";
694
695 // Specifies a custom name for the GSSAPI library to load.
696 const char kGSSAPILibraryName[]             = "gssapi-library-name";
697
698 // These flags show the man page on Linux. They are equivalent to each
699 // other.
700 const char kHelp[]                          = "help";
701 const char kHelpShort[]                     = "h";
702
703 // Makes Windows happy by allowing it to show "Enable access to this program"
704 // checkbox in Add/Remove Programs->Set Program Access and Defaults. This only
705 // shows an error box because the only way to hide Chrome is by uninstalling
706 // it.
707 const char kHideIcons[]                     = "hide-icons";
708
709 // Enables grouping websites by domain and filtering them by period.
710 const char kHistoryEnableGroupByDomain[]    = "enable-grouped-history";
711
712 // Specifies which page will be displayed in newly-opened tabs. We need this
713 // for testing purposes so that the UI tests don't depend on what comes up for
714 // http://google.com.
715 const char kHomePage[]                      = "homepage";
716
717 // Comma-separated list of rules that control how hostnames are mapped.
718 //
719 // For example:
720 //    "MAP * 127.0.0.1" --> Forces all hostnames to be mapped to 127.0.0.1
721 //    "MAP *.google.com proxy" --> Forces all google.com subdomains to be
722 //                                 resolved to "proxy".
723 //    "MAP test.com [::1]:77 --> Forces "test.com" to resolve to IPv6 loopback.
724 //                               Will also force the port of the resulting
725 //                               socket address to be 77.
726 //    "MAP * baz, EXCLUDE www.google.com" --> Remaps everything to "baz",
727 //                                            except for "www.google.com".
728 //
729 // These mappings apply to the endpoint host in a net::URLRequest (the TCP
730 // connect and host resolver in a direct connection, and the CONNECT in an http
731 // proxy connection, and the endpoint host in a SOCKS proxy connection).
732 const char kHostRules[]                     = "host-rules";
733
734 // The maximum number of concurrent host resolve requests (i.e. DNS) to allow
735 // (not counting backup attempts which would also consume threads).
736 // --host-resolver-retry-attempts must be set to zero for this to be exact.
737 const char kHostResolverParallelism[]       = "host-resolver-parallelism";
738
739 // The maximum number of retry attempts to resolve the host. Set this to zero
740 // to disable host resolver retry attempts.
741 const char kHostResolverRetryAttempts[]     = "host-resolver-retry-attempts";
742
743 // Causes net::URLFetchers to ignore requests for SSL client certificates,
744 // causing them to attempt an unauthenticated SSL/TLS session. This is intended
745 // for use when testing various service URLs (eg: kPromoServerURL, kSbURLPrefix,
746 // kSyncServiceURL, etc)
747 const char kIgnoreUrlFetcherCertRequests[]  =
748     "ignore-urlfetcher-cert-requests";
749
750 // Causes the browser to launch directly in incognito mode.
751 const char kIncognito[]                     = "incognito";
752
753 // Causes Chrome to initiate an installation flow for the given app.
754 const char kInstallChromeApp[]              = "install-chrome-app";
755
756 // Causes Chrome to attempt to get metadata from the webstore for the
757 // app/extension ID given, and then prompt the user to download and install it.
758 // This is allowed *only* for ephemeral apps. All other ids will be ignored.
759 const char kInstallEphemeralAppFromWebstore[] =
760     "install-ephemeral-app-from-webstore";
761
762 // Marks a renderer as an Instant process.
763 const char kInstantProcess[]                = "instant-process";
764
765 // Invalidation service should use GCM network channel even if experiment is not
766 // enabled.
767 const char kInvalidationUseGCMChannel[]     = "invalidation-use-gcm-channel";
768
769 // Enables experimental Harmony (ECMAScript 6) features.
770 const char kJavaScriptHarmony[]             = "javascript-harmony";
771
772 // Specifies the testcase used by the IPC fuzzer.
773 const char kIpcFuzzerTestcase[]             = "ipc-fuzzer-testcase";
774
775 // Used for testing - keeps browser alive after last browser window closes.
776 const char kKeepAliveForTest[]              = "keep-alive-for-test";
777
778 // Enable Kiosk mode.
779 const char kKioskMode[]                     = "kiosk";
780
781 // Print automatically in kiosk mode. |kKioskMode| must be set as well.
782 // See http://crbug.com/31395.
783 const char kKioskModePrinting[]             = "kiosk-printing";
784
785 // Comma-separated list of directories with component extensions to load.
786 const char kLoadComponentExtension[]        = "load-component-extension";
787
788 // Loads an extension from the specified directory.
789 const char kLoadExtension[]                 = "load-extension";
790
791 // Makes Chrome default browser
792 const char kMakeDefaultBrowser[]            = "make-default-browser";
793
794 // Use to opt-in user into Finch experiment groups.
795 const char kManualEnhancedBookmarks[] = "manual-enhanced-bookmarks";
796 const char kManualEnhancedBookmarksOptout[] =
797     "manual-enhanced-bookmarks-optout";
798
799 // Forces the maximum disk space to be used by the media cache, in bytes.
800 const char kMediaCacheSize[]                = "media-cache-size";
801
802 // Enables histograming of tasks served by MessageLoop. See
803 // about:histograms/Loop for results, which show frequency of messages on each
804 // thread, including APC count, object signalling count, etc.
805 const char kMessageLoopHistogrammer[]       = "message-loop-histogrammer";
806
807 // Enables the recording of metrics reports but disables reporting. In contrast
808 // to kDisableMetrics, this executes all the code that a normal client would
809 // use for reporting, except the report is dropped rather than sent to the
810 // server. This is useful for finding issues in the metrics code during UI and
811 // performance tests.
812 const char kMetricsRecordingOnly[]          = "metrics-recording-only";
813
814 // Sets the base logging level for the net log. Log 0 logs the most data.
815 // Intended primarily for use with --log-net-log.
816 const char kNetLogLevel[]                   = "net-log-level";
817
818 // Disables the default browser check. Useful for UI/browser tests where we
819 // want to avoid having the default browser info-bar displayed.
820 const char kNoDefaultBrowserCheck[]         = "no-default-browser-check";
821
822 // By default, an https page can load images, fonts or frames from an http
823 // page. This switch overrides this to block this lesser mixed-content problem.
824 const char kNoDisplayingInsecureContent[]   = "no-displaying-insecure-content";
825
826 // Don't record/playback events when using record & playback.
827 const char kNoEvents[]                      = "no-events";
828
829 // Disables all experiments set on about:flags. Does not disable about:flags
830 // itself. Useful if an experiment makes chrome crash at startup: One can start
831 // chrome with --no-experiments, disable the problematic lab at about:flags and
832 // then restart chrome without this switch again.
833 const char kNoExperiments[]                 = "no-experiments";
834
835 // Skip First Run tasks, whether or not it's actually the First Run. Overridden
836 // by kForceFirstRun. This does not drop the First Run sentinel and thus doesn't
837 // prevent first run from occuring the next time chrome is launched without this
838 // flag.
839 const char kNoFirstRun[]                    = "no-first-run";
840
841 // Whether or not the browser should warn if the profile is on a network share.
842 // This flag is only relevant for Windows currently.
843 const char kNoNetworkProfileWarning[]       = "no-network-profile-warning";
844
845 // Don't send hyperlink auditing pings
846 const char kNoPings[]                       = "no-pings";
847
848 // Don't use a proxy server, always make direct connections. Overrides any
849 // other proxy server flags that are passed.
850 const char kNoProxyServer[]                 = "no-proxy-server";
851
852 // Disables the service process from adding itself as an autorun process. This
853 // does not delete existing autorun registrations, it just prevents the service
854 // from registering a new one.
855 const char kNoServiceAutorun[]              = "no-service-autorun";
856
857 // Does not automatically open a browser window on startup (used when
858 // launching Chrome for the purpose of hosting background apps).
859 const char kNoStartupWindow[]               = "no-startup-window";
860
861 // Disables checking whether we received an acknowledgment when registering
862 // a supervised user. Also disables the timeout during registration that waits
863 // for the ack. Useful when debugging against a server that does not
864 // support notifications.
865 const char kNoSupervisedUserAcknowledgmentCheck[]  =
866     "no-managed-user-acknowledgment-check";
867
868 // Specifies the maximum number of threads to use for running the Proxy
869 // Autoconfig (PAC) script.
870 const char kNumPacThreads[]                 = "num-pac-threads";
871
872 // Launches URL in new browser window.
873 const char kOpenInNewWindow[]               = "new-window";
874
875 // Force use of QUIC for requests to the specified origin.
876 const char kOriginToForceQuicOn[]           = "origin-to-force-quic-on";
877
878 // The time that a new chrome process which is delegating to an already running
879 // chrome process started. (See ProcessSingleton for more details.)
880 const char kOriginalProcessStartTime[]      = "original-process-start-time";
881
882 // Enable the out of process PDF plugin.
883 const char kOutOfProcessPdf[] = "out-of-process-pdf";
884
885 // Packages an extension to a .crx installable file from a given directory.
886 const char kPackExtension[]                 = "pack-extension";
887
888 // Optional PEM private key to use in signing packaged .crx.
889 const char kPackExtensionKey[]              = "pack-extension-key";
890
891 // Specifies the path to the user data folder for the parent profile.
892 const char kParentProfile[]                 = "parent-profile";
893
894 // Development flag for permission request API. This flag is needed until
895 // the API is finalized.
896 // TODO(bauerb): Remove when this flag is not needed anymore.
897 const char kPermissionRequestApiScope[]     = "permission-request-api-scope";
898
899 // Development flag for permission request API. This flag is needed until
900 // the API is finalized.
901 // TODO(bauerb): Remove when this flag is not needed anymore.
902 const char kPermissionRequestApiUrl[]       = "permission-request-api-url";
903
904 // Read previously recorded data from the cache. Only cached data is read.
905 // See kRecordMode.
906 const char kPlaybackMode[]                  = "playback-mode";
907
908 // Use the PPAPI (Pepper) Flash found at the given path.
909 const char kPpapiFlashPath[]                = "ppapi-flash-path";
910
911 // Report the given version for the PPAPI (Pepper) Flash. The version should be
912 // numbers separated by '.'s (e.g., "12.3.456.78"). If not specified, it
913 // defaults to "10.2.999.999".
914 const char kPpapiFlashVersion[]             = "ppapi-flash-version";
915
916 // Triggers prerendering of search base page to prefetch results for the typed
917 // omnibox query. Only has an effect when prerender is enabled.
918 const char kPrefetchSearchResults[]         = "prefetch-search-results";
919
920 // Triggers prerendering of pages from suggestions in the omnibox. Only has an
921 // effect when Instant is either disabled or restricted to search, and when
922 // prerender is enabled.
923 const char kPrerenderFromOmnibox[]          = "prerender-from-omnibox";
924 // These are the values the kPrerenderFromOmnibox switch may have, as in
925 // "--prerender-from-omnibox=auto". auto: Allow field trial selection.
926 const char kPrerenderFromOmniboxSwitchValueAuto[] = "auto";
927 //   disabled: No prerendering.
928 const char kPrerenderFromOmniboxSwitchValueDisabled[] = "disabled";
929 //   enabled: Guaranteed prerendering.
930 const char kPrerenderFromOmniboxSwitchValueEnabled[] = "enabled";
931 // Controls speculative prerendering of pages, and content prefetching. Both
932 // are dispatched from <link rel=prefetch href=...> elements.
933 const char kPrerenderMode[]                 = "prerender";
934 // These are the values the kPrerenderMode switch may have, as in
935 // "--prerender=auto".
936 //   auto: Allow field trial selection for prerender.
937 const char kPrerenderModeSwitchValueAuto[]  = "auto";
938 //   disabled: No prerendering.
939 const char kPrerenderModeSwitchValueDisabled[] = "disabled";
940 //   enabled: Prerendering.
941 const char kPrerenderModeSwitchValueEnabled[] = "enabled";
942
943 // Use IPv6 only for privet HTTP.
944 const char kPrivetIPv6Only[]                   = "privet-ipv6-only";
945
946 // Outputs the product version information and quit. Used as an internal api to
947 // detect the installed version of Chrome on Linux.
948 const char kProductVersion[]                = "product-version";
949
950 // Selects directory of profile to associate with the first browser launched.
951 const char kProfileDirectory[]              = "profile-directory";
952
953 // Starts the sampling based profiler for the browser process at startup. This
954 // will only work if chrome has been built with the gyp variable profiling=1.
955 // The output will go to the value of kProfilingFile.
956 const char kProfilingAtStart[]              = "profiling-at-start";
957
958 // Specifies a location for profiling output. This will only work if chrome has
959 // been built with the gyp variable profiling=1.
960 //
961 //   {pid} if present will be replaced by the pid of the process.
962 //   {count} if present will be incremented each time a profile is generated
963 //           for this process.
964 // The default is chrome-profile-{pid}.
965 const char kProfilingFile[]                 = "profiling-file";
966
967 // Specifies a path for the output of task-level profiling which can be loaded
968 // and viewed in about:profiler.
969 const char kProfilingOutputFile[]           = "profiling-output-file";
970
971 // Controls whether profile data is periodically flushed to a file. Normally
972 // the data gets written on exit but cases exist where chrome doesn't exit
973 // cleanly (especially when using single-process). A time in seconds can be
974 // specified.
975 const char kProfilingFlush[]                = "profiling-flush";
976
977 // Specifies a custom URL for fetching NTP promo data.
978 const char kPromoServerURL[]                = "promo-server-url";
979
980 // Forces proxy auto-detection.
981 const char kProxyAutoDetect[]               = "proxy-auto-detect";
982
983 // Specifies a list of hosts for whom we bypass proxy settings and use direct
984 // connections. Ignored if --proxy-auto-detect or --no-proxy-server are also
985 // specified. This is a comma-separated list of bypass rules. See:
986 // "net/proxy/proxy_bypass_rules.h" for the format of these rules.
987 const char kProxyBypassList[]               = "proxy-bypass-list";
988
989 // Uses the pac script at the given URL
990 const char kProxyPacUrl[]                   = "proxy-pac-url";
991
992 // Uses a specified proxy server, overrides system settings. This switch only
993 // affects HTTP and HTTPS requests.
994 const char kProxyServer[]                   = "proxy-server";
995
996 // Specifies a comma separated list of QUIC connection options to send to
997 // the server.
998 const char kQuicConnectionOptions[]         = "quic-connection-options";
999
1000 // Specifies the maximum length for a QUIC packet.
1001 const char kQuicMaxPacketLength[]           = "quic-max-packet-length";
1002
1003 // Specifies the version of QUIC to use.
1004 const char kQuicVersion[]                   = "quic-version";
1005
1006 // Chrome supports a playback and record mode.  Record mode saves *everything*
1007 // to the cache.  Playback mode reads data exclusively from the cache.  This
1008 // allows us to record a session into the cache and then replay it at will.
1009 // See also kPlaybackMode.
1010 const char kRecordMode[]                    = "record-mode";
1011
1012 // Remember user proceeds through SSL interstitials for a specified amount of
1013 // time. In particular, remember these decisions through session restart. The
1014 // time delta to remember certificates should be specified in seconds.
1015 const char kRememberCertErrorDecisions[]    = "remember-cert-error-decisions";
1016
1017 // If set, the app list will forget it has been installed on startup. Note this
1018 // doesn't prevent the app list from running, it just makes Chrome think the app
1019 // list hasn't been enabled (as in kEnableAppList) yet.
1020 const char kResetAppListInstallState[]      = "reset-app-list-install-state";
1021
1022 // Indicates the last session should be restored on startup. This overrides the
1023 // preferences value and is primarily intended for testing. The value of this
1024 // switch is the number of tabs to wait until loaded before 'load completed' is
1025 // sent to the ui_test.
1026 const char kRestoreLastSession[]            = "restore-last-session";
1027
1028 // Disable saving pages as HTML-only, disable saving pages as HTML Complete
1029 // (with a directory of sub-resources). Enable only saving pages as MHTML.
1030 // See http://crbug.com/120416 for how to remove this switch.
1031 const char kSavePageAsMHTML[]               = "save-page-as-mhtml";
1032
1033 // If present, safebrowsing only performs update when
1034 // SafeBrowsingProtocolManager::ForceScheduleNextUpdate() is explicitly called.
1035 // This is used for testing only.
1036 const char kSbDisableAutoUpdate[] = "safebrowsing-disable-auto-update";
1037
1038 // TODO(lzheng): Remove this flag once the feature works fine
1039 // (http://crbug.com/74848).
1040 //
1041 // Disables safebrowsing feature that checks download url and downloads
1042 // content's hash to make sure the content are not malicious.
1043 const char kSbDisableDownloadProtection[] =
1044     "safebrowsing-disable-download-protection";
1045
1046 // Disables safebrowsing feature that checks for blacklisted extensions.
1047 const char kSbDisableExtensionBlacklist[] =
1048     "safebrowsing-disable-extension-blacklist";
1049
1050 // Disables safebrowsing feature that provides a side-effect free whitelist.
1051 const char kSbDisableSideEffectFreeWhitelist[] =
1052     "safebrowsing-disable-side-effect-free-whitelist";
1053
1054 // Causes the process to run as a service process.
1055 const char kServiceProcess[]                = "service";
1056
1057 // Sets a token in the token service, for testing.
1058 const char kSetToken[]                      = "set-token";
1059
1060 // If true the app list will be shown.
1061 const char kShowAppList[]                   = "show-app-list";
1062
1063 // See kHideIcons.
1064 const char kShowIcons[]                     = "show-icons";
1065
1066 // Marks a renderer as the signin process.
1067 const char kSigninProcess[]                 = "signin-process";
1068
1069 // Does not show an infobar when an extension attaches to a page using
1070 // chrome.debugger page. Required to attach to extension background pages.
1071 const char kSilentDebuggerExtensionAPI[]    = "silent-debugger-extension-api";
1072
1073 // Causes Chrome to launch without opening any windows by default. Useful if
1074 // one wishes to use Chrome as an ash server.
1075 const char kSilentLaunch[]                  = "silent-launch";
1076
1077 // Simulates an update being available.
1078 const char kSimulateUpgrade[]               = "simulate-upgrade";
1079
1080 // Simulates a critical update being available.
1081 const char kSimulateCriticalUpdate[]        = "simulate-critical-update";
1082
1083 // Simulates that current version is outdated.
1084 const char kSimulateOutdated[]               = "simulate-outdated";
1085
1086 // Simulates that current version is outdated and auto-update is off.
1087 const char kSimulateOutdatedNoAU[]           = "simulate-outdated-no-au";
1088
1089 // Speculative resource prefetching.
1090 const char kSpeculativeResourcePrefetching[] =
1091     "speculative-resource-prefetching";
1092
1093 // Speculative resource prefetching is disabled.
1094 const char kSpeculativeResourcePrefetchingDisabled[] = "disabled";
1095
1096 // Speculative resource prefetching will only learn about resources that need to
1097 // be prefetched but will not prefetch them.
1098 const char kSpeculativeResourcePrefetchingLearning[] = "learning";
1099
1100 // Speculative resource prefetching is enabled.
1101 const char kSpeculativeResourcePrefetchingEnabled[] = "enabled";
1102
1103 #if defined(ENABLE_SPELLCHECK)
1104 // Enables auto correction for misspelled words.
1105 const char kEnableSpellingAutoCorrect[]     = "enable-spelling-auto-correct";
1106
1107 // Enables participation in the field trial for user feedback to spelling
1108 // service.
1109 const char kEnableSpellingFeedbackFieldTrial[] =
1110     "enable-spelling-feedback-field-trial";
1111
1112 // Specifies the URL where spelling service feedback data will be sent instead
1113 // of the default URL. This switch is for temporary testing only.
1114 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by
1115 // August 2013.
1116 const char kSpellingServiceFeedbackUrl[] = "spelling-service-feedback-url";
1117
1118 // Specifies the number of seconds between sending batches of feedback to
1119 // spelling service. The default is 30 minutes. The minimum is 5 seconds. This
1120 // switch is for temporary testing only.
1121 // TODO(rouslan): Remove this flag when feedback testing is complete. Revisit by
1122 // August 2013.
1123 const char kSpellingServiceFeedbackIntervalSeconds[] =
1124     "spelling-service-feedback-interval-seconds";
1125 #endif
1126
1127 // Specifies the maximum SSL/TLS version ("ssl3", "tls1", "tls1.1", or
1128 // "tls1.2").
1129 const char kSSLVersionMax[]                 = "ssl-version-max";
1130
1131 // Specifies the minimum SSL/TLS version ("ssl3", "tls1", "tls1.1", or
1132 // "tls1.2").
1133 const char kSSLVersionMin[]                 = "ssl-version-min";
1134
1135 // Specifies the minimum SSL/TLS version ("ssl3", "tls1", "tls1.1", or
1136 // "tls1.2") that TLS fallback will accept.
1137 const char kSSLVersionFallbackMin[]         = "ssl-version-fallback-min";
1138
1139 // These values aren't switches, but rather the values that kSSLVersionMax,
1140 // kSSLVersionMin and kSSLVersionFallbackMin can have.
1141 const char kSSLVersionSSLv3[]               = "ssl3";
1142 const char kSSLVersionTLSv1[]               = "tls1";
1143 const char kSSLVersionTLSv11[]              = "tls1.1";
1144 const char kSSLVersionTLSv12[]              = "tls1.2";
1145
1146 // Starts the browser maximized, regardless of any previous settings.
1147 const char kStartMaximized[]                = "start-maximized";
1148
1149 // Sets the supervised user ID for any loaded or newly created profile to the
1150 // given value. Pass an empty string to mark the profile as non-supervised.
1151 // Used for testing.
1152 const char kSupervisedUserId[]              = "managed-user-id";
1153
1154 // Used to authenticate requests to the Sync service for supervised users.
1155 // Setting this switch also causes Sync to be set up for a supervised user.
1156 const char kSupervisedUserSyncToken[]       = "managed-user-sync-token";
1157
1158 // This flag causes sync to retry very quickly (see polling_constants.h) the
1159 // when it encounters an error, as the first step towards exponential backoff.
1160 const char kSyncShortInitialRetryOverride[] =
1161     "sync-short-initial-retry-override";
1162
1163 // Overrides the default server used for profile sync.
1164 const char kSyncServiceURL[]                = "sync-url";
1165
1166 // Enables deferring sync backend initialization until user initiated changes
1167 // occur.
1168 const char kSyncDisableDeferredStartup[]     = "sync-disable-deferred-startup";
1169
1170 // Allows overriding the deferred init fallback timeout.
1171 const char kSyncDeferredStartupTimeoutSeconds[] =
1172     "sync-deferred-startup-timeout-seconds";
1173
1174 // Enables feature to avoid unnecessary GetUpdate requests.
1175 const char kSyncEnableGetUpdateAvoidance[]   =
1176     "sync-enable-get-update-avoidance";
1177
1178 // Disable data backup when user's not signed in.
1179 const char kSyncDisableBackup[] = "disable-sync-backup";
1180
1181 // Disable sync rollback.
1182 const char kSyncDisableRollback[] = "disable-sync-rollback";
1183
1184 // Passes the name of the current running automated test to Chrome.
1185 const char kTestName[]                      = "test-name";
1186
1187 // Disables same-origin check on HTTP resources pushed via a SPDY proxy.
1188 // The value is the host:port of the trusted proxy.
1189 const char kTrustedSpdyProxy[]              = "trusted-spdy-proxy";
1190
1191 // Experimental. Shows a dialog asking the user to try chrome. This flag is to
1192 // be used only by the upgrade process.
1193 const char kTryChromeAgain[]                = "try-chrome-again";
1194
1195 // Runs un-installation steps that were done by chrome first-run.
1196 const char kUninstall[]                     = "uninstall";
1197
1198 // Overrides per-origin quota settings to unlimited storage for any
1199 // apps/origins.  This should be used only for testing purpose.
1200 const char kUnlimitedStorage[]              = "unlimited-storage";
1201
1202 // Uses Spdy for the transport protocol instead of HTTP. This is a temporary
1203 // testing flag.
1204 const char kUseSpdy[]                       = "use-spdy";
1205
1206 // A string used to override the default user agent with a custom one.
1207 const char kUserAgent[]                     = "user-agent";
1208
1209 // Specifies the user data directory, which is where the browser will look for
1210 // all of its state.
1211 const char kUserDataDir[]                   = "user-data-dir";
1212
1213 // Examines a .crx for validity and prints the result.
1214 const char kValidateCrx[]                   = "validate-crx";
1215
1216 // Uses experimental simple cache backend if possible.
1217 const char kUseSimpleCacheBackend[]         = "use-simple-cache-backend";
1218
1219 // Specifies a custom URL for the server which reports variation data to the
1220 // client. Specifying this switch enables the Variations service on
1221 // unofficial builds. See variations_service.cc.
1222 const char kVariationsServerURL[]           = "variations-server-url";
1223
1224 // Prints version information and quits.
1225 const char kVersion[]                       = "version";
1226
1227 // Specify the initial window position: --window-position=x,y
1228 const char kWindowPosition[]                = "window-position";
1229
1230 // Specify the initial window size: --window-size=w,h
1231 const char kWindowSize[]                    = "window-size";
1232
1233 // Uses WinHTTP to fetch and evaluate PAC scripts. Otherwise the default is to
1234 // use Chromium's network stack to fetch, and V8 to evaluate.
1235 const char kWinHttpProxyResolver[]          = "winhttp-proxy-resolver";
1236
1237 #if defined(ENABLE_PLUGIN_INSTALLATION)
1238 // Specifies a custom URL for fetching plug-ins metadata. Used for testing.
1239 const char kPluginsMetadataServerURL[]      = "plugins-metadata-server-url";
1240 #endif
1241
1242 #if defined(OS_ANDROID)
1243 // Disables support for playing videos on Chromecast devices.
1244 const char kDisableCast[]                    = "disable-cast";
1245
1246 // Disables Contextual Search.
1247 const char kDisableContextualSearch[]        = "disable-contextual-search";
1248
1249 // Disables zero suggest experiment on Dev channel.
1250 const char kDisableZeroSuggest[] = "disable-zero-suggest";
1251
1252 // Enable the accessibility tab switcher.
1253 const char kEnableAccessibilityTabSwitcher[] =
1254     "enable-accessibility-tab-switcher";
1255
1256 // Enables app install alerts.
1257 const char kEnableAppInstallAlerts[]        = "enable-app-install-alerts";
1258
1259 // Enables Contextual Search.
1260 const char kEnableContextualSearch[]        = "enable-contextual-search";
1261
1262 // Enables zero suggest functionality on Dev channel, showing most visited
1263 // sites as default suggestions.
1264 const char kEnableZeroSuggestMostVisited[] =
1265     "enable-zero-suggest-most-visited";
1266
1267 // Enable zero suggest functionality on Dev channel, showing most visited
1268 // sites on non-search-result pages as default suggestions.
1269 const char kEnableZeroSuggestMostVisitedWithoutSerp[] =
1270     "enable-zero-suggest-most-visited-without-serp";
1271
1272 // Enables instant search clicks feature.
1273 const char kEnableInstantSearchClicks[] = "enable-instant-search-clicks";
1274
1275 #endif
1276
1277 #if defined(USE_ASH)
1278 const char kOpenAsh[]                       = "open-ash";
1279 #endif
1280
1281 #if defined(OS_POSIX) && !defined(OS_MACOSX) && !defined(OS_CHROMEOS)
1282 // Specifies which password store to use (detect, default, gnome, kwallet).
1283 const char kPasswordStore[]                 = "password-store";
1284 #endif
1285
1286 #if defined(OS_LINUX) && !defined(OS_CHROMEOS)
1287 // Triggers migration of user data directory to another directory
1288 // specified as a parameter. The migration is done under singleton lock,
1289 // and sanity checks are made to avoid corrupting the profile.
1290 // The browser exits after migration is complete.
1291 const char kMigrateDataDirForSxS[]          = "migrate-data-dir-for-sxs";
1292 #endif  // defined(OS_LINUX) && !defined(OS_CHROMEOS)
1293
1294 #if defined(OS_MACOSX)
1295 // Prevents Chrome from quitting when Chrome Apps are open.
1296 const char kAppsKeepChromeAliveInTests[]    = "apps-keep-chrome-alive-in-tests";
1297
1298 // Forcibly disables Lion-style on newer OSes, to allow developers to test the
1299 // older, SnowLeopard-style fullscreen.
1300 const char kDisableSystemFullscreenForTesting[] =
1301     "disable-system-fullscreen-for-testing";
1302
1303 // A process type (switches::kProcessType) that relaunches the browser. See
1304 // chrome/browser/mac/relauncher.h.
1305 const char kRelauncherProcess[]             = "relauncher";
1306
1307 #endif
1308
1309 // Use bubbles for content permissions requests instead of infobars.
1310 const char kEnablePermissionsBubbles[]      = "enable-permissions-bubbles";
1311
1312 #if defined(OS_WIN)
1313 // Fallback to XPS. By default connector uses CDD.
1314 const char kEnableCloudPrintXps[]           = "enable-cloud-print-xps";
1315
1316 // Force-enables the profile shortcut manager. This is needed for tests since
1317 // they use a custom-user-data-dir which disables this.
1318 const char kEnableProfileShortcutManager[]  = "enable-profile-shortcut-manager";
1319
1320 // For the DelegateExecute verb handler to launch Chrome in metro mode on
1321 // Windows 8 and higher.  Used when relaunching metro Chrome.
1322 const char kForceImmersive[]                = "force-immersive";
1323
1324 // For the DelegateExecute verb handler to launch Chrome in desktop mode on
1325 // Windows 8 and higher.  Used when relaunching metro Chrome.
1326 const char kForceDesktop[]                  = "force-desktop";
1327
1328 // Relaunches metro Chrome on Windows 8 and higher using a given shortcut.
1329 const char kRelaunchShortcut[]              = "relaunch-shortcut";
1330
1331 // Requests that Chrome launch the Metro viewer process via the given appid
1332 // (which is assumed to be registered as default browser) and synchronously
1333 // connect to it.
1334 const char kViewerLaunchViaAppId[]          = "viewer-launch-via-appid";
1335
1336 // Waits for the given handle to be signaled before relaunching metro Chrome on
1337 // Windows 8 and higher.
1338 const char kWaitForMutex[]                  = "wait-for-mutex";
1339
1340 // Indicates that chrome was launched to service a search request in Windows 8.
1341 const char kWindows8Search[]                = "windows8-search";
1342 #endif
1343
1344 #if defined(ENABLE_PRINT_PREVIEW) && !defined(OFFICIAL_BUILD)
1345 // Enables support to debug printing subsystem.
1346 const char kDebugPrint[] = "debug-print";
1347 #endif
1348
1349 #ifndef NDEBUG
1350 // Enables overriding the path of file manager extension.
1351 const char kFileManagerExtensionPath[]      = "filemgr-ext-path";
1352 #endif
1353
1354 bool AboutInSettingsEnabled() {
1355   return SettingsWindowEnabled() &&
1356       !CommandLine::ForCurrentProcess()->HasSwitch(
1357           ::switches::kDisableAboutInSettings);
1358 }
1359
1360 bool SettingsWindowEnabled() {
1361 #if defined(OS_CHROMEOS)
1362   return !CommandLine::ForCurrentProcess()->HasSwitch(
1363       ::switches::kDisableSettingsWindow);
1364 #else
1365   return CommandLine::ForCurrentProcess()->HasSwitch(
1366       ::switches::kEnableSettingsWindow);
1367 #endif
1368 }
1369
1370 #if defined(OS_CHROMEOS)
1371 bool PowerOverlayEnabled() {
1372   return CommandLine::ForCurrentProcess()->HasSwitch(
1373       ::switches::kEnablePowerOverlay);
1374 }
1375 #endif
1376
1377 // -----------------------------------------------------------------------------
1378 // DO NOT ADD YOUR CRAP TO THE BOTTOM OF THIS FILE.
1379 //
1380 // You were going to just dump your switches here, weren't you? Instead, please
1381 // put them in alphabetical order above, or in order inside the appropriate
1382 // ifdef at the bottom. The order should match the header.
1383 // -----------------------------------------------------------------------------
1384
1385 }  // namespace switches