> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siderolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

> LinkAliasConfig is a config document to alias (give a different name) to a physical link.

# LinkAliasConfig

```yaml theme={null}
apiVersion: v1alpha1
kind: LinkAliasConfig
name: int0 # Alias for the link.
# Selector to match the link to alias.
selector:
    match: glob("00:1a:2b:*", mac(link.permanent_addr)) # The Common Expression Language (CEL) expression to match the link.
```

```yaml theme={null}
apiVersion: v1alpha1
kind: LinkAliasConfig
name: net%d # Alias for the link.
# Selector to match the link to alias.
selector:
    match: link.driver == "e1000" # The Common Expression Language (CEL) expression to match the link.
```

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`name`</td>
      <td>string</td>
      <td>Alias for the link.<br /><br />Don't use system interface names like "eth0", "ens3", "enp0s2", etc. as those may conflict<br />with existing physical interfaces.<br /><br />The name can contain a single integer format verb (`%d`) to create multiple aliases<br />from a single config document. When a format verb is detected, each matched link receives a sequential<br />alias (e.g. `net0`, `net1`, ...) based on hardware address order of the links.<br />Links already aliased by a previous config are automatically skipped.</td>

      <td />
    </tr>

    <tr>
      <td>`selector`</td>
      <td><a href="#selector">LinkSelector</a></td>
      <td>Selector to match the link to alias.<br /><br />When the alias name is a fixed string, the selector must match exactly one link.<br />When the alias name contains a format verb (e.g. `net%d`), the selector may match multiple links<br />and each match receives a sequential alias.<br />If multiple selectors match the same link, the first one is used.</td>

      <td />
    </tr>
  </tbody>
</table>

## selector

LinkSelector selects a link to alias.

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`match`</td>
      <td>Expression</td>
      <td>The Common Expression Language (CEL) expression to match the link.</td>

      <td />
    </tr>
  </tbody>
</table>