Source code

Revision control

Other Tools

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844
# This lists all the available crash annotations.
#
# Mandatory fields for each entry are:
# - description: A string describing the annotation
# - type: the annotation type, currently `string`, `integer` or `boolean`.
#   The latter are stringified to `1` for true and `0` for false.
#
# Additionally a field can have the following optional fields:
# - altname: A string that will be used when writing out the annotation to the
#   .extra file instead of the annotation name
# - ping: A boolean that indicates whether the annotation is whitelisted for
#   going into the crash ping, if not specified this defaults to false
# - content: A boolean that indicates whether the field will be included in
#   subprocess reports, if not specified this defaults to true

A11yHandlerRegistered:
  description: >
    Set to "true" if the accessibility handler is registered, "false" otherwise.
  type: string

AbortMessage:
  description: >
    Message passed to NS_DebugBreak().
  type: string

Accessibility:
  description: >
    Set to "Active" by the accessibility service when it is active.
  type: string

AccessibilityClient:
  description: >
    Accessibility client ID.
  type: string

AccessibilityInProcClient:
  description: >
    Hexadecimal mask of in-process accessibility consumers, see
    accessible/windows/msaa/Compatibility.h for the mappings.
  type: string

ActualStreamLen:
  description: >
    Actual length of an IPC proxy stream.
  type: integer

AdapterDeviceID:
  description: >
    Graphics adapter name.
  type: string

AdapterDriverVersion:
  description: >
    Graphics adapter driver version.
  type: string

AdapterSubsysID:
  description: >
    Graphics adapter subsystem ID.
  type: string

AdapterVendorID:
  description: >
    Graphics adapter vendor name.
  type: string

additional_minidumps:
  description: >
    Comma separated list of additional minidumps for this crash, each element
    in the list represent the suffix used in the dump filename. E.g. the
    "browser" entry for crash fa909194-737b-4b93-b8da-da110ac785e0 implies the
    existence of the fa909194-737b-4b93-b8da-da110ac785e0-browser.dmp file.
  type: string

Addons:
  description: >
    List of currently enabled add-ons.
  type: string
  altname: Add-ons

AppInitDLLs:
  description: >
    List of DLLs loaded when launching any application on Windows, this
    reflects the contents of the AppInit_DLLs registry key.
  type: string

AsyncShutdownModule:
  description: >
    Holds the contents of the AsyncShutdown.js script
  type: string

AsyncShutdownTimeout:
  description: >
    This annotation is present if a shutdown blocker was not released in time
    and the browser was crashed instead of waiting for shutdown to finish. The
    condition that caused the hang is contained in the annotation.
  type: string
  ping: true

AvailablePageFile:
  description: >
    Windows-only, maximum amount of memory that can be committed.  This
    annotation is populated with the contents of the MEMORYSTATUSEX's structure
    ullAvailPageFile field.
  type: string
  ping: true

AvailablePhysicalMemory:
  description: >
    Windows-only, amount of free physical memory in bytes. This annotation
    is populated with the contents of the MEMORYSTATUSEX's structure
    ullAvailPhys field.
  type: string
  ping: true

AvailableVirtualMemory:
  description: >
    Windows-only, amount of free virtual memory in bytes. This annotation is
    populated with the contents of the MEMORYSTATUSEX's structure
    ullAvailVirtual field.
  type: string
  ping: true

BIOS_Manufacturer:
  description: >
    Name of the BIOS manufacturer.
  type: string

BlockedDllList:
  description: >
    Comma-separated list of blocked DLLS, Windows-only
  type: string
  ping: true

BlocklistInitFailed:
  description: >
    Set to 1 if the DLL blocklist could not be initialized.
  type: boolean
  ping: true

BreakpadReserveAddress:
  description: >
    Address of the buffer reserved by Breakpad.
  type: string

BreakpadReserveSize:
  description: >
    Size of the buffer reserved by Breakpad.
  type: string

Bug_1086977:
  description: >
    Mac-only annotation which should be present only if Firefox crashed when
    loading a facebook plugin.
  type: string

Bug_1541161:
  description: >
    Dump JS Stack in case loadinfo is null within NewChannelFromURIWithProxyFlagsInternal().
  type: string

BuildID:
  description: >
    Application build ID, the format is YYYYMMDDHHMMSS.
  type: string
  ping: true

ClassRegistrationInfoChild:
  description: >
    Microsoft COM class registration annotation for the child process.
  type: string

ClassRegistrationInfoParent:
  description: >
    Microsoft COM class registration annotation for the parent process.
  type: string

CoMarshalInterfaceFailure:
  description: >
    Annotation describing the error returned by trying to marshal an object
    via CoMarshalInterface during the creation of an IPC proxy stream.
  type: string

ContainsMemoryReport:
  description: >
    Indicates that the crash dump contains a memory report.
  type: boolean
  ping: true

ContentSandboxCapabilities:
  description: >
    List of capabilities of the content process sandbox.
  type: string

ContentSandboxEnabled:
  description: >
    Set to 1 when content process sandboxing is enabled.
  type: boolean

ContentSandboxCapable:
  description: >
    Set to 1 if the client is capable of content sandboxing.
  type: boolean

ContentSandboxLevel:
  description: >
    Content sandbox level.
  type: integer

CoUnmarshalInterfaceResult:
  description: >
    Annotation describing the error returned by trying to unmarshal an object
    via CoUnmarshalInterface during the creation of an IPC proxy stream.
  type: integer

CPUMicrocodeVersion:
  description: >
    Version of the CPU microcode.
  type: string

CpuUsageFlashProcess1:
  description: >
    CPU usage of the first Adobe Flash plugin process.
  type: string

CpuUsageFlashProcess2:
  description: >
    CPU usage of the second Adobe Flash plugin process.
  type: string

CrashAddressLikelyWrong:
  description: >
    Set to 1 if signal handling is broken, in which case the crash address is
    likely to be wrong.
  type: boolean

CrashTime:
  description: >
    Crash time in seconds since the Epoch.
  type: string
  ping: true

CreateStreamOnHGlobalFailure:
  description: >
    Set when failing to obtain a global memory handle during the creation of an
    IPC proxy stream.
  type: string

CycleCollector:
  description: >
    Reason why the cycle collector crashed.
  type: string

DeviceResetReason:
  description: >
    Reason why a DirectX device has been reset, Windows only.
  type: string

DOMIPCEnabled:
  description: >
    Set to 1 when a tab is running in a content process
  type: boolean

EMCheckCompatibility:
  description: >
    Set to 1 if add-on compatibility checking is enabled.
  type: boolean

EventLoopNestingLevel:
  description: >
    Present only if higher than 0, indicates that we're running in a nested
    event loop and indicates the nesting level.
  type: integer
  ping: true

ExecutableName:
  description: >
    The name of the last executable that was launched via the nsIProcess class.
    Multiple executables can be launched at the same time from one or more
    threads so this annotation might not always contain the correct value. To
    be removed once bug 1386760 is fixed.
  type: string

ExpectedStreamLen:
  description: >
    Expected length of an IPC proxy stream.
  type: integer

FlashProcessDump:
  description: >
    Type of process the flash plugin is running in, can be either "Broker" or
    "Sandbox".
  type: string

FramePoisonBase:
  description: >
    Base pointer of the memory area used for the poison value we place in freed
    memory.
  type: string
  content: false

FramePoisonSize:
  description: >
    Size of the memory area used for the poison value we place in freed
    memory.
  type: integer
  content: false

GetHGlobalFromStreamFailure:
  description: >
    Error returned when invoking GetHGlobalFromStreamFailure() during the
    creation of an IPC stream proxy.
  type: string

GMPLibraryPath:
  description: >
    Holds the path to the GMP plugin library.
  type: string

GMPPlugin:
  description: >
    Set to 1 if the GMP plugin is enabled.
  type: boolean

GPUProcessLaunchCount:
  description: >
    Number of times the GPU process was launched.
  type: integer

GPUProcessStatus:
  description: >
    Status of the GPU process, can be set to "Running" or "Destroyed"
  type: string

GraphicsCriticalError:
  description: >
    Information of a critical error that occurred within the graphics code.
  type: string

GraphicsSanityTest:
  description: >
    Annotation used in tests.
  type: string

GraphicsStartupTest:
  description: >
    Set to 1 by the graphics driver crash guard when it's activated.
  type: boolean

HangMonitorDescription:
  description: >
    Name of the hang monitor that generated the crash.
  type: string

HasDeviceTouchScreen:
  description: >
    Set to 1 if the device had a touch-screen, this only applies to Firefox
    desktop as on mobile devices we assume a touch-screen is always present.
  type: boolean

IAccessibleConfig:
  description: >
    Set when something is seriously wrong with the IAccessible configuration in
    the computer's registry. The value is always set to "NoSystemTypeLibOrPS"
  type: string

IndexedDBShutdownTimeout:
  description: >
    This annotation is present if IndexedDB shutdown was not finished in time
    and the browser was crashed instead of waiting for IndexedDB shutdown to
    finish. The condition that caused the hang is contained in the annotation.
  type: string
  content: false
  ping: true

InstallTime:
  description: >
    The time when Firefox was installed expressed as seconds since the Epoch
  type: integer

InterfaceRegistrationInfoChild:
  description: >
    Microsoft COM interface registration annotation for the child process.
  type: string

InterfaceRegistrationInfoParent:
  description: >
    Microsoft COM interface registration annotation for the parent process.
  type: string

ipc_channel_error:
  description: >
    Set before a content process crashes because of an IPC channel error, holds
    a description of the error.
  type: string
  ping: true

IpcCreateEndpointsNsresult:
  description: >
    errno value retrieved after failing to create an IPC transport object.
  type: integer

IpcCreatePipeCloExecErrno:
  description: >
    errno value retrieved after failing to set the O_CLOEXEC flag on a pipe
    used for IPC.
  type: integer

IpcCreatePipeFcntlErrno:
  description: >
    errno value retrieved after a call to fcntl() on a pipe used for IPC failed.
  type: integer

IpcCreatePipeSocketPairErrno:
  description: >
    errno value retrieved after a socketpair() call failed while creating an IPC
    transport object.
  type: integer

IpcCreateTransportDupErrno:
  description: >
    errno value retrieved after a dup() call failed while creating an IPC
    transport object.
  type: integer

IPCFatalErrorMsg:
  description: >
    Describes a fatal error that occurred during IPC operation.
  type: string

IPCFatalErrorProtocol:
  description: >
    Name of the protocol used by IPC when a fatal error occurred.
  type: string

IPCMessageName:
  description: >
    Name of the IPC message that caused a crash because it was too large.
  type: string

IPCMessageSize:
  description: >
    Size of the IPC message that caused a crash because it was too large.
  type: integer

IPCReadErrorReason:
  description: >
    Reason why reading an object via IPC failed.
  type: string

IPCShutdownState:
  description: >
    IPC shutdown state, can be set to either "RecvShutdown" or
    "SendFinishShutdown" by a content process while it's shutting down.
  type: string

IPCSystemError:
  description: >
    Description of the last system error that occurred during IPC operation.
  type: string

IPCTransportFailureReason:
  description: >
    Reason why creating an IPC channel failed.
  type: string

IsGarbageCollecting:
  description: >
    If true then the JavaScript garbage collector was running when the crash
    occurred.
  type: boolean
  ping: true

JavaStackTrace:
  description: >
    Java stack trace, only present on Firefox for Android if we encounter an
    uncaught Java exception.
  type: string

JSLargeAllocationFailure:
  description: >
    A large allocation couldn't be satisfied, check the JSOutOfMemory
    description for the possible values of this annotation.
  type: string

JSOutOfMemory:
  description: >
    A small allocation couldn't be satisfied, the annotation may contain the
    "Reporting", "Reported" or "Recovered" value. The first one means that
    we crashed while responding to the OOM condition (possibly while running a
    memory-pressure observers), the second that we crashed after having tried to
    free some memory, and the last that the GC had managed to free enough memory
    to satisfy the allocation.
  type: string

LauncherProcessState:
  description: >
    Launcher process enabled state. The integer value of this annotation must
    match with one of the values in the
    mozilla::LauncherRegistryInfo::EnableState enum
  type: integer

LocalStorageShutdownTimeout:
  description: >
    This annotation is present if LocalStorage shutdown was not finished in time
    and the browser was crashed instead of waiting for LocalStorage shutdown to
    finish. The condition that caused the hang is contained in the annotation.
  type: string
  content: false
  ping: true

LowCommitSpaceEvents:
  description: >
    Number of times the available memory tracker has detected a that
    commit-space was running low. This is a Windows-specific annotation.
  type: integer
  ping: true

MarshalActCtxManifestPath:
  description: >
    Proxy stream marshalling current activation context manifest path.
  type: string

MemoryErrorCorrection:
  description: >
    Windows only, type of error correction used by system memory.  See
    documentation for MemoryErrorCorrection property of
    Win32_PhysicalMemoryArray WMI class.
  type: string
  ping: true

MozCrashReason:
  description: >
    Plaintext description of why Firefox crashed, this is usually set by
    assertions and the like.
  type: string
  ping: true

Notes:
  description: >
    Miscellaneous notes that can be appended to a crash.
  type: string

nsAsyncShutdownComponent:
  description: >
    Holds the contents of the nsAsyncShutdown.js script
  type: string

OOMAllocationSize:
  description: >
    Size of the allocation that caused an out-of-memory condition.
  type: string
  ping: true

PluginCpuUsage:
  description: >
    CPU usage of the plugin process.
  type: string

PluginFilename:
  description: >
    Plugin filename, only the process holding the plugin has this annotation.
  type: string

PluginHang:
  description: >
    The presence of this annotation indicates that this crash was generated in
    response to a plugin hanging.
  type: boolean

PluginHangUIDuration:
  description: >
    Duration in milliseconds of the plugin hang that caused this crash.
  type: integer

PluginName:
  description: >
    Display name of a plugin, only the process holding the plugin has this
    annotation.
  type: string

PluginVersion:
  description: >
    Version of a plugin, only the process holding the plugin has this
    annotation.
  type: string

ProcessType:
  description: >
    Type of the process that crashed, the possible values are defined in
    GeckoProcessTypes.h.
  type: string

ProductName:
  description: >
    Application name (e.g. Firefox).
  type: string
  ping: true

ProductID:
  description: >
    Application UUID (e.g. ec8030f7-c20a-464f-9b0e-13a3a9e97384).
  type: string
  ping: true

ProxyStreamSize:
  description: >
    Size of an IPC proxy stream.
  type: integer

ProxyStreamSizeFrom:
  description: >
    Describes how the size of a proxy stream was obtained. It can be set to
    either Stream::Stat or GlobalSize.
  type: string

ProxyStreamUnmarshalStatus:
  description: >
    Status of the proxy stream unmarshalling, see ipc/mscom/ProxyStream.cpp for
    the various value this annotation can take.
  type: string

ProxyStreamValid:
  description: >
    Set to "false" when encountering an invalid IPC proxy stream.
  type: string

RDDProcessStatus:
  description: >
    Status of the RDD process, can be set to "Running" or "Destroyed"
  type: string

RecordReplay:
  description: >
    Set to 1 if this crash happened in a Web Replay middleman, recording,
    or replaying process.
  type: boolean

RecordReplayError:
  description: >
    Any fatal error that occurred while recording/replaying a tab.
  type: string

RecordReplayHang:
  description: >
    The presence of this annotation indicates that this crash was generated in
    response to a hang in a replaying process.
  type: boolean

ReleaseChannel:
  description: >
    Application release channel (e.g. default, beta, ...)
  type: string
  ping: true

RemoteType:
  description: >
    Type of the content process, can be set to "web", "file" or "extension".
  type: string
  ping: true

SafeMode:
  description: >
    Set to 1 if the browser was started in safe mode.
  type: boolean

SecondsSinceLastCrash:
  description: >
    Time in seconds since the last crash occurred.
  type: string
  ping: true

ServerURL:
  description: >
    URL used to post the crash report.
  type: string

ShutdownProgress:
  description: >
   Shutdown step at which the browser crashed, can be set to "quit-application",
   "profile-change-teardown", "profile-before-change", "xpcom-will-shutdown" or
   "xpcom-shutdown".
  type: string
  ping: true

StartupCrash:
  description: >
    If set to 1 then this crash occurred during startup.
  type: boolean
  content: false
  ping: true

StartupTime:
  description: >
    The time when Firefox was launched expressed in seconds since the Epoch.
  type: integer
  content: false

StatFailure:
  description: >
    Error returned when invoking IStream's Stat function during the creation
    of an IPC proxy stream.
  type: string

StorageConnectionNotClosed:
  description: >
    This annotation is added when a mozStorage connection has not been properly
    closed during shutdown. The annotation holds the filename of the database
    associated with the connection.
  type: string

SystemMemoryUsePercentage:
  description: >
    Windows-only, percentage of physical memory in use. This annotation is
    populated with the contents of the MEMORYSTATUSEX's structure dwMemoryLoad
    field.
  type: integer
  ping: true

TelemetryClientId:
  description: >
    Telemetry client ID.
  type: string

TelemetryEnvironment:
  description: >
    The telemetry environment in JSON format.
  type: string

TelemetryServerURL:
  description: >
    Telemetry server URL. Used to send main process crash pings directly from
    the crashreporter client.
  type: string

TelemetrySessionId:
  description: >
    Telemetry session ID.
  type: string

TestKey:
  description: >
    Annotation used in tests.
  type: string

TestUnicode:
  description: >
    Annotation used in tests.
  type: string

TextureUsage:
  description: >
    Amount of memory in bytes consumed by textures.
  type: string
  ping: true

ThreadIdNameMapping:
  description: >
    List of thread names with their corresponding thread IDs.
  type: string

TotalPageFile:
  description: >
    Windows-only, current committed memory limit. This annotation is
    populated with the contents of the MEMORYSTATUSEX's structure
    ullTotalPageFile field.
  type: string
  ping: true

TotalPhysicalMemory:
  description: >
    Windows-only, amount of physical memory in bytes. This annotation is
    populated with the contents of the MEMORYSTATUSEX's structure
    ullTotalPhys field.
  type: string
  ping: true

TotalVirtualMemory:
  description: >
    Windows-only, size of the virtual address space. This annotation is
    populated with the contents of the MEMORYSTATUSEX's structure
    ullTotalVirtual field.
  type: string
  ping: true

UnknownNetAddrSocketFamily:
  description: >
    An unknown network address family was requested to Necko. The value is the
    requested family number.
  type: integer

UnmarshalActCtx:
  description: >
    Proxy stream unmarshalling current activation context.
  type: string

UnmarshalActCtxManifestPath:
  description: >
    Proxy stream unmarshalling current activation context manifest path.
  type: string

UptimeTS:
  description: >
    Uptime in seconds. This annotation uses a string instead of an integer
    because it has a fractional component.
  type: string
  ping: true

URL:
  description: >
    URL being loaded.
  type: string
  content: false

User32BeforeBlocklist:
  description: >
    Set to 1 if user32.dll was loaded before we could install the DLL blocklist.
  type: boolean
  ping: true

useragent_locale:
  description: >
    User-agent locale.
  type: string

Vendor:
  description: >
    Application vendor (e.g. Mozilla).
  type: string

Version:
  description: >
    Product version.
  type: string

VRProcessStatus:
  description: >
    Status of the VR process, can be set to "Running" or "Destroyed"
  type: string

Winsock_LSP:
  description: >
    Information on winsock LSPs injected in our networking stack.
  type: string