summaryrefslogtreecommitdiff
path: root/doc/README.BasicManagement
diff options
context:
space:
mode:
authorJussi Kukkonen <jussi.kukkonen@intel.com>2013-10-23 16:19:51 +0300
committerJens Georg <jensg@openismus.com>2013-11-02 18:29:39 +0100
commit969261619fa1a8916e7ae70dac78c1e0513ae2a8 (patch)
tree899b0251fff097f69673a99f0714f1eda4964b7c /doc/README.BasicManagement
parentd1f14660839ea7b7bca000de9782011fd03284d2 (diff)
downloadrygel-969261619fa1a8916e7ae70dac78c1e0513ae2a8.tar.gz
core: Add UPnP BasicManagement service support
Add BasicManagement:2 service that contains a bunch of tools (Ping, NSLookup and Traceroute to start with). Service is useful for DLNA Diagnostics, and can be enabled on a plugin-by-plugin basis. See doc/README.BasicManagement for details. Commit was partly authored by Christophe Guiraud <christophe.guiraud@intel.com>. https://bugzilla.gnome.org/show_bug.cgi?id=707831
Diffstat (limited to 'doc/README.BasicManagement')
-rw-r--r--doc/README.BasicManagement24
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/README.BasicManagement b/doc/README.BasicManagement
new file mode 100644
index 00000000..fc77e51e
--- /dev/null
+++ b/doc/README.BasicManagement
@@ -0,0 +1,24 @@
+UPnP BasicManagement / DLNA +DIAGE+
+===================================
+
+Rygel includes an optional BasicManagement:2[1] service implementation.
+The implementation allows running diagnostic tools (Ping, NSLookup and
+Traceroute) and querying their results remotely. Typically this service
+would be running on a mediarenderer or mediaserver device that wants to
+be compliant with the DLNA Diagnostics Guidelines[2].
+
+The BasicManagement service is not started by default. To enable it for
+a plugin add "diagnostics=true" in the configuration section for that
+plugin in rygel.conf:
+ [Playbin]
+ diagnostics=true
+
+The service implementation is portable in the sense of compiling on any
+Posix platform but it does use system tools (ping, nslookup, traceroute)
+and parses their output. It has only been tested with standard linux
+implementations but is likely to not produce good results on other OSes,
+even busybox may require additional work.
+
+[1] http://upnp.org/specs/dm/UPnP-dm-BasicManagement-v2-Service.pdf
+[2] https://members.dlna.org/apps/org/workgroup/mcac/download.php/28678/latest
+ (unfortunately only available to DLNA members)