fc2693110e
Make the scripts use external/kernel-headers/original by default. clean_header.py: Document -k<path>, add -d<path> find_headers.py: Make kernel config files optional update_all.py: Allow setting the path to kernel headers on the command-line update_all.py: Better formatting of output on ttys update_all.py: Automatically perform "git add/rm" on affected files. SYSCALLS.TXT: Fix typo in __socketcall definition. checksyscalls.py: Add support for superH architecture in the checks. gensyscalls.py: Automatically perform "git add/rm" on affected files. cpp.py: Fixed a bug that prevented certain type definitions to be kept in the generated clean header (e.g. struct ethtool_drvinfo in <linux/ethtool.h>) All scripts will use the content of external/kernel-headers/original by default now. The generated code removes all empty lines and trailing whitespace. This is useful to ensure a unified output even if we change the parser again in the future. The top-level disclaimer has been edited with update instructions to regenerate the headers when needed. Also, a warning is now inserted every 8th line in the final output: /* WARNING: DO NOT EDIT, AUTO-GENERATED CODE - SEE TOP FOR INSTRUCTIONS */ Changes under kernel/arch-arm and kernel/arch-x86 should correspond to whitespace differences and additionnal struct definitions that were missed by the previous parser implementation. Change-Id: Icd1c056bacd766759f3e9b7bb5d63a246f3d656a WARNING: If you run these script, do not submit the result to gerrit for now. It seems there are discrepancies between the content of original headers and those currently commited under bionic/libc/kernel/. (This problem is the main motivation to insert the warning repeatedly). Current list of issues: - Missing SuperH headers (i.e. external/kernel-headers/original/asm-sh)
422 lines
12 KiB
Python
422 lines
12 KiB
Python
# common python utility routines for the Bionic tool scripts
|
|
|
|
import sys, os, commands, string, commands
|
|
|
|
# basic debugging trace support
|
|
# call D_setlevel to set the verbosity level
|
|
# and D(), D2(), D3(), D4() to add traces
|
|
#
|
|
verbose = 0
|
|
|
|
def panic(msg):
|
|
sys.stderr.write( find_program_name() + ": error: " )
|
|
sys.stderr.write( msg )
|
|
sys.exit(1)
|
|
|
|
def D(msg):
|
|
global verbose
|
|
if verbose > 0:
|
|
print msg
|
|
|
|
def D2(msg):
|
|
global verbose
|
|
if verbose >= 2:
|
|
print msg
|
|
|
|
def D3(msg):
|
|
global verbose
|
|
if verbose >= 3:
|
|
print msg
|
|
|
|
def D4(msg):
|
|
global verbose
|
|
if verbose >= 4:
|
|
print msg
|
|
|
|
def D_setlevel(level):
|
|
global verbose
|
|
verbose = level
|
|
|
|
|
|
# other stuff
|
|
#
|
|
#
|
|
def find_program_name():
|
|
return os.path.basename(sys.argv[0])
|
|
|
|
def find_program_dir():
|
|
return os.path.dirname(sys.argv[0])
|
|
|
|
def find_file_from_upwards(from_path,target_file):
|
|
"""find a file in the current directory or its parents. if 'from_path' is None,
|
|
seach from the current program's directory"""
|
|
path = from_path
|
|
if path == None:
|
|
path = os.path.realpath(sys.argv[0])
|
|
path = os.path.dirname(path)
|
|
D("this script seems to be located in: %s" % path)
|
|
|
|
while 1:
|
|
D("probing "+path)
|
|
if path == "":
|
|
file = target_file
|
|
else:
|
|
file = path + "/" + target_file
|
|
|
|
if os.path.isfile(file):
|
|
D("found %s in %s" % (target_file, path))
|
|
return file
|
|
|
|
if path == "":
|
|
return None
|
|
|
|
path = os.path.dirname(path)
|
|
|
|
def find_bionic_root():
|
|
file = find_file_from_upwards(None, "SYSCALLS.TXT")
|
|
if file:
|
|
return os.path.dirname(file)
|
|
else:
|
|
return None
|
|
|
|
def find_kernel_headers():
|
|
"""try to find the directory containing the kernel headers for this machine"""
|
|
status, version = commands.getstatusoutput( "uname -r" ) # get Linux kernel version
|
|
if status != 0:
|
|
D("could not execute 'uname -r' command properly")
|
|
return None
|
|
|
|
# get rid of the "-xenU" suffix that is found in Xen virtual machines
|
|
if len(version) > 5 and version[-5:] == "-xenU":
|
|
version = version[:-5]
|
|
|
|
path = "/usr/src/linux-headers-" + version
|
|
D("probing %s for kernel headers" % (path+"/include"))
|
|
ret = os.path.isdir( path )
|
|
if ret:
|
|
D("found kernel headers in: %s" % (path + "/include"))
|
|
return path
|
|
return None
|
|
|
|
|
|
# parser for the SYSCALLS.TXT file
|
|
#
|
|
class SysCallsTxtParser:
|
|
def __init__(self):
|
|
self.syscalls = []
|
|
self.lineno = 0
|
|
|
|
def E(msg):
|
|
print "%d: %s" % (self.lineno, msg)
|
|
|
|
def parse_line(self, line):
|
|
pos_lparen = line.find('(')
|
|
E = self.E
|
|
if pos_lparen < 0:
|
|
E("missing left parenthesis in '%s'" % line)
|
|
return
|
|
|
|
pos_rparen = line.rfind(')')
|
|
if pos_rparen < 0 or pos_rparen <= pos_lparen:
|
|
E("missing or misplaced right parenthesis in '%s'" % line)
|
|
return
|
|
|
|
return_type = line[:pos_lparen].strip().split()
|
|
if len(return_type) < 2:
|
|
E("missing return type in '%s'" % line)
|
|
return
|
|
|
|
syscall_func = return_type[-1]
|
|
return_type = string.join(return_type[:-1],' ')
|
|
|
|
pos_colon = syscall_func.find(':')
|
|
if pos_colon < 0:
|
|
syscall_name = syscall_func
|
|
else:
|
|
if pos_colon == 0 or pos_colon+1 >= len(syscall_func):
|
|
E("misplaced colon in '%s'" % line)
|
|
return
|
|
syscall_name = syscall_func[pos_colon+1:]
|
|
syscall_func = syscall_func[:pos_colon]
|
|
|
|
if pos_rparen > pos_lparen+1:
|
|
syscall_params = line[pos_lparen+1:pos_rparen].split(',')
|
|
params = string.join(syscall_params,',')
|
|
else:
|
|
syscall_params = []
|
|
params = "void"
|
|
|
|
number = line[pos_rparen+1:].strip()
|
|
if number == "stub":
|
|
syscall_id = -1
|
|
syscall_id2 = -1
|
|
else:
|
|
try:
|
|
if number[0] == '#':
|
|
number = number[1:].strip()
|
|
numbers = string.split(number,',')
|
|
syscall_id = int(numbers[0])
|
|
syscall_id2 = syscall_id
|
|
if len(numbers) > 1:
|
|
syscall_id2 = int(numbers[1])
|
|
except:
|
|
E("invalid syscall number in '%s'" % line)
|
|
return
|
|
|
|
t = { "id" : syscall_id,
|
|
"id2" : syscall_id2,
|
|
"name" : syscall_name,
|
|
"func" : syscall_func,
|
|
"params" : syscall_params,
|
|
"decl" : "%-15s %s (%s);" % (return_type, syscall_func, params) }
|
|
|
|
self.syscalls.append(t)
|
|
|
|
def parse_file(self, file_path):
|
|
fp = open(file_path)
|
|
for line in fp.xreadlines():
|
|
self.lineno += 1
|
|
line = line.strip()
|
|
if not line: continue
|
|
if line[0] == '#': continue
|
|
self.parse_line(line)
|
|
|
|
fp.close()
|
|
|
|
|
|
class Output:
|
|
def __init__(self,out=sys.stdout):
|
|
self.out = out
|
|
|
|
def write(self,msg):
|
|
self.out.write(msg)
|
|
|
|
def writeln(self,msg):
|
|
self.out.write(msg)
|
|
self.out.write("\n")
|
|
|
|
class StringOutput:
|
|
def __init__(self):
|
|
self.line = ""
|
|
|
|
def write(self,msg):
|
|
self.line += msg
|
|
D2("write '%s'" % msg)
|
|
|
|
def writeln(self,msg):
|
|
self.line += msg + '\n'
|
|
D2("write '%s\\n'"% msg)
|
|
|
|
def get(self):
|
|
return self.line
|
|
|
|
|
|
def create_file_path(path):
|
|
dirs = []
|
|
while 1:
|
|
parent = os.path.dirname(path)
|
|
#print "parent: %s <- %s" % (parent, path)
|
|
if parent == "/" or parent == "":
|
|
break
|
|
dirs.append(parent)
|
|
path = parent
|
|
|
|
dirs.reverse()
|
|
for dir in dirs:
|
|
#print "dir %s" % dir
|
|
if os.path.isdir(dir):
|
|
continue
|
|
os.mkdir(dir)
|
|
|
|
def walk_source_files(paths,callback,args,excludes=[]):
|
|
"""recursively walk a list of paths and files, only keeping the source files in directories"""
|
|
for path in paths:
|
|
if len(path) > 0 and path[0] == '@':
|
|
# this is the name of another file, include it and parse it
|
|
path = path[1:]
|
|
if os.path.exists(path):
|
|
for line in open(path):
|
|
if len(line) > 0 and line[-1] == '\n':
|
|
line = line[:-1]
|
|
walk_source_files([line],callback,args,excludes)
|
|
continue
|
|
if not os.path.isdir(path):
|
|
callback(path,args)
|
|
else:
|
|
for root, dirs, files in os.walk(path):
|
|
#print "w-- %s (ex: %s)" % (repr((root,dirs)), repr(excludes))
|
|
if len(excludes):
|
|
for d in dirs[:]:
|
|
if os.path.join(root,d) in excludes:
|
|
dirs.remove(d)
|
|
for f in files:
|
|
r, ext = os.path.splitext(f)
|
|
if ext in [ ".h", ".c", ".cpp", ".S" ]:
|
|
callback( "%s/%s" % (root,f), args )
|
|
|
|
def cleanup_dir(path):
|
|
"""create a directory if needed, and ensure that it is totally empty
|
|
by removing any existing content in it"""
|
|
if not os.path.exists(path):
|
|
os.mkdir(path)
|
|
else:
|
|
for root, dirs, files in os.walk(path, topdown=False):
|
|
if root.endswith("kernel_headers/"):
|
|
# skip 'kernel_headers'
|
|
continue
|
|
for name in files:
|
|
os.remove(os.path.join(root, name))
|
|
for name in dirs:
|
|
os.rmdir(os.path.join(root, name))
|
|
|
|
def update_file( path, newdata ):
|
|
"""update a file on disk, only if its content has changed"""
|
|
if os.path.exists( path ):
|
|
try:
|
|
f = open( path, "r" )
|
|
olddata = f.read()
|
|
f.close()
|
|
except:
|
|
D("update_file: cannot read existing file '%s'" % path)
|
|
return 0
|
|
|
|
if oldata == newdata:
|
|
D2("update_file: no change to file '%s'" % path )
|
|
return 0
|
|
|
|
update = 1
|
|
else:
|
|
try:
|
|
create_file_path(path)
|
|
except:
|
|
D("update_file: cannot create path to '%s'" % path)
|
|
return 0
|
|
|
|
f = open( path, "w" )
|
|
f.write( newdata )
|
|
f.close()
|
|
|
|
return 1
|
|
|
|
|
|
class BatchFileUpdater:
|
|
"""a class used to edit several files at once"""
|
|
def __init__(self):
|
|
self.old_files = set()
|
|
self.new_files = set()
|
|
self.new_data = {}
|
|
|
|
def readFile(self,path):
|
|
#path = os.path.realpath(path)
|
|
if os.path.exists(path):
|
|
self.old_files.add(path)
|
|
|
|
def readDir(self,path):
|
|
#path = os.path.realpath(path)
|
|
for root, dirs, files in os.walk(path):
|
|
for f in files:
|
|
dst = "%s/%s" % (root,f)
|
|
self.old_files.add(dst)
|
|
|
|
def editFile(self,dst,data):
|
|
"""edit a destination file. if the file is not mapped from a source,
|
|
it will be added. return 0 if the file content wasn't changed,
|
|
1 if it was edited, or 2 if the file is new"""
|
|
#dst = os.path.realpath(dst)
|
|
result = 1
|
|
if os.path.exists(dst):
|
|
f = open(dst, "r")
|
|
olddata = f.read()
|
|
f.close()
|
|
if olddata == data:
|
|
self.old_files.remove(dst)
|
|
return 0
|
|
else:
|
|
result = 2
|
|
|
|
self.new_data[dst] = data
|
|
self.new_files.add(dst)
|
|
return result
|
|
|
|
def getChanges(self):
|
|
"""determine changes, returns (adds, deletes, edits)"""
|
|
adds = set()
|
|
edits = set()
|
|
deletes = set()
|
|
|
|
for dst in self.new_files:
|
|
if not (dst in self.old_files):
|
|
adds.add(dst)
|
|
else:
|
|
edits.add(dst)
|
|
|
|
for dst in self.old_files:
|
|
if not dst in self.new_files:
|
|
deletes.add(dst)
|
|
|
|
return (adds, deletes, edits)
|
|
|
|
def _writeFile(self,dst,data=None):
|
|
if not os.path.exists(os.path.dirname(dst)):
|
|
create_file_path(dst)
|
|
if data == None:
|
|
data = self.new_data[dst]
|
|
f = open(dst, "w")
|
|
f.write(self.new_data[dst])
|
|
f.close()
|
|
|
|
def updateFiles(self):
|
|
adds, deletes, edits = self.getChanges()
|
|
|
|
for dst in sorted(adds):
|
|
self._writeFile(dst)
|
|
|
|
for dst in sorted(edits):
|
|
self._writeFile(dst)
|
|
|
|
for dst in sorted(deletes):
|
|
os.remove(dst)
|
|
|
|
def updateP4Files(self):
|
|
adds, deletes, edits = self.getChanges()
|
|
|
|
if len(adds):
|
|
files = string.join(sorted(adds)," ")
|
|
D( "%d new files will be p4 add-ed" % len(adds) )
|
|
for dst in adds:
|
|
self._writeFile(dst)
|
|
D2("P4 ADDS: %s" % files)
|
|
o = commands.getoutput( "p4 add " + files )
|
|
D2( o )
|
|
|
|
if len(edits):
|
|
files = string.join(sorted(edits)," ")
|
|
D( "%d files will be p4 edit-ed" % len(edits) )
|
|
D2("P4 EDITS: %s" % files)
|
|
o = commands.getoutput( "p4 edit " + files )
|
|
D2( o )
|
|
for dst in edits:
|
|
self._writeFile(dst)
|
|
|
|
if len(deletes):
|
|
files = string.join(sorted(deletes)," ")
|
|
D( "%d files will be p4 delete-d" % len(deletes) )
|
|
D2("P4 DELETES: %s" % files)
|
|
o = commands.getoutput( "p4 delete " + files )
|
|
D2( o )
|
|
|
|
def updateGitFiles(self):
|
|
adds, deletes, edits = self.getChanges()
|
|
|
|
if adds:
|
|
for dst in sorted(adds):
|
|
self._writeFile(dst)
|
|
commands.getoutput("git add " + " ".join(adds))
|
|
|
|
if deletes:
|
|
commands.getoutput("git rm " + " ".join(deletes))
|
|
|
|
if edits:
|
|
for dst in sorted(edits):
|
|
self._writeFile(dst)
|
|
commands.getoutput("git add " + " ".join(edits))
|