More accurate reason for kernel build failures in README and issue template

This commit is contained in:
Lan Tian 2026-01-09 18:23:53 -08:00
parent 4a1debc1a3
commit 1441ff60eb
No known key found for this signature in database
GPG Key ID: 04E66B6B25A0862B
2 changed files with 6 additions and 6 deletions

View File

@ -8,9 +8,9 @@ body:
value: | value: |
## ⚠️ Before You Submit ## ⚠️ Before You Submit
Most kernel build failures are caused by CachyOS not updating patches for the latest kernel version. Most kernel build failures are caused by version mismatch between CachyOS patches and nixpkgs kernel version.
If this is the case, the only option is to wait for the CachyOS team to update the patches. If this is the case, the only option is to wait for the versions to be in sync again.
Please consider using the `release` branch as it contains the last successful build: Please consider using the `release` branch as it contains the last successful build:
@ -30,9 +30,9 @@ body:
Only submit an issue if the build has been failing for multiple consecutive days, or if it's failing on the `release` branch. Only submit an issue if the build has been failing for multiple consecutive days, or if it's failing on the `release` branch.
options: options:
- label: I understand that most build failures are caused by CachyOS not updating patches for the latest kernel version - label: I understand that most build failures are caused by version mismatch between CachyOS patches and nixpkgs kernel version
required: true required: true
- label: I understand that in most cases, the only option is to wait for the CachyOS team to update the patches - label: I understand that in most cases, the only option is to wait for the versions to be in sync again
required: true required: true
- label: The build has been failing for multiple consecutive days, OR it is failing on the `release` branch - label: The build has been failing for multiple consecutive days, OR it is failing on the `release` branch
required: true required: true

View File

@ -166,13 +166,13 @@ This repo also has [Garnix CI](https://garnix.io) set up, and should work as lon
``` ```
### Help! My kernel is failing to build! ### Help! My kernel is failing to build!
In most cases, failing to build a kernel is caused by CachyOS not updating patches for the latest kernel version. (e.g. hardened 6.18 kernel as of 2025-12-12) In most cases, failing to build a kernel is caused by version mismatch between CachyOS patches and nixpkgs kernel version. (e.g. hardened 6.18 kernel as of 2025-12-12)
Common symptoms are: Common symptoms are:
- "File not found" error, which indicates that CachyOS patches for given kernel version/variant are unavailable. - "File not found" error, which indicates that CachyOS patches for given kernel version/variant are unavailable.
- Failures/conflicts when applying patches, which indicates that CachyOS patches are for an older kernel version. - Failures/conflicts when applying patches, which indicates that CachyOS patches are for an older kernel version.
If this is the case, the only option is to wait for CachyOS team to update the patches. If this is the case, the only option is to wait for the versions to be in sync again.
## How to use ZFS modules ## How to use ZFS modules