{"record":{"id":"16b991308c51b95b","repo":"lima-vm/lima","slug":"unimplemented","errorCode":null,"errorMessage":"unimplemented","messagePattern":"unimplemented","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"pkg/driver/hcs/errors_windows.go","lineNumber":8,"sourceCode":"// SPDX-FileCopyrightText: Copyright The Lima Authors\n// SPDX-License-Identifier: Apache-2.0\n\npackage hcs\n\nimport \"errors\"\n\nvar errUnimplemented = errors.New(\"unimplemented\")\n","sourceCodeStart":1,"sourceCodeEnd":9,"githubUrl":"https://github.com/lima-vm/lima/blob/dd909d0973cd84fa35f9e1693181b4585ea616c1/pkg/driver/hcs/errors_windows.go#L1-L9","documentation":"The Windows HCS driver is a skeleton: snapshot management and display/password connection features are not implemented, so every one of those driver methods returns this sentinel errUnimplemented. Seeing it means you invoked a lima feature the HCS backend does not support at all — there is no transient failure to retry.","triggerScenarios":"limactl snapshot create/apply/delete/list, or display password / display connection operations (e.g. limactl cp/ssh with display flows, vnc password commands), dispatched to the hcs driver — the method immediately returns errUnimplemented.","commonSituations":"Users on Windows choosing vmType hcs (or it being auto-selected) and then attempting snapshotting or display password features that work under other drivers (qemu, vz).","solutions":["Use a driver that implements snapshots (e.g. vmType qemu or vz) for snapshot workflows","Skip display-password features on hcs; use the driver's native console access","Track lima upstream for HCS snapshot/display implementation before retrying"],"exampleFix":"// before (lima.yaml)\nvmType: hcs\n// after: switch to a driver with snapshot support\nvmType: qemu","handlingStrategy":"validation","validationCode":"if inst.Config != nil && inst.Config.VMType != nil && *inst.Config.VMType == \"hcs\" {\n\treturn errors.New(\"snapshots and display-password are unsupported on the hcs driver; use qemu or vz\")\n}","typeGuard":null,"tryCatchPattern":"if err := limactl.SnapshotCreate(inst, name); err != nil {\n\tif strings.Contains(err.Error(), \"unimplemented\") {\n\t\treturn fmt.Errorf(\"hcs driver does not support snapshots; switch vmType\")\n\t}\n\treturn err\n}","preventionTips":["Check the driver capability matrix before using snapshots/display features on Windows","Set vmType explicitly (qemu/vz) when you need snapshots","Track lima releases for HCS feature parity before enabling workflows that need it"],"tags":["windows","hcs","unimplemented","snapshots"],"backgroundTag":"feature-not-implemented","analyzedSha":"dd909d0973cd84fa35f9e1693181b4585ea616c1","analyzedAt":"2026-09-01T14:24:59.842Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}