dfilemaker <nitems> <nlevels> <maxflen>
dfilemaker creates a random directory tree with files having random data that is useful for testing.
Files and directories are created in the current working directory where the tool is executed. dfilemaker takes three positional parameters:
nitems
¶Total number of items to create.
nlevels
¶Maximum depth to create in directory level (relative to current path).
maxflen
¶Maximum number of bytes to write to a file.
The following options are planned in future releases, but they are not yet implemented.
-d
,
--depth
=*min*-*max*
¶Specify the depth of the file system tree to generate. The depth will be selected at random within the bounds of min and max. The default depth is set to 10 min, 20 max.
-f
,
--fill
=*type*
¶Specify the fill pattern of the file. Current options available are:
random
, true
, false
, and alternate
. random
will
fill the file using urandom(4). true
will fill the file
with a 0xFF pattern. false
will fill the file with a 0x00 pattern.
alternate
will fill the file with a 0xAA pattern. The default
fill is random
.
-r
,
--ratio
=*min*-*max*
¶Specify the ratio of files to directories as a percentage. The ratio will be chosen at random within the bounds of min and max. The default ratio is 5% min to 20% max.
-i
,
--seed
=*integer*
¶Specify the seed to use for random number generation. This can be used to create reproducible test runs. The default is to generate a random seed.
-s
,
--size
=*min*-*max*
¶Specify the file sizes to generate. The file size will be chosen at random random within the bounds of min and max. The default file size is set from 1MB to 5MB.
-w
,
--width
=*min*-*max*
¶Specify the width of the file system tree to generate. The width will be selected at random within the bounds of min and max. The width of the tree is determined by counting directories. The default width is set to 10 min, 20 max.
-h
,
--help
¶Print a brief message listing the dfilemaker(1) options and usage.
-v
,
--version
¶Print version information and exit.
The mpiFileUtils source code and all documentation may be downloaded from <https://github.com/hpc/mpifileutils>