Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 3개 있습니다.)

마이크로소프트의 CoreCLR 프로파일러 예제 빌드 방법

CoreCLR 용 프로파일 예제가 github에 공개되어 있습니다.

Microsoft/clr-samples 
; https://github.com/Microsoft/clr-samples

clr-samples/ProfilingAPI/ReJITEnterLeaveHooks/
; https://github.com/Microsoft/clr-samples/tree/master/ProfilingAPI/ReJITEnterLeaveHooks

물론, 빌드하는 방법이 "clr-samples/ProfilingAPI/ReJITEnterLeaveHooks/" 문서에도 나오지만 그래도 정리를 해보겠습니다. ^^

우선, 당연히 Visual Studio 2017은 있어야 합니다. 그런 다음 CoreCLR을 clone합니다.

dotnet/coreclr 
; https://github.com/dotnet/coreclr

부담 갖지 않아도 됩니다. ^^ 단지 include 파일만 필요하기 때문에 빌드까지 할 필요는 없습니다. 그런 다음 cmd.exe 창을 띄우고 다음과 같이 환경 변수를 설정합니다.

SET CORECLR_PATH=...[coreclr 폴더]...
SET BuildOS=Windows_NT
SET BuildArch=...[원하는 플랫폼]...
SET BuildType=...[Debug or Release]...
SET Output=...[빌드 후 생성되는 DLL 파일명]...

가령, clone한 coreclr 폴더가 E:\git_clone\coreclr이고, x64/Debug 모드로 빌드하고 싶다면 다음과 같은 식으로 설정하면 됩니다.

SET CORECLR_PATH=E:\git_clone\coreclr
SET BuildOS=Windows_NT
SET BuildArch=x64
SET BuildType=Debug
SET Output=ClrProfiler.dll

이걸로 준비 작업은 모두 끝입니다. 이후에는 그냥 ./build.cmd 파일을 실행하면 깨끗하게 빌드가 완료됩니다.

참고로, 다음과 같이 .csproj 프로젝트 파일 내에 IncludePath를 통해 위에서 설정한 환경 변수의 값에 따라 include 경로가 결정됩니다.

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
    <LinkIncremental>true</LinkIncremental>
    <IncludePath>$(VC_IncludePath);$(CORECLR_PATH)\src\pal\prebuilt\inc;$(CORECLR_PATH)\src\inc;$(CORECLR_PATH)\bin\Product\$(BuildOS).$(BuildArch).$(BuildType)\inc;$(NETFXSDKDir)Include\um;$(WindowsSDK_IncludePath);</IncludePath>
</PropertyGroup>




그래도 역시 디버깅이 가능한 Visual Studio 2017 내에서 빌드하는 것이 좋습니다. ^^ 이를 위해 명령행 창에서 SET... 환경 변수를 지정한 후 devenv.exe를 실행해야 합니다. 그렇게 실행된 Visual Studio 2017의 경우 환경 변수를 cmd.exe로부터 물려받기 때문에 정상적으로 빌드가 가능합니다.

만약 매번 명령행 창에 SET ... 환경 변수를 적용해서 devenv.exe를 실행하는 것이 귀찮다면 별도로 런처용 .bat를 만들던가, 아니면 전역 환경 변수로 적용하시면 됩니다. 참고로 런처용 .bat를 만든다면 다음의 글에 따라,

Visual Studio(devenv.exe)를 배치 파일(.bat)을 통해 실행하는 방법
; https://www.sysnet.pe.kr/2/0/11293

이렇게 구성해야 합니다.

REM dev_coreclr.bat

SET CORECLR_PATH=E:\git_clone\coreclr
SET BuildOS=Windows_NT
SET BuildArch=x64
SET BuildType=Debug
SET Output=ClrProfiler.dll

start "" "C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\devenv.exe" 




만약, SET ... 환경 변수를 설정하지 않고 Visual Studio에서 ClrProfiler.sln을 올려 곧바로 빌드하면 다음과 같은 컴파일 에러가 발생합니다.

1>------ Rebuild All started: Project: ClrProfiler, Configuration: Debug Win32 ------
1>  ILRewriter.cpp
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1849): error C2220: warning treated as error - no 'object' file generated
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1849): warning C4091: 'typedef ': ignored on left of 'NGenHintEnum' when no variable is declared
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1858): warning C4091: 'typedef ': ignored on left of 'LoadHintEnum' when no variable is declared
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1907): warning C4091: 'typedef ': ignored on left of 'NativeTypeArrayFlags' when no variable is declared
1>  CorProfiler.cpp
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1849): error C2220: warning treated as error - no 'object' file generated
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1849): warning C4091: 'typedef ': ignored on left of 'NGenHintEnum' when no variable is declared
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1858): warning C4091: 'typedef ': ignored on left of 'LoadHintEnum' when no variable is declared
1>c:\program files (x86)\windows kits\8.1\include\um\corhdr.h(1907): warning C4091: 'typedef ': ignored on left of 'NativeTypeArrayFlags' when no variable is declared
1>e:\git_clone\clr-samples\profilingapi\rejitenterleavehooks\corprofiler.h(11): error C2504: 'ICorProfilerCallback8': base class undefined
1>e:\git_clone\clr-samples\profilingapi\rejitenterleavehooks\corprofiler.h(14): error C2143: syntax error: missing ';' before '*'
1>e:\git_clone\clr-samples\profilingapi\rejitenterleavehooks\corprofiler.h(14): error C4430: missing type specifier - int assumed. Note: C++ does not support default-int
1>e:\git_clone\clr-samples\profilingapi\rejitenterleavehooks\corprofiler.h(14): error C2238: unexpected token(s) preceding ';'

왜냐하면, CLR 관련 헤더 파일들이 기본적으로 Windows SDK에 포함된 것을 가져오게 되는데 아쉽게도 현재(2017-09-04) ICorProfilerCallback8 인터페이스 같은 것들은 포함하고 있지 않기 때문에 컴파일이 안됩니다. 이러한 최신 인터페이스들은 CoreClr 관련 헤더 파일에만 정의되어 있습니다. (아마도, 언젠가 Windows SDK에도 ICorProfilerCallback8이 포함되지 않을까요?!)




빌드 후 테스트하는 것도 간단합니다. 다음과 같이 프로파일러의 존재를 알리는 환경 변수를 설정하고,

SET CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
SET CORECLR_ENABLE_PROFILING=1
SET CORECLR_PROFILER_PATH=C:\filePath\to\ClrProfiler.dll

그대로 dotnet.exe 등의 .NET Core 실행 파일을 직접 구동하면 됩니다.

마찬가지로, Visual Studio 2017 내에서 직접 F5 디버깅 환경을 구성하고 싶다면 아래의 글에서처럼 C++ 프로젝트 설정에 환경 변수 설정과 실행될 EXE 환경을 구성해 주시면 됩니다.

디버깅 방법 - CLR 프로파일러
; https://www.sysnet.pe.kr/2/0/258




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 9/4/2017]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2019-02-27 12시08분
리눅스에서의 빌드/테스트는 다음의 글에 정리했습니다.

마이크로소프트의 CoreCLR 프로파일러 예제 빌드 방법 - 리눅스 환경
; http://www.sysnet.pe.kr/2/0/11829
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13971정성태7/17/2025360닷넷: 2343. C# 14 - (2) 속성 구문에서 문맥 키워드로 추가되는 field 예약어파일 다운로드1
13970정성태7/17/2025397닷넷: 2342. C# 14 - (1) (예약)
13969정성태7/17/2025370닷넷: 2341. snap으로 설치한 .NET 리눅스 실행 환경
13968정성태7/16/2025359오류 유형: 969. lddtree - TypeError: 'type' object is not subscriptable
13967정성태7/16/2025389오류 유형: 968. snap으로 설치한 "dotnet run" 실행 시 "undefined symbol: _dl_audit_symbind_alt, version GLIBC_PRIVATE" 오류
13966정성태7/15/2025585디버깅 기술: 223. WinDbg - .kframes 명령어
13965정성태7/11/2025955오류 유형: 967. 디버깅 모드로 실행 시 "Could not find file 'C:\Program Files\IIS Express\Oracle.DataAccess.Common.Configuration.Section.xsd'" 예외
13964정성태7/10/20251506닷넷: 2340. C# - Win32 Multimedia Timer 주기파일 다운로드1
13963정성태7/8/20251115VS.NET IDE: 202. Visual Studio 2022 + Copilot 기본 사용법
13962정성태7/7/20251189스크립트: 79. 파이썬 - onnxruntime_genai에서 지원하지 않는 모델 사용
13961정성태7/5/20251107디버깅 기술: 222. WinDbg 분석 사례 - IISreset 시점에 w3wp.exe의 crash 발생
13960정성태7/3/20251201개발 환경 구성: 752. ProcDump - C/C++ 예외 코드 필터를 지정한 덤프 생성 [2]
13959정성태6/25/20251375오류 유형: 966. Ubuntu - ping: connect: Network is unreachable
13958정성태6/21/20251820닷넷: 2339. C# - Phi-4-multimodal 모델의 GPU 가속 방법 (ORT 사용)파일 다운로드1
13957정성태6/20/20251569닷넷: 2338. C# / Foundry Local - Phi-4-multimodal 모델을 사용하는 방법 [1]
13956정성태6/19/20251705개발 환경 구성: 751. Triton Inference Server의 Python Backend 프로세스
13955정성태6/18/20251839오류 유형: 965. Hugging Face 모델 다운로드 시 "requests.exceptions.HTTPError: 401 Client Error: Unauthorized for url: ..." 오류
13954정성태6/18/20251681닷넷: 2337. C# - Hugging Face에 공개된 LLM 모델을 Foundry Local에서 사용하는 방법파일 다운로드1
13953정성태6/16/20251480스크립트: 78. 파이썬 - 소스 코드의 파일 경로를 지정한 모듈 로드
13952정성태6/15/20251917닷넷: 2336. C# - IValueTaskSource로 인해 주의가 필요한 ValueTask 호출파일 다운로드1
13951정성태6/15/20251741오류 유형: 964. Outlook - 일정이 "You cannot make changes to contents of this read-only folder." 오류 메시지로 삭제가 안 되는 경우
13950정성태6/12/20252479닷넷: 2335. C# - 간단하게 구현해 보는 IValueTaskSource 예제파일 다운로드1
13949정성태6/11/20252418오류 유형: 963. SignTool - "Error: SignerSign() failed." (-2146869243/0x80096005)
13948정성태6/10/20251789오류 유형: 962. 파이썬 - Linux 환경 + TCP 서버 소켓을 사용하는 프로세스 종료 후 재실행하는 경우 "OSError: [Errno 98] Address already in use" 오류 발생
13947정성태6/9/20252410개발 환경 구성: 750. 파이썬 - Azure App Service에 응용 프로그램 배포 후의 환경
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...