1<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
2  <Import Project="$(VCTargetsPath)\Microsoft.CppCommon.targets" />
3
4  <PropertyGroup>
5    <!-- Set the path to clang-cl executable based on the value of the project-
6         level setting.  This has to be done in the .targets file since values
7         selected via the settings UI appear in the vcxproj (which is imported
8         before the targets file but after the props file) and we need the path
9         that the user may have overridden in the UI. -->
10    <CLToolExe Condition="$(UseClangCl)">$(ClangClExecutable)</CLToolExe>
11    <LinkToolExe Condition="$(UseLldLink)">$(LldLinkExecutable)</LinkToolExe>
12    <LIBToolExe Condition="$(UseLlvmLib)">$(LlvmLibExecutable)</LIBToolExe>
13  </PropertyGroup>
14
15  <ItemGroup>
16    <PropertyPageSchema Include="$(VCTargetsPath)$(LangID)\llvm-general.xml">
17      <Context>Project</Context>
18    </PropertyPageSchema>
19  </ItemGroup>
20
21  <!-- Take any clang-specific options that the user wants to pass and stick them onto the
22       general purpose list of command line flags. -->
23  <ItemDefinitionGroup Condition="$(UseClangCl)">
24    <ClCompile>
25      <AdditionalOptions>-m$(PlatformArchitecture) $(ClangClAdditionalOptions) %(AdditionalOptions)</AdditionalOptions>
26    </ClCompile>
27  </ItemDefinitionGroup>
28
29  <ItemDefinitionGroup Condition="$(UseLldLink)">
30    <Link>
31      <AdditionalOptions>$(LldLinkAdditionalOptions) %(AdditionalOptions)</AdditionalOptions>
32    </Link>
33  </ItemDefinitionGroup>
34
35  <!-- We hook up a target to run every time ClCompile is about to run, the
36       purpose of which is to sanitize the command line before it gets passed to
37       the compiler.  Some options we silently discard, other options we warn on
38       and then discard, and other options we generate a hard error.
39
40       We try to keep hard errors to a minimum and reserve it for cases where
41       the option implies fundamentally different assumptions about the way code
42       should be compiled.  This code would probably generate an error anyway,
43       but at least this way we give the user a more useful message about what
44       the actual problem is, rather than relying on some obscure compilation
45       error.
46
47       For any options that clang-cl discards, we would prefer to not even pass
48       them in on the command line.  So if a user starts with a cl projects and
49       changes the toolset to clang, they could have set options such as /Gm
50       (minimal rebuild), /sdl (Security Checks), etc.  The ClCompile task would
51       then notice this and pass these through to clang-cl.exe.  Clang would of
52       course ignore them, but in some cases (such as /Gm), they would generate
53       -Wunused-command-line-argument warnings, so it's better if we can just
54       strip them from the command line entirely.  This also has the side
55       benefit of making command lines shorter which is always nice when trying
56       to look at the tool output.
57      -->
58  <Target Name="BeforeClCompile" BeforeTargets="ClCompile" Condition="$(UseClangCl)">
59    <!-- Error if they're trying to compile this file as managed code. -->
60    <Error Condition="('%(ClCompile.CompileAsManaged)' != 'false') AND ('%(ClCompile.CompileAsManaged)' != '')"
61           File="@(ClCompile)(0,0)"
62           Text="clang-cl does not support compiling managed code (/clr).  This file cannot be compiled."/>
63
64    <!-- Error if WinRT is being used. -->
65    <Error Condition="('%(ClCompile.CompileAsWinRT)' == 'true') OR ('%(ClCompile.WinRTNoStdLib)' == 'true')"
66           File="@(ClCompile)(0,0)"
67           Text="clang-cl does not support Windows Runtime Language Extensions (/ZW, /ZW:nostdlib).  This file cannot be compiled."/>
68
69    <!-- Error if OpenMP language extensions are enabled. -->
70    <Error Condition="'%(ClCompile.OpenMPSupport)' == 'true'"
71           File="@(ClCompile)(0,0)"
72           Text="clang-cl does not support OpenMP (/openmp).  This file cannot be compiled."/>
73
74    <!-- Error if C++ Modules are enabled.  Clang has its own notion of modules that are not compatible. -->
75    <Error Condition="'%(ClCompile.EnableModules)' == 'true'"
76           File="@(ClCompile)(0,0)"
77           Text="clang-cl does not support MSVC Modules (/experimental:module).  This file cannot be compiled."/>
78
79    <ItemGroup>
80      <ClCompile>
81        <!-- Map /ZI and /Zi to /Z7.  Clang internally does this, so if we were
82             to just pass the option through, clang would work.  The problem is
83             that MSBuild would not.  MSBuild detects /ZI and /Zi and then
84             assumes (rightly) that there will be a compiler-generated PDB (e.g.
85             vc141.pdb).  Since clang-cl will not emit this, MSBuild will always
86             think that the compiler-generated PDB needs to be re-generated from
87             scratch and trigger a full build.  The way to avoid this is to
88             always give MSBuild accurate information about how we plan to
89             generate debug info (which is to always using /Z7 semantics).
90             -->
91        <DebugInformationFormat Condition="'%(ClCompile.DebugInformationFormat)' == 'ProgramDatabase'">OldStyle</DebugInformationFormat>
92        <DebugInformationFormat Condition="'%(ClCompile.DebugInformationFormat)' == 'EditAndContinue'">OldStyle</DebugInformationFormat>
93
94        <!-- Unset any options that we either silently ignore or warn about due to compatibility.
95             Generally when an option is set to no value, that means "Don't pass an option to the
96             compiler at all."
97             -->
98        <WholeProgramOptimization/>
99        <EnableFiberSafeOptimizations/>
100        <IgnoreStandardIncludePath/>
101        <EnableParallelCodeGeneration/>
102        <ForceConformanceInForLoopScope/>
103        <TreatWChar_tAsBuiltInType/>
104        <SDLCheck/>
105        <GenerateXMLDocumentationFiles/>
106        <BrowseInformation/>
107        <EnablePREfast/>
108        <MinimalRebuild/>
109        <StringPooling/>
110        <ExpandAttributedSource/>
111        <EnforceTypeConversionRules/>
112        <ErrorReporting/>
113        <DisableLanguageExtensions/>
114        <ProgramDataBaseFileName/>
115        <DisableSpecificWarnings/>
116        <TreatSpecificWarningsAsErrors/>
117        <ForcedUsingFiles/>
118        <PREfastLog/>
119        <PREfastAdditionalOptions/>
120        <PREfastAdditionalPlugins/>
121        <MultiProcessorCompilation/>
122        <UseFullPaths/>
123        <RemoveUnreferencedCodeData/>
124
125        <!-- We can't just unset BasicRuntimeChecks, as that will pass /RTCu to the compiler.
126             We have to explicitly set it to 'Default' to avoid passing anything. -->
127        <BasicRuntimeChecks>Default</BasicRuntimeChecks>
128      </ClCompile>
129    </ItemGroup>
130  </Target>
131
132</Project>
133