culvert 0.2.0

Typed access to the HDMI 2.1 SCDC register map
Documentation 
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

name: Fuzz

on:
  push:
    branches: [main, develop]
  # Not main: the only PRs into main are release-tag's release-promote/* PRs,
  # whose content already passed the fuzz smoke run on develop. Opened by
  # github-actions[bot], their runs would be held for approval and end as
  # action_required/failure.
  pull_request:
    branches: [develop]
  schedule:
    - cron: '0 2 * * 6'  # weekly, Saturday 02:00 UTC
  workflow_dispatch:       # allow manual trigger

env:
  CARGO_TERM_COLOR: always
  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true

jobs:
  fuzz:
    name: Fuzz (${{ matrix.target }})
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        target: [status_flags, ced]

    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1

      - name: Install nightly toolchain
        uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # v1
        with:
          toolchain: nightly

      # Not in install-action's checksum-verified manifests; a fixed version built
      # from crates.io with its own lock file instead.
      - name: Install cargo-fuzz
        run: cargo install cargo-fuzz --locked --version 0.13.2

      - name: Restore corpus cache
        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
        with:
          path: fuzz/corpus/${{ matrix.target }}
          key: fuzz-corpus-${{ matrix.target }}-${{ github.sha }}
          restore-keys: fuzz-corpus-${{ matrix.target }}-

      - name: Fuzz (smoke, 60 s) — PRs and pushes
        if: github.event_name == 'push' || github.event_name == 'pull_request'
        run: cargo +nightly fuzz run ${{ matrix.target }} -- -max_total_time=60

      - name: Fuzz (deep, 1 h) — scheduled and manual
        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
        run: cargo +nightly fuzz run ${{ matrix.target }} -- -max_total_time=3600

      - name: Minimise corpus
        if: success() && (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
        run: cargo +nightly fuzz cmin ${{ matrix.target }}

      - name: Upload corpus artifact
        if: success() && (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        with:
          name: fuzz-corpus-${{ matrix.target }}
          path: fuzz/corpus/${{ matrix.target }}/

      - name: Upload crash artifacts
        if: failure()
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        with:
          name: fuzz-crash-${{ matrix.target }}
          path: fuzz/artifacts/${{ matrix.target }}/

  update-corpus:
    name: Update corpus
    needs: [fuzz]
    if: success() && (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1

      - name: Download all corpus artifacts
        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
        with:
          pattern: fuzz-corpus-*
          path: fuzz/corpus/
          merge-multiple: false

      - name: Flatten artifact subdirectories
        run: |
          for target in status_flags ced; do
            src="fuzz/corpus/fuzz-corpus-${target}"
            dst="fuzz/corpus/${target}"
            if [ -d "$src" ]; then
              mkdir -p "$dst"
              cp -r "$src/." "$dst/"
              rm -rf "$src"
            fi
          done

      - name: Open PR if corpus changed
        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          branch: ci/fuzz-corpus
          commit-message: "ci: update fuzz corpus after deep run"
          title: "ci: update fuzz corpus after deep run"
          body: |
            Minimised corpus from the latest deep fuzz run. Covers both targets:
            `status_flags`, `ced`.

            *Opened automatically by the fuzz CI job.*
          add-paths: fuzz/corpus/