2 This file is part of PulseAudio.
4 Copyright 2004-2006 Lennart Poettering
6 PulseAudio is free software; you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as
8 published by the Free Software Foundation; either version 2.1 of the
9 License, or (at your option) any later version.
11 PulseAudio is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public
17 License along with PulseAudio; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
30 #include <avahi-client/client.h>
31 #include <avahi-client/publish.h>
32 #include <avahi-common/alternative.h>
33 #include <avahi-common/error.h>
34 #include <avahi-common/domain.h>
36 #include <pulse/xmalloc.h>
37 #include <pulse/util.h>
39 #include <pulsecore/parseaddr.h>
40 #include <pulsecore/sink.h>
41 #include <pulsecore/source.h>
42 #include <pulsecore/native-common.h>
43 #include <pulsecore/core-util.h>
44 #include <pulsecore/log.h>
45 #include <pulsecore/dynarray.h>
46 #include <pulsecore/modargs.h>
47 #include <pulsecore/avahi-wrap.h>
48 #include <pulsecore/protocol-native.h>
50 #include "module-zeroconf-publish-symdef.h"
52 PA_MODULE_AUTHOR("Lennart Poettering");
53 PA_MODULE_DESCRIPTION("mDNS/DNS-SD Service Publisher");
54 PA_MODULE_VERSION(PACKAGE_VERSION
);
55 PA_MODULE_LOAD_ONCE(TRUE
);
57 #define SERVICE_TYPE_SINK "_pulse-sink._tcp"
58 #define SERVICE_TYPE_SOURCE "_pulse-source._tcp"
59 #define SERVICE_TYPE_SERVER "_pulse-server._tcp"
60 #define SERVICE_SUBTYPE_SINK_HARDWARE "_hardware._sub."SERVICE_TYPE_SINK
61 #define SERVICE_SUBTYPE_SINK_VIRTUAL "_virtual._sub."SERVICE_TYPE_SINK
62 #define SERVICE_SUBTYPE_SOURCE_HARDWARE "_hardware._sub."SERVICE_TYPE_SOURCE
63 #define SERVICE_SUBTYPE_SOURCE_VIRTUAL "_virtual._sub."SERVICE_TYPE_SOURCE
64 #define SERVICE_SUBTYPE_SOURCE_MONITOR "_monitor._sub."SERVICE_TYPE_SOURCE
65 #define SERVICE_SUBTYPE_SOURCE_NON_MONITOR "_non-monitor._sub."SERVICE_TYPE_SOURCE
67 static const char* const valid_modargs
[] = {
71 enum service_subtype
{
78 struct userdata
*userdata
;
79 AvahiEntryGroup
*entry_group
;
82 enum service_subtype subtype
;
89 AvahiPoll
*avahi_poll
;
95 AvahiEntryGroup
*main_entry_group
;
97 pa_hook_slot
*sink_new_slot
, *source_new_slot
, *sink_unlink_slot
, *source_unlink_slot
, *sink_changed_slot
, *source_changed_slot
;
99 pa_native_protocol
*native
;
102 static void get_service_data(struct service
*s
, pa_sample_spec
*ret_ss
, pa_channel_map
*ret_map
, const char **ret_name
, pa_proplist
**ret_proplist
, enum service_subtype
*ret_subtype
) {
105 pa_assert(ret_proplist
);
106 pa_assert(ret_subtype
);
108 if (pa_sink_isinstance(s
->device
)) {
109 pa_sink
*sink
= PA_SINK(s
->device
);
111 *ret_ss
= sink
->sample_spec
;
112 *ret_map
= sink
->channel_map
;
113 *ret_name
= sink
->name
;
114 *ret_proplist
= sink
->proplist
;
115 *ret_subtype
= sink
->flags
& PA_SINK_HARDWARE
? SUBTYPE_HARDWARE
: SUBTYPE_VIRTUAL
;
117 } else if (pa_source_isinstance(s
->device
)) {
118 pa_source
*source
= PA_SOURCE(s
->device
);
120 *ret_ss
= source
->sample_spec
;
121 *ret_map
= source
->channel_map
;
122 *ret_name
= source
->name
;
123 *ret_proplist
= source
->proplist
;
124 *ret_subtype
= source
->monitor_of
? SUBTYPE_MONITOR
: (source
->flags
& PA_SOURCE_HARDWARE
? SUBTYPE_HARDWARE
: SUBTYPE_VIRTUAL
);
127 pa_assert_not_reached();
130 static AvahiStringList
* txt_record_server_data(pa_core
*c
, AvahiStringList
*l
) {
136 l
= avahi_string_list_add_pair(l
, "server-version", PACKAGE_NAME
" "PACKAGE_VERSION
);
138 t
= pa_get_user_name_malloc();
139 l
= avahi_string_list_add_pair(l
, "user-name", t
);
143 l
= avahi_string_list_add_pair(l
, "machine-id", t
);
146 t
= pa_uname_string();
147 l
= avahi_string_list_add_pair(l
, "uname", t
);
150 l
= avahi_string_list_add_pair(l
, "fqdn", pa_get_fqdn(s
, sizeof(s
)));
151 l
= avahi_string_list_add_printf(l
, "cookie=0x%08x", c
->cookie
);
156 static int publish_service(struct service
*s
);
158 static void service_entry_group_callback(AvahiEntryGroup
*g
, AvahiEntryGroupState state
, void *userdata
) {
159 struct service
*s
= userdata
;
165 case AVAHI_ENTRY_GROUP_ESTABLISHED
:
166 pa_log_info("Successfully established service %s.", s
->service_name
);
169 case AVAHI_ENTRY_GROUP_COLLISION
: {
172 t
= avahi_alternative_service_name(s
->service_name
);
173 pa_log_info("Name collision, renaming %s to %s.", s
->service_name
, t
);
174 pa_xfree(s
->service_name
);
181 case AVAHI_ENTRY_GROUP_FAILURE
: {
182 pa_log("Failed to register service: %s", avahi_strerror(avahi_client_errno(avahi_entry_group_get_client(g
))));
184 avahi_entry_group_free(g
);
185 s
->entry_group
= NULL
;
190 case AVAHI_ENTRY_GROUP_UNCOMMITED
:
191 case AVAHI_ENTRY_GROUP_REGISTERING
:
196 static void service_free(struct service
*s
);
198 static uint16_t compute_port(struct userdata
*u
) {
203 for (i
= pa_native_protocol_servers(u
->native
); i
; i
= pa_strlist_next(i
)) {
206 if (pa_parse_address(pa_strlist_data(i
), &a
) >= 0 &&
207 (a
.type
== PA_PARSED_ADDRESS_TCP4
||
208 a
.type
== PA_PARSED_ADDRESS_TCP6
||
209 a
.type
== PA_PARSED_ADDRESS_TCP_AUTO
) &&
212 pa_xfree(a
.path_or_host
);
216 pa_xfree(a
.path_or_host
);
219 return PA_NATIVE_DEFAULT_PORT
;
222 static int publish_service(struct service
*s
) {
224 AvahiStringList
*txt
= NULL
;
225 const char *name
= NULL
, *t
;
226 pa_proplist
*proplist
= NULL
;
229 char cm
[PA_CHANNEL_MAP_SNPRINT_MAX
];
230 enum service_subtype subtype
;
232 const char * const subtype_text
[] = {
233 [SUBTYPE_HARDWARE
] = "hardware",
234 [SUBTYPE_VIRTUAL
] = "virtual",
235 [SUBTYPE_MONITOR
] = "monitor"
240 if (!s
->userdata
->client
|| avahi_client_get_state(s
->userdata
->client
) != AVAHI_CLIENT_S_RUNNING
)
243 if (!s
->entry_group
) {
244 if (!(s
->entry_group
= avahi_entry_group_new(s
->userdata
->client
, service_entry_group_callback
, s
))) {
245 pa_log("avahi_entry_group_new(): %s", avahi_strerror(avahi_client_errno(s
->userdata
->client
)));
249 avahi_entry_group_reset(s
->entry_group
);
251 txt
= txt_record_server_data(s
->userdata
->core
, txt
);
253 get_service_data(s
, &ss
, &map
, &name
, &proplist
, &subtype
);
254 txt
= avahi_string_list_add_pair(txt
, "device", name
);
255 txt
= avahi_string_list_add_printf(txt
, "rate=%u", ss
.rate
);
256 txt
= avahi_string_list_add_printf(txt
, "channels=%u", ss
.channels
);
257 txt
= avahi_string_list_add_pair(txt
, "format", pa_sample_format_to_string(ss
.format
));
258 txt
= avahi_string_list_add_pair(txt
, "channel_map", pa_channel_map_snprint(cm
, sizeof(cm
), &map
));
259 txt
= avahi_string_list_add_pair(txt
, "subtype", subtype_text
[subtype
]);
261 if ((t
= pa_proplist_gets(proplist
, PA_PROP_DEVICE_DESCRIPTION
)))
262 txt
= avahi_string_list_add_pair(txt
, "description", t
);
263 if ((t
= pa_proplist_gets(proplist
, PA_PROP_DEVICE_ICON_NAME
)))
264 txt
= avahi_string_list_add_pair(txt
, "icon-name", t
);
265 if ((t
= pa_proplist_gets(proplist
, PA_PROP_DEVICE_VENDOR_NAME
)))
266 txt
= avahi_string_list_add_pair(txt
, "vendor-name", t
);
267 if ((t
= pa_proplist_gets(proplist
, PA_PROP_DEVICE_PRODUCT_NAME
)))
268 txt
= avahi_string_list_add_pair(txt
, "product-name", t
);
269 if ((t
= pa_proplist_gets(proplist
, PA_PROP_DEVICE_CLASS
)))
270 txt
= avahi_string_list_add_pair(txt
, "class", t
);
271 if ((t
= pa_proplist_gets(proplist
, PA_PROP_DEVICE_FORM_FACTOR
)))
272 txt
= avahi_string_list_add_pair(txt
, "form-factor", t
);
274 if (avahi_entry_group_add_service_strlst(
276 AVAHI_IF_UNSPEC
, AVAHI_PROTO_UNSPEC
,
279 pa_sink_isinstance(s
->device
) ? SERVICE_TYPE_SINK
: SERVICE_TYPE_SOURCE
,
282 compute_port(s
->userdata
),
285 pa_log("avahi_entry_group_add_service_strlst(): %s", avahi_strerror(avahi_client_errno(s
->userdata
->client
)));
289 if (avahi_entry_group_add_service_subtype(
291 AVAHI_IF_UNSPEC
, AVAHI_PROTO_UNSPEC
,
294 pa_sink_isinstance(s
->device
) ? SERVICE_TYPE_SINK
: SERVICE_TYPE_SOURCE
,
296 pa_sink_isinstance(s
->device
) ? (subtype
== SUBTYPE_HARDWARE
? SERVICE_SUBTYPE_SINK_HARDWARE
: SERVICE_SUBTYPE_SINK_VIRTUAL
) :
297 (subtype
== SUBTYPE_HARDWARE
? SERVICE_SUBTYPE_SOURCE_HARDWARE
: (subtype
== SUBTYPE_VIRTUAL
? SERVICE_SUBTYPE_SOURCE_VIRTUAL
: SERVICE_SUBTYPE_SOURCE_MONITOR
))) < 0) {
299 pa_log("avahi_entry_group_add_service_subtype(): %s", avahi_strerror(avahi_client_errno(s
->userdata
->client
)));
303 if (pa_source_isinstance(s
->device
) && subtype
!= SUBTYPE_MONITOR
) {
304 if (avahi_entry_group_add_service_subtype(
306 AVAHI_IF_UNSPEC
, AVAHI_PROTO_UNSPEC
,
311 SERVICE_SUBTYPE_SOURCE_NON_MONITOR
) < 0) {
313 pa_log("avahi_entry_group_add_service_subtype(): %s", avahi_strerror(avahi_client_errno(s
->userdata
->client
)));
318 if (avahi_entry_group_commit(s
->entry_group
) < 0) {
319 pa_log("avahi_entry_group_commit(): %s", avahi_strerror(avahi_client_errno(s
->userdata
->client
)));
324 pa_log_debug("Successfully created entry group for %s.", s
->service_name
);
328 /* Remove this service */
332 avahi_string_list_free(txt
);
337 static struct service
*get_service(struct userdata
*u
, pa_object
*device
) {
343 pa_object_assert_ref(device
);
345 if ((s
= pa_hashmap_get(u
->services
, device
)))
348 s
= pa_xnew(struct service
, 1);
350 s
->entry_group
= NULL
;
353 if (pa_sink_isinstance(device
)) {
354 if (!(n
= pa_proplist_gets(PA_SINK(device
)->proplist
, PA_PROP_DEVICE_DESCRIPTION
)))
355 n
= PA_SINK(device
)->name
;
357 if (!(n
= pa_proplist_gets(PA_SOURCE(device
)->proplist
, PA_PROP_DEVICE_DESCRIPTION
)))
358 n
= PA_SOURCE(device
)->name
;
361 hn
= pa_get_host_name_malloc();
362 un
= pa_get_user_name_malloc();
364 s
->service_name
= pa_truncate_utf8(pa_sprintf_malloc("%s@%s: %s", un
, hn
, n
), AVAHI_LABEL_MAX
-1);
369 pa_hashmap_put(u
->services
, s
->device
, s
);
374 static void service_free(struct service
*s
) {
377 pa_hashmap_remove(s
->userdata
->services
, s
->device
);
379 if (s
->entry_group
) {
380 pa_log_debug("Removing entry group for %s.", s
->service_name
);
381 avahi_entry_group_free(s
->entry_group
);
384 pa_xfree(s
->service_name
);
388 static pa_bool_t
shall_ignore(pa_object
*o
) {
389 pa_object_assert_ref(o
);
391 if (pa_sink_isinstance(o
))
392 return !!(PA_SINK(o
)->flags
& PA_SINK_NETWORK
);
394 if (pa_source_isinstance(o
))
395 return PA_SOURCE(o
)->monitor_of
|| (PA_SOURCE(o
)->flags
& PA_SOURCE_NETWORK
);
397 pa_assert_not_reached();
400 static pa_hook_result_t
device_new_or_changed_cb(pa_core
*c
, pa_object
*o
, struct userdata
*u
) {
402 pa_object_assert_ref(o
);
404 if (!shall_ignore(o
))
405 publish_service(get_service(u
, o
));
410 static pa_hook_result_t
device_unlink_cb(pa_core
*c
, pa_object
*o
, struct userdata
*u
) {
414 pa_object_assert_ref(o
);
416 if ((s
= pa_hashmap_get(u
->services
, o
)))
422 static int publish_main_service(struct userdata
*u
);
424 static void main_entry_group_callback(AvahiEntryGroup
*g
, AvahiEntryGroupState state
, void *userdata
) {
425 struct userdata
*u
= userdata
;
430 case AVAHI_ENTRY_GROUP_ESTABLISHED
:
431 pa_log_info("Successfully established main service.");
434 case AVAHI_ENTRY_GROUP_COLLISION
: {
437 t
= avahi_alternative_service_name(u
->service_name
);
438 pa_log_info("Name collision: renaming main service %s to %s.", u
->service_name
, t
);
439 pa_xfree(u
->service_name
);
442 publish_main_service(u
);
446 case AVAHI_ENTRY_GROUP_FAILURE
: {
447 pa_log("Failed to register main service: %s", avahi_strerror(avahi_client_errno(avahi_entry_group_get_client(g
))));
449 avahi_entry_group_free(g
);
450 u
->main_entry_group
= NULL
;
454 case AVAHI_ENTRY_GROUP_UNCOMMITED
:
455 case AVAHI_ENTRY_GROUP_REGISTERING
:
460 static int publish_main_service(struct userdata
*u
) {
461 AvahiStringList
*txt
= NULL
;
466 if (!u
->main_entry_group
) {
467 if (!(u
->main_entry_group
= avahi_entry_group_new(u
->client
, main_entry_group_callback
, u
))) {
468 pa_log("avahi_entry_group_new() failed: %s", avahi_strerror(avahi_client_errno(u
->client
)));
472 avahi_entry_group_reset(u
->main_entry_group
);
474 txt
= txt_record_server_data(u
->core
, txt
);
476 if (avahi_entry_group_add_service_strlst(
478 AVAHI_IF_UNSPEC
, AVAHI_PROTO_UNSPEC
,
487 pa_log("avahi_entry_group_add_service_strlst() failed: %s", avahi_strerror(avahi_client_errno(u
->client
)));
491 if (avahi_entry_group_commit(u
->main_entry_group
) < 0) {
492 pa_log("avahi_entry_group_commit() failed: %s", avahi_strerror(avahi_client_errno(u
->client
)));
499 avahi_string_list_free(txt
);
504 static int publish_all_services(struct userdata
*u
) {
512 pa_log_debug("Publishing services in Zeroconf");
514 for (sink
= PA_SINK(pa_idxset_first(u
->core
->sinks
, &idx
)); sink
; sink
= PA_SINK(pa_idxset_next(u
->core
->sinks
, &idx
)))
515 if (!shall_ignore(PA_OBJECT(sink
)))
516 publish_service(get_service(u
, PA_OBJECT(sink
)));
518 for (source
= PA_SOURCE(pa_idxset_first(u
->core
->sources
, &idx
)); source
; source
= PA_SOURCE(pa_idxset_next(u
->core
->sources
, &idx
)))
519 if (!shall_ignore(PA_OBJECT(source
)))
520 publish_service(get_service(u
, PA_OBJECT(source
)));
522 if (publish_main_service(u
) < 0)
531 static void unpublish_all_services(struct userdata
*u
, pa_bool_t rem
) {
537 pa_log_debug("Unpublishing services in Zeroconf");
539 while ((s
= pa_hashmap_iterate(u
->services
, &state
, NULL
))) {
540 if (s
->entry_group
) {
542 pa_log_debug("Removing entry group for %s.", s
->service_name
);
543 avahi_entry_group_free(s
->entry_group
);
544 s
->entry_group
= NULL
;
546 avahi_entry_group_reset(s
->entry_group
);
547 pa_log_debug("Resetting entry group for %s.", s
->service_name
);
552 if (u
->main_entry_group
) {
554 pa_log_debug("Removing main entry group.");
555 avahi_entry_group_free(u
->main_entry_group
);
556 u
->main_entry_group
= NULL
;
558 avahi_entry_group_reset(u
->main_entry_group
);
559 pa_log_debug("Resetting main entry group.");
564 static void client_callback(AvahiClient
*c
, AvahiClientState state
, void *userdata
) {
565 struct userdata
*u
= userdata
;
573 case AVAHI_CLIENT_S_RUNNING
:
574 publish_all_services(u
);
577 case AVAHI_CLIENT_S_COLLISION
:
578 pa_log_debug("Host name collision");
579 unpublish_all_services(u
, FALSE
);
582 case AVAHI_CLIENT_FAILURE
:
583 if (avahi_client_errno(c
) == AVAHI_ERR_DISCONNECTED
) {
586 pa_log_debug("Avahi daemon disconnected.");
588 unpublish_all_services(u
, TRUE
);
589 avahi_client_free(u
->client
);
591 if (!(u
->client
= avahi_client_new(u
->avahi_poll
, AVAHI_CLIENT_NO_FAIL
, client_callback
, u
, &error
))) {
592 pa_log("avahi_client_new() failed: %s", avahi_strerror(error
));
593 pa_module_unload_request(u
->module
, TRUE
);
603 int pa__init(pa_module
*m
) {
606 pa_modargs
*ma
= NULL
;
610 if (!(ma
= pa_modargs_new(m
->argument
, valid_modargs
))) {
611 pa_log("Failed to parse module arguments.");
615 m
->userdata
= u
= pa_xnew(struct userdata
, 1);
618 u
->native
= pa_native_protocol_get(u
->core
);
620 u
->avahi_poll
= pa_avahi_poll_new(m
->core
->mainloop
);
622 u
->services
= pa_hashmap_new(pa_idxset_trivial_hash_func
, pa_idxset_trivial_compare_func
);
624 u
->sink_new_slot
= pa_hook_connect(&m
->core
->hooks
[PA_CORE_HOOK_SINK_PUT
], PA_HOOK_LATE
, (pa_hook_cb_t
) device_new_or_changed_cb
, u
);
625 u
->sink_changed_slot
= pa_hook_connect(&m
->core
->hooks
[PA_CORE_HOOK_SINK_PROPLIST_CHANGED
], PA_HOOK_LATE
, (pa_hook_cb_t
) device_new_or_changed_cb
, u
);
626 u
->sink_unlink_slot
= pa_hook_connect(&m
->core
->hooks
[PA_CORE_HOOK_SINK_UNLINK
], PA_HOOK_LATE
, (pa_hook_cb_t
) device_unlink_cb
, u
);
627 u
->source_new_slot
= pa_hook_connect(&m
->core
->hooks
[PA_CORE_HOOK_SOURCE_PUT
], PA_HOOK_LATE
, (pa_hook_cb_t
) device_new_or_changed_cb
, u
);
628 u
->source_changed_slot
= pa_hook_connect(&m
->core
->hooks
[PA_CORE_HOOK_SOURCE_PROPLIST_CHANGED
], PA_HOOK_LATE
, (pa_hook_cb_t
) device_new_or_changed_cb
, u
);
629 u
->source_unlink_slot
= pa_hook_connect(&m
->core
->hooks
[PA_CORE_HOOK_SOURCE_UNLINK
], PA_HOOK_LATE
, (pa_hook_cb_t
) device_unlink_cb
, u
);
631 u
->main_entry_group
= NULL
;
633 un
= pa_get_user_name_malloc();
634 hn
= pa_get_host_name_malloc();
635 u
->service_name
= pa_truncate_utf8(pa_sprintf_malloc("%s@%s", un
, hn
), AVAHI_LABEL_MAX
-1);
639 if (!(u
->client
= avahi_client_new(u
->avahi_poll
, AVAHI_CLIENT_NO_FAIL
, client_callback
, u
, &error
))) {
640 pa_log("avahi_client_new() failed: %s", avahi_strerror(error
));
657 void pa__done(pa_module
*m
) {
661 if (!(u
= m
->userdata
))
667 while ((s
= pa_hashmap_first(u
->services
)))
670 pa_hashmap_free(u
->services
, NULL
, NULL
);
673 if (u
->sink_new_slot
)
674 pa_hook_slot_free(u
->sink_new_slot
);
675 if (u
->source_new_slot
)
676 pa_hook_slot_free(u
->source_new_slot
);
677 if (u
->sink_changed_slot
)
678 pa_hook_slot_free(u
->sink_changed_slot
);
679 if (u
->source_changed_slot
)
680 pa_hook_slot_free(u
->source_changed_slot
);
681 if (u
->sink_unlink_slot
)
682 pa_hook_slot_free(u
->sink_unlink_slot
);
683 if (u
->source_unlink_slot
)
684 pa_hook_slot_free(u
->source_unlink_slot
);
686 if (u
->main_entry_group
)
687 avahi_entry_group_free(u
->main_entry_group
);
690 avahi_client_free(u
->client
);
693 pa_avahi_poll_free(u
->avahi_poll
);
696 pa_native_protocol_unref(u
->native
);
698 pa_xfree(u
->service_name
);