File: __init__.py

package info (click to toggle)
cnetworkmanager 0.21.1-1.1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 220 kB
  • ctags: 442
  • sloc: python: 1,252; makefile: 29
file content (34 lines) | stat: -rw-r--r-- 1,527 bytes parent folder | download
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", ]