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:
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: 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.