Skip to content

[cDAC] Implement GetPartialUserState for cDAC#127848

Open
barosiak wants to merge 4 commits intodotnet:mainfrom
barosiak:barosiak/GetPartialUserState
Open

[cDAC] Implement GetPartialUserState for cDAC#127848
barosiak wants to merge 4 commits intodotnet:mainfrom
barosiak:barosiak/GetPartialUserState

Conversation

@barosiak
Copy link
Copy Markdown
Member

@barosiak barosiak commented May 6, 2026

Summary

Replaces the legacy-delegation stub in DacDbiImpl.GetPartialUserState with a managed implementation using the IThread contract, mirroring the native C++ logic in dacdbiimpl.cpp that maps thread state flags to CorDebugUserState.

Changes

  • Add Interruptible to ThreadState enum (from m_State)
  • Add new ThreadStateNC enum and StateNC field (from m_StateNC)
  • Implement GetPartialUserState in DacDbiImpl with DEBUG cross-validation
  • Add CorDebugUserState typed enum to IDacDbiInterface
  • Update data descriptor, contract docs, and VM annotations
  • Add unit and dump tests

@barosiak barosiak requested review from max-charlamb, noahfalk and rcj1 May 6, 2026 01:56
@barosiak barosiak self-assigned this May 6, 2026
Copilot AI review requested due to automatic review settings May 6, 2026 01:56
@dotnet-policy-service
Copy link
Copy Markdown
Contributor

Tagging subscribers to this area: @steveisok, @tommcdon, @dotnet/dotnet-diag
See info in area-owners.md if you want to be subscribed.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Implements DacDbiImpl.GetPartialUserState in the managed cDAC reader by mapping thread state flags from the IThread contract (including new Interruptible and StateNC/ThreadStateNC) to a typed CorDebugUserState, and adds unit + dump-based tests to validate the mapping.

Changes:

  • Extend the Thread contract surface to expose Interruptible plus a new StateNC field (ThreadStateNC) and plumb it through descriptors, data model, and contract implementation.
  • Replace the legacy-delegation stub for GetPartialUserState with a managed implementation (plus DEBUG cross-validation against legacy DAC).
  • Add unit and dump tests validating state-flag mapping and GetPartialUserState results.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
src/native/managed/cdac/tests/ThreadTests.cs Adds a unit test ensuring raw state fields map to ThreadState / ThreadStateNC.
src/native/managed/cdac/tests/MockDescriptors/MockDescriptors.Thread.cs Extends mock Thread layout to include StateNC and exposes setters.
src/native/managed/cdac/tests/DumpTests/DacDbi/DacDbiThreadDumpTests.cs Adds dump test cross-validating GetPartialUserState against IThread contract data.
src/native/managed/cdac/tests/ClrDataExceptionStateTests.cs Updates mocks constructing ThreadData to include the new StateNC field.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Legacy/Dbi/IDacDbiInterface.cs Introduces typed CorDebugUserState and updates GetPartialUserState signature.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Legacy/Dbi/DacDbiImpl.cs Implements GetPartialUserState using thread contract data and DEBUG cross-validation.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Contracts/Data/Thread.cs Reads new StateNC field from the Thread data descriptor.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Contracts/Contracts/Thread_1.cs Maps StateNC into ThreadData and adds Interruptible mapping.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Abstractions/Contracts/IThread.cs Extends ThreadState, adds ThreadStateNC, and adds StateNC to ThreadData.
src/coreclr/vm/threads.h Annotates thread state bits and adds m_StateNC to the cDAC data offsets.
src/coreclr/vm/datadescriptor/datadescriptor.inc Adds Thread.StateNC field to the cDAC data descriptor.
docs/design/datacontracts/Thread.md Documents new ThreadState.Interruptible, ThreadStateNC, and ThreadData.StateNC.

Comment thread src/coreclr/vm/threads.h Outdated
Comment thread src/coreclr/vm/threads.h Outdated
Copilot AI review requested due to automatic review settings May 6, 2026 23:05
@barosiak barosiak requested a review from jkotas May 6, 2026 23:09
Comment on lines 5694 to 5695
// Don't report Thread::TS_AbortRequested

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// Don't report Thread::TS_AbortRequested

Not sure what's the point of this comment

Comment thread src/coreclr/vm/threads.h Outdated
enum ThreadStateNoConcurrency
{
TSNC_Unknown = 0x00000000, // threads are initialized this way
TSNC_Unknown = 0x00000000, // threads are initialized this way [cDAC] [Thread]: Contract depends on this value.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
TSNC_Unknown = 0x00000000, // threads are initialized this way [cDAC] [Thread]: Contract depends on this value.
TSNC_Unknown = 0x00000000, // threads are initialized this way

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 14 out of 14 changed files in this pull request and generated 1 comment.

Comment on lines +747 to +751
public int GetPartialUserState(ulong vmThread, CorDebugUserState* pRetVal)
{
*pRetVal = default;
int hr = HResults.S_OK;
try
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants