stafd.conf

nvme-stas
Mr Martin Belanger
Dell, Inc.
stafd.conf 5
stafd.conf stafd 8 configuration file

`/etc/stas/stafd.conf`

## Description

When stafd 8 starts up, it reads its configuration from `stafd.conf`.

## Configuration File Format

`stafd.conf` is a plain text file divided into sections, with configuration entries in the style key=value. A space immediately before or after the `=` is ignored. Empty lines and lines starting with `#` are ignored, which may be used for commenting.

## Options

### [Global] section

The following options are available in the `[Global]` section:

`persistent-connections=`

  Takes a boolean argument. Whether connections to Discovery Controllers (DC) are persistent. When true, connections initiated by stafd will persists even when stafd is stopped. When `false`, `stafd` will disconnect from all DCs it is connected to on exit. Defaults to `false`.

`ignore-iface=`

  Takes a boolean argument. This option controls how connections with Discovery Controllers (DC) are made.

  DCs are automatically discovered using DNS-SD/mDNS. mDNS provides the DC's IP address and the interface on which the DC was discovered.

  There is no guarantee that there will be a route to reach that DC. However, we can use the socket option SO_BINDTODEVICE to force the connection to be made on a specific interface instead of letting the routing tables decide where to make the connection.

  This option determines whether `stafd` will use SO_BINDTODEVICE to force connections on an interface or just rely on the routing tables. The default is to use SO_BINDTODEVICE, in other words, `stafd` does not ignore the interface by default.

  Defaults to `false`.

### [Service Discovery] section

The following options are available in the `[Service Discovery]` section:

`zeroconf=`

  Enable zeroconf provisioning using DNS-SD/mDNS. Takes a string argument `enabled` or `disabled`.

  When `enabled`, the default, `stafd` makes a request with the Avahi daemon to locate Discovery Controllers using DNS-SD/mDNS.

  Discovery Controllers that support zeroconf advertize themselves over mDNS with the service type `_nvme-disc._tcp`.

## See Also

stafd 8