rqlite/rqlite · error

msg

Error message

msg

What it means

fmtError (cmd/rqlited/config_flags.go:252) is a trivial wrapper that converts a message string into a Go error via errors.New. It is used while building Config from command-line flags; any invalid flag value or combination detected during config forging produces this error carrying the specific message.

Source

Thrown at cmd/rqlited/config_flags.go:252

}

func mustParseDuration(d string) time.Duration {
	td, err := time.ParseDuration(d)
	if err != nil {
		panic(err)
	}
	return td
}

func splitString(s, sep string) []string {
	if s == "" {
		return nil
	}
	return strings.Split(s, sep)
}

func fmtError(msg string) error {
	return errors.New(msg)
}

func usage(msg string) {
	fmt.Fprintf(os.Stderr, "%s", msg)
}

View on GitHub (pinned to 7586a4d1bd)

Solutions

1. Read the error message text, which names the offending flag or value
2. Correct the flag value on the rqlited command line
3. Run rqlited -h to see accepted flag formats

Example fix

// before
rqlited -write-queue-capacity=abc
// after
rqlited -write-queue-capacity=5000

// validate flags before launching rqlited
if !regexp.MustCompile(`^[0-9]+$`).MatchString(queueCapacity) {
    return fmt.Errorf("-write-queue-capacity must be numeric, got %q", queueCapacity)
}

if err := forgeConfig(flags); err != nil {
    fmt.Fprintf(os.Stderr, "config error: %v\n", err)
    os.Exit(2)
}

When it happens

Trigger: Starting rqlited with a malformed or invalid value for a config flag, where Forge calls fmtError with the validation message.

Common situations: Passing a bad separator format, unparsable duration/size values, or otherwise malformed flags on the rqlited command line.

Related errors

• -http-verify-common-name requires -http-verify-client
• -node-verify-common-name requires -node-verify-client
• HTTP and Raft addresses must differ
• failed to create TLS config for Raft dialer: %s
• %s environment variable not set

AI-assisted analysis of rqlite/rqlite@7586a4d1bd (2026-09-03). Data as JSON: /api/errors/c933c5fc8d4f0e7d. Report an issue: GitHub.