__unique_stable_name implementation.

CONTRIBUTING.md

@@ -0,0 +1,94 @@
+# Contributing
+
+## License
+Intel Project for LLVM* technology is licensed under the terms of the
+Apache-2.0 with LLVM-exception license (
+[LICENSE.txt](https://github.com/intel/llvm/blob/intel/llvm/LICENSE.TXT))
+to ensure our ability to contribute this project to the LLVM project
+under the same license.
+
+By contributing to this project, you agree to the Apache-2.0 with
+LLVM-exception license and copyright terms there in and release your
+contribution under these terms.
+
+## Sign your work
+Please use the sign-off line at the end of your contribution. Your
+signature certifies that you wrote the contribution or otherwise have
+the right to pass it on as an open-source contribution, and that you
+agree to provide your contribution under the terms of the licenses
+noted above. The rules are pretty simple: if you can certify the
+below (from [developercertificate.org](http://developercertificate.org)):
+
+```
+Developer Certificate of Origin
+Version 1.1
+
+Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
+660 York Street, Suite 102,
+San Francisco, CA 94110 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+(a) The contribution was created in whole or in part by me and I
+    have the right to submit it under the open source license
+    indicated in the file; or
+
+(b) The contribution is based upon previous work that, to the best
+    of my knowledge, is covered under an appropriate open source
+    license and I have the right under that license to submit that
+    work with modifications, whether created in whole or in part
+    by me, under the same open source license (unless I am
+    permitted to submit under a different license), as indicated
+    in the file; or
+
+(c) The contribution was provided directly to me by some other
+    person who certified (a), (b) or (c) and I have not modified
+    it.
+
+(d) I understand and agree that this project and the contribution
+    are public and that a record of the contribution (including all
+    personal information I submit with it, including my sign-off) is
+    maintained indefinitely and may be redistributed consistent with
+    this project or the open source license(s) involved.
+```
+
+Then you just add a line to every git commit message:
+
+    Signed-off-by: Joe Smith <joe.smith@email.com>
+
+Use your real name (sorry, no pseudonyms or anonymous contributions.)
+
+If you set your `user.name` and `user.email` git configs, you can sign your commit automatically with `git commit -s`.
+
+## Contribution process
+
+### Development
+
+ - Create a personal fork of the project on GitHub.
+ - Use **sycl** branch as baseline for your changes.
+ - Prepare your patch (follow [LLVM coding standards](https://llvm.org/docs/CodingStandards.html)).
+ - Build the project and run all tests (see [GetStartedWithSYCLCompiler.md](https://github.com/intel/llvm/blob/sycl/sycl/doc/GetStartedWithSYCLCompiler.md))
+
+### Review and acceptance testing
+
+ - Create a pull request for your changes following [Creating a pull request instructions](https://help.github.com/articles/creating-a-pull-request/).
+ - When the pull request is created signed-off check is done.
+     - **check_pr** - verifies that the signed-off mark is added to each commit message.
+ - Once the pull request is approved by an Intel representative, build and functional testing are started.
+     - **sycl-ubu-x64-pr** - runs all LIT tests on machine with OpenCL runtimes for CPU and GPU.
+ - Approval is lost once the PR branch is updated. New approval and checks rerun are required.
+ - Once approval is received and all checks pass, the pull request is ready to be merged.
+
+### Merge
+
+Merge of pull request is done only by project maintainers. There are three options:
+ - [Rebase and merge] The preferable choice for PRs containing a single commit.
+ - [Squash and merge] Used when there are multiple commits in the PR. 
+   Squashing is done to shorten history and make sure that the project is buildable on any commit.
+ - [Create a merge commit] Used for pull down PRs to avoid duplication of
+   LLVM commits.

README.md

@@ -1,5 +1,23 @@
-# The LLVM Compiler Infrastructure
+# Intel Project for LLVM* technology
 
-This directory and its subdirectories contain source code for LLVM,
-a toolkit for the construction of highly optimized compilers,
-optimizers, and runtime environments.
+## Introduction
+
+Intel staging area for llvm.org contribution.
+Home for Intel LLVM-based projects:
+ - SYCL* Compiler and Runtimes - compiler and runtime libraries for SYCL ([https://www.khronos.org/sycl/](https://www.khronos.org/sycl/)). See **sycl** branch.
+
+## License
+See [LICENSE.txt](https://github.com/intel/llvm/blob/intel/llvm/LICENSE.TXT) for details.
+
+
+## Contributing
+See [CONTRIBUTING.md](https://github.com/intel/llvm/blob/intel/CONTRIBUTING.md) for details.
+
+## Sub-projects Documentation
+ - SYCL Compiler and Runtimes - See [GetStartedWithSYCLCompiler.md](https://github.com/intel/llvm/blob/sycl/sycl/doc/GetStartedWithSYCLCompiler.md)
+
+*Other names and brands may be claimed as the property of others.
+
+## SYCL Extension Proposal Documents
+
+See [sycl/doc/extensions](https://github.com/intel/llvm/tree/sycl/sycl/doc/extensions)

buildbot/README.md

@@ -0,0 +1,28 @@
+# Scripts for build steps on Buildbot
+
+## Purpose
+
+The purpose of the script is for developer to customize build command for the
+builder on Buildbot.
+
+## How it works
+
+The scripts will be run by Buildbot at corresponding build step, for example,
+the **compile** step will run `compile.py`. Developer can change the build
+command, then the builder (e.g. pull request builder) will use the changed
+command to do the build.
+
+## Arguments for the scripts
+
+Refer to argument parser in `main()` function.
+
+## Assumptions
+
+The Buildbot worker directory structure is:
+
+    /path/to/WORKER_ROOT/BUILDER/
+        llvm.src  --> source code
+        llvm.obj  --> build directory
+
+Working directory of the scripts is /path/to/WORKER_ROOT/BUILDER
+

buildbot/check.py

@@ -0,0 +1,47 @@
+import argparse
+import os
+import subprocess
+import sys
+
+DEFAULT_CPU_COUNT = 4
+
+def do_check(args):
+    ret = False
+
+    cpu_count = os.cpu_count()
+    if cpu_count is None:
+        cpu_count = DEFAULT_CPU_COUNT
+
+    make_cmd = ["make", args.test_suite, "VERBOSE=1", "-j", str(cpu_count), "LIT_ARGS=\"-v\""]
+    print(make_cmd)
+
+    subprocess.check_call(make_cmd, cwd=args.obj_dir)
+
+    ret = True
+    return ret
+
+def main():
+    parser = argparse.ArgumentParser(prog="check.py",
+                                     description="script to do LIT testing",
+                                     formatter_class=argparse.RawTextHelpFormatter)
+    parser.add_argument("-n", "--build-number", metavar="BUILD_NUM", help="build number")
+    parser.add_argument("-b", "--branch", metavar="BRANCH", help="pull request branch")
+    parser.add_argument("-d", "--base-branch", metavar="BASE_BRANCH", help="pull request base branch")
+    parser.add_argument("-r", "--pr-number", metavar="PR_NUM", help="pull request number")
+    parser.add_argument("-w", "--builder-dir", metavar="BUILDER_DIR",
+                        help="builder directory, which is the directory contains source and build directories")
+    parser.add_argument("-s", "--src-dir", metavar="SRC_DIR", help="source directory")
+    parser.add_argument("-o", "--obj-dir", metavar="OBJ_DIR", required=True, help="build directory")
+    parser.add_argument("-t", "--test-suite", metavar="TEST_SUITE", required=True, help="check-xxx target")
+
+    args = parser.parse_args()
+
+    print("args:{}".format(args))
+
+    return do_check(args)
+
+if __name__ == "__main__":
+    ret = main()
+    exit_code = 0 if ret else 1
+    sys.exit(exit_code)
+

buildbot/clang_tidy.py

@@ -0,0 +1,68 @@
+import argparse
+import os
+import subprocess
+import sys
+
+FILE_EXTENSIONS = [".h", ".hpp", ".c", ".cc", ".cpp"]
+
+def do_clang_tidy(args):
+    ret = False
+
+    merge_base_cmd = ["git", "merge-base", "origin/{}".format(args.base_branch), args.branch]
+    print(merge_base_cmd)
+    base_commit = subprocess.check_output(merge_base_cmd, cwd=args.src_dir)
+    base_commit = base_commit.rstrip()
+
+    changed_files = os.path.join(args.builder_dir, "clang_tidy_changed_files.txt")
+    if os.path.isfile(changed_files):
+        os.remove(changed_files)
+
+    diff_cmd = ["git", "--no-pager", "diff", base_commit, args.branch, "--name-only"]
+    print(diff_cmd)
+    with open(changed_files, 'w') as f:
+        subprocess.check_call(merge_base_cmd, cwd=args.src_dir, stdout=f, stderr=subprocess.STDOUT)
+
+    if os.path.isfile(changed_files):
+        clang_tidy_binary = os.path.join(args.obj_dir, "bin", "clang-tidy")
+        if os.path.isfile(clang_tidy_binary):
+            with open(changed_files, 'r') as f:
+                for line in f:
+                    filename, file_extension = os.path.splitext(line)
+                    if file_extension.lower() in FILE_EXTENSIONS:
+                        clang_tidy_cmd = [clang_tidy_binary, line]
+                        print(clang_tidy_cmd)
+                        subprocess.run(clang_tidy_binary, cwd=args.src_dir)
+            ret = True
+        else:
+            print("no such file:{}".format(clang_tidy_binary))
+            # TODO report error when clang-tidy is ready
+            print("clang-tidy is not get built, always return success for now.")
+            ret = True
+
+    return ret
+
+def main():
+    parser = argparse.ArgumentParser(prog="clang_tidy.py",
+                                     description="script to do clang_tidy",
+                                     formatter_class=argparse.RawTextHelpFormatter)
+    parser.add_argument("-n", "--build-number", metavar="BUILD_NUM", help="build number")
+    parser.add_argument("-b", "--branch", metavar="BRANCH", required=True, help="pull request branch")
+    parser.add_argument("-d", "--base-branch", metavar="BASE_BRANCH", required=True,
+                        help="pull request base branch")
+    parser.add_argument("-r", "--pr-number", metavar="PR_NUM", help="pull request number")
+    parser.add_argument("-w", "--builder-dir", metavar="BUILDER_DIR", required=True,
+                        help="builder directory, which is the directory contains source and build directories")
+    parser.add_argument("-s", "--src-dir", metavar="SRC_DIR", required=True, help="source directory")
+    parser.add_argument("-o", "--obj-dir", metavar="OBJ_DIR", required=True, help="build directory")
+
+    args = parser.parse_args()
+
+    print("args:{}".format(args))
+
+    return do_clang_tidy(args)
+
+if __name__ == "__main__":
+    ret = main()
+    exit_code = 0 if ret else 1
+    sys.exit(exit_code)
+

buildbot/compile.py

@@ -0,0 +1,46 @@
+import argparse
+import os
+import subprocess
+import sys
+
+DEFAULT_CPU_COUNT = 4
+
+def do_compile(args):
+    ret = False
+
+    cpu_count = os.cpu_count()
+    if cpu_count is None:
+        cpu_count = DEFAULT_CPU_COUNT
+
+    make_cmd = ["make", "-j", str(cpu_count), "sycl-toolchain"]
+    print(make_cmd)
+
+    subprocess.check_call(make_cmd, cwd=args.obj_dir)
+
+    ret = True
+    return ret
+
+def main():
+    parser = argparse.ArgumentParser(prog="compile.py",
+                                     description="script to do compile",
+                                     formatter_class=argparse.RawTextHelpFormatter)
+    parser.add_argument("-n", "--build-number", metavar="BUILD_NUM", help="build number")
+    parser.add_argument("-b", "--branch", metavar="BRANCH", help="pull request branch")
+    parser.add_argument("-d", "--base-branch", metavar="BASE_BRANCH", help="pull request base branch")
+    parser.add_argument("-r", "--pr-number", metavar="PR_NUM", help="pull request number")
+    parser.add_argument("-w", "--builder-dir", metavar="BUILDER_DIR",
+                        help="builder directory, which is the directory contains source and build directories")
+    parser.add_argument("-s", "--src-dir", metavar="SRC_DIR", help="source directory")
+    parser.add_argument("-o", "--obj-dir", metavar="OBJ_DIR", required=True, help="build directory")
+
+    args = parser.parse_args()
+
+    print("args:{}".format(args))
+
+    return do_compile(args)
+
+if __name__ == "__main__":
+    ret = main()
+    exit_code = 0 if ret else 1
+    sys.exit(exit_code)
+

buildbot/configure.py

@@ -0,0 +1,64 @@
+import argparse
+import os
+import subprocess
+import sys
+
+def do_configure(args):
+    ret = False
+
+    llvm_dir = os.path.join(args.src_dir, "llvm")
+    sycl_dir = os.path.join(args.src_dir, "sycl")
+    spirv_dir = os.path.join(args.src_dir, "llvm-spirv")
+    ocl_header_dir = os.path.join(args.obj_dir, "OpenCL-Headers")
+    icd_loader_lib = os.path.join(args.obj_dir, "OpenCL-ICD-Loader", "build", "libOpenCL.so")
+
+    cmake_cmd = ["cmake",
+                 "-DCMAKE_BUILD_TYPE={}".format(args.build_type),
+                 "-DLLVM_EXTERNAL_PROJECTS=sycl;llvm-spirv",
+                 "-DLLVM_EXTERNAL_SYCL_SOURCE_DIR={}".format(sycl_dir),
+                 "-DLLVM_EXTERNAL_LLVM_SPIRV_SOURCE_DIR={}".format(spirv_dir),
+                 "-DLLVM_ENABLE_PROJECTS=clang;llvm-spirv;sycl",
+                 "-DOpenCL_INCLUDE_DIR={}".format(ocl_header_dir),
+                 "-DOpenCL_LIBRARY={}".format(icd_loader_lib),
+                 "-DLLVM_BUILD_TOOLS=OFF",
+                 llvm_dir]
+
+    print(cmake_cmd)
+
+    try:
+        subprocess.check_call(cmake_cmd, cwd=args.obj_dir)
+    except subprocess.CalledProcessError:
+        cmake_cache = os.path.join(args.obj_dir, "CMakeCache.txt")
+        if os.path.isfile(cmake_cache):
+            os.remove(cmake_cache)
+        subprocess.check_call(cmake_cmd, cwd=args.obj_dir)
+
+    ret = True
+    return ret
+
+def main():
+    parser = argparse.ArgumentParser(prog="configure.py",
+                                     description="script to do configure",
+                                     formatter_class=argparse.RawTextHelpFormatter)
+    parser.add_argument("-n", "--build-number", metavar="BUILD_NUM", help="build number")
+    parser.add_argument("-b", "--branch", metavar="BRANCH", help="pull request branch")
+    parser.add_argument("-d", "--base-branch", metavar="BASE_BRANCH", help="pull request base branch")
+    parser.add_argument("-r", "--pr-number", metavar="PR_NUM", help="pull request number")
+    parser.add_argument("-w", "--builder-dir", metavar="BUILDER_DIR",
+                        help="builder directory, which is the directory contains source and build directories")
+    parser.add_argument("-s", "--src-dir", metavar="SRC_DIR", required=True, help="source directory")
+    parser.add_argument("-o", "--obj-dir", metavar="OBJ_DIR", required=True, help="build directory")
+    parser.add_argument("-t", "--build-type",
+                        metavar="BUILD_TYPE", required=True, help="build type, debug or release")
+
+    args = parser.parse_args()
+
+    print("args:{}".format(args))
+
+    return do_configure(args)
+
+if __name__ == "__main__":
+    ret = main()
+    exit_code = 0 if ret else 1
+    sys.exit(exit_code)
+