qzx getGPULoad

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 GetGPULoad --json

{
    "success": true,
    "message": "Found 1 GPU from NVIDIA. Showing detailed information. GPU 1: NVIDIA GeForce RTX 4070 (NVIDIA), 12282 MiB VRAM, 18 % utilization, 44 C.",
    "gpus": [
        {
            "index": 0,
            "name": "NVIDIA GeForce RTX 4070",
            "vendor": "NVIDIA",
            "driver_version": "example-driver",
            "memory": {
                "total": "12282 MiB",
                "used": "2210 MiB",
                "free": "10072 MiB"
            },
            "utilization": "18 %",
            "temperature": "44 C"
        }
    ],
    "nvidia_gpus": [
        {
            "index": 0,
            "name": "NVIDIA GeForce RTX 4070",
            "vendor": "NVIDIA",
            "driver_version": "example-driver",
            "memory": {
                "total": "12282 MiB",
                "used": "2210 MiB",
                "free": "10072 MiB"
            },
            "utilization": "18 %",
            "temperature": "44 C"
        }
    ],
    "gpu_count": 1,
    "detected_vendors": [
        "NVIDIA"
    ],
    "gpu_summary": [
        "GPU 1: NVIDIA GeForce RTX 4070 (NVIDIA), 12282 MiB VRAM, 18 % utilization, 44 C"
    ]
}

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "amd_gpus": [],
        "detected_vendors": {
            "type": "array"
        },
        "error": {
            "type": "string"
        },
        "generic_gpu_info": [],
        "gpu_count": [],
        "gpu_summary": [],
        "gpus": {
            "type": "array"
        },
        "intel_gpus": [],
        "nvidia_gpus": []
    },
    "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 the supported operating-system matrix.