pcap 2.4.0

A packet capture API around pcap/wpcap
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

on:
  workflow_call:
    inputs:
      os:
        required: true
        type: string
    secrets:
      NPCAP_OEM_PASSWORD:
        required: false
      NPCAP_OEM_USERNAME:
        required: false

env:
  RUST_BACKTRACE: 1
  CARGO_TERM_VERBOSE: true
  CARGO_TERM_COLOR: always
  PCAP_CI_TEST_TARGETS: ${{ contains(inputs.os, 'windows') && (github.event_name == 'pull_request') && '--lib' || '--all-targets' }}
  PCAP_CI_GRCOV_CMD: >-
    ${{ contains(inputs.os, 'windows') && 'C:/grcov' || './grcov' }}
    target/debug/profraw
    --binary-path ./target/debug/
    --output-types html
    --source-dir .
    --ignore-not-existing
    --ignore "build.rs"
    --ignore "tests/*"
    --ignore "examples/*"
    --excl-start "GRCOV_EXCL_START|mod tests \{"
    --excl-stop "GRCOV_EXCL_STOP"
    --output-path ./target/debug/coverage/
  PCAP_CI_COV_CMD: >-
    python3 .github/scripts/coverage.py
    --coverage-file ./target/debug/coverage/coverage.json
  PCAP_CI_COV_FAIL_UNDER_NO_FEATURES: ${{ contains(inputs.os, 'windows') && '80.00' || '100.00' }}
  PCAP_CI_COV_FAIL_UNDER_ALL_FEATURES: ${{ contains(inputs.os, 'windows') && '75.00' || '96.00' }}

jobs:
  coverage:
    runs-on: ${{ inputs.os }}
    env:
      LLVM_PROFILE_FILE: 'target/debug/profraw/pcap-%p-%m.profraw'
      RUSTFLAGS: '-C instrument-coverage'
    steps:
      - uses: actions/checkout@v4
      - if: ${{ contains(inputs.os, 'ubuntu') }}
        run: sudo apt-get install libpcap-dev
      - if: ${{ contains(inputs.os, 'macos') }}
        run: brew install libpcap
      - if: ${{ contains(inputs.os, 'windows') }}
        run: |
          Invoke-WebRequest -Uri "https://npcap.com/dist/npcap-sdk-1.13.zip" -OutFile "C:/npcap-sdk.zip"
          Expand-Archive -LiteralPath C:/npcap-sdk.zip -DestinationPath C:/npcap-sdk
          echo "LIB=C:/npcap-sdk/Lib/x64" >> $env:GITHUB_ENV
      - if: ${{ contains(inputs.os, 'windows') && (github.event_name != 'pull_request') }}
        run: |
          $SecPassword = ConvertTo-SecureString "${{ secrets.NPCAP_OEM_PASSWORD }}" -AsPlainText -Force
          $CredObject = New-Object System.Management.Automation.PSCredential ("${{ secrets.NPCAP_OEM_USERNAME }}", $SecPassword)
          Invoke-WebRequest -Uri "https://npcap.com/oem/dist/npcap-1.71-oem.exe" -OutFile C:/npcap-oem.exe -Credential $CredObject
          C:/npcap-oem.exe /S
      # No installation of actuall library since we cannot install OEM pcap on pull request branches
      # anyway. We'll just be running unit tests on Windows. No integration tests.
      - run: |
          rustup update --no-self-update stable
          rustup default stable
          rustup component add llvm-tools-preview
      - if: ${{ contains(inputs.os, 'ubuntu') }}
        run: >-
          wget https://github.com/mozilla/grcov/releases/latest/download/grcov-x86_64-unknown-linux-gnu.tar.bz2 -qO- |
          tar -xj -C ./
      - if: ${{ contains(inputs.os, 'macos') }}
        run: >-
          wget https://github.com/mozilla/grcov/releases/latest/download/grcov-x86_64-apple-darwin.tar.bz2 -qO- |
          tar -xj -C ./
      - if: ${{ contains(inputs.os, 'windows') }}
        run: |
          Invoke-WebRequest -Uri "https://github.com/mozilla/grcov/releases/latest/download/grcov-x86_64-pc-windows-msvc.zip" -OutFile C:/grcov.zip
          Expand-Archive -LiteralPath C:/grcov.zip -DestinationPath C:/
      # Coverage without features.
      - run: cargo test  ${{ env.PCAP_CI_TEST_TARGETS }}                --no-fail-fast
      - run: ${{ env.PCAP_CI_GRCOV_CMD }}
      - run: ${{ env.PCAP_CI_COV_CMD }} --fail-under ${{ env.PCAP_CI_COV_FAIL_UNDER_NO_FEATURES }}
      # Clean up coverage artifacts.
      - if: ${{ contains(inputs.os, 'windows') }}
        run: |
          Remove-Item -Recurse -Force ./target/debug/coverage
          Remove-Item -Recurse -Force ./target/debug/profraw
      - if: ${{ ! contains(inputs.os, 'windows') }}
        run: rm -rf ./target/debug/{coverage,profraw}
      - run: cargo clean -p pcap
      # Coverage with features.
      - run: cargo test  ${{ env.PCAP_CI_TEST_TARGETS }} --all-features --no-fail-fast
      - run: ${{ env.PCAP_CI_GRCOV_CMD }}
      - run: ${{ env.PCAP_CI_COV_CMD }} --fail-under ${{ env.PCAP_CI_COV_FAIL_UNDER_ALL_FEATURES }}
      # On push to main push results to coverage branch.
      - if: ${{ (github.event_name == 'push') && (github.ref == 'refs/heads/main') && contains(inputs.os, 'ubuntu') }}
        uses: actions/checkout@v4
        with:
          clean: false
          ref: coverage
      - if: ${{ (github.event_name == 'push') && (github.ref == 'refs/heads/main') && contains(inputs.os, 'ubuntu') }}
        run: |
          rm -rf *.html badges src coverage.json
          cp -r ./target/debug/coverage/* ./
          git config --local user.email "action@github.com"
          git config --local user.name "GitHub Action"
          git add -A
          git commit -m "Code coverage for "$(git rev-parse --short origin/main)
          git push