feat(crashpad): add option to delay shutdown until crash report upload completes (Linux)

[JoshuaMoelans]

In some scenarios, waiting for the upload to complete makes more sense than trying to quickly kill the crashed process.
Crashpad PR getsentry/crashpad#121

We start by providing this for Linux, since this is the most common use-case for this kind of wait-before-shutdown behavior. If the need arises, we can reconsider adding it for other platforms as well.

• add Sentry option
• implement option passthrough into Crashpad
• reason about (not) adding this to other platforms (win/mac)
• add test(s) <- manually tested
  -> we can try getting the Docker testing setup into CI as well <- out of scope for this PR
• test interaction with retry mechanism
  
• update docs (e.g. Options , backend tradeoffs ?) feat(native): add crashpad-wait-for-upload option sentry-docs#13117

Manual testing

Testing in CI is tricky, so we opted to test this on a local Docker setup instead. Below are the example Dockerfile and docker-compose.yml that we used to test this feature

dockerfile

FROM ubuntu:22.04

# Install required dependencies
RUN apt-get update && apt-get install -y \
    build-essential \
    cmake \
    git \
    python3 \
    python3-pip \
    pkg-config \
    systemd \
    libcurl4-openssl-dev

# Set working directory
WORKDIR /sentry-native

# Copy sentry-native source code
COPY . .

# Clean any existing build
RUN rm -rf build/

# Build the project
RUN cmake -B build \
    -DCMAKE_RUNTIME_OUTPUT_DIRECTORY=/sentry-native/build \
    -DSENTRY_BACKEND=crashpad

RUN cmake --build build --target sentry_example

docker-compose.yml

services:
  sentry-example:
    environment:
      - SENTRY_DSN=<your_sentry_DSN>
    build: .
    volumes:
      - .:/sentry-native:rw
      - /sentry-native/build  # This prevents the build directory from being mounted from host
    cap_add:
      - SYS_PTRACE
    security_opt:
      - seccomp:unconfined
    command: ./build/sentry_example log crash sleep capture-multiple
# alternatively command: ./build/sentry_example log crash sleep capture-multiple crashpad-wait-for-upload

[github-actions]

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against 3f932ff

[codecov]

Codecov Report

Attention: Patch coverage is 50.00000% with 3 lines in your changes missing coverage. Please review.

Project coverage is 82.63%. Comparing base (4ebdbe9) to head (7dfb073).
Report is 4 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1153      +/-   ##
==========================================
- Coverage   82.67%   82.63%   -0.04%     
==========================================
  Files          53       53              
  Lines        7954     7959       +5     
  Branches     1246     1246              
==========================================
+ Hits         6576     6577       +1     
- Misses       1264     1268       +4     
  Partials      114      114              

[JoshuaMoelans]

Do we already want to add the dockerfile & docker-compose files to the repo for posterity, or should we just leave them in the PR description as-is (until we add a proper Docker test into our CI testing setup)

[supervacuus]

Do we already want to add the dockerfile & docker-compose files to the repo for posterity, or should we just leave them in the PR description as-is (until we add a proper Docker test into our CI testing setup)

I think it is enough to have it here.