Skip to content

Document new Microsoft.Diagnostics.NETCore.Client.DiagnosticsClient.WriteDump/WriteDumpAsync APIs #2717

Closed
dotnet/docs
#28262
@mikem8361

Description

@mikem8361

Documentation Request

Document new Microsoft.Diagnostics.NETCore.Client.DiagnosticsClient.WriteDump/WriteDumpAsync APIs.

class DiagnosticsClient
{
    /// <summary>
    /// Trigger a core dump generation.
    /// </summary> 
    /// <param name="dumpType">Type of the dump to be generated</param>
    /// <param name="dumpPath">Full path to the dump to be generated. By default it is /tmp/coredump.{pid}</param>
    /// <param name="flags">logging and crash report flags. On runtimes less than 6.0, only LoggingEnabled is supported.</param>
    public void WriteDump(DumpType dumpType, string dumpPath, WriteDumpFlags flags);
    
    /// <summary>
    /// Trigger a core dump generation.
    /// </summary> 
    /// <param name="dumpType">Type of the dump to be generated</param>
    /// <param name="dumpPath">Full path to the dump to be generated. By default it is /tmp/coredump.{pid}</param>
    /// <param name="logDumpGeneration">When set to true, display the dump generation debug log to the console.</param>
    /// <param name="token">The token to monitor for cancellation requests.</param>
    public async Task WriteDumpAsync(DumpType dumpType, string dumpPath, bool logDumpGeneration, CancellationToken token);
     
    /// <summary>
    /// Trigger a core dump generation.
    /// </summary> 
    /// <param name="dumpType">Type of the dump to be generated</param>
    /// <param name="dumpPath">Full path to the dump to be generated. By default it is /tmp/coredump.{pid}</param>
    /// <param name="flags">logging and crash report flags. On runtimes less than 6.0, only LoggingEnabled is supported.</param>
    /// <param name="token">The token to monitor for cancellation requests.</param>
    public async Task WriteDumpAsync(DumpType dumpType, string dumpPath, WriteDumpFlags flags, CancellationToken token);
}

Previous documentation

Only void WriteDump(DumpType dumpType, string dumpPath, bool logDumpGeneration = false) is currently documented.

Metadata

Metadata

Labels

documentationDocumentation related issue

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions