From e8527fe25dec9e04eda4e3362422549b97aeb520 Mon Sep 17 00:00:00 2001
From: Alexey Romanenko <santiago@php.net>
Date: Wed, 9 Sep 2009 09:42:34 +0000
Subject: [PATCH] added new example

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@288194 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/gupnp/examples.xml | 57 ++++++++++++++++++++++++++++++------
 1 file changed, 48 insertions(+), 9 deletions(-)

diff --git a/reference/gupnp/examples.xml b/reference/gupnp/examples.xml
index c1598a8a13..ef6853acfb 100644
--- a/reference/gupnp/examples.xml
+++ b/reference/gupnp/examples.xml
@@ -4,25 +4,64 @@
 <chapter xml:id="gupnp.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
  <para>
-  Description here...
+  This example shows how to obtain information about all devices and services. 
+  It starts infinite loop and while any of available devices or services 
+  is found proper callback function will be invoked.
  </para>
  <example>
-  <title>Gupnp Example</title>
+  <title>Search for all UPnP devices and services.</title>
   <programlisting role="php">
 <![CDATA[
 <?php
 
-/* ... */
+/* Callback for available device */
+function device_proxy_available_cb($proxy, $arg)
+{
+	$info = gupnp_device_info_get($proxy);
+
+	$type = $info['device_type'];
+	$location = $info['location'];
+
+	printf("Device available:\n");
+	printf("\ttype:     %s\n", $type);
+	printf("\tlocation: %s\n", $location);
+}
+
+/* Callback for available service */
+function service_proxy_available_cb($proxy, $arg)
+{
+	$info = gupnp_service_info_get($proxy);
+
+	$type = $info['service_type'];
+	$location = $info['location'];
+
+	printf("Service available:\n");
+	printf("\ttype:     %s\n", $type);
+	printf("\tlocation: %s\n", $location);
+}
+
+/* Create the UPnP context */
+$context = gupnp_context_new();
+if (!$context) {
+	printf("Error creating the GUPnP context\n");
+	exit(-1);
+}
+
+/* We're interested in everything */
+$cp = gupnp_control_point_new($context, "ssdp:all");
+
+/* Set callbacks */
+gupnp_control_point_callback_set($cp, 
+	GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE, 'device_proxy_available_cb');
+gupnp_control_point_callback_set($cp, 
+	GUPNP_SIGNAL_SERVICE_PROXY_AVAILABLE, 'service_proxy_available_cb');
+
+/* Start for browsing (infinite loop, hit Ctrl-C to interrupt) */
+gupnp_control_point_browse_start($cp);
 
 ?>
 ]]>
   </programlisting>
-  &example.outputs.similar;
-  <screen>
-<![CDATA[
-...
-]]>
-  </screen>
  </example>
 </chapter>