From 3a625af272ee8c6f878ba4d44ed1c741a1582395 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Wed, 3 Aug 2005 21:07:02 +0000 Subject: * 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 --- examples/Makefile.am | 36 +++++++++++ examples/browse-services.c | 112 ++++++++++++++++++++++++++++++++ examples/publish-service.c | 156 +++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 304 insertions(+) create mode 100644 examples/Makefile.am create mode 100644 examples/browse-services.c create mode 100644 examples/publish-service.c (limited to 'examples') 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 +#endif + +#include + +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 +#endif + +#include +#include +#include + +#include + +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; +} -- cgit