1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34
|
"""A library for NetworkManager
User's view: the computer has an IP address and can connect to one of the
WiFi networks around, or to a wire.
Admin's view: the computer has network interfaces (on network devices),
which have configurations (/etc/network...). They can connect to access
points around. A connected interface has an IP config.
NetworkManager's view: computer has L{Devices<Device>}, some of which are
managed by L{NetworkManager}. WiFi devices see L{APs<AccessPoint>}. There are
L{Connections<networkmanager.applet.Connection>} which specify how a type of
device (wired, wireless) can be activated. The connections are provided by two
services separate from NM: NMSS and NMUS. To connect, the needed ingredients
are a Connection (+its service), a Device, optionally an L{AccessPoint}. It
results in an L{ActiveConnection} which remembers its ingredients. The device
then knows its L{IP4Config} and L{DHCP4Config}.
(TODO: explain VPN plugins, modems (ModemManager))
For details, see
- U{http://projects.gnome.org/NetworkManager/developers/spec.html}
- U{http://live.gnome.org/NetworkManagerConfigurationSpecification}
"""
#__docformat__ = "restructuredtext en"
# TODO hyperlinks to classes in epydoc. a diagram?
from accesspoint import AccessPoint
from activeconnection import ActiveConnection
from device import Device, IP4Config, DHCP4Config
from networkmanager import NetworkManager
__all__ = ["AccessPoint", "ActiveConnection", "Device",
"DHCP4Config", "IP4Config", "NetworkManager", ]
|