{"record":{"id":"b1e5e6cf6fda321b","repo":"hashicorp/nomad","slug":"fingerprint-q-retry-attempts-cannot-be-less-than","errorCode":null,"errorMessage":"fingerprint %q retry attempts cannot be less than -1","messagePattern":"fingerprint %q retry attempts cannot be less than -1","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"client/config/fingerprint.go","lineNumber":112,"sourceCode":"// Validate the fingerprint block to ensure we do not have any values that\n// cannot be handled.\nfunc (f *Fingerprint) Validate() error {\n\n\tif f == nil {\n\t\treturn nil\n\t}\n\n\tif f.Name == \"\" {\n\t\treturn errors.New(\"fingerprint name cannot be empty\")\n\t}\n\tif !slices.Contains(validEnvFingerprinters, f.Name) {\n\t\treturn fmt.Errorf(\"fingerprint %q does not support configuration\", f.Name)\n\t}\n\tif f.RetryInterval < 0 {\n\t\treturn fmt.Errorf(\"fingerprint %q retry interval cannot be negative\", f.Name)\n\t}\n\tif f.RetryAttempts < -1 {\n\t\treturn fmt.Errorf(\"fingerprint %q retry attempts cannot be less than -1\", f.Name)\n\t}\n\tif len(f.ExtraKeysHCL) > 0 {\n\t\treturn fmt.Errorf(\"fingerprint %q contains unknown configuration options: %s\",\n\t\t\tf.Name, strings.Join(f.ExtraKeysHCL, \",\"))\n\t}\n\n\treturn nil\n}\n","sourceCodeStart":94,"sourceCodeEnd":121,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/client/config/fingerprint.go#L94-L121","documentation":"Returned by Fingerprint.Validate when the fingerprint block's RetryAttempts is less than -1; -1 means infinite retries and lower values are meaningless, indicating a typo or bad config in the client's fingerprint stanza.","triggerScenarios":"Thrown at client/config/fingerprint.go:112 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set retry_attempts to -1 for unlimited retries or a value >= 0","Remove the option to use defaults"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"482b49bf1aec006f089bcfc7e632d8f6ac303e5e","analyzedAt":"2026-09-04T07:54:14.808Z","contentChangedAt":"2026-09-04T07:54:14.808Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}