Update main README.md to include FreeBSD

This PR adds FreeBSD to the main README.md.

Merge pull request #800 from janhenke/fbsd-doc

Initial FreeBSD instructions based on the Linux instructions.

Initial FreeBSD instructions based on the Linux instructions.

This file is a copy of the Linux instructions, modified for the differences
between Linux and FreeBSD. It is not perfect yet, we are still missing some
parts on FreeBSD (LLDB, CoreFX). Also the package download with NuGet.exe does
not work yet due to a problem with importing CA certs. Nevertheless this is a
start and better than nothing. Closes #799.

Merge pull request #798 from justincormack/netbsd

basic NetBSD platform support

basic NetBSD platform support

Merge pull request #790 from richlander/rich-readme

Add source instructions more prominently

Add source instructions more prominently

Merge pull request #795 from richlander/rich-windowsnuget

Add instructions for acquiring binaries for Windows via NuGet

Add instructions for acquiring binaries for Windows via NuGet

Merge pull request #796 from stephentoub/temp_currency_symbol

Temporarily change invariant currency symbol on Unix for demo purposes

Temporarily change invariant currency symbol on Unix for demo purposes

mscorlib's globalization stack on Unix is a temporary implementation, good enough to help unblock getting the rest of the system up and running and for some basic demos.  However, such demos are hindered slightly by the use of the international monetary symbol "\x00a4" when rendering currency.  This commit just makes a temporary tweak to instead use "$".

Merge pull request #794 from dotnet/fix-gc-issue

Fix GC stack unwinding issue

Fix GC stack unwinding issue

This change fixes a GC stack unwinding issue when a GC is
triggered in a catch handler that caught a rethrown
exception.
The problem was that we need to propagate the m_fFixupCallerSPForGCReporting
to the new exception tracker created when interleaved exception handling
starts processing a block of managed frames after processing another
block of managed frames followed by a block of native frames.
Without this flag, the m_EnclosingClauseInfoForGCReporting's
caller SP is not updated when the target unwind frame is found and
such an update is needed.

Merge pull request #788 from ellismg/fix-pal-dylib-loading

Fix loading of PAL on OSX

Merge pull request #787 from sokket/master

Fixing an issue in FILECanonicalizePath where some paths did not canonicalize properly

Merge pull request #783 from Djuffin/dbi-linux

CoreCLR DBI  automatically detects CLR instance to attach to

Fix loading of PAL on OSX

On OSX our trick to preload the PAL from the host before trying to load
coreclr doesn't actually cause the OSX loader to correctly resolve the
dependency.

This change moves to use rpath and then add an entry to the rpath list
for libcoreclr to @loader_path.

This way, we can load libcoreclr even in cases where the path to the PAL
is not on DYLD_LIBRARY_PATH and your CWD is not the doesn't have a copy.

Related issues are #709 and #719

Addressing PR feedback in the test cases and fixing casing for test case runs

CoreCLR DBI  automatically detects CLR instance to attach to (when possible)

Merge pull request #791 from janhenke/freebsd-linking

Fix the two remaining linker errors on FreeBSD.

Merge pull request #789 from mikem8361/dactablefix

Fixed the dac table file problem

Fix the two remaining linker errors on FreeBSD.

Thanks to Jan Vorlicek for finding the source of the first linker error. Those
linker options need to be passed to the linker on FreeBSD too.
The second linker error is caused by the fact that FreeBSD has no libdl, the
functionality is instead implemented in libc. Thus do not add the -ldl option
to the linker on FreeBSD. Fixes #739

This is fixes the build on FreeBSD completely!

Merge pull request #786 from libengu/TestStructPromote

Add Directed/StructPromote test cases for JIT

Merge pull request #784 from libengu/TestGenericsFields

Add Generics/Fields test cases for JIT

Fixed the dac table file problem. The file name used isn't unique if there is more than one process running managed code.  As a temporary fix (using a file is very temporary anyway), use the CLR module base address in the file name. Even if there is more than one process with managed code/coreclr running if the base address is the same the dac table address will be the same. Moved the dac table initialization to be sooner in the EE initialization because SOS/DAC can need it even before the EE debugger support is started. Also fixed the dac table file cleanup. We can't actually remove the dac file now that the base address is part of the name because multiple processes could be using it.

Merge pull request #773 from janhenke/build-args

Add optional arguments for choosing clang version and verbose build output

Merge pull request #771 from mikem8361/hwexcept

Share hardware exception between coreclr and DAC

Changed the VM's hardware exception to return if not in manged code. For DAC's hardware exception handling, add
hardware exception holder used to determine if a C++ exception should be thrown for a hardware exception. Cleaned
up PAL initialization interactions between the debugger modules (PAL_InitializeDLL) and coreclr (PAL_InitializeCoreCLR).

Addressing PR feedback

Fixing an issue in FILECanonicalizePath where paths like /Test/..
would not be properly canonicalized due to a missing check to
ensure the function doesn't truncate the root slash

Merge pull request #785 from DickvdBrink/SOS-plugin-build

Fixed lldb not found error on fedora

Add Directed/StructPromote test cases for JIT

Add Directed/StructPromote test cases for JIT. Related proj, config files
added. Solution file update is delayed to later PRs for parallel working.
Passed build, buildtest, runtest.

Fixed lldb not found error on fedora

liblldb is installed in /usr/lib64/llvm/liblldb.so

Add Generics/Fields test cases for JIT

Add Generics/Fields test cases for JIT. Related proj, config, and sln files
added and updated. Passed build, buildtest, runtest.

Merge pull request #759 from brianrob/perfmap

Enable perf_events to resolve JIT compiled code addresses

Add optional arguments for choosing clang version and verbose build output

This commit adds two optional arguments to build.sh. The "verbose" option
enables verbose build output. This can be useful to debug build failures by
seeing the complete command line used to invoke the build.
The other option is "clangx.y", which allows to specify the clang version used
for the build. This makes it easy to test different clang versions and aid
future migration to newer clang releases and other platforms. Closes #740

Merge pull request #776 from libengu/TestInlineOpt

Add Inline test cases for JIT

Merge pull request #774 from dotnet-bot/from-tfs

Merge changes from TFS

Add Inline test cases for JIT

Add inlining optimizaiton test cases for JIT. Related proj, config, and sln files
added and updated. Passed build, buildtest, runtest.

Merge pull request #750 from fieryorc/pull/add-apis

Add few pal APIs to pal library

Add few pal APIs needed for debugger code.
Added APIs:

InterlockedBitTestAndReset
InterlockedBitTestAndSet
InitializeCriticalSectionEx

Added test for the first two APIs.

Merge pull request #775 from mmitche/run-cppcheck

Initial commit of script to run cppcheck.

Initial commit of script to run cppcheck.

This script runs the cppcheck and sloccount tools for static analysis.  The lab runs this script with the default arguments

Mark script as executable

Adds support for resolving JIT compiled managed call frames in perf_events.

Merge pull request #768 from libengu/TestGenericsArrays

Add Generics/Arrays test cases for JIT

Merge pull request #765 from DickvdBrink/llvm_locate_fix

Fixed locating llvm tools on fedora

Update framework assembly for System.Uri WinRT projection from System.dll to Internal.Uri.dll

For NetCore for CoreCLR System.Uri was moved from System.dll to Internal.Uri.dll. This change updates the WinRT projection for this change.

This is a temporary workaround while we investigate a complete fix and will break phone and .NET 4.6 scenarios.

[tfs-changeset: 1457678]

Add Generics/Arrays test cases for JIT

Add test cases in directory JIT/Generics/Arrays. Related proj, config, and sln files
added and updated. Passed build, buildtest, runtest.

Merge pull request #766 from libengu/cmov

Add test cases in directory Directed/cmov

Add test cases in directory Directed/cmov

Add test cases in directory Directed/cmov. Logical operator
tests where many of the operations emit cmov instruciton on
x86\x64. Related proj, config, and sln files added and updated.
Passed build, buildtest, runtest.

Merge pull request #752 from CarolEidt/PrecedenceFixes

Issue #609 & #610: Fix precedence issues

Merge pull request #754 from jkotas/unnecessaryfile

Delete unnecessary .gitmirror file

Delete unnecessary .gitmirror file

Merge pull request #753 from dotnet-bot/from-tfs

Merge changes from TFS

Use more appropriate mirror setting for src\corefx

[tfs-changeset: 1457001]

Merge pull request #745 from bartonjs/crypto-interop-library

Create native interop library System.Security.Cryptography.Native

Fixed locating llvm tools on fedora

The locate_llvm_exec function was missing the $llvm_prefix

Merge pull request #746 from libengu/TestCheckedCtor

Add CSharp Base/Peer Constructor test cases

Create native interop library System.Security.Cryptography.Native

Add CSharp Base/Peer Constructor test cases

Add CSharp Base/Peer Constructor test cases. Related proj, config,
and sln files added and updated. Passed build, buildtest, runtest.

Issue #609 & #610: Fix precedence issues

Near line 6089 in importer.cpp, enforcing the precedence indicated by
the indentation resulted in no diffs, which at first seemed surprising.
However, this is because we never encounter the other mask values
without calli.

Near line 10483, this is where we convert (dup, stloc) to (stloc, ldloc).
This was clearly intended only for non-debug mode, but the original code
in the importer was like this:

     if (!opts.compDbgCode &&
         (nextOpcode == CEE_STLOC)   ||
         (nextOpcode == CEE_STLOC_S) ||
         ((nextOpcode >= CEE_STLOC_0) &&
         (nextOpcode <= CEE_STLOC_3)))
     {
         insertLdloc = true;

Due to the fact that the parens don't support the apparent intended
precedence, the condition is equivalent to:

    if ((!opts.compDbgCode && (nextOpcode == CEE_STLOC)   ||
       (nextOpcode == CEE_STLOC_S)                        ||
       ((nextOpcode >= CEE_STLOC_0) && (nextOpcode <= CEE_STLOC_3)))

Changing it the apparent original meaning caused regressions.  This is
because it is often cheaper to load a local (i.e. the insertLdloc case)
than to do a dup, which may 1) cause a temp to be created to store the
value on the stack, or 2) result in a tree (e.g. a large constant) which
is cloneable but which is more expensive in code bytes than a ldloc.

The original code clearly intended to do this only in the non-debug case,
but with the incorrect parens it was doing it for any short stloc.  I'm
not sure that it is 100% OK to do this transformation on dbg code, but
we've apparently been doing it for some time (it's the same way in
jit32).

Adding the apparently intended parens caused regressions (158392 bytes
over all the MCH files). The change in this shelveset has a net
improvement (3848 bytes over all jitAsmDiffs).  (Doing this
transformation in all cases, i.e. just eliminating the !opts.compDbgCode,
causes zero diffs, indicating that we don't have any instances of dups
followed by non-short stlocs.)

Fix #609
Fix #610

Merge pull request #742 from dotnet-bot/from-tfs

Merge changes from TFS

Enable build crossgen.exe from build.cmd.

Adds and modifies CMakeLists.txt files to enable building of crossgen.exe from build.cmd for x64 processor on Windows. Also adds a step in build.cmd to generate native image for mscorlib.

[tfs-changeset: 1456454]

Merge pull request #736 from ellismg/hardcode-utf8-in-pal

Hardcode CP_ACP to UTF-8 on Linux

Merge pull request #727 from richlander/rich-docs

Add Book of the Runtime docs

Merge pull request #733 from stephentoub/temp_path

Make GetTempPathA/W first check TMPDIR

Merge pull request #738 from libengu/AddJITCSETests

Add JIT CSE tests

Add JIT CSE tests

Add JIT CSE (common sub-expression elimination) optimization tests.
Related proj, config, and sln files added and updated. Passed build,
buildtest, runtest. Code went through Microsoft internal process
to meet open-source requirements.

Merge pull request #737 from janvorli/fix-div-overflow-exception

Ensure we differentiate between division by zero and overflow

Ensure we differentiate between division by zero and overflow

This change implements parsing of the IDIV instruction operand so that
we can find whether an integer division error was a division by zero or
an integer overflow.
It replaces the previous functionality that was implemented for OSX only
and was incomplete (it didn't handle memory operands) and partially incorrect
(not handling R8..R15 properly).

Add DAC Notes Book of the Runtime doc

Add Threading Book of the Runtime doc

Simplify a bit of logic in GetTempPathA

Hardcode CP_ACP to UTF-8 on Linux

Previously, on Linux, the PAL would attempt to detect the current codepage via
setlocale and maintained a mapping from LC_TYPES to Win32 locale names.
On OSX, we didn't do any of this, instead we always used UTF-8 as the
current codepage.

This change moves to this model on Linux as well, something we want to
do because it will enable us to use Ansi marshalling during PInvoke to
marshall UTF-8 data to native code (which is common when interoping with
existing native libraries on Linux) and allows us to remove a bunch of
code we don't want to carry forward from the PAL.

Merge pull request #730 from josteink/freebsd-linking

CoreClr: Fix FreeBSD linking-issues.

Add Profiling Book of the Runtime doc

Add Exceptions Book of the Runtime doc

Add Type System Book of the Runtime doc

Merge pull request #734 from josteink/freebsd-fpregs

Fix up final FPU-registers for FreeBSD x86_64.

Fix up final FPU-registers for FreeBSD x86_64.

FreeBSD now builds without compilation errors. For FreeBSD and glory!

                ,        ,
               /(        )`
               \ \___   / |
               /- _  `-/  '
              (/\/ \ \   /\
              / /   | `    \
              O O   ) /    |
              `-^--'`<     '
             (_.)  _  )   /
              `.___/`    /
                `-----' /
   <----.     __ / __   \
   <----|====O)))==) \) /====
   <----'    `--' `.__,' \
                |        |
                 \       /       /\
            ______( (_  / \______/
          ,'  ,-----'   |
          `--{__________)

This closes https://github.com/dotnet/coreclr/issues/594#issuecomment-93995183

Make GetTempPathA/W first check TMPDIR

Today GetTempPathA/W are hardcoded to return /tmp/.  This commit makes them first consult the TMPDIR environment variable, using its value if it exists.

This also overhauls the tests for GetTempPathA/W, which were out-of-date with regards to the existing implementation and which were excluded from PAL test runs.

CoreClr: Fix FreeBSD linking-issues.

This fix brings the build almost up to 100% (from 35%), where it fails due to PIC-errors.

Merge pull request #729 from mikem8361/clrstackfix

The ICorDebug version of sos ClrStack command stopped working

Merge pull request #723 from janvorli/fix-dangling-else

Fix dangling else warnings

The ICorDebug version of sos ClrStack command ("sos ClrStack -i") stopped working.  The existing was enumerating

all the modules in the target process to find the coreclr module, but under linux we just picked the first module found
because given just the base address of the module, it isn't easy to determine correct module given the context and
constrains the debugshim code ran.  We were lucky and picked the correct module but now the order has changed
which broke this command.

The fix is to just get the address for coreclr and create the ICorDebug interface from that instead of enumerating all the modules.

Merge pull request #701 from janvorli/fix-freebsd-rc-issue

Fix .rc processing issue on FreeBSD

Merge pull request #726 from janvorli/fix-copyright-headers

Add missing MIT license headers

Fix the return macro on Windows

There seems to be a bug in the VC++ compiler that causes the
following error to occur:
ex.cpp(492): fatal error C1061: compiler limit : blocks nested too deeply
There seems to be no nesting when I look at preprocessed source of the ex.cpp
and it builds fine on Unix.
To make the Windows build happy, I have left the return macro definition
for MSVC as it was before my change and only changed it for other compilers.

Merge pull request #721 from pgavlin/CorWarnings

Fix two sources of warnings in cor{,info}.h

Merge pull request #724 from ellismg/use-libcoreclr-for-some-apis

PInvoke to libcoreclr for three APIs

Merge pull request #722 from dotnet-bot/from-tfs

Merge changes from TFS

Add missing MIT license headers

.rc and .def files were missing the MIT license headers, so this
change adds them.

PInvoke to libcoreclr for three APIs

After pulling the PAL out of the runtime, we redirected all the PInvokes
which were going to libcoreclr to libcoreclrpal. It turns out that
CoTaskMemAlloc, CoTaskMemFree and CoCreateGuid are still exported by the
runtime itself and not the PAL.

Update the three PInvokes for these functions from managed code to point
at the runtime itself.

Fix dangling else warnings

This change fixes all dangling else warnings and removes the
compiler flag that was disabling their reporting.

Merge pull request #691 from josteink/freebsd-threading

PAL: Fix threading on FreeBSD.

Fix for the build break. I had moved UAP Host under a folder whcih is built only for x86. I'm changing the dirs.proj's to build the UAPHost for all architectures.
I verified that UAPHost gets built on x86coresys and armcoresys, whille VSIntegration and MSBuildTask folders gets built only on x86coresys.

[tfs-changeset: 1454192]

Fix two sources of warnings in cor{,info}.h

- cor.h was incorrectly casting a pointer-to-const to a
  pointer-to-non-const.
- corinfo.h contained a 0-sized array, which is not standard C++,
  and therefore generates a warning on compilers without MSVC
  extensions enabled. Using a 1-sized array (which is already done
  elsewhere in the same file) prevents this warning.

PAL: Fix threading on FreeBSD.

Merge pull request #719 from ellismg/preload-pal-from-corerun

Explicitly load libcoreclrpal in corerun

Explicitly load libcoreclrpal in corerun

libcoreclr has a dependency on libcoreclrpal, but libcoreclrpal is
usually not on the path the loader probes, since it is SxS with the
runtime itself.

Instead of forcing LD_LIBRARY_PATH to be set just have corerun load the
PAL from the same folder as the runtime before loading libcoreclr.

Fixes #709