Txfs2

  • Article

This automated test evaluates the transactional capability of the NTFS file system (TxF). It contains scenarios that test simple transacted operations, such as creating and deleting a file, or committing and rolling back the transaction. It also tests more advanced features of TxF, such as savepoints, miniversion, and secondary resource managers (RMs).

This test runs on the volume where it is started, typically the system volume. For the test to work correctly, this volume must be an NTFS volume or a compressed NTFS volume.

Note

   For more information about the behavior of file systems, see File System Behavior in the Microsoft Windows Environment.

 

Test details

   
Specifications
  • Filter.Driver.FileSystem.MiniFilter
  • Filter.Driver.AntiVirus.MiniFilter
  • Filter.Driver.FileSystem.Functionality
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
  • Windows 10, mobile edition (Arm)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 30
Category Development
Timeout (in minutes) 1800
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:

FAT

FAT16

1,024 MB

k:

FAT32

FAT32

1,024 MB

l:

ExFAT

ExFAT

2,048 MB

m:

UDF

UDF

2,048 MB

n:

 

The test runs variations for each of these six partitions.

Note

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

More information

Command syntax

Command option Description

Txfsreg --regression

Must be run on the target volume.

Note

   For command-line help for this test binary, type /h.

 

File list

File Location

TxfsReg.exe

<[testbinroot]>\NTTest\basetest\core_file_services\txf\

Ntlog.dll

<[testbinroot]>\NTTest\CommonTest\Ntlog\

Ntlogger.ini

<[testbinroot]>\NTTest\\CommonTest\Ntlog\

Stresslog.dll

<[testbinroot]>\NTTest\basetest\core_file_services\shared_libs\

RunTxF.cmd

<[testbinroot]>\NTTest\\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\

WrapTxF.cmd

<[testbinroot]>\NTTest\BASETEST\Core_File_Services\FilterManager\TestSuite\Scripts\FileSystems\

 

Parameters

Parameter name Parameter description
LLU_LclAdminUser LLU for execute
LLU_NetAccessOnly LLU for copy
NTFS_DRIVE_LETTER The drive letter for the NTFS volume that the TxF tests will run on.
CNTFS_DRIVE_LETTER The drive letter for the Compressed NTFS volume that the TxF test will run on.