mirror of
https://github.com/keylase/nvidia-patch.git
synced 2026-09-02 03:03:43 +00:00
25 lines
1.3 KiB
Markdown
25 lines
1.3 KiB
Markdown
# AGENTS.md
|
||
|
||
This repo provides NVENC/NvFBC patches for Nvidia drivers on Linux (`patch.sh`, `patch-fbc.sh`)
|
||
and Windows (`.1337` files under `win/`, applied via Win_1337_Apply_Patch).
|
||
|
||
## Golden rules
|
||
|
||
- **Never hand-edit generated artifacts.** `README.md`, `win/README.md`, and `drivers.json`
|
||
are generated. `drivers.json` is the single source of truth; the READMEs are rebuilt from it
|
||
and the `tools/readme-autogen/templates/` templates.
|
||
- **Never hand-edit the `patch_list` in `patch.sh`/`patch-fbc.sh`.** Use the autopatch scripts.
|
||
- The canonical end-to-end flow is `.github/workflows/gen_linux_patches.yml` and
|
||
`.github/workflows/gen_win_patches.yml` — mirror them when working manually.
|
||
|
||
## Testing: >12 simultaneous NVENC sessions
|
||
|
||
The unpatched driver fails past 12 concurrent sessions; the patch must allow 13+.
|
||
|
||
- **Linux**: `tools/patch-tester/patch-tester.sh` — runs 13 concurrent `h264_nvenc` encodes
|
||
(1M–13M bitrate) against `testsrc` via CUDA. All 13 must complete without error.
|
||
Requires ffmpeg built with NVENC/CUDA support and the patched driver installed.
|
||
- **Windows**: `win/tools/patch-tester/patch-tester.ps1` (or `.bat`) — same 13-stream test.
|
||
|
||
Test against the patched driver and confirm 13 sessions succeed on a consumer GPU before opening a PR.
|