Where is the wpa_supplicant.conf option "update_config=1" documented?

First of all, I know what the option does. According to the Arch Linux Wiki, it gives the command line "wpa_cli" utility the permission to rewrite wpa_supplicant.conf:

Warning: Setting update_config to 1 allows wpa_supplicant to overwrite
the configuration file. When overwriting, wpa_supplicant will reset
file permissions according to your default umask. It might
accidentally make the file readable to everyone thus exposing your
passwords, if your system is multiuser.

But the Arch Linux wiki is the closest I could get to an authoritative description of this feature. It doesn’t appear in any of the man pages for wpa_supplicant, including the following: wpa_cli(8), wpa_supplicant(8) and wpa_supplicant.conf(5).

Where is the official documentation for this feature? My fear is that, if it’s indeed an "undocumented" feature that appears only in the source code, then any developer could simply edit out or disable the feature in a future release.

Asked By: Aubergone


The option appears to be documented in the example configuration file on the project’s web site:

# Whether to allow wpa_supplicant to update (overwrite) configuration
# This option can be used to allow wpa_supplicant to overwrite configuration
# file whenever configuration is changed (e.g., new network block is added with
# wpa_cli or wpa_gui, or a password is changed). This is required for
# wpa_cli/wpa_gui to be able to store the configuration changes permanently.
# Please note that overwriting configuration file will remove the comments from
# it.

As it’s documented on the project’s web site, I’d assume that the option isn’t going anywhere for a while.

Answered By: ErikF
Categories: Answers Tags: , ,
Answers are sorted by their score. The answer accepted by the question owner as the best is marked with
at the top-right corner.