Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hangfireio/stdump

Explore stack trace of a running managed process or from a minidump file
https://github.com/hangfireio/stdump

Last synced: about 2 months ago
JSON representation

Explore stack trace of a running managed process or from a minidump file

Awesome Lists containing this project

README

        

# stdump

Explore stack trace of a running managed process or from a minidump file

## Installation

You can install `stdump` using one of the following ways:

* **Manual**: Obtain an archive from the [latest release](https://github.com/HangfireIO/stdump/releases/latest).
* **NuGet**: `Install-Package stdump`
* **.NET Tool**: `dotnet tool install -g stdump`

After installing, there will be two executables: `stdump-x86.exe` and `stdump-x64.exe`.

### Elevated Access on Linux and macOS

Elevated access is unnecessary when the target application operates under the same user account. But for other cases, it might be useful to run the utility under a privileged account.

```bash
sudo dotnet tool install stdump --tool-path /usr/local/share/dotnet-tools
```

```bash
sudo /usr/local/share/dotnet-tools/stdump
```

## Usage

To display a stack trace of a running program, use its PID or process name.

```
stdump 12832
```

```
stdump w3wp.exe
```

Or point `stdump` to a minidump file.

```
stdump c:\debug\w3wp.dmp
```

## Output

```
STDump v0.0.1 - Writes process managed stack traces
Copyright (C) 2016 Hangfire OÜ
Based on Microsoft.Diagnostics.Runtime (CLR MD). Copyright (C) Microsoft Corporation.

Writes managed stack trace of a running process, or from a minidump file to console.

Found CLR v4.6.1080.00

Following AppDomains found:

AppDomain #1
Address: 5029808
Name: ConsoleApplication38.exe
Configuration: c:\users\odinserj\documents\visual studio 2015\Projects\ConsoleApplication38\ConsoleApplication38\bin\Debug\ConsoleApplication38.exe.Config
Directory: c:\users\odinserj\documents\visual%20studio%202015\Projects\ConsoleApplication38\ConsoleApplication38\bin\Debug\

Following threads found:

Thread #1
OS Thread ID: 10400
AppDomain Address: 5029808
Type: Foreground

Managed stack trace:
- [InlinedCallFrame] at UNKNOWN
- DomainNeutralILStubClass.IL_STUB_PInvoke(Microsoft.Win32.SafeHandles.SafeFileHandle, Byte*, Int32, Int32 ByRef, IntPtr) at mscorlib
- [InlinedCallFrame] at UNKNOWN
- System.IO.__ConsoleStream.ReadFileNative(Microsoft.Win32.SafeHandles.SafeFileHandle, Byte[], Int32, Int32, Boolean, Boolean, Int32 ByRef) at mscorlib
- System.IO.__ConsoleStream.Read(Byte[], Int32, Int32) at mscorlib
- System.IO.StreamReader.ReadBuffer() at mscorlib
- System.IO.StreamReader.ReadLine() at mscorlib
- System.IO.TextReader+SyncTextReader.ReadLine() at mscorlib
- System.Console.ReadLine() at mscorlib
- Microsoft.PFE.Samples.Program.Main() at ConsoleApplication38
- [GCFrame] at UNKNOWN

Thread #2
OS Thread ID: 2168
AppDomain Address: 5029808
Type: Background
Role: Finalizer

Managed stack trace:
- [DebuggerU2MCatchHandlerFrame] at UNKNOWN
```