system · Command reference
qzx getSmartValues
What it does
Retrieves disk health information using S.M.A.R.T. technology
Canonical command: getSmartValues
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
Read-only under the current classification
No documented dry-run parameter
May invoke native programs
No documented network use
Outcome may depend on permissions
This safety classification was reviewed against implementation digest sha256:558818187b0592b9f8c3537293bc48aa96924649afc03abca2b72112531ab336 on 2026-07-24.
Exact syntax
qzx getSmartValues <disk> [format] --jsonParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| disk | str | Yes | Not declared | Disk identifier (e.g., "sda" on Linux, "PhysicalDrive0" on Windows) |
| format | str | No | "health" | Output format: "full" for all data, "health" for health summary |
Input examples
qzx getSmartValues sdaGet health information for /dev/sda (Linux)
qzx getSmartValues PhysicalDrive0 fullGet full S.M.A.R.T. data for PhysicalDrive0 (Windows)
For the complete structured payload, add --json: qzx getSmartValues <disk> [format] --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 getSmartValues sda --json
{
"success": true,
"message": "Retrieves disk health information using S.M.A.R.T. technology. In this illustrative example, the command completed successfully.",
"disk": "Example value",
"format": "json",
"health_status": "Example value"
}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"
},
"disk": [],
"error": {
"type": "string"
},
"format": [],
"health_status": {
"type": "string"
},
"stderr": []
},
"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 a controlled privileged environment.
Evidence and provenance
- Implementation
- src/qzx/commands/system/get_smart_values.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.