ddcopy.exe

The ddcopy utility, is a Device Driver Copy utility that copies only those drivers in the driver set that support a specific machine.

Two versions of the utility come with 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] [/?]

The ddcopy utility uses these parameters.

Table 1. ddcopy parameters
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 utility returns the following values to indicate status:

Table 2. ddcopy return values
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 utility usage.

Table 3. ddcopy examples
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.