12.8 Install Your Kernel PlugIn Driver

12.8 Install Your Kernel PlugIn Driver
	Chapter 12. Creating a Kernel PlugIn Driver

12.8.1 On Windows


	Driver installation on Windows requires administrator privileges.

Copy the driver file (xxx.sys) to the target platform's drivers directory: %windir%\system32\drivers (e.g., C:\WINNT\system32\drivers – on Windows 2000, or C:\Windows\system32\drivers – on Windows 7 / Vista / Server 2008 / Server 2003 / XP).
Register/load your driver, using the wdreg.exe or wdreg_gui.exe utility:
In the following instructions, KP_NAME stands for your Kernel PlugIn driver's name, without the .sys extension.
To install your driver, run:
WinDriver\util> wdreg -name KP_NAME install


	Kernel PlugIn drivers are dynamically loadable, and thus do not require a reboot in order to load.

12.8.2 On Mac OS X


	Driver installation on Mac OS X requires root privileges.

To install your Kernel PlugIn driver on Mac OS X, run the following command from a command-line prompt:
$ sudo <path to wdreg> <KP_dir>/macos/build/<Release/Debug>/kp_xxx.kext

For example:

For a generated DriverWizard MY_KP Kernel PlugIn project:
$ sudo ~/WinDriver/redist/wdreg ~/WinDriver/wizard/my_projects/my_kp/kermode/macos/build/Release/kp_my_kp.kext
For the KP_PCI sample:
$ sudo ~/WinDriver/redist/wdreg ~/WinDriver/samples/pci_diag/kp_pci/macos/build/Release/kp_pci.kext

12.8.3 On Linux

Change directory to your Kernel PlugIn driver directory.
For example, when installing the sample KP_PCI driver, run:
cd WinDriver/samples/pci_diag/kp_pci
When installing a driver created using the Kernel PlugIn files generated by DriverWizard, run the following command, where <path> signifies the path to your generated DriverWizard project directory (e.g., /home/user/WinDriver/wizard/my_projects/my_kp):
cd <path>/kermode/
Execute the following command to install your Kernel PlugIn driver:
The following command must be executed with root privileges.
make install


	In the following instructions, KP_NAME stands for your Kernel PlugIn driver's name, without the .sys extension.


	The following command must be executed with root privileges.


12.7 Compile Your Kernel PlugIn Driver		Chapter 13. Dynamically Loading Your Driver