dotnet / dotnet/diagnostics

Profiling: Make better docs about what metadata APIs are legal to call in which situations

Open
#1,182 1 comment 2 reactions 1 assignee Claimed by @davmason View on GitHub
documentation tracking
Dominant language
C++
Stars
1.3k
Forks
404
Avg merge
2d 5h
Merged PRs (30d)
35

Description

The profiler has pretty poor documentation in this area. What little that exists on David Broman's blog or MSDN is typically either overly loose (we give the profiler writer the entire IMetadatEmit API and somehow expect them to know which modifications will work?) or overly restrictive (we say do all edits during ModuleLoadFinished, but some of them actually work later too)

We likely need to bucket all the possible modifications into 4 categories:
a) Never legal
b) Legal at Module load for images that aren't precompiled
c) Legal at Module load for any image
d) Legal at any time

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.