Cast: Stop logging kVideoFrameSentToEncoder and rename a couple events.
[chromium-blink-merge.git] / content / public / common / content_switches.cc
blob7bfbf039fc146153e7f3c548740766007fb5ce06
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.
5 #include "content/public/common/content_switches.h"
7 #include "base/command_line.h"
9 namespace switches {
11 // The number of MSAA samples for canvas2D. Requires MSAA support by GPU to
12 // have an effect. 0 disables MSAA.
13 const char kAcceleratedCanvas2dMSAASampleCount[] = "canvas-msaa-sample-count";
15 // By default, file:// URIs cannot read other file:// URIs. This is an
16 // override for developers who need the old behavior for testing.
17 const char kAllowFileAccessFromFiles[] = "allow-file-access-from-files";
19 // Allows frames with an https origin to use WebSockets with an insecure URL
20 // (ws://).
21 const char kAllowInsecureWebSocketFromHttpsOrigin[] =
22 "allow-insecure-websocket-from-https-origin";
24 // Allows loopback interface to be added in network list for peer connection.
25 const char kAllowLoopbackInPeerConnection[] =
26 "allow-loopback-in-peer-connection";
28 // Enables the sandboxed processes to run without a job object assigned to them.
29 // This flag is required to allow Chrome to run in RemoteApps or Citrix. This
30 // flag can reduce the security of the sandboxed processes and allow them to do
31 // certain API calls like shut down Windows or access the clipboard. Also we
32 // lose the chance to kill some processes until the outer job that owns them
33 // finishes.
34 const char kAllowNoSandboxJob[] = "allow-no-sandbox-job";
36 // Allows debugging of sandboxed processes (see zygote_main_linux.cc).
37 const char kAllowSandboxDebugging[] = "allow-sandbox-debugging";
39 // The same as kAuditHandles except all handles are enumerated.
40 const char kAuditAllHandles[] = "enable-handle-auditing-all";
42 // Enumerates and prints a child process' most dangerous handles when it
43 // is terminated.
44 const char kAuditHandles[] = "enable-handle-auditing";
46 // Choose which logging channels in blink platform to activate. See
47 // Logging.cpp in blink's Source/platform for a list of available channels.
48 const char kBlinkPlatformLogChannels[] = "blink-platform-log-channels";
50 // Block cross-site documents (i.e., HTML/XML/JSON) from being loaded in
51 // subresources when a document is not supposed to read them. This will later
52 // allow us to block them from the entire renderer process when site isolation
53 // is enabled.
54 const char kBlockCrossSiteDocuments[] = "block-cross-site-documents";
56 // Causes the browser process to throw an assertion on startup.
57 const char kBrowserAssertTest[] = "assert-test";
59 // Causes the browser process to crash on startup.
60 const char kBrowserCrashTest[] = "crash-test";
62 // Path to the exe to run for the renderer and plugin subprocesses.
63 const char kBrowserSubprocessPath[] = "browser-subprocess-path";
65 // Dumps extra logging about plugin loading to the log file.
66 const char kDebugPluginLoading[] = "debug-plugin-loading";
68 // Sets the tile size used by composited layers.
69 const char kDefaultTileWidth[] = "default-tile-width";
70 const char kDefaultTileHeight[] = "default-tile-height";
72 // Disable antialiasing on 2d canvas.
73 const char kDisable2dCanvasAntialiasing[] = "disable-canvas-aa";
75 // Disables client-visible 3D APIs, in particular WebGL and Pepper 3D.
76 // This is controlled by policy and is kept separate from the other
77 // enable/disable switches to avoid accidentally regressing the policy
78 // support for controlling access to these APIs.
79 const char kDisable3DAPIs[] = "disable-3d-apis";
81 // Disable gpu-accelerated 2d canvas.
82 const char kDisableAccelerated2dCanvas[] = "disable-accelerated-2d-canvas";
84 // Disables accelerated compositing for backgrounds of root layers with
85 // background-attachment: fixed.
86 const char kDisableAcceleratedFixedRootBackground[] =
87 "disable-accelerated-fixed-root-background";
89 // Disables accelerated compositing for overflow scroll.
90 const char kDisableAcceleratedOverflowScroll[] =
91 "disable-accelerated-overflow-scroll";
93 // Disables layer squashing.
94 const char kDisableLayerSquashing[] =
95 "disable-layer-squashing";
97 // Disables hardware acceleration of video decode, where available.
98 const char kDisableAcceleratedVideoDecode[] =
99 "disable-accelerated-video-decode";
101 // Disables the alternate window station for the renderer.
102 const char kDisableAltWinstation[] = "disable-winsta";
104 // Disable the ApplicationCache.
105 const char kDisableApplicationCache[] = "disable-application-cache";
107 // Disable limits on the number of backing stores. Can prevent blinking for
108 // users with many windows/tabs and lots of memory.
109 const char kDisableBackingStoreLimit[] = "disable-backing-store-limit";
111 // See comment for kEnableCompositingForFixedPosition.
112 const char kDisableCompositingForFixedPosition[] =
113 "disable-fixed-position-compositing";
115 // See comment for kEnableCompositingForTransition.
116 const char kDisableCompositingForTransition[] =
117 "disable-transition-compositing";
119 // Disables HTML5 DB support.
120 const char kDisableDatabases[] = "disable-databases";
122 // Disables delegated renderer.
123 const char kDisableDelegatedRenderer[] = "disable-delegated-renderer";
125 // Disables desktop notifications (default enabled on windows).
126 const char kDisableDesktopNotifications[] = "disable-desktop-notifications";
128 // Disables experimental navigator content utils implementation.
129 const char kDisableNavigatorContentUtils[] =
130 "disable-navigator-content-utils";
132 // Handles URL requests by NPAPI plugins through the renderer.
133 const char kDisableDirectNPAPIRequests[] = "disable-direct-npapi-requests";
135 // Disable the per-domain blocking for 3D APIs after GPU reset.
136 // This switch is intended only for tests.
137 extern const char kDisableDomainBlockingFor3DAPIs[] =
138 "disable-domain-blocking-for-3d-apis";
140 // Disable running the SharedWorker inside the renderer process.
141 const char kDisableEmbeddedSharedWorker[] = "disable-embedded-shared-worker";
143 // Disable experimental WebGL support.
144 const char kDisableExperimentalWebGL[] = "disable-webgl";
146 // Disable the fast text autosizing implementation.
147 const char kDisableFastTextAutosizing[] = "disable-fast-text-autosizing";
149 // Disable FileSystem API.
150 const char kDisableFileSystem[] = "disable-file-system";
152 // Disables sending filters (SkImageFilter objects) between processes over IPC
153 const char kDisableFiltersOverIPC[] = "disable-filters-over-ipc";
155 const char kDisableFixedPositionCreatesStackingContext[]
156 = "disable-fixed-position-creates-stacking-context";
158 // Disable 3D inside of flapper.
159 const char kDisableFlash3d[] = "disable-flash-3d";
161 // Disable Stage3D inside of flapper.
162 const char kDisableFlashStage3d[] = "disable-flash-stage3d";
164 const char kDisableGestureTapHighlight[] = "disable-gesture-tap-highlight";
166 // Disable GL multisampling.
167 const char kDisableGLMultisampling[] = "disable-gl-multisampling";
169 // Disables GPU hardware acceleration. If software renderer is not in place,
170 // then the GPU process won't launch.
171 const char kDisableGpu[] = "disable-gpu";
173 // Prevent the compositor from using its GPU implementation.
174 const char kDisableGpuCompositing[] = "disable-gpu-compositing";
176 // Disable the limit on the number of times the GPU process may be restarted
177 // This switch is intended only for tests.
178 extern const char kDisableGpuProcessCrashLimit[] =
179 "disable-gpu-process-crash-limit";
181 // Disable GPU rasterization, i.e. rasterize on the CPU only.
182 // Overrides the kEnableGpuRasterization and kForceGpuRasterization flags.
183 const char kDisableGpuRasterization[] = "disable-gpu-rasterization";
185 // When using CPU rasterizing disable low resolution tiling. This uses
186 // less power, particularly during animations, but more white may be seen
187 // during fast scrolling especially on slower devices.
188 const char kDisableLowResTiling[] = "disable-low-res-tiling";
190 // Disable the GPU process sandbox.
191 const char kDisableGpuSandbox[] = "disable-gpu-sandbox";
193 // Disable the thread that crashes the GPU process if it stops responding to
194 // messages.
195 const char kDisableGpuWatchdog[] = "disable-gpu-watchdog";
197 // Suppresses hang monitor dialogs in renderer processes. This may allow slow
198 // unload handlers on a page to prevent the tab from closing, but the Task
199 // Manager can be used to terminate the offending process in this case.
200 const char kDisableHangMonitor[] = "disable-hang-monitor";
202 // Disable the RenderThread's HistogramCustomizer.
203 const char kDisableHistogramCustomizer[] = "disable-histogram-customizer";
205 // Paint content on the main thread instead of the compositor thread.
206 // Overrides the kEnableImplSidePainting flag.
207 const char kDisableImplSidePainting[] = "disable-impl-side-painting";
209 // Prevent Java from running.
210 const char kDisableJava[] = "disable-java";
212 // Don't execute JavaScript (browser JS like the new tab page still runs).
213 const char kDisableJavaScript[] = "disable-javascript";
215 // Don't kill a child process when it sends a bad IPC message. Apart
216 // from testing, it is a bad idea from a security perspective to enable
217 // this switch.
218 const char kDisableKillAfterBadIPC[] = "disable-kill-after-bad-ipc";
220 // Disables prefixed Encrypted Media API (e.g. webkitGenerateKeyRequest()).
221 const char kDisablePrefixedEncryptedMedia[] =
222 "disable-prefixed-encrypted-media";
224 // Disables LCD text.
225 const char kDisableLCDText[] = "disable-lcd-text";
227 // Disable LocalStorage.
228 const char kDisableLocalStorage[] = "disable-local-storage";
230 // Force logging to be disabled. Logging is enabled by default in debug
231 // builds.
232 const char kDisableLogging[] = "disable-logging";
234 // Disables Media Source API (i.e., the MediaSource object).
235 const char kDisableMediaSource[] = "disable-media-source";
237 // Disable Pepper3D.
238 const char kDisablePepper3d[] = "disable-pepper-3d";
240 // Disables compositor-accelerated touch-screen pinch gestures.
241 const char kDisablePinch[] = "disable-pinch";
243 // Prevent plugins from running.
244 const char kDisablePlugins[] = "disable-plugins";
246 // Disable discovering third-party plug-ins. Effectively loading only
247 // ones shipped with the browser plus third-party ones as specified by
248 // --extra-plugin-dir and --load-plugin switches.
249 const char kDisablePluginsDiscovery[] = "disable-plugins-discovery";
251 // Disables remote web font support. SVG font should always work whether this
252 // option is specified or not.
253 const char kDisableRemoteFonts[] = "disable-remote-fonts";
255 // Turns off the accessibility in the renderer.
256 const char kDisableRendererAccessibility[] = "disable-renderer-accessibility";
258 // Disables the new layout/paint system which paints after layout is complete.
259 const char kDisableRepaintAfterLayout[] = "disable-repaint-after-layout";
261 // Disable the seccomp filter sandbox (seccomp-bpf) (Linux only).
262 const char kDisableSeccompFilterSandbox[] = "disable-seccomp-filter-sandbox";
264 // Disable session storage.
265 const char kDisableSessionStorage[] = "disable-session-storage";
267 // Disable the setuid sandbox (Linux only).
268 const char kDisableSetuidSandbox[] = "disable-setuid-sandbox";
270 // Enable shared workers. Functionality not yet complete.
271 const char kDisableSharedWorkers[] = "disable-shared-workers";
273 // Disables site-specific tailoring to compatibility issues in WebKit.
274 const char kDisableSiteSpecificQuirks[] = "disable-site-specific-quirks";
276 // Disable smooth scrolling for testing.
277 const char kDisableSmoothScrolling[] = "disable-smooth-scrolling";
279 // Disables the use of a 3D software rasterizer.
280 const char kDisableSoftwareRasterizer[] = "disable-software-rasterizer";
282 // Disables speech input.
283 const char kDisableSpeechInput[] = "disable-speech-input";
285 // Disable False Start in SSL and TLS connections.
286 const char kDisableSSLFalseStart[] = "disable-ssl-false-start";
288 // Disable multithreaded GPU compositing of web content.
289 const char kDisableThreadedCompositing[] = "disable-threaded-compositing";
291 // Disable accelerated overflow scrolling in corner cases (that would not be
292 // handled by enable-accelerated-overflow-scroll).
293 const char kDisableUniversalAcceleratedOverflowScroll[] =
294 "disable-universal-accelerated-overflow-scroll";
296 // Don't enforce the same-origin policy. (Used by people testing their sites.)
297 const char kDisableWebSecurity[] = "disable-web-security";
299 // Disables support for XSLT.
300 const char kDisableXSLT[] = "disable-xslt";
302 // Disables Blink's XSSAuditor. The XSSAuditor mitigates reflective XSS.
303 const char kDisableXSSAuditor[] = "disable-xss-auditor";
305 // Disable rasterizer that writes directly to GPU memory associated with tiles.
306 // Overrides the kEnableZeroCopy flag.
307 const char kDisableZeroCopy[] = "disable-zero-copy";
309 // Specifies if the |DOMAutomationController| needs to be bound in the
310 // renderer. This binding happens on per-frame basis and hence can potentially
311 // be a performance bottleneck. One should only enable it when automating dom
312 // based tests.
313 const char kDomAutomationController[] = "dom-automation";
315 // Enable bleeding-edge code to make Chrome draw content faster. The changes
316 // behind this path are very likely to break lots of content.
317 // ** DO NOT use this flag unless you know what you are doing. **
318 const char kEnableBleedingEdgeRenderingFastPaths[] =
319 "enable-bleeding-edge-rendering-fast-paths";
321 // Disable deferred image filters.
322 const char kDisableDeferredFilters[] = "disable-deferred-filters";
324 // Enables accelerated compositing for backgrounds of root layers with
325 // background-attachment: fixed.
326 const char kEnableAcceleratedFixedRootBackground[] =
327 "enable-accelerated-fixed-root-background";
329 // Enables accelerated compositing for overflow scroll. Promotes eligible
330 // overflow:scroll elements to layers to enable accelerated scrolling for them.
331 const char kEnableAcceleratedOverflowScroll[] =
332 "enable-accelerated-overflow-scroll";
334 // Enables LCD text.
335 const char kEnableLCDText[] = "enable-lcd-text";
337 // Enables experimental feature that maps multiple RenderLayers to
338 // one composited layer to avoid pathological layer counts.
339 const char kEnableLayerSquashing[] =
340 "enable-layer-squashing";
342 // Enable experimental container node culling.
343 const char kEnableContainerCulling[] = "enable-container-culling";
345 // Turns on extremely verbose logging of accessibility events.
346 const char kEnableAccessibilityLogging[] = "enable-accessibility-logging";
348 // Use a BeginFrame signal from browser to renderer to schedule rendering.
349 const char kEnableBeginFrameScheduling[] = "enable-begin-frame-scheduling";
351 // Enable the creation of compositing layers for fixed position
352 // elements. Three options are needed to support four possible scenarios:
353 // 1. Default (disabled)
354 // 2. Enabled always (to allow dogfooding)
355 // 3. Disabled always (to give safety fallback for users)
356 // 4. Enabled only if we detect a highDPI display
358 // Option #4 may soon be the default, because the feature is needed soon for
359 // high DPI, but cannot be used (yet) for low DPI. Options #2 and #3 will
360 // override Option #4.
361 const char kEnableCompositingForFixedPosition[] =
362 "enable-fixed-position-compositing";
364 // Enable/Disable the creation of compositing layers for RenderLayers with a
365 // transition on a property that supports accelerated animation (that is,
366 // opacity, -webkit-transform, and -webkit-filter), even when no animation is
367 // running. These options allow for three possible scenarios:
368 // 1. Default (enabled only if we dectect a highDPI display)
369 // 2. Enabled always.
370 // 3. Disabled always.
371 const char kEnableCompositingForTransition[] =
372 "enable-transition-compositing";
374 // Defer image decoding in WebKit until painting.
375 const char kEnableDeferredImageDecoding[] = "enable-deferred-image-decoding";
377 // Enables delegated renderer.
378 const char kEnableDelegatedRenderer[] = "enable-delegated-renderer";
380 // Enables restarting interrupted downloads.
381 const char kEnableDownloadResumption[] = "enable-download-resumption";
383 // Enables support for Encrypted Media Extensions (e.g. MediaKeys).
384 const char kEnableEncryptedMedia[] = "enable-encrypted-media";
386 // Enable experimental canvas features, e.g. canvas 2D context attributes
387 const char kEnableExperimentalCanvasFeatures[] =
388 "enable-experimental-canvas-features";
390 // Enables Web Platform features that are in development.
391 const char kEnableExperimentalWebPlatformFeatures[] =
392 "enable-experimental-web-platform-features";
394 // By default, cookies are not allowed on file://. They are needed for testing,
395 // for example page cycler and layout tests. See bug 1157243.
396 const char kEnableFileCookies[] = "enable-file-cookies";
398 // Enable the fast text autosizing implementation.
399 const char kEnableFastTextAutosizing[] = "enable-fast-text-autosizing";
401 const char kEnableFixedPositionCreatesStackingContext[]
402 = "enable-fixed-position-creates-stacking-context";
404 // Enable Gesture Tap Highlight
405 const char kEnableGestureTapHighlight[] = "enable-gesture-tap-highlight";
407 // Enables TRACE for GL calls in the renderer.
408 const char kEnableGpuClientTracing[] = "enable-gpu-client-tracing";
410 // Allow heuristics to determine when a layer tile should be drawn with the
411 // Skia GPU backend. Only valid with GPU accelerated compositing +
412 // impl-side painting.
413 const char kEnableGpuRasterization[] = "enable-gpu-rasterization";
415 // When using CPU rasterizing generate low resolution tiling. Low res
416 // tiles may be displayed during fast scrolls especially on slower devices.
417 const char kEnableLowResTiling[] = "enable-low-res-tiling";
419 // See comment for kEnableCompositingForFixedPosition.
420 const char kEnableHighDpiCompositingForFixedPosition[] =
421 "enable-high-dpi-fixed-position-compositing";
423 #if defined(OS_WIN)
424 // Disable the Legacy Window which corresponds to the size of the WebContents.
425 const char kDisableLegacyIntermediateWindow[] = "disable-legacy-window";
427 // Enables the DirectWrite font rendering system on windows.
428 const char kEnableDirectWrite[] = "enable-direct-write";
430 // Use high resolution timers for TimeTicks.
431 const char kEnableHighResolutionTime[] = "enable-high-resolution-time";
432 #endif
434 // Paint content on the compositor thread instead of the main thread.
435 const char kEnableImplSidePainting[] = "enable-impl-side-painting";
437 // Enables support for inband text tracks in media content.
438 const char kEnableInbandTextTracks[] = "enable-inband-text-tracks";
440 // Force logging to be enabled. Logging is disabled by default in release
441 // builds.
442 const char kEnableLogging[] = "enable-logging";
444 // Enables the memory benchmarking extension
445 const char kEnableMemoryBenchmarking[] = "enable-memory-benchmarking";
447 // On Windows, converts the page to the currently-installed monitor profile.
448 // This does NOT enable color management for images. The source is still
449 // assumed to be sRGB.
450 const char kEnableMonitorProfile[] = "enable-monitor-profile";
452 // Enables use of cache if offline, even if it's stale
453 const char kEnableOfflineCacheAccess[] = "enable-offline-cache-access";
455 // Enable rasterizer that writes directly to GPU memory.
456 const char kEnableOneCopy[] = "enable-one-copy";
458 // Enables use of hardware overlay for fullscreen video playback. Android only.
459 const char kEnableOverlayFullscreenVideo[] = "enable-overlay-fullscreen-video";
461 // Disables blink subtitle and media control on top of overlay fullscreen video.
462 const char kDisableOverlayFullscreenVideoSubtitle[] =
463 "disable-overlay-fullscreen-video-subtitle";
465 // Forward overscroll event data from the renderer to the browser.
466 const char kEnableOverscrollNotifications[] = "enable-overscroll-notifications";
468 // Enables compositor-accelerated touch-screen pinch gestures.
469 const char kEnablePinch[] = "enable-pinch";
471 // Make the values returned to window.performance.memory more granular and more
472 // up to date in shared worker. Without this flag, the memory information is
473 // still available, but it is bucketized and updated less frequently. This flag
474 // also applys to workers.
475 const char kEnablePreciseMemoryInfo[] = "enable-precise-memory-info";
477 // Enable caching of pre-parsed JS script data. See http://crbug.com/32407.
478 const char kEnablePreparsedJsCaching[] = "enable-preparsed-js-caching";
480 // Enable privileged WebGL extensions; without this switch such extensions are
481 // available only to Chrome extensions.
482 const char kEnablePrivilegedWebGLExtensions[] =
483 "enable-privileged-webgl-extensions";
485 // Enables the CSS multicol implementation that uses the regions implementation.
486 const char kEnableRegionBasedColumns[] =
487 "enable-region-based-columns";
489 // Enables the new layout/paint system which paints after layout is complete.
490 const char kEnableRepaintAfterLayout[] =
491 "enable-repaint-after-layout";
493 // Enables targeted style recalculation optimizations.
494 const char kEnableTargetedStyleRecalc[] =
495 "enable-targeted-style-recalc";
497 // Cause the OS X sandbox write to syslog every time an access to a resource
498 // is denied by the sandbox.
499 const char kEnableSandboxLogging[] = "enable-sandbox-logging";
501 // Enables seccomp-bpf support for Android. Requires experimental kernel
502 // support. <http://crbug.com/166704>
503 const char kEnableSeccompFilterSandbox[] =
504 "enable-seccomp-filter-sandbox";
506 // Enables the Skia benchmarking extension
507 const char kEnableSkiaBenchmarking[] = "enable-skia-benchmarking";
509 // On platforms that support it, enables smooth scroll animation.
510 const char kEnableSmoothScrolling[] = "enable-smooth-scrolling";
512 // Enable spatial navigation
513 const char kEnableSpatialNavigation[] = "enable-spatial-navigation";
515 // Enables the synthesis part of the Web Speech API.
516 const char kEnableSpeechSynthesis[] = "enable-speech-synthesis";
518 // Enables StatsTable, logging statistics to a global named shared memory table.
519 const char kEnableStatsTable[] = "enable-stats-table";
521 // Experimentally ensures that each renderer process:
522 // 1) Only handles rendering for pages from a single site, apart from iframes.
523 // (Note that a page can reference content from multiple origins due to images,
524 // JavaScript files, etc. Cross-site iframes are also loaded in-process.)
525 // 2) Only has authority to see or use cookies for the page's top-level origin.
526 // (So if a.com iframes b.com, the b.com network request will be sent without
527 // cookies.)
528 // This is expected to break compatibility with many pages for now. Unlike the
529 // --site-per-process flag, this allows cross-site iframes, but it blocks all
530 // cookies on cross-site requests.
531 const char kEnableStrictSiteIsolation[] = "enable-strict-site-isolation";
533 // Enable support for ServiceWorker. See
534 // https://github.com/slightlyoff/ServiceWorker for more information.
535 const char kEnableServiceWorker[] = "enable-service-worker";
537 // Enable support for sync events in ServiceWorkers.
538 const char kEnableServiceWorkerSync[] = "enable-service-worker-sync";
540 // Enable use of experimental TCP sockets API for sending data in the
541 // SYN packet.
542 const char kEnableTcpFastOpen[] = "enable-tcp-fastopen";
544 // Enable multithreaded GPU compositing of web content.
545 const char kEnableThreadedCompositing[] = "enable-threaded-compositing";
547 // Enable accelerated overflow scrolling in all cases.
548 const char kEnableUniversalAcceleratedOverflowScroll[] =
549 "enable-universal-accelerated-overflow-scroll";
551 // Enable screen capturing support for MediaStream API.
552 const char kEnableUserMediaScreenCapturing[] =
553 "enable-usermedia-screen-capturing";
555 // Enables the use of the @viewport CSS rule, which allows
556 // pages to control aspects of their own layout. This also turns on touch-screen
557 // pinch gestures.
558 const char kEnableViewport[] = "enable-viewport";
560 // Enables the use of the legacy viewport meta tag. Turning this on also
561 // turns on the @viewport CSS rule
562 const char kEnableViewportMeta[] = "enable-viewport-meta";
564 // Resizes of the main frame are the caused by changing between landscape
565 // and portrait mode (i.e. Android) so the page should be rescaled to fit
566 const char kMainFrameResizesAreOrientationChanges[] =
567 "main-frame-resizes-are-orientation-changes";
569 // Enable the Vtune profiler support.
570 const char kEnableVtune[] = "enable-vtune-support";
572 // Enable SVG Animations on the Web Animations model.
573 const char kEnableWebAnimationsSVG[] = "enable-web-animations-svg";
575 // Enables WebGL extensions not yet approved by the community.
576 const char kEnableWebGLDraftExtensions[] = "enable-webgl-draft-extensions";
578 // Enables Web MIDI API.
579 const char kEnableWebMIDI[] = "enable-web-midi";
581 // Enable rasterizer that writes directly to GPU memory associated with tiles.
582 const char kEnableZeroCopy[] = "enable-zero-copy";
584 // Load NPAPI plugins from the specified directory.
585 const char kExtraPluginDir[] = "extra-plugin-dir";
587 // Enable force_compositing_mode in layout tests.
588 const char kForceCompositingMode[] = "force-compositing-mode";
590 // Some field trials may be randomized in the browser, and the randomly selected
591 // outcome needs to be propagated to the renderer. For instance, this is used
592 // to modify histograms recorded in the renderer, or to get the renderer to
593 // also set of its state (initialize, or not initialize components) to match the
594 // experiment(s). The option is also useful for forcing field trials when
595 // testing changes locally. The argument is a list of name and value pairs,
596 // separated by slashes. See FieldTrialList::CreateTrialsFromString() in
597 // field_trial.h for details.
598 const char kForceFieldTrials[] = "force-fieldtrials";
600 // Always use the Skia GPU backend for drawing layer tiles. Only valid with GPU
601 // accelerated compositing + impl-side painting. Overrides the
602 // kEnableGpuRasterization flag.
603 const char kForceGpuRasterization[] = "force-gpu-rasterization";
605 // Force renderer accessibility to be on instead of enabling it on demand when
606 // a screen reader is detected. The disable-renderer-accessibility switch
607 // overrides this if present.
608 const char kForceRendererAccessibility[] = "force-renderer-accessibility";
610 // Passes gpu device_id from browser process to GPU process.
611 const char kGpuDeviceID[] = "gpu-device-id";
613 // Passes gpu driver_vendor from browser process to GPU process.
614 const char kGpuDriverVendor[] = "gpu-driver-vendor";
616 // Passes gpu driver_version from browser process to GPU process.
617 const char kGpuDriverVersion[] = "gpu-driver-version";
619 // Extra command line options for launching the GPU process (normally used
620 // for debugging). Use like renderer-cmd-prefix.
621 const char kGpuLauncher[] = "gpu-launcher";
623 // Makes this process a GPU sub-process.
624 const char kGpuProcess[] = "gpu-process";
626 // Allow shmat system call in GPU sandbox.
627 const char kGpuSandboxAllowSysVShm[] = "gpu-sandbox-allow-sysv-shm";
629 // Makes GPU sandbox failures fatal.
630 const char kGpuSandboxFailuresFatal[] = "gpu-sandbox-failures-fatal";
632 // Allow GPU sandbox to start later
633 const char kGpuSandboxStartAfterInitialization[] =
634 "gpu-sandbox-start-after-initialization";
636 // Causes the GPU process to display a dialog on launch.
637 const char kGpuStartupDialog[] = "gpu-startup-dialog";
639 // Passes gpu vendor_id from browser process to GPU process.
640 const char kGpuVendorID[] = "gpu-vendor-id";
642 // These mappings only apply to the host resolver.
643 const char kHostResolverRules[] = "host-resolver-rules";
645 // Ignores certificate-related errors.
646 const char kIgnoreCertificateErrors[] = "ignore-certificate-errors";
648 // Ignores GPU blacklist.
649 const char kIgnoreGpuBlacklist[] = "ignore-gpu-blacklist";
651 // Run the GPU process as a thread in the browser process.
652 const char kInProcessGPU[] = "in-process-gpu";
654 // Specifies the flags passed to JS engine
655 const char kJavaScriptFlags[] = "js-flags";
657 // Load an NPAPI plugin from the specified path.
658 const char kLoadPlugin[] = "load-plugin";
660 // Logs GPU control list decisions when enforcing blacklist rules.
661 const char kLogGpuControlListDecisions[] = "log-gpu-control-list-decisions";
663 // Sets the minimum log level. Valid values are from 0 to 3:
664 // INFO = 0, WARNING = 1, LOG_ERROR = 2, LOG_FATAL = 3.
665 const char kLoggingLevel[] = "log-level";
667 // Enables saving net log events to a file and sets the file name to use.
668 const char kLogNetLog[] = "log-net-log";
670 // Make plugin processes log their sent and received messages to VLOG(1).
671 const char kLogPluginMessages[] = "log-plugin-messages";
673 // Sets the width and height above which a composited layer will get tiled.
674 const char kMaxUntiledLayerHeight[] = "max-untiled-layer-height";
675 const char kMaxUntiledLayerWidth[] = "max-untiled-layer-width";
677 // Sample memory usage with high frequency and store the results to the
678 // Renderer.Memory histogram. Used in memory tests.
679 const char kMemoryMetrics[] = "memory-metrics";
681 // Mutes audio sent to the audio device so it is not audible during
682 // automated testing.
683 const char kMuteAudio[] = "mute-audio";
685 // Don't send HTTP-Referer headers.
686 const char kNoReferrers[] = "no-referrers";
688 // Disables the sandbox for all process types that are normally sandboxed.
689 const char kNoSandbox[] = "no-sandbox";
691 // Number of worker threads used to rasterize content.
692 const char kNumRasterThreads[] = "num-raster-threads";
694 // Enables or disables history navigation in response to horizontal overscroll.
695 // Set the value to '1' to enable the feature, and set to '0' to disable.
696 // Defaults to enabled.
697 const char kOverscrollHistoryNavigation[] =
698 "overscroll-history-navigation";
700 // Specifies a command that should be used to launch the plugin process. Useful
701 // for running the plugin process through purify or quantify. Ex:
702 // --plugin-launcher="path\to\purify /Run=yes"
703 const char kPluginLauncher[] = "plugin-launcher";
705 // Tells the plugin process the path of the plugin to load
706 const char kPluginPath[] = "plugin-path";
708 // Causes the process to run as a plugin subprocess.
709 const char kPluginProcess[] = "plugin";
711 // Causes the plugin process to display a dialog on launch.
712 const char kPluginStartupDialog[] = "plugin-startup-dialog";
714 // Argument to the process type that indicates a PPAPI broker process type.
715 const char kPpapiBrokerProcess[] = "ppapi-broker";
717 // "Command-line" arguments for the PPAPI Flash; used for debugging options.
718 const char kPpapiFlashArgs[] = "ppapi-flash-args";
720 // Runs PPAPI (Pepper) plugins in-process.
721 const char kPpapiInProcess[] = "ppapi-in-process";
723 // Like kPluginLauncher for PPAPI plugins.
724 const char kPpapiPluginLauncher[] = "ppapi-plugin-launcher";
726 // Argument to the process type that indicates a PPAPI plugin process type.
727 const char kPpapiPluginProcess[] = "ppapi";
729 // Causes the PPAPI sub process to display a dialog on launch. Be sure to use
730 // --no-sandbox as well or the sandbox won't allow the dialog to display.
731 const char kPpapiStartupDialog[] = "ppapi-startup-dialog";
733 // Runs a single process for each site (i.e., group of pages from the same
734 // registered domain) the user visits. We default to using a renderer process
735 // for each site instance (i.e., group of pages from the same registered
736 // domain with script connections to each other).
737 const char kProcessPerSite[] = "process-per-site";
739 // Runs each set of script-connected tabs (i.e., a BrowsingInstance) in its own
740 // renderer process. We default to using a renderer process for each
741 // site instance (i.e., group of pages from the same registered domain with
742 // script connections to each other).
743 const char kProcessPerTab[] = "process-per-tab";
745 // The value of this switch determines whether the process is started as a
746 // renderer or plugin host. If it's empty, it's the browser.
747 const char kProcessType[] = "type";
749 // Enables more web features over insecure connections. Designed to be used
750 // for testing purposes only.
751 const char kReduceSecurityForTesting[] = "reduce-security-for-testing";
753 // Register Pepper plugins (see pepper_plugin_list.cc for its format).
754 const char kRegisterPepperPlugins[] = "register-pepper-plugins";
756 // Enables remote debug over HTTP on the specified port.
757 const char kRemoteDebuggingPort[] = "remote-debugging-port";
759 // Causes the renderer process to throw an assertion on launch.
760 const char kRendererAssertTest[] = "renderer-assert-test";
762 // On POSIX only: the contents of this flag are prepended to the renderer
763 // command line. Useful values might be "valgrind" or "xterm -e gdb --args".
764 const char kRendererCmdPrefix[] = "renderer-cmd-prefix";
766 // Causes the process to run as renderer instead of as browser.
767 const char kRendererProcess[] = "renderer";
769 // Overrides the default/calculated limit to the number of renderer processes.
770 // Very high values for this setting can lead to high memory/resource usage
771 // or instability.
772 const char kRendererProcessLimit[] = "renderer-process-limit";
774 // Causes the renderer process to display a dialog on launch.
775 const char kRendererStartupDialog[] = "renderer-startup-dialog";
777 // Causes the process to run as a sandbox IPC subprocess.
778 const char kSandboxIPCProcess[] = "sandbox-ipc";
780 // Enables or disables scroll end effect in response to vertical overscroll.
781 // Set the value to '1' to enable the feature, and set to '0' to disable.
782 // Defaults to disabled.
783 const char kScrollEndEffect[] = "scroll-end-effect";
785 // Visibly render a border around paint rects in the web page to help debug
786 // and study painting behavior.
787 const char kShowPaintRects[] = "show-paint-rects";
789 // Runs the renderer and plugins in the same process as the browser
790 const char kSingleProcess[] = "single-process";
792 // Experimentally enforces a one-site-per-process security policy.
793 // All cross-site navigations force process swaps, and we can restrict a
794 // renderer process's access rights based on its site. For details, see:
795 // http://www.chromium.org/developers/design-documents/site-isolation
797 // Unlike --enable-strict-site-isolation (which allows cross-site iframes),
798 // this flag does not affect which cookies are attached to cross-site requests.
799 // Support is being added to render cross-site iframes in a different process
800 // than their parent pages.
801 const char kSitePerProcess[] = "site-per-process";
803 // Skip gpu info collection, blacklist loading, and blacklist auto-update
804 // scheduling at browser startup time.
805 // Therefore, all GPU features are available, and about:gpu page shows empty
806 // content. The switch is intended only for layout tests.
807 // TODO(gab): Get rid of this switch entirely.
808 const char kSkipGpuDataLoading[] = "skip-gpu-data-loading";
810 // Specifies if the browser should start in fullscreen mode, like if the user
811 // had pressed F11 right after startup.
812 const char kStartFullscreen[] = "start-fullscreen";
814 // Specifies if the |StatsCollectionController| needs to be bound in the
815 // renderer. This binding happens on per-frame basis and hence can potentially
816 // be a performance bottleneck. One should only enable it when running a test
817 // that needs to access the provided statistics.
818 const char kStatsCollectionController[] =
819 "enable-stats-collection-bindings";
821 // Upscale defaults to "good".
822 const char kTabCaptureDownscaleQuality[] = "tab-capture-downscale-quality";
824 // Scaling quality for capturing tab. Should be one of "fast", "good" or "best".
825 // One flag for upscaling, one for downscaling.
826 // Upscale defaults to "best".
827 const char kTabCaptureUpscaleQuality[] = "tab-capture-upscale-quality";
829 // Allows for forcing socket connections to http/https to use fixed ports.
830 const char kTestingFixedHttpPort[] = "testing-fixed-http-port";
831 const char kTestingFixedHttpsPort[] = "testing-fixed-https-port";
833 // Runs the security test for the renderer sandbox.
834 const char kTestSandbox[] = "test-sandbox";
836 // Type of the current test harness ("browser" or "ui").
837 const char kTestType[] = "test-type";
839 const char kTouchScrollingMode[] = "touch-scrolling-mode";
840 const char kTouchScrollingModeAsyncTouchmove[] = "async-touchmove";
841 const char kTouchScrollingModeSyncTouchmove[] = "sync-touchmove";
842 const char kTouchScrollingModeTouchcancel[] = "touchcancel";
844 // Causes TRACE_EVENT flags to be recorded beginning with shutdown. Optionally,
845 // can specify the specific trace categories to include (e.g.
846 // --trace-shutdown=base,net) otherwise, all events are recorded.
847 // --trace-shutdown-file can be used to control where the trace log gets stored
848 // to since there is otherwise no way to access the result.
849 const char kTraceShutdown[] = "trace-shutdown";
851 // If supplied, sets the file which shutdown tracing will be stored into, if
852 // omitted the default will be used "chrometrace.log" in the current directory.
853 // Has no effect unless --trace-shutdown is also supplied.
854 // Example: --trace-shutdown --trace-shutdown-file=/tmp/trace_event.log
855 const char kTraceShutdownFile[] = "trace-shutdown-file";
857 // Causes TRACE_EVENT flags to be recorded from startup. Optionally, can
858 // specify the specific trace categories to include (e.g.
859 // --trace-startup=base,net) otherwise, all events are recorded. Setting this
860 // flag results in the first call to BeginTracing() to receive all trace events
861 // since startup. In Chrome, you may find --trace-startup-file and
862 // --trace-startup-duration to control the auto-saving of the trace (not
863 // supported in the base-only TraceLog component).
864 const char kTraceStartup[] = "trace-startup";
866 // Sets the time in seconds until startup tracing ends. If omitted a default of
867 // 5 seconds is used. Has no effect without --trace-startup, or if
868 // --startup-trace-file=none was supplied.
869 const char kTraceStartupDuration[] = "trace-startup-duration";
871 // If supplied, sets the file which startup tracing will be stored into, if
872 // omitted the default will be used "chrometrace.log" in the current directory.
873 // Has no effect unless --trace-startup is also supplied.
874 // Example: --trace-startup --trace-startup-file=/tmp/trace_event.log
875 // As a special case, can be set to 'none' - this disables automatically saving
876 // the result to a file and the first manually recorded trace will then receive
877 // all events since startup.
878 const char kTraceStartupFile[] = "trace-startup-file";
882 // Prioritizes the UI's command stream in the GPU process
883 extern const char kUIPrioritizeInGpuProcess[] =
884 "ui-prioritize-in-gpu-process";
886 // Overrides the preferred discardable memory implementation.
887 const char kUseDiscardableMemory[] = "use-discardable-memory";
889 // Use fake device for MediaStream to replace actual camera and microphone.
890 const char kUseFakeDeviceForMediaStream[] = "use-fake-device-for-media-stream";
892 // Bypass the media stream infobar by selecting the default device for media
893 // streams (e.g. WebRTC). Works with --use-fake-device-for-media-stream.
894 const char kUseFakeUIForMediaStream[] = "use-fake-ui-for-media-stream";
896 // Set when Chromium should use a mobile user agent.
897 const char kUseMobileUserAgent[] = "use-mobile-user-agent";
899 // On POSIX only: the contents of this flag are prepended to the utility
900 // process command line. Useful values might be "valgrind" or "xterm -e gdb
901 // --args".
902 const char kUtilityCmdPrefix[] = "utility-cmd-prefix";
904 // Causes the process to run as a utility subprocess.
905 const char kUtilityProcess[] = "utility";
907 // The utility process is sandboxed, with access to one directory. This flag
908 // specifies the directory that can be accessed.
909 const char kUtilityProcessAllowedDir[] = "utility-allowed-dir";
911 // Allows MDns to access network in sandboxed process.
912 const char kUtilityProcessEnableMDns[] = "utility-enable-mdns";
914 const char kUtilityProcessRunningElevated[] = "utility-run-elevated";
916 // In debug builds, asserts that the stream of input events is valid.
917 const char kValidateInputEventStream[] = "validate-input-event-stream";
919 // Will add kWaitForDebugger to every child processes. If a value is passed, it
920 // will be used as a filter to determine if the child process should have the
921 // kWaitForDebugger flag passed on or not.
922 const char kWaitForDebuggerChildren[] = "wait-for-debugger-children";
924 // Overrides the amount of shared memory the webgl command buffer allocates
925 const char kWebGLCommandBufferSizeKb[] = "webgl-command-buffer-size-kb";
927 // Causes the process to run as a worker subprocess.
928 const char kWorkerProcess[] = "worker";
930 // The prefix used when starting the zygote process. (i.e. 'gdb --args')
931 const char kZygoteCmdPrefix[] = "zygote-cmd-prefix";
933 // Causes the process to run as a renderer zygote.
934 const char kZygoteProcess[] = "zygote";
936 #if defined(ENABLE_WEBRTC)
937 // Enables audio processing in a MediaStreamTrack. When this flag is on, AEC,
938 // NS and AGC will be done per MediaStreamTrack instead of in PeerConnection.
939 const char kEnableAudioTrackProcessing[] = "enable-audio-track-processing";
941 // Disables WebRTC device enumeration.
942 const char kDisableDeviceEnumeration[] = "disable-device-enumeration";
944 // Disables HW decode acceleration for WebRTC.
945 const char kDisableWebRtcHWDecoding[] = "disable-webrtc-hw-decoding";
947 // Disables encryption of RTP Media for WebRTC. When Chrome embeds Content, it
948 // ignores this switch on its stable and beta channels.
949 const char kDisableWebRtcEncryption[] = "disable-webrtc-encryption";
951 // Disables HW encode acceleration for WebRTC.
952 const char kDisableWebRtcHWEncoding[] = "disable-webrtc-hw-encoding";
954 // Enables WebRTC to open TCP server sockets.
955 const char kEnableWebRtcTcpServerSocket[] = "enable-webrtc-tcp-server-socket";
957 // Enables VP8 HW encode acceleration for WebRTC.
958 const char kEnableWebRtcHWVp8Encoding[] = "enable-webrtc-hw-vp8-encoding";
959 #endif
961 #if defined(OS_ANDROID)
962 // Disable user gesture requirement for the media element to enter fullscreen.
963 const char kDisableGestureRequirementForMediaFullscreen[] =
964 "disable-gesture-requirement-for-media-fullscreen";
966 // Disable user gesture requirement for media playback.
967 const char kDisableGestureRequirementForMediaPlayback[] =
968 "disable-gesture-requirement-for-media-playback";
970 // Disable history logging for media elements.
971 const char kDisableMediaHistoryLogging[] = "disable-media-history";
973 // Disable the click delay by sending click events during double tap.
974 const char kDisableClickDelay[] = "disable-click-delay";
976 // Disable overscroll edge effects like those found in Android views.
977 const char kDisableOverscrollEdgeEffect[] = "disable-overscroll-edge-effect";
979 // WebRTC is enabled by default on Android.
980 const char kDisableWebRTC[] = "disable-webrtc";
982 // Enable the recognition part of the Web Speech API.
983 const char kEnableSpeechRecognition[] = "enable-speech-recognition";
985 // Always use the video overlay for the embedded video.
986 // This switch is intended only for tests.
987 const char kForceUseOverlayEmbeddedVideo[] = "force-use-overlay-embedded-video";
989 // The telephony region (ISO country code) to use in phone number detection.
990 const char kNetworkCountryIso[] = "network-country-iso";
992 // Enables remote debug over HTTP on the specified socket name.
993 const char kRemoteDebuggingSocketName[] = "remote-debugging-socket-name";
994 #endif
996 // Disable web audio API.
997 const char kDisableWebAudio[] = "disable-webaudio";
999 #if defined(OS_CHROMEOS)
1000 // Disables panel fitting (used for mirror mode).
1001 const char kDisablePanelFitting[] = "disable-panel-fitting";
1002 #endif
1004 #if defined(OS_MACOSX) && !defined(OS_IOS)
1005 const char kEnableCarbonInterposing[] = "enable-carbon-interposing";
1007 // Disables support for Core Animation plugins. This is triggered when
1008 // accelerated compositing is disabled. See http://crbug.com/122430 .
1009 const char kDisableCoreAnimationPlugins[] =
1010 "disable-core-animation-plugins";
1011 #endif
1013 // Don't dump stuff here, follow the same order as the header.
1015 } // namespace switches