crowdsecurity/crowdsec · error

ErrFeatureNameCase

ErrFeatureNameCase

Error message

name is not lowercase

What it means

Sentinel fflag.ErrFeatureNameCase: the feature-flag name contains uppercase characters; names must be lowercase to be valid. Raised by validateFeatureName when featureName != strings.ToLower(featureName).

Source

Thrown at pkg/fflag/features.go:44

package fflag

import (
	"errors"
	"fmt"
	"io"
	"os"
	"regexp"
	"sort"
	"strings"

	"github.com/goccy/go-yaml"
	"github.com/sirupsen/logrus"
)

var (
	ErrFeatureNameEmpty   = errors.New("name is empty")
	ErrFeatureNameCase    = errors.New("name is not lowercase")
	ErrFeatureNameInvalid = errors.New("invalid name (allowed a-z, 0-9, _, .)")
	ErrFeatureUnknown     = errors.New("unknown feature")
	ErrFeatureDeprecated  = errors.New("the flag is deprecated")
	ErrFeatureRetired     = errors.New("the flag is retired")
)

const (
	ActiveState     = iota // the feature can be enabled, and its description is logged (Info)
	DeprecatedState        // the feature can be enabled, and a deprecation message is logged (Warning)
	RetiredState           // the feature is ignored and a deprecation message is logged (Error)
)

type Feature struct {
	Name  string
	State int // active, deprecated, retired

	// Description should be a short sentence, explaining the feature.
	Description string

View on GitHub (pinned to 909b515798)

Solutions

1. Rename the feature flag to all-lowercase (a-z, 0-9, _, .)

When it happens

Trigger: Thrown at pkg/fflag/features.go:44 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of crowdsecurity/crowdsec@909b515798 (2026-09-06). Data as JSON: /api/errors/c0412f9aa27cc338. Report an issue: GitHub.