system · Command reference
qzx testDiskSpeed
What it does
Benchmarks sequential write and read speeds (MB/s) of the filesystem at a target path
Canonical command: testDiskSpeed
Accepted aliases: None
Case-sensitive: no
Included in the published package
Available in PyPI 0.2.2.0.2. This page documents the 0.2.2.0.2 alpha development checkout.
Safety and effects
Can mutate state
No documented dry-run parameter
No native program invocation in the current classification
No documented network use
No inherent elevation requirement
Creates and removes temporary test data while measuring disk performance.
This safety classification was reviewed against implementation digest sha256:eff61f880daa6eab276dae6da94c6fd5d71e52170381c6e8a05bcd972f0e5cc1 on 2026-07-24.
Exact syntax
qzx testDiskSpeed [test_path] [size_mb] --jsonParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| test_path | str | No | "." | Directory path to benchmark (defaults to current directory) |
| size_mb | str | No | "50" | Temporary test file size in Megabytes (defaults to 50) |
Input examples
qzx testDiskSpeedBenchmark disk speed in the current folder using a 50MB test file
qzx testDiskSpeed C:/temp 100Benchmark disk speed in C:/temp using a 100MB test file
For the complete structured payload, add --json: qzx testDiskSpeed [test_path] [size_mb] --json
Representative output example
This illustrative JSON is derived from the current implementation-backed result contract. It shows what the command can return without claiming a recorded execution; values vary with inputs, host, permissions, and optional tools.
Example command: qzx testDiskSpeed --json
{
"success": true,
"message": "Benchmarks sequential write and read speeds (MB/s) of the filesystem at a target path. In this illustrative example, the command completed successfully.",
"read_duration_seconds": 42.7,
"read_speed_mbs": 42.7,
"test_directory": "C:\\project\\example.txt",
"test_file_size_mb": "C:\\project\\example.txt",
"write_duration_seconds": 42.7,
"write_speed_mbs": 42.7
}View the JSON result contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"error": {
"type": "string"
},
"read_duration_seconds": [],
"read_speed_mbs": [],
"test_directory": [],
"test_file_size_mb": [],
"write_duration_seconds": [],
"write_speed_mbs": []
},
"additionalProperties": true
}Errors and limits
The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.
QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.
Evidence workflow: requires an isolated disposable target.
Evidence and provenance
- Implementation
- src/qzx/commands/system/test_disk_speed.py
- Tests
- No command-specific test file with the same module name was found; this does not prove that all coverage is absent.
- Documentation channel
- Development documentation 0.2.2.0.2 · main · sha256:319b16857a87636ebc3b89734cc040a737bb56194464fca33ce73bdae2043096
- Availability
- 0.2.2.0.2 or earlier
Keep exploring
Related commands
These commands also belong to the system category. Compare them to choose the operation that best fits your task.