From 439bdfd6882e3632a4fe67f0d19801524a1c7d8d Mon Sep 17 00:00:00 2001
From: Marcel Holtmann <marcel@holtmann.org>
Date: Wed, 30 Jan 2008 16:34:54 +0100
Subject: [PATCH] Add manager documentation

---
 doc/Makefile.am     |  2 ++
 doc/manager-api.txt | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 doc/manager-api.txt

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 0274292..fadc659 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 0000000..0d5fbfb
--- /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.
+
-- 
2.7.4