--- title: "BFD configuration" description: "Reference for the BFD configuration resource in Calico Enterprise that tunes Bidirectional Forwarding Detection on BGP-peered nodes." product: "Calico Enterprise" version: "3.23 (latest)" section: "Reference" canonical_url: "https://docs.tigera.io/calico-enterprise/latest/reference/resources/bfdconfig" --- # BFD configuration A bidirectional forwarding detection (BFD) configuration resource (`BFDConfiguration`) represents BFD-specific configuration options for a selection of one or more nodes. For `kubectl` commands, the following case-insensitive aliases may be used to specify the resource type on the CLI: `bfdconfiguration.projectcalico.org`, `bfdconfigurations.projectcalico.org` as well as abbreviations such as `bfdconfiguration.p` and `bfdconfigurations.p`. ## Sample YAML ```yaml apiVersion: projectcalico.org/v3 kind: BFDConfiguration metadata: name: default spec: nodeSelector: "all()" interfaces: - matchPattern: "*" minimumRecvInterval: 10ms minimumSendInterval: 100ms idleSendInterval: 1m multiplier: 5 ``` ## BFD configuration definition ### Metadata | Field | Description | Accepted Values | Schema | | ----- | --------------------------------------------------------- | --------------------------------------------------- | ------ | | name | Unique name to describe this resource instance. Required. | Alphanumeric string with optional `.`, `_`, or `-`. | string | ### Spec | Field | Description | Accepted Values | Schema | Default | | ------------ | --------------------------------------------------------- | --------------- | ------------------------------------- | --------------------- | | nodeSelector | Selects one or more nodes to which this resource applies. | | string | [selector](#selector) | | interfaces | List of per-interface BFD configuration parameters. | | List of [BFDInterface](#bfdinterface) | | ### BFDInterface | Field | Description | Accepted Values | Schema | Default | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------ | ------- | | matchPattern | Pattern to match one or more interfaces. Supports exact interface names, match on interface prefixes (e.g., β€œeth\*”), or β€œ\*” to select all interfaces on the selected node(s). | | string | | | minimumRecvInterval | The minimum interval between received BFD packets. Must be a whole number of milliseconds greater than 0. | | string | 10ms | | minimumSendInterval | The minimum interval between transmitted BFD packets. Must be a whole number of milliseconds greater than 0. | | string | 100ms | | idleSendInterval | The interval between transmitted BFD packets when the BFD peer is idle. Must be a whole number of milliseconds greater than 0. | | string | 1m | | multiplier | The number of intervals that must pass without receiving a BFD packet before the peer is considered down. | | string | 5 | ### Selector A label selector is an expression which either matches or does not match a resource based on its labels. Calico Enterprise label selectors support a number of operators, which can be combined into larger expressions using the boolean operators and parentheses. | Expression | Meaning | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Logical operators** | | | `( )` | Matches if and only if `` matches. (Parentheses are used for grouping expressions.) | | `! ` | Matches if and only if `` does not match. **Tip:** `!` is a special character at the start of a YAML string, if you need to use `!` at the start of a YAML string, enclose the string in quotes. | | ` && ` | "And": matches if and only if both ``, and, `` matches | | ` \|\| ` | "Or": matches if and only if either ``, or, `` matches. | | **Match operators** | | | `all()` | Match all in-scope resources. To match *no* resources, combine this operator with `!` to form `!all()`. | | `global()` | Match all non-namespaced resources. Useful in a `namespaceSelector` to select global resources such as global network sets. | | `k == 'v'` | Matches resources with the label 'k' and value 'v'. | | `k != 'v'` | Matches resources without label 'k' or with label 'k' and value *not* equal to `v` | | `has(k)` | Matches resources with label 'k', independent of value. To match pods that do not have label `k`, combine this operator with `!` to form `!has(k)` | | `k in { 'v1', 'v2' }` | Matches resources with label 'k' and value in the given set | | `k not in { 'v1', 'v2' }` | Matches resources without label 'k' or with label 'k' and value *not* in the given set | | `k contains 's'` | Matches resources with label 'k' and value containing the substring 's' | | `k starts with 's'` | Matches resources with label 'k' and value starting with the substring 's' | | `k ends with 's'` | Matches resources with label 'k' and value ending with the substring 's' | Operators have the following precedence: - **Highest**: all the match operators - Parentheses `( ... )` - Negation with `!` - Conjunction with `&&` - **Lowest**: Disjunction with `||` For example, the expression ```text ! has(my-label) || my-label starts with 'prod' && role in {'frontend','business'} ``` Would be "bracketed" like this: ```text ((!(has(my-label)) || ((my-label starts with 'prod') && (role in {'frontend','business'})) ``` It would match: - Any resource that did not have label "my-label". - Any resource that both: - Has a value for `my-label` that starts with "prod", and, - Has a role label with value either "frontend", or "business". ## Supported operations | Datastore type | Create | Delete | Update | Get/List | Notes | | --------------------- | ------ | ------ | ------ | -------- | ----- | | Kubernetes API server | Yes | Yes | Yes | Yes | |