2 # SPDX-License-Identifier: BSD-3-Clause
3 # Copyright 2016 6WIND S.A.
7 echo "usage: $(basename $0) [-h] <git_range>"
15 Find fixes to backport on previous versions.
16 It looks for the word "fix" in the headline or a tag "Fixes" or "Reverts".
17 The oldest bug origin is printed as well as partially fixed versions.
21 usage_error () # <message>
28 while getopts h ARG ; do
30 h ) print_help ; exit 0 ;;
31 ? ) print_usage >&2 ; exit 1 ;;
34 shift $(($OPTIND - 1))
35 [ $# -ge 1 ] || usage_error 'range argument required'
38 # get major release version of a commit
39 commit_version () # <hash>
41 # use current branch as history reference
42 local refbranch=$(git rev-parse --abbrev-ref HEAD)
43 local tag=$( (git tag -l --contains $1 --merged $refbranch 2>&- ||
44 # tag --merged option has been introduced in git 2.7.0
45 # below is a fallback in case of old git version
46 for t in $(git tag -l --contains $1) ; do
47 git branch $refbranch --contains $t |
51 if [ -z "$tag" ] ; then
52 # before -rc1 tag of release in progress
53 cat VERSION | cut -d'.' -f-2
55 echo $tag | sed 's,^v,,' | sed 's,-rc.*,,'
59 # get bug origin hashes of a fix
60 origin_filter () # <hash>
62 git log --format='%b' -1 $1 |
63 sed -n 's,^ *\([Ff]ixes\|[Rr]everts\): *\([0-9a-f]*\).*,\2,p'
66 # get oldest major release version of bug origins
67 origin_version () # <origin_hash> ...
71 git rev-parse -q --verify $1 >&- || continue
72 # get version of this bug origin
73 local origver=$(commit_version $origin)
74 local roothashes="$(origin_filter $origin)"
75 if [ -n "$roothashes" ] ; then
76 # look chained fix of fix recursively
77 local rootver="$(origin_version $roothashes)"
78 [ -n "$rootver" ] || continue
79 echo "$rootver (partially fixed in $origver)"
83 # filter the oldest origin
84 done | sort -uV | head -n1
87 # print a marker for stable tag presence
88 stable_tag () # <hash>
90 if git log --format='%b' -1 $1 | grep -qi '^Cc: *stable@dpdk.org' ; then
97 # print a marker for fixes tag presence
100 if git log --format='%b' -1 $1 | grep -qi '^Fixes: *' ; then
107 git log --oneline --reverse $range |
108 while read id headline ; do
109 origins=$(origin_filter $id)
110 stable=$(stable_tag $id)
111 fixes=$(fixes_tag $id)
112 [ "$stable" = "S" ] || [ "$fixes" = "F" ] || [ -n "$origins" ] || \
113 echo "$headline" | grep -q fix || continue
114 version=$(commit_version $id)
115 if [ -n "$origins" ] ; then
116 origver="$(origin_version $origins)"
117 [ -n "$origver" ] || continue
118 # ignore fix of bug introduced in the same release
119 ! echo "$origver" | grep -q "^$version" || continue
123 printf '%s %7s %s %s %s (%s)\n' $version $id $stable $fixes "$headline" "$origver"