ReparsePoints
This automated test validates reparse points on the upper file system stack.
This test sets, deletes, and queries reparse points via FSCTLs. The test proceeds by setting different sizes of reparse data on files and directories.
The test also includes dismount testing with setting reparse points and invalid input. Specifically, the test includes the following:
FSCTL_SET_REPARSE_POINT
FSCTL_GET_REPARSE_POINT
FSCTL_DELETE_REPARSE_POINT
Note
For more information about the behavior of file systems, see File System Behavior in the Microsoft Windows Environment.
Test details
| Specifications |
|
| Platforms |
|
| Supported Releases |
|
| Expected run time (in minutes) | 60 |
| Category | Development |
| Timeout (in minutes) | 3600 |
| Requires reboot | false |
| Requires special configuration | false |
| Type | automatic |
Additional documentation
Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):
Running the test
For more information about requirements, see File System Testing Prerequisites.
In addition, this test requires extra hard drive space for four simple 2,048-megabyte (MB) partitions and two simple 1,024-MB partitions.
Before you run the test, you must add the following partitions to the Windows environment.
| Label | File system | Size | Expected drive letter |
|---|---|---|---|
NTFS |
NTFS |
2,048 MB |
g: |
CNTFS |
NTFS (compressed) |
2,048 MB |
i: |
REFS |
REFS |
1,024 MB |
o: |
Note
RunReparsePoint.cmd contains references to environment variables that you can change to allow for skipping of certain file systems.
Troubleshooting
For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.
For troubleshooting information, see Troubleshooting File System Testing.
All test cases return Pass or Fail. To review test details, review the test log from Windows Hardware Lab Kit (Windows HLK) Studio.
If you experience a test failure, run it with the option /V to have the test print additional information about variation failures (example: rp_regres %DRIVE_ltr% /V).
If you experience many failures, make sure that you are running on the correct type of file system. You can also check the file-system information about a volume to make sure that reparse points are supported. To do so, use the command fsutil fsinfo volumeinfo %DRIVE_ltr% and look for the output Supports Reparse Points.
More information
Command syntax
| Command option | Description |
|---|---|
Rp_regres %DRIVE_ltr% |
Specifies the driver to test. |
Note
For command-line help for this test binary, type /h.
File list
| File | Location |
|---|---|
Rp_regres.exe |
<[testbinroot]>\NTTest\basetest\core_file_services\ntfs\ |
Ntlog.dll |
<[testbinroot]>\NTTest\CommonTest\Ntlog\ |
Ntlogger.ini |
<[testbinroot]>\NTTest\CommonTest\Ntlog\ |
Stresslog.dll |
<[testbinroot]>\NTTest\basetest\core_file_services\shared_libs\ |
RunReparsePoint.cmd |
<[testbinroot]>\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\ |
WrapReparsePoint.cmd |
<[testbinroot]>\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\ |
IsREFSSupported.vbs |
<[testbinroot]>\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems |
Parameters
| Parameter name | Parameter description |
|---|---|
| NTFS_DRIVE_LETTER | The drive letter for the NTFS volume that the Reparse Points test will run on. |
| LLU_LclAdminUser | LLU for execute |
| LLU_NetAccessOnly | LLU for copy |
| CNTFS_DRIVE_LETTER | The drive letter for the Compressed NTFS volume that the Reparse Points test will run on. |
| REFS_DRIVE_LETTER | The drive letter for the ReFS volume that the test will run on. Enter NONE if not >= Win8 Server. |