1 #ifndef fooclientpublishhfoo
2 #define fooclientpublishhfoo
7 This file is part of avahi.
9 avahi is free software; you can redistribute it and/or modify it
10 under the terms of the GNU Lesser General Public License as
11 published by the Free Software Foundation; either version 2.1 of the
12 License, or (at your option) any later version.
14 avahi is distributed in the hope that it will be useful, but WITHOUT
15 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
16 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
17 Public License for more details.
19 You should have received a copy of the GNU Lesser General Public
20 License along with avahi; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
27 #include <avahi-common/cdecl.h>
28 #include <avahi-common/address.h>
29 #include <avahi-common/strlst.h>
30 #include <avahi-common/defs.h>
31 #include <avahi-common/watch.h>
32 #include <avahi-common/gccmacro.h>
34 #include <avahi-client/client.h>
36 /** \file avahi-client/publish.h Publishing Client API */
38 /** \example client-publish-service.c Example how to register a DNS-SD
39 * service using the client interface to avahi-daemon. It behaves like a network
40 * printer registering both an IPP and a BSD LPR service. */
42 #ifndef DOXYGEN_SHOULD_SKIP_THIS
46 /** An entry group object */
47 typedef struct AvahiEntryGroup AvahiEntryGroup;
49 /** The function prototype for the callback of an AvahiEntryGroup */
50 typedef void (*AvahiEntryGroupCallback) (AvahiEntryGroup *g, AvahiEntryGroupState state, void* userdata);
52 /** Create a new AvahiEntryGroup object */
53 AvahiEntryGroup* avahi_entry_group_new (AvahiClient*, AvahiEntryGroupCallback callback, void *userdata);
55 /** Clean up and free an AvahiEntryGroup object */
56 int avahi_entry_group_free (AvahiEntryGroup *);
58 /** Commit an AvahiEntryGroup */
59 int avahi_entry_group_commit (AvahiEntryGroup*);
61 /** Reset an AvahiEntryGroup */
62 int avahi_entry_group_reset (AvahiEntryGroup*);
64 /** Get an AvahiEntryGroup's state */
65 int avahi_entry_group_get_state (AvahiEntryGroup*);
67 /** Check if an AvahiEntryGroup is empty */
68 int avahi_entry_group_is_empty (AvahiEntryGroup*);
70 /** Get an AvahiEntryGroup's owning client instance */
71 AvahiClient* avahi_entry_group_get_client (AvahiEntryGroup*);
73 /** Add a service, takes a variable NULL terminated list of text records */
74 int avahi_entry_group_add_service(
75 AvahiEntryGroup *group,
76 AvahiIfIndex interface,
77 AvahiProtocol protocol,
78 AvahiPublishFlags flags,
84 ...) AVAHI_GCC_SENTINEL;
86 /** Add a service, takes an AvahiStringList for text records */
87 int avahi_entry_group_add_service_strlst(
88 AvahiEntryGroup *group,
89 AvahiIfIndex interface,
90 AvahiProtocol protocol,
91 AvahiPublishFlags flags,
97 AvahiStringList *txt);
99 /** Add a service, takes a NULL terminated va_list for text records */
100 int avahi_entry_group_add_service_va(
101 AvahiEntryGroup *group,
102 AvahiIfIndex interface,
103 AvahiProtocol protocol,
104 AvahiPublishFlags flags,
112 /** Add a subtype for a service */
113 int avahi_entry_group_add_service_subtype(
114 AvahiEntryGroup *group,
115 AvahiIfIndex interface,
116 AvahiProtocol protocol,
117 AvahiPublishFlags flags,
121 const char *subtype);
123 /** Update a TXT record for an existing service */
124 int avahi_entry_group_update_service_txt(
126 AvahiIfIndex interface,
127 AvahiProtocol protocol,
128 AvahiPublishFlags flags,
132 ...) AVAHI_GCC_SENTINEL;
134 /** Update a TXT record for an existing service */
135 int avahi_entry_group_update_service_txt_strlst(
137 AvahiIfIndex interface,
138 AvahiProtocol protocol,
139 AvahiPublishFlags flags,
143 AvahiStringList *strlst);
145 /** Update a TXT record for an existing service */
146 int avahi_entry_group_update_service_txt_va(
148 AvahiIfIndex interface,
149 AvahiProtocol protocol,
150 AvahiPublishFlags flags,
156 #ifndef DOXYGEN_SHOULD_SKIP_THIS