dsmfind.exe

Edit online

Run the dsmfind.exe program from a Command Prompt window to show files that are described by a job file or by a file path and file attribute filters.

Syntax


1  DSMFIND.exe
1   -la
1  jobfile
1 
2.1  filespec
2.2.1+ 
2.2.1 
2.2.2.1  -a
2.2.2.1  -ax
2.2.1 filter
2.2.1   -s
2.2.1   -sx
1 ?  -r

Options

-la
List Windows® supported file attributes. Use the listed values to determine the filter for a dsmfind.exe command.
jobfile
Specify the path of a migration job file. The command displays all files that meet the criteria that is defined in a migration job file.
filter
Use this option with the attribute options (-a and -ax). Specify a filter for file attributes. The filter must be in the format 0xnnnnnnnn, where n is a hexadecimal number. You can combine file attributes. For example, the filter with value 0x00001600 is a combination of these file attributes:
  • 0x00000200 (FILE_ATTRIBUTE_SPARSE_FILE)
  • 0x00000400 (FILE_ATTRIBUTE_REPARSE_POINT )
  • 0x00001000 (FILE_ATTRIBUTE_OFFLINE)
-a or -ai
Use this option with a filter. This option displays only files that have all attributes defined by the filter.
-ax
Use this option with a filter. This option excludes files that have all attributes defined by the filter.
-s or -si
This option displays stub files only. This is the same as -a 0x00001600.
When stub files are created, stub files have these attributes:
  • 0x00000200 (FILE_ATTRIBUTE_SPARSE_FILE)
  • 0x00000400 (FILE_ATTRIBUTE_REPARSE_POINT )
  • 0x00001000 (FILE_ATTRIBUTE_OFFLINE)
Note: Some anti-virus programs can remove the attribute FILE_ATTRIBUTE_OFFLINE from stub files.
-sx
This option excludes stub files. This is the same as -ax 0x00001600.
-r
The command displays files in all subdirectories.

Invoke the command with no options to display help for the command.

Examples

Task
Display all files that meet the criteria that is defined in the job file c:\hsmclient\jobs\migrate011.osj.

Command: dsmfind c:\hsmclient\jobs\migrate011.osj

Task
Display all Excel files in c:\projects\2009\.

Command: dsmfind c:\projects\2009\*.xls

Task
Display all Excel files in c:\projects\ and all subdirectories.

Command: dsmfind c:\projects\*.xls -r

Task
Display all stub files in c:\projects\ and all subdirectories.

Command: dsmfind c:\projects\ -r -s

Task
Display all read-only stub files in c:\projects\ and all subdirectories. Read-only files have attribute FILE_ATTRIBUTE_READONLY (0x00000001). Read-only stub files with other attributes are not displayed. Only files with combined attributes of 0x00001601 are displayed.

Command: dsmfind c:\projects\ -r -s -a 0x00000001

Task
Display help for the dsmfind.exe command.

Command: dsmfind