Announcing ConnMan.net

Posted Jun 24, 2009 14:43 UTC (Wed) by dcbw (guest, #50562)
In reply to: Announcing ConnMan.net by enberg
Parent article: Announcing ConnMan.net

Is there something wrong with http://projects.gnome.org/NetworkManager/developers/spec.... ? It's a full description of the D-Bus API. Most of libnm-glib is also documented. Much of libnm-util is as well. Of course more documentation is needed, both in the code and for usage of the D-Bus interface. However, I'd think that nm-tool would give you a pretty good idea of how to use it via libnm-glib, and it's also simple via Python if you take a look at the dbus spec.

Announcing ConnMan.net

Posted Jun 24, 2009 16:33 UTC (Wed) by wstephenson (guest, #14795) [Link] (3 responses)

http://live.gnome.org/NetworkManagerConfigurationSpecific... is necessary to know too, but is incomplete in many ways, so all roads lead back to grokking the NM daemon and gnome client code.

Announcing ConnMan.net

Posted Jun 24, 2009 16:36 UTC (Wed) by dcbw (guest, #50562) [Link] (2 responses)

I assume you mean the lack of the documentation of the key/value pairs for configuration? That's a valid criticism, but it's being fixed by documenting libnm-util.

What other ways is it "incomplete"?

Announcing ConnMan.net

Posted Jun 24, 2009 16:59 UTC (Wed) by wstephenson (guest, #14795) [Link] (1 responses)

Generally a Big Picture of how NM configuration works is missing.

Re the config key/values:
Groups like pppoe are missing.
The dependencies between settings groups to make NM accept a connection.
Lots of details of the significance of the values, for example the need for clients to keep seen-bssids updated for autoconnect to work, and the timestamp's role in choosing which connection to autoconnect.

Announcing ConnMan.net

Posted Jun 24, 2009 18:29 UTC (Wed) by dcbw (guest, #50562) [Link]

All valid points. The documentation does need to be a lot better, that's true, and that's something that we've been trying to make a better effort on in the past 6 months or so.