README.blacklist
Blacklisting Upstream Commit-IDs ================================ We track the git history of the upstream Linux kernel for fixes that we potentially need to backport to our kernel branches. The tooling creates a list of upstream commit-ids that are already part of our kernels and compares the 'Fixes:' tags in upstream commits with that list. If there is a match, we found a fix that might need to be backported. If the commit is not needed in our kernels, it can be blacklisted, so that the tools do not report that commit again. There are two ways to blacklist a commit: 1) Put the commit-id into blacklist.conf. This file exists to blacklist fixes for the base kernel version of the branch. 2) Use the 'No-Fix:' tag in the patch-files. The format of that tag is the same as for the 'Git-commit:' tag. Only one commit can be blacklisted per tag, you have to use 'No-Fix:' once for each commit to be blacklisted. This option can be used to blacklist fixes for an already backported upstream patch. Both options require a full 40-character git commit-id. The blacklist.conf file also supports blacklisting by source code path. A list of paths can be put into that file and patches that only touch these paths are automatically blacklisted too. Feel free to send any questions and/or suggestions about fixes-tracking and blacklisting to: Joerg Roedel <jroedel@suse.de>