Manpages

NAME

iwd.config - Configuration file for wireless daemon

SYNOPSIS

Configuration file main.conf

DESCRIPTION

The main.conf configuration file configures the system-wide settings for iwd. This file lives in the configuration directory specified by the environment variable $CONFIGURATION_DIRECTORY, which is normally provided by systemd. In the absence of such an environment variable it defaults to /etc/iwd. If no main.conf is present, then default values are chosen. The presence of main.conf is not required.

FILE FORMAT

See iwd.network for details on the file format.

SETTINGS

The settings are split into several categories. Each category has a group associated with it and described in separate tables below.

General Settings
The group [General] contains general settings.

Network
The group [Network] contains network configuration related settings.

Blacklist
The group [Blacklist] contains settings related to blacklisting of BSSes. If iwd determines that a connection to a BSS fails for a reason that indicates the BSS is currently misbehaving or misconfigured (e.g. timeouts, unexpected status/reason codes, etc), then iwd will blacklist this BSS and avoid connecting to it for a period of time. These options let the user control how long a misbehaved BSS spends on the blacklist.

Rank
The group [Rank] contains settings related to ranking of networks for autoconnect purposes.

Scan
The group [Scan] contains settings related to scanning functionality. No modification from defaults is normally required.

IPv4
The group [IPv4] contains settings related to IPv4 network configuration.

DriverQuirks
The group [DriverQuirks] contains special flags associated with drivers that are buggy or just don't behave similar enough to the majority of other drivers.

SEE ALSO

iwd(8), iwd.network(5)

AUTHOR

Marcel Holtmann <marcel [AT] holtmann.org>, Denis Kenzior <denkenz [AT] gmail.com>, Andrew Zaborowski <andrew.zaborowski [AT] intel.com>, Tim Kourt <tim.a.kourt [AT] linux.com>, James Prestwood <prestwoj [AT] gmail.com>

COPYRIGHT

2013-2019 Intel Corporation