* add C examples

* change doxygen to output stuff in "doxygen/" instead of "doxygen-doc/"
* implement avahi_entry_group_{reset,is_empty}() and make everyone use it
* move holdoff (SLEEPING) time checking from server to entry group
* add preliminary error codes


git-svn-id: file:///home/lennart/svn/public/avahi/trunk@216 941a03a8-eaeb-0310-b9a0-b1bbd8fe43fe

3 files changed, 304 insertions, 0 deletions

diff --git a/examples/Makefile.am b/examples/Makefile.am
new file mode 100644
index 0000000..e7be1bf
--- /dev/null
+++ b/examples/Makefile.am
@@ -0,0 +1,36 @@
+# $Id$
+#
+# This file is part of avahi.
+# 
+# avahi is free software; you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as
+# published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version.
+#
+# avahi is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with avahi; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+# USA.
+
+AM_CFLAGS=-I$(top_srcdir)
+
+# GLIB 2.0
+AM_CFLAGS+=$(GLIB20_CFLAGS)
+AM_LDADD=$(GLIB20_LIBS)
+
+noinst_PROGRAMS = \
+	publish-service \
+	browse-services
+
+publish_service_SOURCES = publish-service.c
+publish_service_CFLAGS = $(AM_CFLAGS)
+publish_service_LDADD = $(AM_LDADD) ../avahi-core/libavahi-core.la ../avahi-common/libavahi-common.la
+
+browse_services_SOURCES = browse-services.c
+browse_services_CFLAGS = $(AM_CFLAGS)
+browse_services_LDADD = $(AM_LDADD) ../avahi-core/libavahi-core.la ../avahi-common/libavahi-common.la
diff --git a/examples/browse-services.c b/examples/browse-services.c
new file mode 100644
index 0000000..bb8eed8
--- /dev/null
+++ b/examples/browse-services.c
@@ -0,0 +1,112 @@
+/* $Id$ */
+
+/***
+  This file is part of avahi.
+ 
+  avahi is free software; you can redistribute it and/or modify it
+  under the terms of the GNU Lesser General Public License as
+  published by the Free Software Foundation; either version 2.1 of the
+  License, or (at your option) any later version.
+ 
+  avahi is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+  or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
+  Public License for more details.
+ 
+  You should have received a copy of the GNU Lesser General Public
+  License along with avahi; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+  USA.
+***/
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <avahi-core/core.h>
+
+static GMainLoop *main_loop = NULL;
+
+static void resolve_callback(AvahiServiceResolver *r, AvahiIfIndex interface, AvahiProtocol protocol, AvahiResolverEvent event, const gchar *name,const gchar *type,const gchar *domain, const gchar *host_name, const AvahiAddress *address, guint16 port, AvahiStringList *txt, gpointer userdata) {
+    g_assert(r);
+
+    /* Called whenever a service has been resolved successfully or timed out */
+
+    if (event == AVAHI_RESOLVER_TIMEOUT)
+        g_message("Failed to resolve service '%s' of type '%s' in domain '%s'.", name, type, domain);
+    else {
+        gchar a[128], *t;
+
+        g_assert(event == AVAHI_RESOLVER_FOUND);
+        
+        g_message("Service '%s' of type '%s' in domain '%s':", name, type, domain);
+
+        avahi_address_snprint(a, sizeof(a), address);
+        t = avahi_string_list_to_string(txt);
+        g_message("\t%s:%u (%s) TXT=%s", host_name, port, a, t);
+        g_free(t);
+    }
+
+    avahi_service_resolver_free(r);
+}
+
+static void browse_callback(AvahiServiceBrowser *b, AvahiIfIndex interface, AvahiProtocol protocol, AvahiBrowserEvent event, const gchar *name, const gchar *type, const gchar *domain, gpointer userdata) {
+    g_assert(b);
+    
+    AvahiServer *s = userdata;
+
+    /* Called whenever a new services becomes available on the LAN or is removed from the LAN */
+
+    g_message("%s: service '%s' of type '%s' in domain '%s'",
+              event == AVAHI_BROWSER_NEW ? "NEW" : "REMOVED",
+              name,
+              type,
+              domain);
+
+    /* If it's new, let's resolve it */
+    if (event == AVAHI_BROWSER_NEW)
+        
+        /* We ignore the returned resolver object. In the callback function
+        we free it. If the server is terminated before the callback
+        function is called the server will free the resolver for us. */
+
+        avahi_service_resolver_new(s, interface, protocol, name, type, domain, AVAHI_PROTO_UNSPEC, resolve_callback, s);
+}
+
+int main(int argc, char*argv[]) {
+    AvahiServerConfig config;
+    AvahiServer *server = NULL;
+    AvahiServiceBrowser *sb;
+
+    /* Do not publish any local records */
+    avahi_server_config_init(&config);
+    config.publish_hinfo = FALSE;
+    config.publish_addresses = FALSE;
+    config.publish_workstation = FALSE;
+    config.publish_domain = FALSE;
+    
+    /* Allocate a new server */
+    server = avahi_server_new(NULL, &config, NULL, NULL);
+
+    /* Free the configuration data */
+    avahi_server_config_free(&config);
+
+    /* Create the service browser */
+    sb = avahi_service_browser_new(server, AVAHI_IF_UNSPEC, AVAHI_PROTO_UNSPEC, "_http._tcp", NULL, browse_callback, server);
+    
+    /* Run the main loop */
+    main_loop = g_main_loop_new(NULL, FALSE);
+    g_main_loop_run(main_loop);
+
+    /* Cleanup things */
+    if (sb)
+        avahi_service_browser_free(sb);
+    
+    if (server)
+        avahi_server_free(server);
+
+    if (main_loop)
+        g_main_loop_unref(main_loop);
+
+    return 0;
+}
diff --git a/examples/publish-service.c b/examples/publish-service.c
new file mode 100644
index 0000000..c9d0141
--- /dev/null
+++ b/examples/publish-service.c
@@ -0,0 +1,156 @@
+/* $Id$ */
+
+/***
+  This file is part of avahi.
+ 
+  avahi is free software; you can redistribute it and/or modify it
+  under the terms of the GNU Lesser General Public License as
+  published by the Free Software Foundation; either version 2.1 of the
+  License, or (at your option) any later version.
+ 
+  avahi is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+  or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
+  Public License for more details.
+ 
+  You should have received a copy of the GNU Lesser General Public
+  License along with avahi; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+  USA.
+***/
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <time.h>
+#include <stdio.h>
+#include <stdlib.h>
+
+#include <avahi-core/core.h>
+
+static AvahiEntryGroup *group = NULL;
+static GMainLoop *main_loop = NULL;
+static gchar *name = NULL;
+
+static void create_services(AvahiServer *s);
+
+static void entry_group_callback(AvahiServer *s, AvahiEntryGroup *g, AvahiEntryGroupState state, gpointer userdata) {
+    g_assert(s);
+    g_assert(g == group);
+
+    /* Called whenever the entry group state changes */
+
+    if (state == AVAHI_ENTRY_GROUP_ESTABLISHED)
+        /* The entry group has been established successfully */
+        g_message("Service '%s' successfully established.", name);
+    
+    else if (state == AVAHI_ENTRY_GROUP_COLLISION) {
+        gchar *n;
+
+        /* A service name collision happened. Let's pick a new name */
+        n = avahi_alternative_service_name(name);
+        g_free(name);
+        name = n;
+
+        g_message("Service name collision, renaming service to '%s'", name);
+
+        /* And recreate the services */
+        create_services(s);
+    }
+}
+
+static void create_services(AvahiServer *s) {
+    gchar r[128];
+    g_assert(s);
+
+    /* If this is the first time we're called, let's create a new entry group */
+    if (!group)
+        group = avahi_entry_group_new(s, entry_group_callback, NULL);
+
+    g_message("Adding service '%s'", name);
+
+    /* Create some random TXT data */
+    snprintf(r, sizeof(r), "random=%i", rand());
+
+    /* Add the service for IPP */
+    if (avahi_server_add_service(s, group, AVAHI_IF_UNSPEC, AVAHI_PROTO_UNSPEC, name, "_ipp._tcp", NULL, NULL, 651, "test=blah", r, NULL) < 0) {
+        g_message("Failed to add _ipp._tcp service.");
+        g_main_loop_quit(main_loop);
+        return;
+    }
+
+    /* Add the same service for BSD LPR */
+    if (avahi_server_add_service(s, group, AVAHI_IF_UNSPEC, AVAHI_PROTO_UNSPEC, name, "_printer._tcp", NULL, NULL, 515, NULL) < 0) {
+        g_message("Failed to add _printer._tcp service.");
+        g_main_loop_quit(main_loop);
+        return;
+    }
+
+    /* Tell the server to register the service */
+    avahi_entry_group_commit(group);
+}
+
+static void server_callback(AvahiServer *s, AvahiServerState state, gpointer userdata) {
+    g_assert(s);
+
+    /* Called whenever the server state changes */
+
+    if (state == AVAHI_SERVER_RUNNING)
+        /* The serve has startup successfully and registered its host
+         * name on the network, so it's time to create our services */
+        create_services(s);
+    
+    else if (state == AVAHI_SERVER_COLLISION) {
+        gchar *n;
+        
+        /* A host name collision happened. Let's pick a new name for the server */
+        n = avahi_alternative_host_name(avahi_server_get_host_name(s));
+        g_message("Host name collision, retrying with '%s'", n);
+        avahi_server_set_host_name(s, n);
+        g_free(n);
+
+        /* Let's drop our registered services. When the server is back
+         * in AVAHI_SERVER_RUNNING state we will register them
+         * again with the new host name. */
+        if (group)
+            avahi_entry_group_reset(group);
+    }
+}
+
+int main(int argc, char*argv[]) {
+    AvahiServerConfig config;
+    AvahiServer *server = NULL;
+
+    srand(time(NULL));
+    
+    name = g_strdup("MegaPrinter");
+
+    /* Let's set the host name for this server. */
+    avahi_server_config_init(&config);
+    config.host_name = g_strdup("gurkiman");
+    
+    /* Allocate a new server */
+    server = avahi_server_new(NULL, &config, server_callback, NULL);
+
+    /* Free the configuration data */
+    avahi_server_config_free(&config);
+    
+    /* Run the main loop */
+    main_loop = g_main_loop_new(NULL, FALSE);
+    g_main_loop_run(main_loop);
+
+    /* Cleanup things */
+    if (group)
+        avahi_entry_group_free(group);
+
+    if (server)
+        avahi_server_free(server);
+
+    if (main_loop)
+        g_main_loop_unref(main_loop);
+
+    g_free(name);
+    
+    return 0;
+}