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