{"record":{"id":"f754c198ba730feb","repo":"ipfs/kubo","slug":"error-while-inspecting-s-path-q-w","errorCode":null,"errorMessage":"error while inspecting %s path (%q): %w","messagePattern":"error while inspecting (.+?) path \\(%q\\): %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/ipfs/kubo/daemon.go","lineNumber":1293,"sourceCode":"\t// Extra space after \"MFS\" so \"mounted at:\" lines up with IPFS and\n\t// IPNS in the column above. Matches MountCmd's output formatter.\n\tfmt.Printf(\"IPFS mounted at: %s\\n\", fsdir)\n\tfmt.Printf(\"IPNS mounted at: %s\\n\", nsdir)\n\tfmt.Printf(\"MFS  mounted at: %s\\n\", mfsdir)\n\treturn nil\n}\n\nfunc checkFusePath(name, path string) error {\n\tif path == \"\" {\n\t\treturn fmt.Errorf(\"%s path cannot be empty\", name)\n\t}\n\n\tfileInfo, err := os.Stat(path)\n\tif err != nil {\n\t\tif os.IsNotExist(err) {\n\t\t\treturn fmt.Errorf(\"%s path (%q) does not exist: %w\", name, path, err)\n\t\t}\n\t\treturn fmt.Errorf(\"error while inspecting %s path (%q): %w\", name, path, err)\n\t}\n\n\tif !fileInfo.IsDir() {\n\t\treturn fmt.Errorf(\"%s path (%q) is not a directory\", name, path)\n\t}\n\n\treturn nil\n}\n\nfunc maybeRunGC(req *cmds.Request, node *core.IpfsNode) (<-chan error, error) {\n\tenableGC, _ := req.Options[enableGCKwd].(bool)\n\tif !enableGC {\n\t\treturn nil, nil\n\t}\n\n\terrc := make(chan error)\n\tgo func() {\n\t\terrc <- corerepo.PeriodicGC(req.Context, node)","sourceCodeStart":1275,"sourceCodeEnd":1311,"githubUrl":"https://github.com/ipfs/kubo/blob/329838acdfafae224582930457efe80aa217afc0/cmd/ipfs/kubo/daemon.go#L1275-L1311","documentation":"checkFusePath's generic guard: os.Stat on the configured FUSE mountpoint (IPFS/IPNS/MFS path) returned an error other than NotExist, e.g. a permission denial or a broken symlink on some path component. %s is the mount name (\"IPFS path\" etc.), %q the path, %w the underlying stat error. Fires during mountFuse when the path exists in a form stat cannot inspect.","triggerScenarios":"Thrown at cmd/ipfs/kubo/daemon.go:1293 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Fix permissions on the mountpoint path or its parents so the ipfs process can stat it","Remove dangling symlinks along the path","Point the mount config at an existing directory and retry 'ipfs daemon --mount'"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"329838acdfafae224582930457efe80aa217afc0","analyzedAt":"2026-09-03T18:30:52.135Z","contentChangedAt":"2026-09-03T18:30:52.135Z","schemaVersion":2},"datasetVersion":"2026-09-11T00:17:11.886Z"}