{"record":{"id":"1960cf8883240fcc","repo":"juicedata/juicefs","slug":"invalid-guid-mask-q-expected-an-unsigned-32-bit","errorCode":null,"errorMessage":"invalid guid-mask %q: expected an unsigned 32-bit integer","messagePattern":"invalid guid-mask %q: expected an unsigned 32-bit integer","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"sdk/java/libjfs/guid.go","lineNumber":32,"sourceCode":" * limitations under the License.\n */\n\npackage main\n\nimport (\n\t\"crypto/md5\"\n\t\"encoding/binary\"\n\t\"fmt\"\n\t\"os/user\"\n\t\"strconv\"\n\t\"sync\"\n)\n\nfunc guidMask(value, metaName string) (uint32, error) {\n\tif value != \"\" {\n\t\tmask, err := strconv.ParseUint(value, 0, 32)\n\t\tif err != nil {\n\t\t\treturn 0, fmt.Errorf(\"invalid guid-mask %q: expected an unsigned 32-bit integer\", value)\n\t\t}\n\t\tif mask == 0 {\n\t\t\treturn 0, fmt.Errorf(\"invalid guid-mask %q: value must be greater than zero\", value)\n\t\t}\n\t\treturn uint32(mask), nil\n\t}\n\tswitch metaName {\n\tcase \"mysql\", \"postgres\", \"sqlite3\":\n\t\treturn uint32(0x7FFFFFFF), nil\n\tdefault:\n\t\treturn 0, nil\n\t}\n}\n\ntype pwent struct {\n\tid   uint32\n\tname string\n}","sourceCodeStart":14,"sourceCodeEnd":50,"githubUrl":"https://github.com/juicedata/juicefs/blob/c9a67b23e8e08ec23ec331aa6f1675e2319e921c/sdk/java/libjfs/guid.go#L14-L50","documentation":"Returned by guidMask in the Java SDK's native library when the guid-mask option is set but is not parseable as an unsigned 32-bit integer. The mask constrains generated uid/gid values; a non-numeric or out-of-range value is rejected at init.","triggerScenarios":"Thrown at sdk/java/libjfs/guid.go:32 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set guid-mask to a valid unsigned 32-bit integer, e.g. 0x7FFFFFFF, or omit it"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c9a67b23e8e08ec23ec331aa6f1675e2319e921c","analyzedAt":"2026-09-06T17:55:48.476Z","contentChangedAt":"2026-09-06T17:55:48.476Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}