This repository contains the source code for various .NET Core runtime diagnostic tools and documents.
Перейти к файлу
dotnet-maestro[bot] 147534f6a0
[main] Update dependencies from dotnet/aspnetcore (#5210)
This pull request updates the following dependencies

[marker]: <> (Begin:e96c3e1a-afbc-49f7-37c9-08dc4e3803cb)
## From https://github.com/dotnet/aspnetcore
- **Subscription**: e96c3e1a-afbc-49f7-37c9-08dc4e3803cb
- **Build**: 20250127.5
- **Date Produced**: January 28, 2025 3:45:58 AM UTC
- **Commit**: 6060ad140af062710b9ad14b013a37635f1eddbd
- **Branch**: refs/heads/main

[DependencyUpdate]: <> (Begin)

- **Updates**:
- **Microsoft.AspNetCore.App.Ref**: [from 10.0.0-alpha.2.25075.1 to
10.0.0-preview.2.25077.5][1]
- **Microsoft.AspNetCore.App.Ref.Internal**: [from
10.0.0-alpha.2.25075.1 to 10.0.0-preview.2.25077.5][1]

[1]:
4af8275e9d...6060ad140a

[DependencyUpdate]: <> (End)


[marker]: <> (End:e96c3e1a-afbc-49f7-37c9-08dc4e3803cb)

Co-authored-by: dotnet-maestro[bot] <dotnet-maestro[bot]@users.noreply.github.com>
2025-01-28 10:17:45 -08:00
.config Add CodeQL pipeline (#3513) 2022-11-19 10:59:04 -05:00
.devcontainer Small change to dev container setup. (#3686) 2023-02-25 10:13:26 -08:00
.github Update source-build team references (#5002) 2024-10-16 08:15:27 -07:00
documentation Add JavaScript and WASM symbols conventions (#5096) 2024-12-11 13:51:15 -08:00
eng [main] Update dependencies from dotnet/aspnetcore (#5210) 2025-01-28 10:17:45 -08:00
src Let the debugger knows DATAS is on (#5164) 2025-01-24 13:49:29 -08:00
.editorconfig Add analyzers, fix issues detected by them, style enforcement, and some misc bugs in SOSRunner (#3721) 2023-03-10 17:00:25 -08:00
.gitattributes Add the managed SOS code. 2018-04-26 15:47:59 -07:00
.gitignore [main] Update dependencies from dotnet/installer (#3673) 2023-02-24 22:59:49 -08:00
Build.cmd Fix native build broken by glibc dependencies. Fix latest 8.0 runtime testing. (#3878) 2023-05-17 16:49:25 -07:00
CMakeLists.txt Sync shared (PAL, utilcode, inc, etc.) files with latest runtime (#4885) 2024-08-28 09:14:33 -07:00
CODE-OF-CONDUCT.md Link Code of Conduct (#980) 2020-04-02 16:36:25 -07:00
Directory.Build.props Update to build with net8, remove net6 and start net10 testing (#5103) 2024-12-13 14:28:59 -08:00
Directory.Build.targets [main] Update dependencies from dotnet/installer (#3370) 2022-10-04 15:31:15 -07:00
LICENSE.TXT Initialize repo 2018-03-21 18:05:51 -07:00
NuGet.config Update to build with net8, remove net6 and start net10 testing (#5103) 2024-12-13 14:28:59 -08:00
README.md chore(readme): fix Debugging CoreCLR link (#3606) 2023-01-17 09:15:59 -08:00
Restore.cmd Use darc runtime subscription versions for testing (#682) 2019-12-13 14:47:52 -08:00
SECURITY.md Fix whitespace in SECURITY.md (#870) 2020-03-02 17:41:26 -08:00
THIRD-PARTY-NOTICES.TXT Adding Commandline args to dotnet-tool ps (#2831) 2022-02-22 12:32:31 -07:00
Test.cmd Use darc runtime subscription versions for testing (#682) 2019-12-13 14:47:52 -08:00
build.sh Fix native build broken by glibc dependencies. Fix latest 8.0 runtime testing. (#3878) 2023-05-17 16:49:25 -07:00
debuggees.sln Fixes issue https://github.com/dotnet/diagnostics/issues/4850 (#4923) 2024-09-12 10:52:10 -07:00
diagnostics-codeql.yml Fix native build broken by glibc dependencies. Fix latest 8.0 runtime testing. (#3878) 2023-05-17 16:49:25 -07:00
diagnostics.sln Add IMAGE_FILE_MACHINE_ARM64X and IMAGE_FILE_MACHINE_ARM64EC (#2858) 2024-09-18 18:57:47 -07:00
diagnostics.yml Update linux build images (#5097) 2024-12-10 17:15:51 -08:00
dotnet.cmd Release tools (#1648) 2020-11-11 16:48:21 -08:00
dotnet.sh Fix misc SOS bugs (#2600) 2021-09-20 16:32:51 -07:00
global.json [main] Update dependencies from dotnet/arcade (#5208) 2025-01-26 23:25:42 -08:00
restore.sh Use darc runtime subscription versions for testing (#682) 2019-12-13 14:47:52 -08:00
start-vs.cmd Add helper scripts to open in VS Code with proper SDK (#4523) 2024-02-23 13:06:10 -08:00
start-vscode.cmd Add helper scripts to open in VS Code with proper SDK (#4523) 2024-02-23 13:06:10 -08:00
start-vscode.sh Add start-vscode.sh (#5039) 2024-11-06 18:54:54 +00:00
test.sh Use PEFile instead of clrmd's PEImage (#2769) 2021-12-08 01:24:32 +00:00

README.md

.NET Core Diagnostics Repo

This repository contains the source code for various .NET Core runtime diagnostic tools. It currently contains SOS, the managed portion of SOS, the lldb SOS plugin and various global diagnostic tools. The goals of this repo is to build SOS and the lldb SOS plugin for the portable (glibc based) Linux platform (Centos 7) and the platforms not supported by the portable (musl based) build (Centos 6, Alpine, and macOS) and to test across various indexes in a very large matrix: OSs/distros (Centos 6/7, Ubuntu, Alpine, Fedora, Debian, RHEL 7.2), architectures (x64, x86, arm, arm64), lldb versions (3.9 to 9.0) and .NET Core (all in-development and supported major versions).

Another goal to make it easier to obtain a version of lldb (currently 3.9) with scripts and documentation for platforms/distros like Centos, Alpine, Fedora, etc. that by default provide really old versions.

This repo will also allow out of band development of new SOS and lldb plugin features like symbol server support for the .NET Core runtime and solve the source build problem having SOS.NETCore (managed portion of SOS) in the runtime repo.

See the GitHub Release tab for notes on SOS and diagnostic tools releases.


Building the Repository

The build depends on Git, CMake, Python and of course a C++ compiler. Once these prerequisites are installed the build is simply a matter of invoking the 'build' script (build.cmd or build.sh) at the base of the repository.

The details of installing the components differ depending on the operating system. See the following pages based on your OS. There is no cross-building across OS (only for ARM, which is built on x64). You have to be on the particular platform to build that platform.

To install the platform's prerequisites and build:

SOS and Other Diagnostic Tools

  • SOS - About the SOS debugger extension.
  • dotnet-dump - Dump collection and analysis utility.
  • dotnet-gcdump - Heap analysis tool that collects gcdumps of live .NET processes.
  • dotnet-trace - Enable the collection of events for a running .NET Core Application to a local trace file.
  • dotnet-counters - Monitor performance counters of a .NET Core application in real time.

Build Status

Build Status

License

The diagnostics repository is licensed under the MIT license.