summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorjashook <jashoo@microsoft.com>2017-06-14 10:01:58 -0700
committerjashook <jashoo@microsoft.com>2017-06-14 10:21:11 -0700
commitba2acbdfe136cb5ab1b875368ed2768193d59b5e (patch)
treed35c1ccf85fcd7002018355c351c0cd59e7468f6 /Documentation
parentb386a62a3b191d01723fa9a5c65fa4914dcb4854 (diff)
downloadcoreclr-ba2acbdfe136cb5ab1b875368ed2768193d59b5e.tar.gz
coreclr-ba2acbdfe136cb5ab1b875368ed2768193d59b5e.tar.bz2
coreclr-ba2acbdfe136cb5ab1b875368ed2768193d59b5e.zip
Add documentation for building test(s) on Unix
This also includes steps on how to build individual tests.
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/building/unix-test-instructions.md32
1 files changed, 30 insertions, 2 deletions
diff --git a/Documentation/building/unix-test-instructions.md b/Documentation/building/unix-test-instructions.md
index 96546a0249..a6dd77afa7 100644
--- a/Documentation/building/unix-test-instructions.md
+++ b/Documentation/building/unix-test-instructions.md
@@ -6,12 +6,40 @@ CoreCLR tests
**Building**
-Build CoreCLR on [Windows](https://github.com/dotnet/coreclr/blob/master/Documentation/building/windows-instructions.md) & [Unix](https://github.com/dotnet/coreclr/blob/master/Documentation/building/linux-instructions.md), and CoreFX on [Unix](https://github.com/dotnet/corefx/blob/master/Documentation/building/unix-instructions.md).
+Build CoreCLR on [Unix](https://github.com/dotnet/coreclr/blob/master/Documentation/building/linux-instructions.md), and CoreFX on [Unix](https://github.com/dotnet/corefx/blob/master/Documentation/building/unix-instructions.md).
-To build only the tests, on the Windows machine:
+**Building the Tests**
+
+To build the tests on Unix:
+
+> `./build-test.sh -rebuild`
+
+As of [#11860](https://github.com/dotnet/coreclr/pull/11860) building the tests on unix works; however, it will take significantly more time than building on Windows.
+
+To build on Windows:
> `C:\coreclr>build-test.cmd -rebuild`
+**Building Individual Tests**
+
+During development there are many instances where building an individual test is fast and necessary. All of the necessary tools to build are under coreclr/Tools. It is possible to use coreclr/Tools/MSBuild.dll as you would normally use MSBuild with a few caveats.
+
+Note that coreclr/Tools/msbuild.sh exists as well to make the call shorter.
+
+**!! Note !! -- Passing /p:__BuildOs=[OSX|Linux] is required.**
+
+>If you omit it you will get the following error: `error MSB4801: The task factory "CodeTaskFactory" could not be loaded because this version of MSBuild does not support it.`
+---
+
+**Building an Individual Test Example**
+
+>`coreclr/Tools/msbuild.sh /maxcpucount coreclr/tests/src/JIT/CodeGenBringUpTests/Array1.csproj /p:__BuildType=Release /p:__BuildOS=OSX`
+
+Or
+
+>`coreclr/Tools/dotnetcli/dotnet coreclr/Tools/MSBuild.dll /maxcpucount coreclr/tests/src/JIT/CodeGenBringUpTests/Array1.csproj /p:__BuildType=Release /p:__BuildOS=OSX`
+
+
**Running tests**
The following instructions assume that on the Unix machine: