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 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197
|
#!/usr/bin/env python3
# Copyright 2018 Mellanox Technologies Inc.
# Licensed under BSD (MIT variant) or GPLv2. See COPYING.
# PYTHON_ARGCOMPLETE_OK
"""This script takes a commitish from a kernel tree and synchronizes the RDMA
headers we use with that tree.
During development, before commits are accepted to the official kernel git
tree, the --not-final option should be used. Once finalized the commit should
be revised using --amend, eg using the exec feature of 'git rebase'"""
import argparse
import subprocess
import tempfile
import os
import contextlib
import textwrap
import email.utils
import collections
def git_call(args):
"""Run git and display the output to the terminal"""
return subprocess.check_call(['git',] + args);
def git_output(args,mode=None,input=None):
"""Run git and return the output"""
o = subprocess.check_output(['git',] + args,input=input);
if mode == "raw":
return o;
return o.strip();
@contextlib.contextmanager
def in_directory(dir):
"""Context manager that chdirs into a directory and restores the original
directory when closed."""
cdir = os.getcwd();
old_env = {};
try:
# git rebase invokes its exec with a bunch of git variables set that
# prevent us from invoking git in another tree, blow them away.
for k in list(os.environ.keys()):
if k.startswith("GIT"):
old_env[k] = os.environ[k];
del os.environ[k];
os.chdir(dir);
yield True;
finally:
os.chdir(cdir);
os.environ.update(old_env);
def copy_objects(args):
"""Copy the uapi header objects from the kernel repo at the commit indicated
into our repo. This is done by having git copy the tree object and blobs from the
kernel tree into this tree and then revising our index. This is a simple way
to ensure they match exactly."""
with in_directory(args.KERNEL_GIT):
if args.not_final:
fmt = "--format=?? (\"%s\")";
else:
fmt = "--format=%h (\"%s\")";
kernel_desc = git_output(["log",
"--abbrev=12","-1",
fmt,
args.COMMIT]);
ntree = git_output(["rev-parse",
"%s:include/uapi/rdma"%(args.COMMIT)]);
pack = git_output(["pack-objects",
"-q","--revs","--stdout"],
mode="raw",
input=ntree);
git_output(["unpack-objects","-q"],input=pack);
return (ntree,kernel_desc);
def update_cmake(args,ntree):
"""Create a new CMakeLists.txt that lists all of the kernel headers
for installation."""
# We need to expand to a publish_internal_headers for each directory
fns = git_output(["ls-tree","--name-only","--full-tree","-r",ntree]).splitlines();
groups = collections.defaultdict(list);
for I in fns:
d,p = os.path.split(os.path.join("rdma",I.decode()));
groups[d].append(p);
data = subprocess.check_output(['git',"cat-file","blob",
":kernel-headers/CMakeLists.txt"]);
data = data.decode();
# Build a new CMakeLists.txt in a temporary file
with tempfile.NamedTemporaryFile("wt") as F:
# Emit the headers lists
for I,vals in sorted(groups.items()):
F.write("publish_internal_headers(%s\n"%(I));
for J in sorted(vals):
F.write(" %s\n"%(os.path.join(I,J)));
F.write(" )\n");
F.write("\n");
# Throw away the old header lists
cur = iter(data.splitlines());
for ln in cur:
if not ln:
continue;
if ln.startswith("publish_internal_headers(rdma"):
while not next(cur).startswith(" )"):
pass;
continue;
F.write(ln + '\n');
break;
# and copy the remaining lines
for ln in cur:
F.write(ln + '\n');
F.flush();
blob = git_output(["hash-object","-w",F.name]);
git_call(["update-index","--cacheinfo",
b"0644,%s,kernel-headers/CMakeLists.txt"%(blob)]);
def make_commit(args,ntree,kernel_desc):
"""Make the rdma-core commit that syncs the kernel header directory."""
head_id = git_output(["rev-parse","HEAD"]);
old_tree_id = git_output(["rev-parse",b"%s^{tree}"%(head_id)]);
if args.amend:
subject = git_output(["log","-1","--format=%s"]).decode();
if subject != "Update kernel headers":
raise ValueError("In amend mode, but current HEAD does not seem to be a kernel update with subject %r"%(
subject));
parent = git_output(["rev-parse",head_id + b"^"]);
else:
parent = head_id;
emaila = email.utils.formataddr((git_output(["config","user.name"]).decode(),
git_output(["config","user.email"]).decode()));
# Build a new tree object that replaces the kernel headers directory
with tempfile.NamedTemporaryFile() as F:
os.environ["GIT_INDEX_FILE"] = F.name;
git_call(["read-tree",head_id]);
git_call(["rm","-r","--quiet","--cached",
"kernel-headers/rdma"]);
git_call(["read-tree","--prefix=kernel-headers/rdma",ntree]);
update_cmake(args,ntree);
all_tree = git_output(["write-tree"]);
del os.environ["GIT_INDEX_FILE"];
if not args.amend and old_tree_id == all_tree:
raise ValueError("Commit is empty, aborting");
# And now create the commit
msg="Update kernel headers\n\n";
p = textwrap.fill("To commit: %s."%(kernel_desc.decode()),
width=74)
msg = msg + p;
msg = msg + "\n\nSigned-off-by: %s\n"%(emaila);
commit = git_output(["commit-tree",all_tree,"-p",parent,
"-F","-"],
input=msg.encode());
return commit,head_id;
parser = argparse.ArgumentParser(description='Update kernel headers from the kernel tree')
parser.add_argument("--amend",
action="store_true",
default=False,
help="Replace the top commit with the the kernel header commit");
parser.add_argument("--not-final",
action="store_true",
default=False,
help="Use if the git commit given is not part of the official kernel git tree. This option should be used during development.");
parser.add_argument("KERNEL_GIT",
action="store",
help="Kernel git directory");
parser.add_argument("COMMIT",
action="store",
help="Kernel commitish to synchronize headers with");
try:
import argcomplete;
argcomplete.autocomplete(parser);
except ImportError:
pass;
args = parser.parse_args();
ntree,kernel_desc = copy_objects(args);
commit,head_id = make_commit(args,ntree,kernel_desc);
# Finalize
if args.amend:
print("Commit amended");
git_call(["--no-pager","diff","--stat",head_id,commit]);
git_call(["reset","--merge",commit]);
else:
git_call(["merge","--ff","--ff-only",commit]);
|