Provided by: iwd_2.14-1ubuntu3_amd64 bug

NAME

       iwd.ap - Configuration of IWD access points

NAME

       iwd.ap - Access point provisioning files

SYNOPSIS

       Description of access point provisioning files.

DESCRIPTION

       An  access  point provisioning file defines the configuration of an IWD access point. These files live in
       $STATE_DIRECTORY/ap     (/var/lib/iwd/ap     by     default).      They     are     read     when     the
       net.connman.iwd.AccessPoint.StartProfile(ssid) DBus method is used.

FILE FORMAT

       See iwd.network for details on the settings file syntax.

SETTINGS

       The  settings  are  split  into  several categories.  Each category has a group associated with it and is
       described in the corresponding table below.

   General Settings
       The group [General] contains general AP configuration.
                               ┌──────────────┬───────────────────────────────────────┐
                               │ Channel      │ Channel number                        │
                               │              │                                       │
                               │              │ Optional  channel  number   for   the │
                               │              │ access   point   to  operate  on.  If │
                               │              │ omitted the channel  will  be  chosen │
                               │              │ automatically.  Channels greater than │
                               │              │ or equal to 36 will select  the  5GHz │
                               │              │ band for the AP to operate on.        │
                               │              │                                       │
                               │              │ Note:  Due to regulatory requirements │
                               │              │ the linux kernel does  not  allow  or │
                               │              │ strictly  limits  5GHz use in AP mode │
                               │              │ while   in   world   roaming.   These │
                               │              │ frequencies become available once the │
                               │              │ country  is  set,  either  via  IWD's │
                               │              │ main.conf  option   [General].Country │
                               │              │ (see  man  iwd.config)  or externally │
                               │              │ (e.g. iw reg set <CC>).  If  you  are │
                               │              │ having  trouble using 5GHz ensure the │
                               │              │ country is set, and that the  desired │
                               │              │ frequency/channel is unrestricted.    │
                               ├──────────────┼───────────────────────────────────────┤
                               │ RekeyTimeout │ Timeout for PTK rekeys (seconds)      │
                               │              │                                       │
                               │              │ The  time  interval  at  which the AP │
                               │              │ starts a rekey for a  given  station. │
                               │              │ If  not provided a default value of 0 │
                               │              │ is used (rekeying is disabled).       │
                               ├──────────────┼───────────────────────────────────────┤
                               │ DisableHT    │ Boolean value                         │
                               │              │                                       │
                               │              │ Explicitly  disable  HT  capabilities │
                               │              │ for this AP.                          │
                               └──────────────┴───────────────────────────────────────┘

   Network Authentication Settings
       The group [Security] contains settings for Wi-Fi security and authentication configuration.
                             ───────────────────────────────────────────────────────────
                               Passphrase        8..63 character string

                                                 WPA-PSK  Passphrase  to  be used with
                                                 this access point.  At least  one  of
                                                 Passphrase,   PreSharedKey   must  be
                                                 present.
                             ───────────────────────────────────────────────────────────
                               PreSharedKey      64-character hex-string

                                                 Processed passphrase for this network
                                                 in the form of a hex-encoded  32-byte
                                                 pre-shared   key.    Either  this  or
                                                 Passphrase must be present.
                             ───────────────────────────────────────────────────────────
                               PairwiseCiphers   Comma  separated  list  of   pairwise
                                                 ciphers for the AP supports.

                                                 Values can include: TKIP, CCMP, GCMP,
                                                 GCMP-256, CCMP-256

                                                 The  underlying hardware and IWD's AP
                                                 implementation must also support  the
                                                 ciphers listed
                             ───────────────────────────────────────────────────────────
                               GroupCipher       Group cipher the AP uses

                                                 A  single cipher value the AP can use
                                                 as the group cipher. Values  are  the
                                                 same as pairwise ciphers and the same
                                                 restrictions  apply (hardware and IWD
                                                 implementation   must   support   the
                                                 cipher)
                             ┌─────────────────┬───────────────────────────────────────┐
                             │                 │                                       │
   IPv4 Network Configuration│                 │                                       │
--

SEE ALSO

       iwd(8), iwd.network(5)

AUTHOR

       James Prestwood <prestwoj@gmail.com>

COPYRIGHT

       2020 Intel Corporation

iwd                                              20 October 2020                                       IWD.AP(5)