NETHostWindows.cpp 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413
  1. #include <Atomic/IO/Log.h>
  2. #include <Atomic/IO/FileSystem.h>
  3. #include "NETHostWindows.h"
  4. // https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/clr-configuration-knobs.md
  5. // set COMPLUS_LogEnable=1
  6. // set COMPLUS_LogToConsole=1
  7. // set COMPLUS_LogLevel=9
  8. // set COMPLUS_ManagedLogFacility=0x00001000
  9. namespace Atomic
  10. {
  11. NETHostWindows::NETHostWindows(Context* context) :
  12. NETHost(context),
  13. clrRuntimeHost_(0),
  14. clrModule_(0),
  15. appDomainID_(0)
  16. {
  17. }
  18. NETHostWindows::~NETHostWindows()
  19. {
  20. }
  21. bool NETHostWindows::CreateDelegate(const String& assemblyName, const String& qualifiedClassName, const String& methodName, void** funcOut)
  22. {
  23. if (!clrRuntimeHost_)
  24. return false;
  25. HRESULT hr = clrRuntimeHost_->CreateDelegate(appDomainID_, WString(assemblyName).CString(), WString(qualifiedClassName).CString(), WString(methodName).CString(), (INT_PTR *)funcOut);
  26. if (FAILED(hr))
  27. {
  28. return false;
  29. }
  30. return true;
  31. }
  32. bool NETHostWindows::Initialize()
  33. {
  34. // It is very important that this is the native path "\\" vs "/" as find files will return "/" or "\" depending
  35. // on what you give it, which will result in the domain failing to initialize as coreclr can't handle "/" on init
  36. if (!coreCLRFilesAbsPath_.Length())
  37. return false;
  38. if (!coreCLRTPAPaths_.Length())
  39. return false;
  40. if (!coreCLRAssemblyLoadPaths_.Length())
  41. return false;
  42. if (!LoadCLRDLL())
  43. return false;
  44. if (!InitCLRRuntimeHost())
  45. return false;
  46. if (!CreateAppDomain())
  47. return false;
  48. return true;
  49. }
  50. void NETHostWindows::WaitForDebuggerConnect()
  51. {
  52. while (!IsDebuggerPresent())
  53. {
  54. Sleep(100);
  55. }
  56. }
  57. bool NETHostWindows::LoadCLRDLL()
  58. {
  59. WString wcoreCLRDLLPath(coreCLRFilesAbsPath_ + "coreclr.dll");
  60. HMODULE result = ::LoadLibraryExW(wcoreCLRDLLPath.CString(), NULL, 0);
  61. if (!result)
  62. {
  63. LOGERRORF("Unable to load CoreCLR from %s", (coreCLRFilesAbsPath_ + "coreclr.dll").CString() );
  64. return false;
  65. }
  66. // Pin the module - CoreCLR.dll does not support being unloaded.
  67. HMODULE dummy_coreCLRModule;
  68. if (!::GetModuleHandleExW(GET_MODULE_HANDLE_EX_FLAG_PIN, wcoreCLRDLLPath.CString(), &dummy_coreCLRModule))
  69. {
  70. LOGERRORF("Unable to pin CoreCLR module: %s", (coreCLRFilesAbsPath_ + "coreclr.dll").CString() );
  71. return false;
  72. }
  73. clrModule_ = result;
  74. return true;
  75. }
  76. bool NETHostWindows::CreateAppDomain()
  77. {
  78. wchar_t appPath[MAX_LONGPATH] = W("");
  79. wchar_t appNiPath[MAX_LONGPATH * 2] = W("");
  80. //wcscpy_s(appPath, WString(coreCLRFilesAbsPath_).CString());
  81. wcscpy_s(appNiPath, appPath);
  82. wcscat_s(appNiPath, MAX_LONGPATH * 2, W(";"));
  83. wcscat_s(appNiPath, MAX_LONGPATH * 2, appPath);
  84. // Construct native search directory paths
  85. wchar_t nativeDllSearchDirs[MAX_LONGPATH * 3];
  86. wcscpy_s(nativeDllSearchDirs, appPath);
  87. wcscat_s(nativeDllSearchDirs, MAX_LONGPATH * 3, W(";"));
  88. wcscat_s(nativeDllSearchDirs, MAX_LONGPATH * 3, WString(coreCLRFilesAbsPath_).CString());
  89. //-------------------------------------------------------------
  90. // Create an AppDomain
  91. // Allowed property names:
  92. // APPBASE
  93. // - The base path of the application from which the exe and other assemblies will be loaded
  94. //
  95. // TRUSTED_PLATFORM_ASSEMBLIES
  96. // - The list of complete paths to each of the fully trusted assemblies
  97. //
  98. // APP_PATHS
  99. // - The list of paths which will be probed by the assembly loader
  100. //
  101. // APP_NI_PATHS
  102. // - The list of additional paths that the assembly loader will probe for ngen images
  103. //
  104. // NATIVE_DLL_SEARCH_DIRECTORIES
  105. // - The list of paths that will be probed for native DLLs called by PInvoke
  106. //
  107. // IMPORTANT: ALL PATHS MUST USE "\" and not "/"
  108. const wchar_t *property_keys[] = {
  109. W("TRUSTED_PLATFORM_ASSEMBLIES"),
  110. W("APP_PATHS"),
  111. W("APP_NI_PATHS"),
  112. W("NATIVE_DLL_SEARCH_DIRECTORIES"),
  113. W("AppDomainCompatSwitch")
  114. };
  115. const wchar_t *property_values[] = {
  116. // TRUSTED_PLATFORM_ASSEMBLIES
  117. tpaList_.CStr(),
  118. // APP_PATHS
  119. appPath,
  120. // APP_NI_PATHS
  121. appNiPath,
  122. // NATIVE_DLL_SEARCH_DIRECTORIES
  123. nativeDllSearchDirs,
  124. // AppDomainCompatSwitch
  125. W("UseLatestBehaviorWhenTFMNotSpecified")
  126. };
  127. HRESULT hr = clrRuntimeHost_->CreateAppDomainWithManager(
  128. W("AtomicNETDomain"), // The friendly name of the AppDomain
  129. // Flags:
  130. // APPDOMAIN_ENABLE_PLATFORM_SPECIFIC_APPS
  131. // - By default CoreCLR only allows platform neutral assembly to be run. To allow
  132. // assemblies marked as platform specific, include this flag
  133. //
  134. // APPDOMAIN_ENABLE_PINVOKE_AND_CLASSIC_COMINTEROP
  135. // - Allows sandboxed applications to make P/Invoke calls and use COM interop
  136. //
  137. // APPDOMAIN_SECURITY_SANDBOXED
  138. // - Enables sandboxing. If not set, the app is considered full trust
  139. //
  140. // APPDOMAIN_IGNORE_UNHANDLED_EXCEPTION
  141. // - Prevents the application from being torn down if a managed exception is unhandled
  142. //
  143. APPDOMAIN_ENABLE_PLATFORM_SPECIFIC_APPS |
  144. APPDOMAIN_ENABLE_PINVOKE_AND_CLASSIC_COMINTEROP |
  145. APPDOMAIN_DISABLE_TRANSPARENCY_ENFORCEMENT,
  146. NULL, // Name of the assembly that contains the AppDomainManager implementation
  147. NULL, // The AppDomainManager implementation type name
  148. sizeof(property_keys)/sizeof(wchar_t*), // The number of properties
  149. property_keys,
  150. property_values,
  151. &appDomainID_);
  152. if (FAILED(hr)) {
  153. LOGERRORF("Failed call to CreateAppDomainWithManager. ERRORCODE:%u ", hr);
  154. return false;
  155. }
  156. return true;
  157. }
  158. bool NETHostWindows::InitCLRRuntimeHost()
  159. {
  160. if (!clrModule_)
  161. return false;
  162. FnGetCLRRuntimeHost pfnGetCLRRuntimeHost =
  163. (FnGetCLRRuntimeHost)::GetProcAddress(clrModule_, "GetCLRRuntimeHost");
  164. if (!pfnGetCLRRuntimeHost)
  165. {
  166. LOGERRORF("Unable to get GetCLRRuntimeHost function from module: %s", (coreCLRFilesAbsPath_ + "coreclr.dll").CString() );
  167. return false;
  168. }
  169. HRESULT hr = pfnGetCLRRuntimeHost(IID_ICLRRuntimeHost2, (IUnknown**)&clrRuntimeHost_);
  170. if (FAILED(hr))
  171. {
  172. LOGERRORF("Failed to get ICLRRuntimeHost2 interface. ERRORCODE: %u", hr);
  173. return false;
  174. }
  175. // Set up the startup flags for the clr runtime
  176. STARTUP_FLAGS dwStartupFlags = (STARTUP_FLAGS)(
  177. STARTUP_FLAGS::STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN |
  178. STARTUP_FLAGS::STARTUP_SINGLE_APPDOMAIN /* |
  179. STARTUP_FLAGS::STARTUP_SERVER_GC*/
  180. );
  181. // Default startup flags
  182. hr = clrRuntimeHost_->SetStartupFlags(dwStartupFlags);
  183. if (FAILED(hr))
  184. {
  185. LOGERRORF("Failed to set startup flags. ERRORCODE: %u", hr);
  186. return false;
  187. }
  188. /*
  189. // Authenticate with either CORECLR_HOST_AUTHENTICATION_KEY or CORECLR_HOST_AUTHENTICATION_KEY_NONGEN
  190. hr = clrRuntimeHost_->Authenticate(CORECLR_HOST_AUTHENTICATION_KEY);
  191. if (FAILED(hr))
  192. {
  193. LOGERRORF("CoreCLR failed to authenticate. ERRORCODE: %u", hr);
  194. return false;
  195. }
  196. */
  197. hr = clrRuntimeHost_->Start();
  198. if (FAILED(hr))
  199. {
  200. LOGERRORF("Failed to start CoreCLR. ERRORCODE: %u", hr);
  201. return false;
  202. }
  203. if (!GenerateTPAList())
  204. {
  205. LOGERRORF("Failed to generate TPA List");
  206. return false;
  207. }
  208. return true;
  209. }
  210. bool NETHostWindows::TPAListContainsFile(wchar_t* fileNameWithoutExtension, wchar_t** rgTPAExtensions, int countExtensions)
  211. {
  212. if (!tpaList_.CStr()) return false;
  213. for (int iExtension = 0; iExtension < countExtensions; iExtension++)
  214. {
  215. wchar_t fileName[MAX_LONGPATH];
  216. wcscpy_s(fileName, MAX_LONGPATH, W("\\")); // So that we don't match other files that end with the current file name
  217. wcscat_s(fileName, MAX_LONGPATH, fileNameWithoutExtension);
  218. wcscat_s(fileName, MAX_LONGPATH, rgTPAExtensions[iExtension] + 1);
  219. wcscat_s(fileName, MAX_LONGPATH, W(";")); // So that we don't match other files that begin with the current file name
  220. if (wcsstr(tpaList_.CStr(), fileName))
  221. {
  222. return true;
  223. }
  224. }
  225. return false;
  226. }
  227. void NETHostWindows::RemoveExtensionAndNi(wchar_t* fileName)
  228. {
  229. // Remove extension, if it exists
  230. wchar_t* extension = wcsrchr(fileName, W('.'));
  231. if (extension != NULL)
  232. {
  233. extension[0] = W('\0');
  234. // Check for .ni
  235. size_t len = wcslen(fileName);
  236. if (len > 3 &&
  237. fileName[len - 1] == W('i') &&
  238. fileName[len - 2] == W('n') &&
  239. fileName[len - 3] == W('.') )
  240. {
  241. fileName[len - 3] = W('\0');
  242. }
  243. }
  244. }
  245. void NETHostWindows::AddFilesFromDirectoryToTPAList(const wchar_t* targetPath, wchar_t** rgTPAExtensions, int countExtensions)
  246. {
  247. wchar_t assemblyPath[MAX_LONGPATH];
  248. for (int iExtension = 0; iExtension < countExtensions; iExtension++)
  249. {
  250. wcscpy_s(assemblyPath, MAX_LONGPATH, targetPath);
  251. const size_t dirLength = wcslen(targetPath);
  252. wchar_t* const fileNameBuffer = assemblyPath + dirLength;
  253. const size_t fileNameBufferSize = MAX_LONGPATH - dirLength;
  254. wcscat_s(assemblyPath, rgTPAExtensions[iExtension]);
  255. WIN32_FIND_DATA data;
  256. HANDLE findHandle = FindFirstFile(assemblyPath, &data);
  257. if (findHandle != INVALID_HANDLE_VALUE)
  258. {
  259. do
  260. {
  261. if (!(data.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY))
  262. {
  263. // It seems that CoreCLR doesn't always use the first instance of an assembly on the TPA list (ni's may be preferred
  264. // over il, even if they appear later). So, only include the first instance of a simple assembly name to allow
  265. // users the opportunity to override Framework assemblies by placing dlls in %CORE_LIBRARIES%
  266. // ToLower for case-insensitive comparisons
  267. wchar_t* fileNameChar = data.cFileName;
  268. while (*fileNameChar)
  269. {
  270. *fileNameChar = towlower(*fileNameChar);
  271. fileNameChar++;
  272. }
  273. // Remove extension
  274. wchar_t fileNameWithoutExtension[MAX_LONGPATH];
  275. wcscpy_s(fileNameWithoutExtension, MAX_LONGPATH, data.cFileName);
  276. RemoveExtensionAndNi(fileNameWithoutExtension);
  277. // Add to the list if not already on it
  278. if (!TPAListContainsFile(fileNameWithoutExtension, rgTPAExtensions, countExtensions))
  279. {
  280. const size_t fileLength = wcslen(data.cFileName);
  281. const size_t assemblyPathLength = dirLength + fileLength;
  282. wcsncpy_s(fileNameBuffer, fileNameBufferSize, data.cFileName, fileLength);
  283. tpaList_.Append(assemblyPath, assemblyPathLength);
  284. tpaList_.Append(W(";"), 1);
  285. }
  286. else
  287. {
  288. LOGINFOF("NETHostWindows skipping assembly");
  289. }
  290. }
  291. } while (0 != FindNextFile(findHandle, &data));
  292. FindClose(findHandle);
  293. }
  294. }
  295. }
  296. bool NETHostWindows::GenerateTPAList()
  297. {
  298. wchar_t *rgTPAExtensions[] = {
  299. W("*.ni.dll"), // Probe for .ni.dll first so that it's preferred if ni and il coexist in the same dir
  300. W("*.dll"),
  301. W("*.ni.exe"),
  302. W("*.exe"),
  303. };
  304. AddFilesFromDirectoryToTPAList(WString(coreCLRFilesAbsPath_).CString(), rgTPAExtensions, _countof(rgTPAExtensions));
  305. Vector<String> paths = coreCLRTPAPaths_.Split(';');
  306. for (unsigned i = 0; i < paths.Size(); i++)
  307. {
  308. AddFilesFromDirectoryToTPAList(WString(GetNativePath(paths[i])).CString(), rgTPAExtensions, _countof(rgTPAExtensions));
  309. }
  310. return true;
  311. }
  312. }
  313. /*
  314. RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogEnable, W("LogEnable"), "Turns on the traditional CLR log.")
  315. RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFacility, W("LogFacility"), "Specifies a facility mask for CLR log. (See 'loglf.h'; VM interprets string value as hex number.) Also used by stresslog.")
  316. RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFacility2, W("LogFacility2"), "Specifies a facility mask for CLR log. (See 'loglf.h'; VM interprets string value as hex number.) Also used by stresslog.")
  317. RETAIL_CONFIG_DWORD_INFO(EXTERNAL_logFatalError, W("logFatalError"), 1, "Specifies whether EventReporter logs fatal errors in the Windows event log.")
  318. CONFIG_STRING_INFO_EX(INTERNAL_LogFile, W("LogFile"), "Specifies a file name for the CLR log.", CLRConfig::REGUTIL_default)
  319. CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFileAppend, W("LogFileAppend"), "Specifies whether to append to or replace the CLR log file.")
  320. CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogFlushFile, W("LogFlushFile"), "Specifies whether to flush the CLR log file file on each write.")
  321. RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(EXTERNAL_LogLevel, W("LogLevel"), "4=10 msgs, 9=1000000, 10=everything")
  322. RETAIL_CONFIG_STRING_INFO_DIRECT_ACCESS(INTERNAL_LogPath, W("LogPath"), "?Fusion debug log path.")
  323. RETAIL_CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogToConsole, W("LogToConsole"), "Writes the CLR log to console.")
  324. CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogToDebugger, W("LogToDebugger"), "Writes the CLR log to debugger (OutputDebugStringA).")
  325. CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogToFile, W("LogToFile"), "Writes the CLR log to a file.")
  326. CONFIG_DWORD_INFO_DIRECT_ACCESS(INTERNAL_LogWithPid, W("LogWithPid"), "Appends pid to filename for the CLR log.")
  327. RETAIL_CONFIG_DWORD_INFO_EX(EXTERNAL_FusionLogFileNamesIncludePid, W("FusionLogFileNamesIncludePid"), 0, "Fusion logging will append process id to log filenames.", CLRConfig::REGUTIL_default)
  328. */