diff options
author | Marcel Holtmann <marcel@holtmann.org> | 2008-01-30 16:34:54 +0100 |
---|---|---|
committer | Marcel Holtmann <marcel@holtmann.org> | 2008-01-30 16:34:54 +0100 |
commit | 439bdfd6882e3632a4fe67f0d19801524a1c7d8d (patch) | |
tree | f9a72f6d807f4c2d6afc5e7f14e29de35817d239 /doc | |
parent | 97697ebc4f19a72938252ea856d9e13a043ce0d6 (diff) | |
download | connman-439bdfd6882e3632a4fe67f0d19801524a1c7d8d.tar.gz connman-439bdfd6882e3632a4fe67f0d19801524a1c7d8d.tar.bz2 connman-439bdfd6882e3632a4fe67f0d19801524a1c7d8d.zip |
Add manager documentation
Diffstat (limited to 'doc')
-rw-r--r-- | doc/Makefile.am | 2 | ||||
-rw-r--r-- | doc/manager-api.txt | 47 |
2 files changed, 49 insertions, 0 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am index 02742923..fadc659d 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,2 +1,4 @@ +EXTRA_DIST = manager-api.txt + MAINTAINERCLEANFILES = Makefile.in diff --git a/doc/manager-api.txt b/doc/manager-api.txt new file mode 100644 index 00000000..0d5fbfb8 --- /dev/null +++ b/doc/manager-api.txt @@ -0,0 +1,47 @@ +Manager hierarchy +***************** + +Service name org.freedesktop.connman +Interface name org.freedesktop.connman.Manager +Object path / + +Methods array{object} ListInterfaces() + void RegisterAgent(object path) + void UnregisterAgent(object path) + +Signals InterfaceAdded(object) + InterfaceRemoved(object) + + +Method: ListInferfaces +====================== +This method lists all available interfaces. The return value is an array of +object paths. Every attached network interface (eth0, wlan0 etc.) of the +system is presented by an object path with additional interfaces on it. The +main interface is org.freedesktop.connman.Interface. + +Method: RegisterAgent +===================== +This method allows the user interace to register an agent. There can be only +one agent registered at a time. The parameter of the method is the object +path the agent has been registered for the callback method. The agent has +to implement org.freedesktop.connman.Agent interface on this object path. + +Method: UnregisterAgent +======================= +This method unregisters a previously registered agent. In case the agent +application exits the core will automatically unregister the agent. However +for a clean agent application it is important to call the unregister method. + +Signal: InterfaceAdded +====================== +This signal is emitted every time a new interface has been found by the +core and successfully activated. The signal is also emitted on startup +or at anytime at runtime in case of hotplug devices. + +Signal: InterfaceRemoved +======================== +This signal is emitted every time an interface has been removed. This can +happen at any time in case of hotplug devices. When the system shuts down, +this signal is also emitted. + |