errors: generate error codes for WERROR
authorBob Campbell <bobcampbell@catalyst.net.nz>
Thu, 12 Jan 2017 21:22:16 +0000 (10:22 +1300)
committerAndrew Bartlett <abartlet@samba.org>
Tue, 14 Feb 2017 08:46:23 +0000 (09:46 +0100)
Signed-off-by: Bob Campbell <bobcampbell@catalyst.net.nz>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Garming Sam <garming@catalyst.net.nz>
source4/scripting/bin/gen_werror.py [new file with mode: 0644]

diff --git a/source4/scripting/bin/gen_werror.py b/source4/scripting/bin/gen_werror.py
new file mode 100644 (file)
index 0000000..7210d3f
--- /dev/null
@@ -0,0 +1,149 @@
+#!/usr/bin/env python
+
+#
+# Unix SMB/CIFS implementation.
+#
+# WERROR error definition generation
+#
+# Copyright (C) Catalyst.Net Ltd. 2017
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+import sys, os.path, io, string
+from gen_error_common import parseErrorDescriptions, ErrorDef
+
+def generateHeaderFile(out_file, errors):
+    out_file.write("/*\n")
+    out_file.write(" * Descriptions for errors generated from\n")
+    out_file.write(" * [MS-ERREF] https://msdn.microsoft.com/en-us/library/cc231199.aspx\n")
+    out_file.write(" */\n\n")
+    out_file.write("#ifndef _WERR_GEN_H\n")
+    out_file.write("#define _WERR_GEN_H\n")
+    for err in errors:
+        line = "#define %s W_ERROR(%s)\n" % (err.err_define, hex(err.err_code))
+        out_file.write(line)
+    out_file.write("\n#endif /* _WERR_GEN_H */\n")
+
+def generateSourceFile(out_file, errors):
+    out_file.write("#include \"werror.h\"\n")
+
+    out_file.write("/*\n")
+    out_file.write(" * Names for errors generated from\n")
+    out_file.write(" * [MS-ERREF] https://msdn.microsoft.com/en-us/library/cc231199.aspx\n")
+    out_file.write(" */\n")
+
+    out_file.write("static const struct werror_code_struct dos_errs[] = \n")
+    out_file.write("{\n")
+    for err in errors:
+        out_file.write("\t{ \"%s\", %s },\n" % (err.err_define, err.err_define))
+    out_file.write("{ 0, W_ERROR(0) }\n")
+    out_file.write("};\n")
+
+    out_file.write("\n/*\n")
+    out_file.write(" * Descriptions for errors generated from\n")
+    out_file.write(" * [MS-ERREF] https://msdn.microsoft.com/en-us/library/cc231199.aspx\n")
+    out_file.write(" */\n")
+
+    out_file.write("static const struct werror_str_struct dos_err_strs[] = \n")
+    out_file.write("{\n")
+    for err in errors:
+        # Account for the possibility that some errors may not have descriptions
+        if err.err_string == "":
+            continue
+        out_file.write("\t{ %s, \"%s\" },\n"%(err.err_define, err.err_string))
+    out_file.write("\t{ W_ERROR(0), 0 }\n")
+    out_file.write("};")
+
+def generatePythonFile(out_file, errors):
+    out_file.write("/*\n")
+    out_file.write(" * Errors generated from\n")
+    out_file.write(" * [MS-ERREF] https://msdn.microsoft.com/en-us/library/cc231199.aspx\n")
+    out_file.write(" */\n")
+    out_file.write("#include <Python.h>\n")
+    out_file.write("#include \"includes.h\"\n\n")
+    out_file.write("static inline PyObject *ndr_PyLong_FromUnsignedLongLong(unsigned long long v)\n");
+    out_file.write("{\n");
+    out_file.write("\tif (v > LONG_MAX) {\n");
+    out_file.write("\t\treturn PyLong_FromUnsignedLongLong(v);\n");
+    out_file.write("\t} else {\n");
+    out_file.write("\t\treturn PyInt_FromLong(v);\n");
+    out_file.write("\t}\n");
+    out_file.write("}\n\n");
+    # This is needed to avoid a missing prototype error from the C
+    # compiler. There is never a prototype for this function, it is a
+    # module loaded by python with dlopen() and found with dlsym().
+    out_file.write("void initwerror(void);\n")
+    out_file.write("void initwerror(void)\n")
+    out_file.write("{\n")
+    out_file.write("\tPyObject *m;\n\n")
+    out_file.write("\tm = Py_InitModule3(\"werror\", NULL, \"WERROR defines\");\n");
+    out_file.write("\tif (m == NULL)\n");
+    out_file.write("\t\treturn;\n\n");
+    for err in errors:
+        line = """\tPyModule_AddObject(m, \"%s\",
+                  \t\tndr_PyLong_FromUnsignedLongLong(W_ERROR_V(%s)));\n""" % (err.err_define, err.err_define)
+        out_file.write(line)
+    out_file.write("}\n");
+
+def transformErrorName( error_name ):
+    if error_name.startswith("WERR_"):
+        error_name = error_name.replace("WERR_", "", 1)
+    elif error_name.startswith("ERROR_"):
+        error_name = error_name.replace("ERROR_", "", 1)
+    return "WERR_" + error_name.upper()
+
+# Script to generate files werror_gen.h, doserr_gen.c and
+# py_werror.c.
+#
+# These files contain generated definitions for WERRs and
+# their descriptions/names.
+#
+# This script takes four inputs:
+# [1]: The name of the text file which is the content of an HTML table
+#      (e.g. the one found at https://msdn.microsoft.com/en-us/library/cc231199.aspx)
+#      copied and pasted.
+# [2]: [[output werror_gen.h]]
+# [3]: [[output doserr_gen.c]]
+# [4]: [[output py_werror.c]]
+def main():
+    if len(sys.argv) == 5:
+        input_file_name = sys.argv[1]
+        gen_headerfile_name = sys.argv[2]
+        gen_sourcefile_name = sys.argv[3]
+        gen_pythonfile_name = sys.argv[4]
+    else:
+        print "usage: %s winerrorfile headerfile sourcefile pythonfile" % sys.argv[0]
+        sys.exit()
+
+    input_file = open(input_file_name, "r")
+    errors = parseErrorDescriptions(input_file, True, transformErrorName)
+    input_file.close()
+
+    print "writing new header file: %s" % gen_headerfile_name
+    out_file = open(gen_headerfile_name, "w")
+    generateHeaderFile(out_file, errors)
+    out_file.close()
+    print "writing new source file: %s" % gen_sourcefile_name
+    out_file = open(gen_sourcefile_name, "w")
+    generateSourceFile(out_file, errors)
+    out_file.close()
+    print "writing new python file: %s" % gen_pythonfile_name
+    out_file = open(gen_pythonfile_name, "w")
+    generatePythonFile(out_file, errors)
+    out_file.close()
+
+if __name__ == '__main__':
+
+    main()