ci-core-dumper

A utility to automate analysis of core dumps from crashes during CI builds and test runs.

Support Linux, OSX (somewhat), and Windows. Tested with Appveyor, Github Actions, Travis-CI.

On Linux, uses the corepattern facility to capture, and analyzes with GDB. On OSX, find and print any CrashReporter logs. On Windows, uses the AeDebug facility to capture, and analyzes with CDB.

Usage on Github Actions:

...
jobs:
  test:
    runs-on: ${{ matrix.os }}
    name: My Job
    steps:
      - uses: actions/checkout@v3
      - uses: mdavidsaver/ci-core-dumper@master
      - runs: |
         ulimit -c unlimited
         ... something which might crash

With Github Actions only, a dummy ulimit command is provided on Windows.

Usage in Travis-CI:

install:
  - sudo pip install git+https://github.com/mdavidsaver/ci-core-dumper#egg=ci-core-dumper

before_script:
  - sudo python -m ci_core_dumper install

script:
  - ulimit -c unlimited
  - ... something which might crash

after_failure:
  - python -m ci_core_dumper report

Info on stages.

Usage in Appveyor:

install:
  - cmd: pip install git+https://github.com/mdavidsaver/ci-core-dumper#egg=ci-core-dumper

before_test:
  - cmd: python -m ci_core_dumper install

test_script:
  - ... something which might crash

on_failure:
  - cmd: python -m ci_core_dumper report

Info on stages.

User setup verification

Test crashes should be rare. So the best case is that ci-core-dumper is installed but never used. There is a risk of false negatives if some issue prevents ci-core-dumper from functioning correctly. eg. omitting 'ulimit -c unlimited' on *NIX or SetErrorMode(2) on Windows.

Extra Commands

The action arguments extra_cdb: and extra_gdb: can be used to pass a semicolon separated list of extra debugger commands to CDB or GDB. eg.

...
jobs:
...
      - uses: mdavidsaver/ci-core-dumper@master
        with:
          extra_gdb: "info auto-load"

Development

Please report any issue on the Github project.

• Github Project