DDCOPY.EXE

The Device Driver Copy (ddcopy.exe) utility can copy only those drivers in the driver set that support a specific machine.

Two versions of the utility come with the ServerGuide Scripting Toolkit:

A 32-bit version for Windows 32-bit operating systems and for the Windows Preinstallation Environment (Windows PE) 2.1/3.0 (32-bit)
A 64-bit version for Windows x64 operating systems and for Windows PE 2.1/3.0 (x64).

Microsoft uses the term device-driver directory to refer to the directory that contains drivers for an individual device. All device-driver files are located in individual device-driver directories that contain the files for an individual device driver. The following directories are device-driver directories:

\adaptec
\asm
\hal
\ideraid
\srvraid

However, when specifying the source path for the ddcopy command, always specify the directory that contains the drvset.ini file. In this case, the source directory is the C:\w03_drv\$oem$\$1\drv directory.

When you issue a ddcopy command against a directory that contains device-driver directories. Ddcopy copies all of the device drivers that are specific to the specified machine types and any other files located in the drv directory to the new location.

The SupportedSystems keyword in the drvset.ini file is modified to reflect the new machine list.

The ddcopy.exe utility has the following command-line syntax:

ddcopy <source_path> <destination_path> [/M:machine_types or platform_ids] 
[/C:category] | [/V:n] [/?]

Parameter	Description
`source_path`	Defines the fully qualified path to the directory that contains the device-driver directories and the drvset.ini file.
`destination_path`	Specifies the fully qualified path of the target directory for copying the device drivers.
`/M:machine_types or platform_ids`	Specifies machine types or platform IDs to limit the number of drivers that are copied. Multiple machine types or platform IDs are allowed when delimited by commas.
`/C:category`	Specifies the driver categories to limit the device drivers to be copied. Multiple categories can be specified using a comma as the delimiter. If omitted, then all the device driver categories are copied. Valid values are: Network Video Management Chipset Mass Storage Application Tape Hotfix This is only valid with driver sets from ServerGuide 7.4.12 or greater.
`/V:n`	Specifies the verbose level used to report status during the deployment process. Valid values for n are: 0 - quiet mode 3 - default 5 - maximum information

The ddcopy.exe utility returns the following values to indicate status:

Value	Description
0	Success
1	Syntax error
2	Program error
3	Failed to copy
4	Machine type or platform ID not found
5	Destination is read-only
6	File not found

The following examples illustrate ddcopy.exe utility usage.

Example	Description
`ddcopy d:\drivers\$oem$\$1\drv c:\wininst\$oem$\$1\drv`	Copies all the drivers from the d:\drivers\$oem$\$1\drv directory to the c:\wininst\$oem$\$1\drv directory
`ddcopy d:\drivers\$oem$\$1\drv c:\wininst\$oem$\$1\drv /M:8832`	Copies the drivers that are specifically for machine type 8832 from the d:\drivers\$oem$\$1\drv directory to the c:\wininst\$oem$\$1\drv directory and updates the supported systems field in the drivers' DrvInfo.ini file and the c:\wininst\$oem$\$1\drv\drvset.ini file.
`ddcopy d:\drivers\$oem$\$1\drv c:\wininst\$oem$\$1\drv /M:8832,8865`	Copies the drivers for machine type 8832 and machine type 8865 from the d:\drivers\$oem$\$1\drv directory to the c:\wininst\$oem$\$1\drv directory and updates the supported systems field in the drivers' DrvInfo.ini file and the c:\wininst\$oem$\$1\drv\drvset.ini file.
`ddcopy d:\drivers\$oem$\$1\drv c:\mydrvs /m:8832 /c:network,video`	Copies the Network and Video drivers specific to the machine type 8832 from the d:\drivers\$oem$\$1\drv directory to the c:\mydrvs directory and updates the supported systems field in the drivers' DrvInfo.ini file as well as the c:\mydrvs\drvset.ini file.