mirror of
https://github.com/VSadov/Satori.git
synced 2025-06-08 11:37:04 +09:00
Fix trailing whitespaces (#40891)
* Trim trailing whitespaces * Match raw with rendered * Delete extra asterisks and | * Update ELT Hooks - tail calls.md Co-authored-by: Jan Kotas <jkotas@microsoft.com>
This commit is contained in:
parent
d9f0ba704d
commit
d14b50ae21
141 changed files with 1128 additions and 1219 deletions
|
@ -14,13 +14,13 @@ Debugging CoreFX build issues
|
|||
|
||||
(This documentation is work in progress.)
|
||||
|
||||
I found the following process to help when investigating some of the build issues caused by incorrect packaging.
|
||||
I found the following process to help when investigating some of the build issues caused by incorrect packaging.
|
||||
|
||||
To quickly validate if a given project compiles on all supported configurations use `dotnet build /t:RebuildAll`. This applies for running tests as well. For more information, see [Building individual libraries](../../building/libraries/README.md#building-individual-libraries)
|
||||
To quickly validate if a given project compiles on all supported configurations use `dotnet build /t:RebuildAll`. This applies for running tests as well. For more information, see [Building individual libraries](../../building/libraries/README.md#building-individual-libraries)
|
||||
|
||||
Assuming the current directory is `\src\contractname\`:
|
||||
|
||||
1. Build the `\ref` folder: `dotnet build`
|
||||
1. Build the `\ref` folder: `dotnet build`
|
||||
|
||||
|
||||
Check the logs for output such as:
|
||||
|
@ -58,7 +58,7 @@ Use the same technique above to ensure that the binaries include the correct imp
|
|||
|
||||
Ensure that all Build Pivots are actually being built. This should build all .\ref and .\src variations as well as actually creating the NuGet packages.
|
||||
|
||||
Verify that the contents of the nuspec as well as the actual package is correct. You can find the packages by searching for the following pattern in the msbuild output:
|
||||
Verify that the contents of the nuspec as well as the actual package is correct. You can find the packages by searching for the following pattern in the msbuild output:
|
||||
|
||||
```
|
||||
GetPkgProjPackageDependencies:
|
||||
|
|
|
@ -25,16 +25,16 @@ As Administrator:
|
|||
windbg -I
|
||||
```
|
||||
|
||||
You may need to do this for both x64 and x86 versions.
|
||||
You may need to do this for both x64 and x86 versions.
|
||||
Any application that crashes should now automatically start a WinDBG session.
|
||||
|
||||
## Debugging tests
|
||||
To run a single test from command line:
|
||||
|
||||
* Locate the test binary folder based on the CSPROJ name.
|
||||
* Locate the test binary folder based on the CSPROJ name.
|
||||
|
||||
For example: `src\System.Net.Sockets\tests\Functional\System.Net.Sockets.Tests.csproj` will build and output binaries at `bin\tests\Windows_NT.AnyCPU.Debug\System.Net.Sockets.Tests\netcoreapp1.0`.
|
||||
|
||||
|
||||
* Execute the test
|
||||
|
||||
Assuming that your repo is at `C:\corefx`:
|
||||
|
@ -44,7 +44,7 @@ cd C:\corefx\bin\tests\Windows_NT.AnyCPU.Debug\System.Net.Sockets.Tests\netcorea
|
|||
C:\corefx\bin\tests\Windows_NT.AnyCPU.Debug\System.Net.Sockets.Tests\netcoreapp1.0\CoreRun.exe xunit.console.dll System.Net.Sockets.Tests.dll -xml testResults.xml -notrait category=nonwindowstests -notrait category=OuterLoop -notrait category=failing
|
||||
```
|
||||
|
||||
* If the test crashes or encounters a `Debugger.Launch()` method call, WinDBG will automatically start and attach to the `CoreRun.exe` process
|
||||
* If the test crashes or encounters a `Debugger.Launch()` method call, WinDBG will automatically start and attach to the `CoreRun.exe` process
|
||||
|
||||
The following commands will properly configure the debugging extension and fix symbol and source-code references:
|
||||
|
||||
|
@ -129,7 +129,7 @@ Logs are going to be placed in %SYSTEMDRIVE%\sockets.etl.
|
|||
|
||||
1. Install [PerfView](https://github.com/Microsoft/perfview/blob/master/documentation/Downloading.md)
|
||||
2. Run PerfView as Administrator
|
||||
3. Press Alt+C to collect events
|
||||
3. Press Alt+C to collect events
|
||||
4. Disable all other collection parameters
|
||||
5. Add Additional Providers (see below - Important: keep the "*" wildcard before the names.)
|
||||
|
||||
|
@ -137,7 +137,7 @@ Logs are going to be placed in %SYSTEMDRIVE%\sockets.etl.
|
|||
|
||||
### Built-in EventSource tracing
|
||||
|
||||
The following EventSources are built-in to CoreFX. The ones that are not marked as [__TestCode__] can be enabled in production scenarios for log collection.
|
||||
The following EventSources are built-in to CoreFX. The ones that are not marked as [__TestCode__] can be enabled in production scenarios for log collection.
|
||||
|
||||
#### Global
|
||||
* `*System.Diagnostics.Eventing.FrameworkEventSource {8E9F5090-2D75-4d03-8A81-E5AFBF85DAF1}`: Global EventSource used by multiple namespaces.
|
||||
|
@ -169,5 +169,5 @@ Helper scripts are available at https://github.com/dotnet/runtime/tree/master/sr
|
|||
* `*System.Threading.Tasks.Parallel.EventSource`: Provides an event source for tracing TPL information.
|
||||
* `*System.Threading.Tasks.Dataflow.DataflowEventSource {16F53577-E41D-43D4-B47E-C17025BF4025}`: Provides an event source for tracing Dataflow information.
|
||||
|
||||
## Notes
|
||||
## Notes
|
||||
* You can find the test invocation command-line by looking at the logs generated after the `dotnet build /t:test` within the test folder.
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue