74 lines
3.1 KiB
Text
74 lines
3.1 KiB
Text
-*-text-*-
|
|
|
|
A terse (and incomplete) list of API changes between 0.5.2 and 0.6:
|
|
|
|
* Most browsing and registration functions and their callbacks gained
|
|
new "flags" parameters. Passing 0 results in similar behaviour as
|
|
in 0.5.2
|
|
|
|
* avahi-client/client.h has been split into client.h, publish.h and lookup.h
|
|
|
|
* avahi-core/core.h has been split into core.h publish.h lookup.h
|
|
|
|
* avahi_client_is_service_local() has been removed. Use instead the special
|
|
flags AVAHI_LOOKUP_RESULT_LOCAL and AVAHI_LOOKUP_RESULT_OUR_OWN which are
|
|
set when resolving or browsing for services. AVAHI_LOOKUP_RESULT_OUR_OWN is
|
|
what most people should use.
|
|
|
|
* AVAHI_RESOLVER_TIMEOUT and AVAHI_RESOLVER_NOT_FOUND have been
|
|
removed. Instead AVAHI_RESOLVER_FAILURE is used and the exact error
|
|
code is available from avahi_client_errno()/avahi_server_errno()
|
|
|
|
* The events AVAHI_BROWSER_CACHE_EXHAUSTED, AVAHI_BROWSER_ALL_FOR_NOW
|
|
have been introduced. Failures during browsing are now passed as
|
|
AVAHI_BROWSER_FAILURE and the error code is made available through
|
|
avahi_client_errno()/avahi_server_errno().
|
|
|
|
* The server gained a new state AVAHI_SERVER_FAILURE if some fatal
|
|
error happens. The reason can be found in
|
|
avahi_server_errno(). Clients can safely ignore this state.
|
|
|
|
* You can now update existing records by setting the
|
|
AVAHI_PUBLISH_UPDATE flags for add_service() and friends. Consider
|
|
using avahi_server_update_service_txt_strlst() if you need to
|
|
update only the TXT record for a service.
|
|
|
|
* Proper support for service subtypes is now available. Use
|
|
avahi_server_add_service_subtype() for that.
|
|
|
|
* Entry groups gained the new state AVAHI_ENTRY_GROUP_FAILURE. The
|
|
reason is available using
|
|
avahi_server_errno()/avahi_client_errno().
|
|
|
|
* Many superfluous functions have been removed from the public API or
|
|
entirely.
|
|
|
|
* avahi_simple_poll_iterate() has been split up into three
|
|
functions. avahi_simple_poll_loop() has been introduced.
|
|
|
|
* Some new limits have been introduced: AVAHI_ADDRESS_STR_MAX,
|
|
AVAHI_DOMAIN_NAME_MAX, AVAHI_LABEL_MAX
|
|
|
|
* The functions avahi_service_name_join() and
|
|
avahi_service_name_split() have been introduced.
|
|
|
|
* AVAHI_ERR_LOCAL_COLLISION has been renamed to AVAHI_ERR_COLLSION
|
|
|
|
* The values of AVAHI_PROTO_xxx have changed, they are no longer
|
|
identical to the BSD AF_xxx constants
|
|
|
|
* avahi_client_new() now takes an additional flags parameter. Most
|
|
interesting flag here is AVAHI_CLIENT_NO_FAIL, which can be used to
|
|
create an AvahiClient object even when the daemon is not
|
|
running. This is useful to deal with daemon restarts.
|
|
|
|
* AvahiClient gained a new state AVAHI_CLIENT_FAILURE. (superseding
|
|
AVAHI_CLIENT_DISCONNECTED). If this event happens,
|
|
avahi_client_errno() will return the reason. If the error returned
|
|
is AVAHI_ERR_DISCONNECTED, the situation where
|
|
AVAHI_CLIENT_DISCONNECTED was previously thrown is entered. You may
|
|
choose to reconnect in that case by freeing your AvahiClient new
|
|
and create a new one with passing AVAHI_CLIENT_NO_FAIL.
|
|
|
|
* There's now a client side AvahiRecordBrowser, and
|
|
avahi_entry_group_add_record().
|