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

JNI DLL 컴파일 시 x86과 x64의 Export된 함수의 이름이 왜 다를까요?

보통 JNI 소스 코드를 작성할 때 ".c" 파일로 만드는데요.

예를 들어 다음과 같은 식으로 코드를 추가해 줄 수 있습니다.

#include <jni.h>
#include <fcntl.h>
#include <process.h>
#include <windows.h>
#include <psapi.h>

/*extern "C"*/ JNIEXPORT int JNICALL Test(int t, int y);

JNIEXPORT int JNICALL Test(int t, int y)
{
    return t + y;
}

어차피 ".C" 확장자라서 Visual C++은 알아서 "Compile as C Code (/TC)" 옵션으로 빌드해 주기 때문에 "extern" 구문 지정은 필요하지 않습니다. (사실, C 컴파일 과정에서는 extern "C" 구문을 사용하는 경우 오류가 발생합니다.)

이렇게 작성하고 평상시대로 x86/x64 버전의 DLL을 생성하는 배치 파일을 작성해서 돌린 후 결과 확인을 위해 Depends.exe로 살펴보았는데,

c_linkage_1.png

x86: _Test@8
x64: Test


결괏값을 보고 당황하기 시작했습니다. 보는 것처럼 x86 DLL은 "_Test@8"로 "Name-decoration"이 되었고, x64 DLL은 "Test"로 나왔기 때문입니다.

보통, 제가 DLL을 만들면 가장 먼저 확인하는 것이 위에서처럼 DLL의 export 구문이 "Test"와 같이 간결하게 나왔는지를 봅니다. 아래의 글에서도 사례가 있었지요.

Windbg 확장 DLL 만들기 (1) - 스레드를 강제 종료시키는 명령어
; https://www.sysnet.pe.kr/2/0/1198

그런데, JNI DLL을 빌드했을 때는 2가지(x86/x64) 버전이 각각 다른 이름으로 export되어 있었기 때문에 혼란이 온 것입니다.

대체 제가 뭘 잘못한 것일까요? 처음에는 extern "C" 구문과 관련되어 x86에서 적용되지 않았다고 착각하여 그에 대한 해결방법이 있는지에 대해서만 찾아보았습니다. 음... ^^; (당연히) 없더군요.

잠시 심호흡 한번 하고!
차근차근히 정리를 해보았습니다. 우선, "_Test@8"과 같이 나오는 경우는 __stdcall에 해당합니다. 실제로 JNICALL은 다음과 같이 정의되어 있습니다.

#define JNICALL __stdcall

그렇군요... 뭔가 이상합니다. 오히려 그렇게 따지면 x86에서 제대로 나온 것이고 반대로 x64의 결과가 잘못되었기 때문입니다. 아하~~~ 이 순간 예전에 읽었던 글이 하나가 생각나더군요.

Everything You Need To Know To Start Programming 64-Bit Windows Systems
; https://learn.microsoft.com/en-us/archive/msdn-magazine/2006/may/x64-starting-out-in-64-bit-windows-systems-with-visual-c

In designing the calling convention, the x64 architecture took advantage of the opportunity to clean up the mess of existing Win32 calling conventions such as __stdcall, __cdecl, __fastcall, _thiscall, and so on. In Win64, there's just one native calling convention, and modifiers like __cdecl are ignored by the compiler. The reduction in calling convention flavors is a wonderful boon for debuggability, among other things.


아마도 마이크로소프트가 다양하게 생겨나는 calling convention을 일일이 맞춰주는 것이 비생산적이라고 여겼던 결과일 텐데요. x64 환경에서는 단 하나의 calling convention으로 정리를 해버린 것입니다.

결론은, __stdcall 방식으로 호출되는 함수를 포함하고 있는 DLL이 x86과 x64에서 서로 다른 이름으로 export 되는 것은 너무나 자연스러운 결과입니다. 보통의 Win32 DLL을 Visual C++로 만들 때는 __cdecl을 사용하기 때문에 x86과 x64의 이름이 같게 export 되지만 JNI와 같은 경우에는 명시적으로 x86에서 __stdcall을 사용하고 있기 때문에 달랐던 것 뿐입니다.

첨부된 파일은 위의 코드를 포함한 예제 프로젝트입니다.




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 8/18/2023]

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

비밀번호

댓글 작성자
 



2012-05-25 09시33분
64비트 리눅스 vs 64비트 윈도우 호출 규약 비교(Calling Convention)
; http://kkamagui.tistory.com/811
정성태
2015-01-29 12시08분
The compiler can make up its own calling conventions, within limits
; https://devblogs.microsoft.com/oldnewthing/20150128-00/?p=44813
정성태

... 46  47  48  49  50  51  52  53  54  55  [56]  57  58  59  60  ...
NoWriterDateCnt.TitleFile(s)
12571정성태3/21/202117017오류 유형: 706. WSL 2 기반으로 "Enable Kubernetes" 활성화 시 초기화 실패 [1]
12570정성태3/19/202122739개발 환경 구성: 555. openssl - CA로부터 인증받은 새로운 인증서를 생성하는 방법
12569정성태3/18/202122935개발 환경 구성: 554. WSL 인스턴스 export/import 방법 및 단축 아이콘 설정 방법
12568정성태3/18/202115885오류 유형: 705. C# 빌드 - Couldn't process file ... due to its being in the Internet or Restricted zone or having the mark of the web on the file.
12567정성태3/17/202118545개발 환경 구성: 553. Docker Desktop for Windows를 위한 k8s 대시보드 활성화 [1]
12566정성태3/17/202118240개발 환경 구성: 552. Kubernetes - kube-apiserver와 REST API 통신하는 방법 (Docker Desktop for Windows 환경)
12565정성태3/17/202114904오류 유형: 704. curl.exe 실행 시 dll not found 오류
12564정성태3/16/202115754VS.NET IDE: 160. 새 프로젝트 창에 C++/CLI 프로젝트 템플릿이 없는 경우
12563정성태3/16/202118654개발 환경 구성: 551. C# - JIRA REST API 사용 정리 (3) jira-oauth-cli 도구를 이용한 키 관리
12562정성태3/15/202119125개발 환경 구성: 550. C# - JIRA REST API 사용 정리 (2) JIRA OAuth 토큰으로 API 사용하는 방법파일 다운로드1
12561정성태3/12/202117985VS.NET IDE: 159. Visual Studio에서 개행(\n, \r) 등의 제어 문자를 치환하는 방법 - 정규 표현식 사용
12560정성태3/11/202119175개발 환경 구성: 549. ssh-keygen으로 생성한 PKCS#1 개인키/공개키 파일을 각각 PKCS8/PEM 형식으로 변환하는 방법
12559정성태3/11/202119507.NET Framework: 1028. 닷넷 5 환경의 Web API에 OpenAPI 적용을 위한 NSwag 또는 Swashbuckle 패키지 사용 [2]파일 다운로드1
12558정성태3/10/202118603Windows: 192. Power Automate Desktop (Preview) 소개 - Bitvise SSH Client 제어 [1]
12557정성태3/10/202116752Windows: 191. 탐색기의 보안 탭에 있는 "Object name" 경로에 LEFT-TO-RIGHT EMBEDDING 제어 문자가 포함되는 문제
12556정성태3/9/202114486오류 유형: 703. PowerShell ISE의 Debug / Toggle Breakpoint 메뉴가 비활성 상태인 경우
12555정성태3/8/202118354Windows: 190. C# - 레지스트리에 등록된 DigitalProductId로부터 라이선스 키(Product Key)를 알아내는 방법파일 다운로드2
12554정성태3/8/202117824.NET Framework: 1027. 닷넷 응용 프로그램을 위한 PDB 옵션 - full, pdbonly, portable, embedded
12553정성태3/5/202117114개발 환경 구성: 548. 기존 .NET Framework 프로젝트를 .NET Core/5+ 용으로 변환해 주는 upgrade-assistant, try-convert 도구 소개 [4]
12552정성태3/5/202116902개발 환경 구성: 547. github workflow/actions에서 Visual Studio Marketplace 패키지 등록하는 방법
12551정성태3/5/202115454오류 유형: 702. 비주얼 스튜디오 - The 'CascadePackage' package did not load correctly. (2)
12550정성태3/5/202115318오류 유형: 701. Live Share 1.0.3713.0 버전을 1.0.3884.0으로 업데이트 이후 ContactServiceModelPackage 오류 발생하는 문제
12549정성태3/4/202116759오류 유형: 700. VsixPublisher를 이용한 등록 시 다양한 오류 유형 해결책
12548정성태3/4/202117929개발 환경 구성: 546. github workflow/actions에서 nuget 패키지 등록하는 방법
12547정성태3/3/202118439오류 유형: 699. 비주얼 스튜디오 - The 'CascadePackage' package did not load correctly.
12546정성태3/3/202118462개발 환경 구성: 545. github workflow/actions에서 빌드시 snk 파일 다루는 방법 - Encrypted secrets
... 46  47  48  49  50  51  52  53  54  55  [56]  57  58  59  60  ...