Use macro rather than manually setting thumb bit in debugger.cpp

[platform/upstream/coreclr.git] / Documentation / project-docs / profiling-api-status.md

diff --git a/Documentation/project-docs/profiling-api-status.md b/Documentation/project-docs/profiling-api-status.md
index 7aaec3c..599e8c1 100644 (file)
--- a/Documentation/project-docs/profiling-api-status.md
+++ b/Documentation/project-docs/profiling-api-status.md
@@ -1,46 +1,27 @@
-#Status of CoreCLR Profiler APIs
-
-The notes below will help you determine what profiling APIs are safe to use. The .NET Core project started with the codebase from the desktop CoreCLR/Silverlight so all the profiler APIs present there are also present in the code here. However that doesn't automatically imply that they are all working or being actively tested right now. Our goal is to eventually have everything tested and working across all the supported OSes. As we make progress we'll document it here. If you want to use APIs that we haven't tested yet you are welcome to do so, but you need to do your own testing to determine whether they work. If you do test APIs we haven't gotten to yet, we hope you'll add a note below in the Community Tested API section so that everyone can benefit.
-
-##Microsoft Tested APIs:
-
-###Windows
-
-* ICorProfilerCallback:
- * `Initialize`
- * `ModuleLoadFinished`
- * `ModuleUnloadStarted`
- * `ModuleUnloadFinished`
- * `ModuleAttachedToAssembly`
- * `JITCompilationStarted`
-
-* ICorProfilerInfo:
- * `GetModuleInfo`
- * `GetModuleMetaData`
- * `GetModuleInfo`
- * `GetModuleInfo2`
- * `GetModuleMetaData`
- * `GetFunctionInfo`
- * `SetILFunctionBody`
- * `SetILInstrumentedCodeMap`
- * `GetILFunctionBodyAllocator`
- * `GetRuntimeInformation`
- * `SetEventMask`
-
-* The flags tested for SetEventMask are:
- * `COR_PRF_MONITOR_MODULE_LOADS`
- * `COR_PRF_MONITOR_JIT_COMPILATION`
- * `COR_PRF_DISABLE_INLINING`
-
-###Linux
-###OS X
-
-##Community Tested APIs (please include GitHub handle)
-###Windows
-###Linux
-###OS X
-
-##APIs definitely known not to work yet
-###Windows
-###Linux
-###OS X
+# Status of CoreCLR Profiler APIs
+
+The .NET Core project started with the codebase from the desktop CoreCLR/Silverlight so all the profiler APIs present there are also present in the code here. This is the status of our testing and porting efforts for these APIs.
+
+## Platform test coverage
+
+- Windows on x86/x64/arm32
+- Linux on x86/x64/arm32
+- OSX 
+
+## Known issues
+
+### DoStackSnapshot
+
+The implementation of this API was making some questionable assumptions about Windows OS API behavior in order to walk callstacks asynchronously. When operating in this async mode we aren't yet confident we can produce reasonable implementations for other platforms. Our understanding is that most users of this API are attempting to do sample based profiling. If so we think it may be easier to offer a runtime provided event stream of sample callstacks to accomplish the same scenario without needing the API, but we also haven't heard any demand for it. Feedback welcome!
+
+### Profiler does not disable Concurrent GC
+
+See github issue [#13153](https://github.com/dotnet/coreclr/issues/13153) for more details.
+
+### ReJIT on ARM
+
+ReJIT feature is only available on x86/x64 for now. 
+
+### Any issues we missed?
+
+Please let us know and we will get it addressed. Thanks!
\ No newline at end of file