Unclear/misleading documentation for /etc/network/interfaces extensions

Bug #44315 reported by Niku Toivola
10
Affects Status Importance Assigned to Milestone
wpasupplicant (Ubuntu)
Fix Released
Medium
Unassigned

Bug Description

Binary package hint: wpasupplicant

The wpa_supplicant provided extensions to /etc/network/interfaces are only documented in /usr/share/doc/wpasupplicant/README.modes and the explanations for wpa-psk and wpa-passphrase are misleading. Proposed fixes:

1. Add these extensions to the wpa_supplicant man page (or some other suitable man page) and add a pointer to that in the interfaces(5) man page, similar to the wireless extensions and wireless(7).

2. Clarify the documentation for wpa-psk and wpa-passphrase so that the functionality is clear: 'wpa-psk "ascii passphrase in quotes"' works, 'wpa-psk <psk in hex format>' works, 'wpa-passphrase ascii passphrase without quotes' works, 'wpa-passphrase "ascii passphrase in quotes"' mysteriously fails.

Revision history for this message
kelmo (kelrin) wrote :

I hope that recent changes in debians 0.5.5-2 wpasupplicant version address this issue.

In that version the 'wpa-psk' value is evaluated as follows:

It is considered to be 256-bit hex key when containing exactly 64 hexadecimal only characters, otherwise it is considered as a passphrase. There is no need for quoted passphrases or 'wpa-passphrase' in this case (but remains compat. with those mentioned cases).

This makes the documentation much more simple, and less obsfucated for the end user.

What do others think about patching interfaces(5) manpage to add reference to wpasupplicant stuff?

Revision history for this message
Reinhard Tartler (siretart) wrote :

As edgy is in deep freeze mode now, I don't think that 6.10 will ship wpasupplicant 0.5.5-2, unless there are compelling reasons to do so.

About adding further information to interfaces(5): Sure!

Revision history for this message
Reinhard Tartler (siretart) wrote :

feisty now has 0.5.5-4, which should have clarified documentation. feel free to reopen with additional information if necessary

Changed in wpasupplicant:
status: Unconfirmed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.