Microsoft MVP성태의 닷넷 이야기
DDK: 2. Device Driver 응용 프로그램의 빌드 스크립트 [링크 복사], [링크+제목 복사],
조회: 30252
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 3개 있습니다.)
Device Driver 응용 프로그램의 빌드 스크립트

아래의 이야기에 이어서.

Visual Studio 2010 - Device Driver 제작- Hello World 예제
; https://www.sysnet.pe.kr/2/0/919

그럼, 지난번 만들어 둔 예제 프로젝트를 기반으로 다중 플랫폼들에 설치를 할 수 있도록 그에 맞는 *.sys 파일을 생성하는 배포 스크립트 파일을 만들어 볼까요? ^^




목표는 다음과 같습니다.

  1. x86, x64 버전으로 빌드
  2. Windows XP, 2003, Windows Server 2008 / R2 버전 지원
  3. 배포

차근차근히 하나씩 채워보면,

우선, 명령행 빌드 환경을 점검해야 합니다. 이 부분은 일반적인 "Visual Studio Command Prompt (2010)"에 설정된 PATH 값과 이외의 필요에 맞는 환경 변수를 정의합니다.

SET FrameworkVersion=v4.0.30319
SET PATH=C:\Windows\Microsoft.NET\Framework\%FrameworkVersion%;C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\;C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\BIN;C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\Tools;C:\ProgramFiles (x86)\Microsoft Visual Studio 10.0\VC\VCPackages;C:\Program Files (x86)\HTML Help Workshop;C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\bin;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;D:\Tools\SysInternals;

FOR /F %%I IN ("%0") DO SET CURRENTDIR=%%~dpI

SET BUILDCONFIG=Release
SET DriverName=DeviceDriverSample
SET SERVICENAME32=%DriverName%32
SET SERVICENAME64=%DriverName%64

자, ^^ 이제 msbuild로 예전에 살펴봤던 대로 x86과 x64 빌드를 해주면 되겠지요.

MSBuild를 이용한 VC++ 프로젝트 빌드
; https://www.sysnet.pe.kr/2/0/871

msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:Platform=Win32;Configuration=%BUILDCONFIG% /p:TargetName=%SERVICENAME32%
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:Platform=x64;Configuration=%BUILDCONFIG% /p:TargetName=%SERVICENAME64%

위와 같은 정도면 일단 x86 버전과 x64 버전은 정상적으로 출력이 됩니다. 그런데 Device Driver의 경우 보통, 윈도우 운영체제마다 달리해서 제작이 되곤 합니다. 그래서 x86/x64 버전에 대한 구분을 운영체제별로 해주는 것이 좋습니다. 이를 위해 출력 폴더를 다음과 같은 식으로 잡아주는 것이 좋겠고,

/bin/win7
    /win2003
    /vista
    /winxp

그럼, Windows 7 / 2008 R2용으로 빌드하고 싶은 경우에는 OutDir 환경 변수를 다음과 같이 맞춰주면 됩니다.

SET TARGETOS=win7
msbuild ... /p:OutDir=%CURRENTDIR%\bin\%TARGETOS%

그런데, 여기서 고려해야 할 사항이 있지요. 운영체제마다 소스 코드 내에 사용되는 구조체 필드의 offset 값, 상수값들이 틀릴 수 있기 때문에 이에 대한 지원을 포함시켜 주어야 합니다. 물론, 이런 경우 프로젝트를 다르게 가져가는 것보다는 적절한 "전처리기"를 정의해서 소스 코드를 단일하게 관리하는 것이 더 편한데요.

예를 들어, 다음과 같이 DDK의 VER_PRODUCTBUILD에 따라 내부 정의를 달리하는 ntifs.h 파일을 include 하는 경우라면,

#include <ntddk.h>
#include "ntifs.h"

다음과 같이 외부에서 정의 가능한 TARGET_PLATFORM_VER 전처리기를 끼워두고,

#include <ntddk.h>

#if defined( TARGET_PLATFORM_VER )
#if defined(VER_PRODUCTBUILD)
#undef VER_PRODUCTBUILD 
#define VER_PRODUCTBUILD TARGET_PLATFORM_VER
#else
#define VER_PRODUCTBUILD TARGET_PLATFORM_VER
#endif
#endif
#include "ntifs.h"

그런 후에, "MSBuild를 이용한 VC++ 프로젝트 빌드" 글에서 설명했던 것처럼, TARGET_PLATFORM_VER 전처리기를 msbuild에서 제어할 수 있도록 vcxproj 파일의 PreprocessorDefinitions를 바꿔주면 다음과 같이 개별 운영체제에 맞는 sys 파일을 생성할 수 있는 msbuild 배치가 구성됩니다.

REM 32 bit Windows XP
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=2600 ...

REM 32 bit Windows 2003
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=3790 ...

와~~~ 그럼, 다음과 같은 정도의 빌드 스크립트를 구성하면 XP/2003/Vista/2008/2008 R2까지 개별 32/64비트 sys 파일이 생성되겠군요. ^^

REM Windows XP 32/64
SET TARGETOS=winxp
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=2600 /p:Platform=Win32;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample32 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=2600 /p:Platform=x64;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample64 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\

REM Windows 2003 32/64
SET TARGETOS=win2003
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=3790 /p:Platform=Win32;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample32 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=3790 /p:Platform=x64;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample64 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\

REM Windows Vista/2008 32/64
SET TARGETOS=vista
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=6002 /p:Platform=Win32;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample32 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=6002 /p:Platform=x64;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample64 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\

REM Windows 7/2008 R2 32/64
SET TARGETOS=win7
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=7600 /p:Platform=Win32;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample32 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\
msbuild ".\DeviceDriverSample\DeviceDriverSample.vcxproj" /p:PLATFORM_PREPROCESSOR=7600 /p:Platform=x64;Configuration=%BUILDCONFIG% /p:TargetName=DeviceDriverSample64 /p:OutDir=%CURRENTDIR%bin\%TARGETOS%\

마지막으로 배포는... 해당 VPC를 각각 만들어 두어서 복사 작업만 해주면 됩니다. 다음과 같이. ^^

SET TESTPC=WIN7X64EN
robocopy %CURRENTDIR%bin \\%TESTPC%\d$\devicetest /S
SET TESTPC=win2003x86
robocopy %CURRENTDIR%bin \\%TESTPC%\d$\devicetest /S
SET TESTPC=win2008x86
robocopy %CURRENTDIR%bin \\%TESTPC%\d$\devicetest /S

그런데, 배포를 단순 복사하는 것만으로는 좀 아쉽죠. 복사하기 전 서비스를 중지 -> 복사 -> 서비스 시작하는 작업을 해주면 더 좋을 것 같습니다. 그럼 sc.exe 가 떠오르는 군요. ^^
SET TESTPC=WIN7X64EN
SET SERVICENAME64=%DriverName%64

sc \\%TESTPC% stop "%SERVICENAME64%"
robocopy %CURRENTDIR%bin \\%TESTPC%\d$\devicetest /S
sc \\%TESTPC% start "%SERVICENAME64%"

최초의 배포 한번은 오류가 날 테지만 상관없습니다. 다음 빌드부터는 편하게 자동으로 업데이트 되는 효과를 얻을 테니.




참고로, 윈도우 운영체제가 Windows 7 x64/2008 R2부터는 정식 인증서로 서명하지 않은 드라이버는 올라오지 않게 됩니다. 이를 위해 우선, "테스트 인증서"로 서명해야 하는데요. 여기서는 다음에 첨부한 인증서를 가져다가,

인증서 관련(CER, PVK, SPC, PFX) 파일 만드는 방법
; https://www.sysnet.pe.kr/2/0/863

아래의 글에서 설명한 방법 대로,

Appinit_Dlls로 구현한 환경변수 설정 DLL
; https://www.sysnet.pe.kr/2/0/883

singtool.exe를 이용해서 서명하는 작업을 빌드 스크립트에 추가하였습니다.

Signtool sign /v /sm /n "mytest" %CURRENTDIR%bin\%TARGETOS%\%SERVICENAME64%.sys

그다음, 아래와 같이 대상 운영체제에서 미리 관리자 권한으로 명령어를 실행해 두고 재부팅합니다.

=== Windows 7 / 2008 R2 ====
bcdedit /set TESTSIGNING ON

위의 명령어가 실행된 PC에서는 "테스트 인증서"로 서명된 디바이스 드라이버를 로드할 수 있도록 허용되어지고, 구분을 쉽게 하기 위해 바탕 화면에는 "Test Mode Windows 7 Build 7600"과 같은 메시지가 나타납니다.




기타 몇 가지 더... ^^

위의 sc.exe를 이용해서 대상 서비스를 로드/해제하게 되는데요. 이에 앞서 드라이버를 시스템에 등록해 주어야 합니다. 이런 경우, 쉽게 사용할 수 있는 툴이 "OSR Driver Loader"인데요. 다음의 경로에서 다운로드 받을 수 있습니다.

OSR Online - Driver Loader 
; http://www.osronline.com/article.cfm?article=157

device_driver_build_script_1.png

이 외에, 가상 머신에 대한 windbg 연결이 필요한 데, 그에 관해서는 다음의 글을 참조합니다.

원격 컴퓨터 디버깅 - VPC 설정
; https://www.sysnet.pe.kr/2/0/265

위의 글에서는 Virtual Server를 기준으로 설명하고 있지만, Hyper-V에서도 설정은 유사합니다.

그리고 중요한 것 하나 더!

소스 코드 형상관리는 잊으시면 안되죠. ^^ 이 부분은, 다음의 글을 참고하셔서 필요한 부분을 지금까지 위에서 설명한 빌드 스크립트에 추가해 주시면 되겠습니다.

배치 파일로 팀 빌드 구성
; https://www.sysnet.pe.kr/2/0/905

첨부한 파일은 제가 예제로 구성한 build.bat 파일과 예제 프로젝트입니다.



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

[연관 글]






[최초 등록일: ]
[최종 수정일: 6/27/2021]

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

비밀번호

댓글 작성자
 



2010-10-22 12시12분
위의 글을 읽어보신 분들은, 아래의 글을 꼭 읽어주세요. ^^

Device Driver 응용 프로그램의 빌드 스크립트 - 두 번째 이야기
; http://www.sysnet.pe.kr/2/0/936
kevin25
2020-02-16 09시19분
HyperSine/Windows10-CustomKernelSigners
; https://github.com/HyperSine/Windows10-CustomKernelSigners
정성태

... 106  107  [108]  109  110  111  112  113  114  115  116  117  118  119  120  ...
NoWriterDateCnt.TitleFile(s)
11224정성태6/13/201718131.NET Framework: 661. Json.NET의 DeserializeObject 수행 시 속성 이름을 동적으로 바꾸는 방법파일 다운로드1
11223정성태6/12/201716819개발 환경 구성: 318. WCF Service Application과 WCFTestClient.exe
11222정성태6/10/201720542오류 유형: 399. WCF - A property with the name 'UriTemplateMatchResults' already exists.파일 다운로드1
11221정성태6/10/201717483오류 유형: 398. Fakes - Assembly 'Jennifer5.Fakes' with identity '[...].Fakes, [...]' uses '[...]' which has a higher version than referenced assembly '[...]' with identity '[...]'
11220정성태6/10/201722888.NET Framework: 660. Shallow Copy와 Deep Copy [1]파일 다운로드2
11219정성태6/7/201718208.NET Framework: 659. 닷넷 - TypeForwardedFrom / TypeForwardedTo 특성의 사용법
11218정성태6/1/201721015개발 환경 구성: 317. Hyper-V 내의 VM에서 다시 Hyper-V를 설치: Nested Virtualization
11217정성태6/1/201716906오류 유형: 397. initerrlog: Could not open error log file 'C:\...\MSSQL12.MSSQLSERVER\MSSQL\Log\ERRORLOG'
11216정성태6/1/201719011오류 유형: 396. Activation context generation failed
11215정성태6/1/201719935오류 유형: 395. 관리 콘솔을 실행하면 "This app has been blocked for your protection" 오류 발생 [1]
11214정성태6/1/201717666오류 유형: 394. MSDTC 서비스 시작 시 -1073737712(0xC0001010) 오류와 함께 종료되는 문제 [1]
11213정성태5/26/201722461오류 유형: 393. TFS - The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.
11212정성태5/26/201721812오류 유형: 392. Windows Server 2016에 KB4019472 업데이트가 실패하는 경우
11211정성태5/26/201720845오류 유형: 391. BeginInvoke에 전달한 람다 함수에 CS1660 에러가 발생하는 경우
11210정성태5/25/201721290기타: 65. ActiveX 없는 전자 메일에 사용된 "개인정보 보호를 위해 암호화된 보안메일"의 암호화 방법
11209정성태5/25/201768207Windows: 143. Windows 10의 Recovery 파티션을 삭제 및 새로 생성하는 방법 [16]
11208정성태5/25/201727937오류 유형: 390. diskpart의 set id 명령어에서 "The specified type is not in the correct format." 오류 발생
11207정성태5/24/201728220Windows: 142. Windows 10의 복구 콘솔로 부팅하는 방법
11206정성태5/24/201721505오류 유형: 389. DISM.exe - The specified image in the specified wim is already mounted for read/write access.
11205정성태5/24/201721262.NET Framework: 658. C#의 tail call 구현은? [1]
11204정성태5/22/201730794개발 환경 구성: 316. 간단하게 살펴보는 Docker for Windows [7]
11203정성태5/19/201718735오류 유형: 388. docker - Host does not exist: "default"
11202정성태5/19/201719804오류 유형: 387. WPF - There is no registered CultureInfo with the IetfLanguageTag 'ug'.
11201정성태5/16/201722544오류 유형: 386. WPF - .NET 3.5 이하에서 TextBox에 한글 입력 시 TextChanged 이벤트의 비정상 종료 문제 [1]파일 다운로드1
11200정성태5/16/201719317오류 유형: 385. WPF - 폰트가 없어 System.IO.FileNotFoundException 예외가 발생하는 경우
11199정성태5/16/201721142.NET Framework: 657. CultureInfo.GetCultures가 반환하는 값
... 106  107  [108]  109  110  111  112  113  114  115  116  117  118  119  120  ...