Source code

Revision control

Other Tools

1
# This lists all the available crash annotations.
2
#
3
# Mandatory fields for each entry are:
4
# - description: A string describing the annotation
5
# - type: the annotation type, currently `string`, `integer` or `boolean`.
6
# The latter are stringified to `1` for true and `0` for false.
7
#
8
# Additionally a field can have the following optional fields:
9
# - altname: A string that will be used when writing out the annotation to the
10
# .extra file instead of the annotation name
11
# - ping: A boolean that indicates whether the annotation is whitelisted for
12
# going into the crash ping, if not specified this defaults to false
13
# - content: A boolean that indicates whether the field will be included in
14
# subprocess reports, if not specified this defaults to true
15
16
A11yHandlerRegistered:
17
description: >
18
Set to "true" if the accessibility handler is registered, "false" otherwise.
19
type: string
20
21
AbortMessage:
22
description: >
23
Message passed to NS_DebugBreak().
24
type: string
25
26
Accessibility:
27
description: >
28
Set to "Active" by the accessibility service when it is active.
29
type: string
30
31
AccessibilityClient:
32
description: >
33
Accessibility client ID.
34
type: string
35
36
AccessibilityInProcClient:
37
description: >
38
Hexadecimal mask of in-process accessibility consumers, see
39
accessible/windows/msaa/Compatibility.h for the mappings.
40
type: string
41
42
ActualStreamLen:
43
description: >
44
Actual length of an IPC proxy stream.
45
type: integer
46
47
AdapterDeviceID:
48
description: >
49
Graphics adapter name.
50
type: string
51
52
AdapterDriverVendor:
53
description: >
54
Graphics adapter driver vendor.
55
type: string
56
57
AdapterDriverVersion:
58
description: >
59
Graphics adapter driver version.
60
type: string
61
62
AdapterSubsysID:
63
description: >
64
Graphics adapter subsystem ID.
65
type: string
66
67
AdapterVendorID:
68
description: >
69
Graphics adapter vendor name.
70
type: string
71
72
additional_minidumps:
73
description: >
74
Comma separated list of additional minidumps for this crash, each element
75
in the list represent the suffix used in the dump filename. E.g. the
76
"browser" entry for crash fa909194-737b-4b93-b8da-da110ac785e0 implies the
77
existence of the fa909194-737b-4b93-b8da-da110ac785e0-browser.dmp file.
78
type: string
79
80
Addons:
81
description: >
82
List of currently enabled add-ons.
83
type: string
84
altname: Add-ons
85
86
AppInitDLLs:
87
description: >
88
List of DLLs loaded when launching any application on Windows, this
89
reflects the contents of the AppInit_DLLs registry key.
90
type: string
91
92
AsyncShutdownModule:
93
description: >
94
Holds the contents of the AsyncShutdown.js script
95
type: string
96
97
AsyncShutdownTimeout:
98
description: >
99
This annotation is present if a shutdown blocker was not released in time
100
and the browser was crashed instead of waiting for shutdown to finish. The
101
condition that caused the hang is contained in the annotation.
102
type: string
103
ping: true
104
105
AvailablePageFile:
106
description: >
107
Windows-only, maximum amount of memory that can be committed. This
108
annotation is populated with the contents of the MEMORYSTATUSEX's structure
109
ullAvailPageFile field.
110
type: string
111
ping: true
112
113
AvailablePhysicalMemory:
114
description: >
115
Windows-only, amount of free physical memory in bytes. This annotation
116
is populated with the contents of the MEMORYSTATUSEX's structure
117
ullAvailPhys field.
118
type: string
119
ping: true
120
121
AvailableVirtualMemory:
122
description: >
123
Windows-only, amount of free virtual memory in bytes. This annotation is
124
populated with the contents of the MEMORYSTATUSEX's structure
125
ullAvailVirtual field.
126
type: string
127
ping: true
128
129
BIOS_Manufacturer:
130
description: >
131
Name of the BIOS manufacturer.
132
type: string
133
134
BlockedDllList:
135
description: >
136
Comma-separated list of blocked DLLS, Windows-only
137
type: string
138
ping: true
139
140
BlocklistInitFailed:
141
description: >
142
Set to 1 if the DLL blocklist could not be initialized.
143
type: boolean
144
ping: true
145
146
BreakpadReserveAddress:
147
description: >
148
Address of the buffer reserved by Breakpad.
149
type: string
150
151
BreakpadReserveSize:
152
description: >
153
Size of the buffer reserved by Breakpad.
154
type: string
155
156
Bug_1086977:
157
description: >
158
Mac-only annotation which should be present only if Firefox crashed when
159
loading a facebook plugin.
160
type: string
161
162
Bug_1541161:
163
description: >
164
Dump JS Stack in case loadinfo is null within NewChannelFromURIWithProxyFlagsInternal().
165
type: string
166
167
BuildID:
168
description: >
169
Application build ID, the format is YYYYMMDDHHMMSS.
170
type: string
171
ping: true
172
173
ClassRegistrationInfoChild:
174
description: >
175
Microsoft COM class registration annotation for the child process.
176
type: string
177
178
ClassRegistrationInfoParent:
179
description: >
180
Microsoft COM class registration annotation for the parent process.
181
type: string
182
183
CoMarshalInterfaceFailure:
184
description: >
185
Annotation describing the error returned by trying to marshal an object
186
via CoMarshalInterface during the creation of an IPC proxy stream.
187
type: string
188
189
ContainsMemoryReport:
190
description: >
191
Indicates that the crash dump contains a memory report.
192
type: boolean
193
ping: true
194
195
ContentSandboxCapabilities:
196
description: >
197
List of capabilities of the content process sandbox.
198
type: string
199
200
ContentSandboxEnabled:
201
description: >
202
Set to 1 when content process sandboxing is enabled.
203
type: boolean
204
205
ContentSandboxCapable:
206
description: >
207
Set to 1 if the client is capable of content sandboxing.
208
type: boolean
209
210
ContentSandboxLevel:
211
description: >
212
Content sandbox level.
213
type: integer
214
215
CoUnmarshalInterfaceResult:
216
description: >
217
Annotation describing the error returned by trying to unmarshal an object
218
via CoUnmarshalInterface during the creation of an IPC proxy stream.
219
type: integer
220
221
CPUMicrocodeVersion:
222
description: >
223
Version of the CPU microcode.
224
type: string
225
226
CpuUsageFlashProcess1:
227
description: >
228
CPU usage of the first Adobe Flash plugin process.
229
type: string
230
231
CpuUsageFlashProcess2:
232
description: >
233
CPU usage of the second Adobe Flash plugin process.
234
type: string
235
236
CrashAddressLikelyWrong:
237
description: >
238
Set to 1 if signal handling is broken, in which case the crash address is
239
likely to be wrong.
240
type: boolean
241
242
CrashTime:
243
description: >
244
Crash time in seconds since the Epoch.
245
type: string
246
ping: true
247
248
CreateStreamOnHGlobalFailure:
249
description: >
250
Set when failing to obtain a global memory handle during the creation of an
251
IPC proxy stream.
252
type: string
253
254
CycleCollector:
255
description: >
256
Reason why the cycle collector crashed.
257
type: string
258
259
DeviceResetReason:
260
description: >
261
Reason why a DirectX device has been reset, Windows only.
262
type: string
263
264
DOMIPCEnabled:
265
description: >
266
Set to 1 when a tab is running in a content process
267
type: boolean
268
269
EMCheckCompatibility:
270
description: >
271
Set to 1 if add-on compatibility checking is enabled.
272
type: boolean
273
274
EventLoopNestingLevel:
275
description: >
276
Present only if higher than 0, indicates that we're running in a nested
277
event loop and indicates the nesting level.
278
type: integer
279
ping: true
280
281
ExpectedStreamLen:
282
description: >
283
Expected length of an IPC proxy stream.
284
type: integer
285
286
FlashProcessDump:
287
description: >
288
Type of process the flash plugin is running in, can be either "Broker" or
289
"Sandbox".
290
type: string
291
292
FramePoisonBase:
293
description: >
294
Base pointer of the memory area used for the poison value we place in freed
295
memory.
296
type: string
297
content: false
298
299
FramePoisonSize:
300
description: >
301
Size of the memory area used for the poison value we place in freed
302
memory.
303
type: integer
304
content: false
305
306
GetHGlobalFromStreamFailure:
307
description: >
308
Error returned when invoking GetHGlobalFromStreamFailure() during the
309
creation of an IPC stream proxy.
310
type: string
311
312
GMPLibraryPath:
313
description: >
314
Holds the path to the GMP plugin library.
315
type: string
316
317
GMPPlugin:
318
description: >
319
Set to 1 if the GMP plugin is enabled.
320
type: boolean
321
322
GPUProcessLaunchCount:
323
description: >
324
Number of times the GPU process was launched.
325
type: integer
326
327
GPUProcessStatus:
328
description: >
329
Status of the GPU process, can be set to "Running" or "Destroyed"
330
type: string
331
332
GraphicsCriticalError:
333
description: >
334
Information of a critical error that occurred within the graphics code.
335
type: string
336
337
GraphicsSanityTest:
338
description: >
339
Annotation used in tests.
340
type: string
341
342
GraphicsStartupTest:
343
description: >
344
Set to 1 by the graphics driver crash guard when it's activated.
345
type: boolean
346
347
HangMonitorDescription:
348
description: >
349
Name of the hang monitor that generated the crash.
350
type: string
351
352
HasDeviceTouchScreen:
353
description: >
354
Set to 1 if the device had a touch-screen, this only applies to Firefox
355
desktop as on mobile devices we assume a touch-screen is always present.
356
type: boolean
357
358
IAccessibleConfig:
359
description: >
360
Set when something is seriously wrong with the IAccessible configuration in
361
the computer's registry. The value is always set to "NoSystemTypeLibOrPS"
362
type: string
363
364
IndexedDBShutdownTimeout:
365
description: >
366
This annotation is present if IndexedDB shutdown was not finished in time
367
and the browser was crashed instead of waiting for IndexedDB shutdown to
368
finish. The condition that caused the hang is contained in the annotation.
369
type: string
370
content: false
371
ping: true
372
373
InstallTime:
374
description: >
375
The time when Firefox was installed expressed as seconds since the Epoch
376
type: integer
377
378
InterfaceRegistrationInfoChild:
379
description: >
380
Microsoft COM interface registration annotation for the child process.
381
type: string
382
383
InterfaceRegistrationInfoParent:
384
description: >
385
Microsoft COM interface registration annotation for the parent process.
386
type: string
387
388
ipc_channel_error:
389
description: >
390
Set before a content process crashes because of an IPC channel error, holds
391
a description of the error.
392
type: string
393
ping: true
394
395
IpcCreateEndpointsNsresult:
396
description: >
397
errno value retrieved after failing to create an IPC transport object.
398
type: integer
399
400
IpcCreatePipeCloExecErrno:
401
description: >
402
errno value retrieved after failing to set the O_CLOEXEC flag on a pipe
403
used for IPC.
404
type: integer
405
406
IpcCreatePipeFcntlErrno:
407
description: >
408
errno value retrieved after a call to fcntl() on a pipe used for IPC failed.
409
type: integer
410
411
IpcCreatePipeSocketPairErrno:
412
description: >
413
errno value retrieved after a socketpair() call failed while creating an IPC
414
transport object.
415
type: integer
416
417
IpcCreateTransportDupErrno:
418
description: >
419
errno value retrieved after a dup() call failed while creating an IPC
420
transport object.
421
type: integer
422
423
IPCFatalErrorMsg:
424
description: >
425
Describes a fatal error that occurred during IPC operation.
426
type: string
427
428
IPCFatalErrorProtocol:
429
description: >
430
Name of the protocol used by IPC when a fatal error occurred.
431
type: string
432
433
IPCMessageName:
434
description: >
435
Name of the IPC message that caused a crash because it was too large.
436
type: string
437
438
IPCMessageSize:
439
description: >
440
Size of the IPC message that caused a crash because it was too large.
441
type: integer
442
443
IPCReadErrorReason:
444
description: >
445
Reason why reading an object via IPC failed.
446
type: string
447
448
IPCShutdownState:
449
description: >
450
IPC shutdown state, can be set to either "RecvShutdown" or
451
"SendFinishShutdown" by a content process while it's shutting down.
452
type: string
453
454
IPCSystemError:
455
description: >
456
Description of the last system error that occurred during IPC operation.
457
type: string
458
459
IPCTransportFailureReason:
460
description: >
461
Reason why creating an IPC channel failed.
462
type: string
463
464
IsGarbageCollecting:
465
description: >
466
If true then the JavaScript garbage collector was running when the crash
467
occurred.
468
type: boolean
469
ping: true
470
471
IsWayland:
472
description: >
473
If true then the Wayland windowing system was in use.
474
type: boolean
475
476
JavaStackTrace:
477
description: >
478
Java stack trace, only present on Firefox for Android if we encounter an
479
uncaught Java exception.
480
type: string
481
482
JSLargeAllocationFailure:
483
description: >
484
A large allocation couldn't be satisfied, check the JSOutOfMemory
485
description for the possible values of this annotation.
486
type: string
487
488
JSOutOfMemory:
489
description: >
490
A small allocation couldn't be satisfied, the annotation may contain the
491
"Reporting", "Reported" or "Recovered" value. The first one means that
492
we crashed while responding to the OOM condition (possibly while running a
493
memory-pressure observers), the second that we crashed after having tried to
494
free some memory, and the last that the GC had managed to free enough memory
495
to satisfy the allocation.
496
type: string
497
498
LauncherProcessState:
499
description: >
500
Launcher process enabled state. The integer value of this annotation must
501
match with one of the values in the
502
mozilla::LauncherRegistryInfo::EnableState enum
503
type: integer
504
505
LocalStorageShutdownTimeout:
506
description: >
507
This annotation is present if LocalStorage shutdown was not finished in time
508
and the browser was crashed instead of waiting for LocalStorage shutdown to
509
finish. The condition that caused the hang is contained in the annotation.
510
The condition is constructed by stringifying status of global arrays and
511
hash tables that blocked LocalStorage shutdown (gPrepareDatastoreOps,
512
gDatastores and gLiveDatabases). gDatastores and gLiveDatabases currently
513
only report the number of elements. gPrepareDatastoreOps reports the number
514
of elements and status of individual elements (duplicit entries are removed):
515
"gPrepareDatastoreOps: N (element1, element2, elementN)" where N is the
516
number of elements. Status of individual elements is constructed by taking
517
PrepareDatastoreOp's sanitized origin string, stringified state and
518
stringified nested state. A full example:
519
"gPrepareDatastoreOps: 1 (http://aaa.aaa.aaa*Nesting*DatabaseWorkOpen)"
520
type: string
521
content: false
522
ping: true
523
524
LowCommitSpaceEvents:
525
description: >
526
Number of times the available memory tracker has detected a that
527
commit-space was running low. This is a Windows-specific annotation.
528
type: integer
529
ping: true
530
531
MarshalActCtxManifestPath:
532
description: >
533
Proxy stream marshalling current activation context manifest path.
534
type: string
535
536
MemoryErrorCorrection:
537
description: >
538
Windows only, type of error correction used by system memory. See
539
documentation for MemoryErrorCorrection property of
540
Win32_PhysicalMemoryArray WMI class.
541
type: string
542
ping: true
543
544
MozCrashReason:
545
description: >
546
Plaintext description of why Firefox crashed, this is usually set by
547
assertions and the like.
548
type: string
549
ping: true
550
551
Notes:
552
description: >
553
Miscellaneous notes that can be appended to a crash.
554
type: string
555
556
nsAsyncShutdownComponent:
557
description: >
558
Holds the contents of the nsAsyncShutdown.js script
559
type: string
560
561
OOMAllocationSize:
562
description: >
563
Size of the allocation that caused an out-of-memory condition.
564
type: string
565
ping: true
566
567
PluginCpuUsage:
568
description: >
569
CPU usage of the plugin process.
570
type: string
571
572
PluginFilename:
573
description: >
574
Plugin filename, only the process holding the plugin has this annotation.
575
type: string
576
577
PluginHang:
578
description: >
579
The presence of this annotation indicates that this crash was generated in
580
response to a plugin hanging.
581
type: boolean
582
583
PluginHangUIDuration:
584
description: >
585
Duration in milliseconds of the plugin hang that caused this crash.
586
type: integer
587
588
PluginName:
589
description: >
590
Display name of a plugin, only the process holding the plugin has this
591
annotation.
592
type: string
593
594
PluginVersion:
595
description: >
596
Version of a plugin, only the process holding the plugin has this
597
annotation.
598
type: string
599
600
ProcessType:
601
description: >
602
Type of the process that crashed, the possible values are defined in
603
GeckoProcessTypes.h.
604
type: string
605
606
ProductName:
607
description: >
608
Application name (e.g. Firefox).
609
type: string
610
ping: true
611
612
ProductID:
613
description: >
614
Application UUID (e.g. ec8030f7-c20a-464f-9b0e-13a3a9e97384).
615
type: string
616
ping: true
617
618
ProxyStreamSize:
619
description: >
620
Size of an IPC proxy stream.
621
type: integer
622
623
ProxyStreamSizeFrom:
624
description: >
625
Describes how the size of a proxy stream was obtained. It can be set to
626
either Stream::Stat or GlobalSize.
627
type: string
628
629
ProxyStreamUnmarshalStatus:
630
description: >
631
Status of the proxy stream unmarshalling, see ipc/mscom/ProxyStream.cpp for
632
the various value this annotation can take.
633
type: string
634
635
ProxyStreamValid:
636
description: >
637
Set to "false" when encountering an invalid IPC proxy stream.
638
type: string
639
640
RDDProcessStatus:
641
description: >
642
Status of the RDD process, can be set to "Running" or "Destroyed"
643
type: string
644
645
RecordReplay:
646
description: >
647
Set to 1 if this crash happened in a Web Replay middleman, recording,
648
or replaying process.
649
type: boolean
650
651
RecordReplayError:
652
description: >
653
Any fatal error that occurred while recording/replaying a tab.
654
type: string
655
656
RecordReplayHang:
657
description: >
658
The presence of this annotation indicates that this crash was generated in
659
response to a hang in a replaying process.
660
type: boolean
661
662
ReleaseChannel:
663
description: >
664
Application release channel (e.g. default, beta, ...)
665
type: string
666
ping: true
667
668
RemoteType:
669
description: >
670
Type of the content process, can be set to "web", "file" or "extension".
671
type: string
672
ping: true
673
674
SafeMode:
675
description: >
676
Set to 1 if the browser was started in safe mode.
677
type: boolean
678
679
SecondsSinceLastCrash:
680
description: >
681
Time in seconds since the last crash occurred.
682
type: string
683
ping: true
684
685
ServerURL:
686
description: >
687
URL used to post the crash report.
688
type: string
689
690
ShutdownProgress:
691
description: >
692
Shutdown step at which the browser crashed, can be set to "quit-application",
693
"profile-change-teardown", "profile-before-change", "xpcom-will-shutdown" or
694
"xpcom-shutdown".
695
type: string
696
ping: true
697
698
StartupCrash:
699
description: >
700
If set to 1 then this crash occurred during startup.
701
type: boolean
702
content: false
703
ping: true
704
705
StartupTime:
706
description: >
707
The time when Firefox was launched expressed in seconds since the Epoch.
708
type: integer
709
content: false
710
711
StatFailure:
712
description: >
713
Error returned when invoking IStream's Stat function during the creation
714
of an IPC proxy stream.
715
type: string
716
717
StorageConnectionNotClosed:
718
description: >
719
This annotation is added when a mozStorage connection has not been properly
720
closed during shutdown. The annotation holds the filename of the database
721
associated with the connection.
722
type: string
723
724
SystemMemoryUsePercentage:
725
description: >
726
Windows-only, percentage of physical memory in use. This annotation is
727
populated with the contents of the MEMORYSTATUSEX's structure dwMemoryLoad
728
field.
729
type: integer
730
ping: true
731
732
TelemetryClientId:
733
description: >
734
Telemetry client ID.
735
type: string
736
737
TelemetryEnvironment:
738
description: >
739
The telemetry environment in JSON format.
740
type: string
741
742
TelemetryServerURL:
743
description: >
744
Telemetry server URL. Used to send main process crash pings directly from
745
the crashreporter client.
746
type: string
747
748
TelemetrySessionId:
749
description: >
750
Telemetry session ID.
751
type: string
752
753
TestKey:
754
description: >
755
Annotation used in tests.
756
type: string
757
758
TestUnicode:
759
description: >
760
Annotation used in tests.
761
type: string
762
763
TextureUsage:
764
description: >
765
Amount of memory in bytes consumed by textures.
766
type: string
767
ping: true
768
769
ThreadIdNameMapping:
770
description: >
771
List of thread names with their corresponding thread IDs.
772
type: string
773
774
TotalPageFile:
775
description: >
776
Windows-only, current committed memory limit. This annotation is
777
populated with the contents of the MEMORYSTATUSEX's structure
778
ullTotalPageFile field.
779
type: string
780
ping: true
781
782
TotalPhysicalMemory:
783
description: >
784
Windows-only, amount of physical memory in bytes. This annotation is
785
populated with the contents of the MEMORYSTATUSEX's structure
786
ullTotalPhys field.
787
type: string
788
ping: true
789
790
TotalVirtualMemory:
791
description: >
792
Windows-only, size of the virtual address space. This annotation is
793
populated with the contents of the MEMORYSTATUSEX's structure
794
ullTotalVirtual field.
795
type: string
796
ping: true
797
798
UnknownNetAddrSocketFamily:
799
description: >
800
An unknown network address family was requested to Necko. The value is the
801
requested family number.
802
type: integer
803
804
UnmarshalActCtx:
805
description: >
806
Proxy stream unmarshalling current activation context.
807
type: string
808
809
UnmarshalActCtxManifestPath:
810
description: >
811
Proxy stream unmarshalling current activation context manifest path.
812
type: string
813
814
UptimeTS:
815
description: >
816
Uptime in seconds. This annotation uses a string instead of an integer
817
because it has a fractional component.
818
type: string
819
ping: true
820
821
URL:
822
description: >
823
URL being loaded.
824
type: string
825
content: false
826
827
User32BeforeBlocklist:
828
description: >
829
Set to 1 if user32.dll was loaded before we could install the DLL blocklist.
830
type: boolean
831
ping: true
832
833
useragent_locale:
834
description: >
835
User-agent locale.
836
type: string
837
838
Vendor:
839
description: >
840
Application vendor (e.g. Mozilla).
841
type: string
842
843
Version:
844
description: >
845
Product version.
846
type: string
847
848
VRProcessStatus:
849
description: >
850
Status of the VR process, can be set to "Running" or "Destroyed"
851
type: string
852
853
Winsock_LSP:
854
description: >
855
Information on winsock LSPs injected in our networking stack.
856
type: string