X-Git-Url: http://git.meshlink.io/?a=blobdiff_plain;f=avahi-compat-howl%2Finclude%2Fdiscovery%2Fdiscovery.h;fp=avahi-compat-howl%2Finclude%2Fdiscovery%2Fdiscovery.h;h=1e8a7d5ac2cc09e3a8c6b3723d835434fc02277a;hb=c6bf0e465bceac2ef0e5f3a3ba97ae1f8b251a40;hp=0000000000000000000000000000000000000000;hpb=ac550214812696d5ec68900d02df823d13724e47;p=catta diff --git a/avahi-compat-howl/include/discovery/discovery.h b/avahi-compat-howl/include/discovery/discovery.h new file mode 100644 index 0000000..1e8a7d5 --- /dev/null +++ b/avahi-compat-howl/include/discovery/discovery.h @@ -0,0 +1,327 @@ +#ifndef _discovery_discovery_h +#define _discovery_discovery_h + +/* + * Copyright 2003, 2004 Porchdog Software. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without modification, + * are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY PORCHDOG SOFTWARE ``AS IS'' AND ANY + * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE HOWL PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, + * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY + * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE + * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED + * OF THE POSSIBILITY OF SUCH DAMAGE. + * + * The views and conclusions contained in the software and documentation are those + * of the authors and should not be interpreted as representing official policies, + * either expressed or implied, of Porchdog Software. + */ + +#include +#include + + +#if defined(__cplusplus) +extern "C" +{ +#endif + + +struct _sw_discovery; +typedef struct _sw_discovery * sw_discovery; + + +/* + * keeps track of different discovery operations + */ +typedef sw_uint32 sw_discovery_oid; + + +/* + * For backwards compatibility + */ +#define sw_discovery_publish_host_id sw_discovery_oid +#define sw_discovery_publish_id sw_discovery_oid +#define sw_discovery_browse_id sw_discovery_oid +#define sw_discovery_resolve_id sw_discovery_oid + + +/* + * how to connect to server + */ +typedef enum _sw_discovery_init_flags +{ + SW_DISCOVERY_USE_SHARED_SERVICE = 0x1, + SW_DISCOVERY_USE_PRIVATE_SERVICE = 0x2, + SW_DISCOVERY_SKIP_VERSION_CHECK = 0x4 +} sw_discovery_init_flags; + + +/* + * status for asynchronous registration call + */ +typedef enum _sw_discovery_publish_status +{ + SW_DISCOVERY_PUBLISH_STARTED, + SW_DISCOVERY_PUBLISH_STOPPED, + SW_DISCOVERY_PUBLISH_NAME_COLLISION, + SW_DISCOVERY_PUBLISH_INVALID +} sw_discovery_publish_status; + + +typedef enum _sw_discovery_browse_status +{ + SW_DISCOVERY_BROWSE_INVALID, + SW_DISCOVERY_BROWSE_RELEASE, + SW_DISCOVERY_BROWSE_ADD_DOMAIN, + SW_DISCOVERY_BROWSE_ADD_DEFAULT_DOMAIN, + SW_DISCOVERY_BROWSE_REMOVE_DOMAIN, + SW_DISCOVERY_BROWSE_ADD_SERVICE, + SW_DISCOVERY_BROWSE_REMOVE_SERVICE, + SW_DISCOVERY_BROWSE_RESOLVED +} sw_discovery_browse_status; + + +typedef enum _sw_discovery_query_record_status +{ + SW_DISCOVERY_QUERY_RECORD_ADD = 0x1 +} sw_discovery_query_record_status; + + +typedef sw_result +(HOWL_API *sw_discovery_publish_reply)( + sw_discovery session, + sw_discovery_oid oid, + sw_discovery_publish_status status, + sw_opaque extra); + +typedef sw_result +(HOWL_API *sw_discovery_browse_reply)( + sw_discovery session, + sw_discovery_oid oid, + sw_discovery_browse_status status, + sw_uint32 interface_index, + sw_const_string name, + sw_const_string type, + sw_const_string domain, + sw_opaque extra); + +typedef sw_result +(HOWL_API *sw_discovery_resolve_reply)( + sw_discovery session, + sw_discovery_oid oid, + sw_uint32 interface_index, + sw_const_string name, + sw_const_string type, + sw_const_string domain, + sw_ipv4_address address, + sw_port port, + sw_octets text_record, + sw_uint32 text_record_len, + sw_opaque extra); + + +typedef sw_result +(HOWL_API *sw_discovery_query_record_reply)( + sw_discovery session, + sw_discovery_oid oid, + sw_discovery_query_record_status status, + sw_uint32 interface_index, + sw_const_string fullname, + sw_uint16 rrtype, + sw_uint16 rrclass, + sw_uint16 rrdatalen, + sw_const_octets rrdata, + sw_uint32 ttl, + sw_opaque extra); + + +/* + * API for publishing/browsing/resolving services + */ +sw_result HOWL_API +sw_discovery_init( + sw_discovery * self); + + +sw_result HOWL_API +sw_discovery_init_with_flags( + sw_discovery * self, + sw_discovery_init_flags flags); + + +sw_result HOWL_API +sw_discovery_fina( + sw_discovery self); + + +sw_result HOWL_API +sw_discovery_publish_host( + sw_discovery self, + sw_uint32 interface_index, + sw_const_string name, + sw_const_string domain, + sw_ipv4_address address, + sw_discovery_publish_reply reply, + sw_opaque extra, + sw_discovery_oid * oid); + + +sw_result HOWL_API +sw_discovery_publish( + sw_discovery self, + sw_uint32 interface_index, + sw_const_string name, + sw_const_string type, + sw_const_string domain, + sw_const_string host, + sw_port port, + sw_octets text_record, + sw_uint32 text_record_len, + sw_discovery_publish_reply reply, + sw_opaque extra, + sw_discovery_oid * oid); + + +sw_result HOWL_API +sw_discovery_publish_update( + sw_discovery self, + sw_discovery_oid oid, + sw_octets text_record, + sw_uint32 text_record_len); + + + +/* + * API for browsing domains + */ +sw_result HOWL_API +sw_discovery_browse_domains( + sw_discovery self, + sw_uint32 interface_index, + sw_discovery_browse_reply reply, + sw_opaque extra, + sw_discovery_oid * oid); + + + +/* + * API for browsing services + */ +sw_result HOWL_API +sw_discovery_browse( + sw_discovery self, + sw_uint32 interface_index, + sw_const_string type, + sw_const_string domain, + sw_discovery_browse_reply reply, + sw_opaque extra, + sw_discovery_oid * oid); + + +/* + * API for resolving services + */ +sw_result HOWL_API +sw_discovery_resolve( + sw_discovery self, + sw_uint32 interface_index, + sw_const_string name, + sw_const_string type, + sw_const_string domain, + sw_discovery_resolve_reply reply, + sw_opaque extra, + sw_discovery_oid * oid); + + +sw_result HOWL_API +sw_discovery_query_record( + sw_discovery self, + sw_uint32 interface_index, + sw_uint32 flags, + sw_const_string fullname, + sw_uint16 rrtype, + sw_uint16 rrclass, + sw_discovery_query_record_reply reply, + sw_opaque extra, + sw_discovery_oid * oid); + + +sw_result HOWL_API +sw_discovery_cancel( + sw_discovery self, + sw_discovery_oid oid); + + + +/* ---------------------------------------------------------- + * + * Event Processing APIs + * + * ---------------------------------------------------------- + */ + + +sw_result HOWL_API +sw_discovery_run( + sw_discovery self); + + +sw_result HOWL_API +sw_discovery_stop_run( + sw_discovery self); + + +int HOWL_API +sw_discovery_socket( + sw_discovery self); + + +sw_result HOWL_API +sw_discovery_read_socket( + sw_discovery self); + + +sw_result HOWL_API +sw_discovery_salt( + sw_discovery self, + sw_salt * salt); + + +/* + * Error codes + */ +#define SW_DISCOVERY_E_BASE 900 +#define SW_DISCOVERY_E_UNKNOWN (SW_DISCOVERY_E_BASE + 2) +#define SW_DISCOVERY_E_NO_SUCH_NAME (SW_DISCOVERY_E_BASE + 3) +#define SW_DISCOVERY_E_NO_MEM (SW_DISCOVERY_E_BASE + 4) +#define SW_DISCOVERY_E_BAD_PARAM (SW_DISCOVERY_E_BASE + 5) +#define SW_DISCOVERY_E_BAD_REFERENCE (SW_DISCOVERY_E_BASE + 6) +#define SW_DISCOVERY_E_BAD_STATE (SW_DISCOVERY_E_BASE + 7) +#define SW_DISCOVERY_E_BAD_FLAGS (SW_DISCOVERY_E_BASE + 8) +#define SW_DISCOVERY_E_NOT_SUPPORTED (SW_DISCOVERY_E_BASE + 9) +#define SW_DISCOVERY_E_NOT_INITIALIZED (SW_DISCOVERY_E_BASE + 10) +#define SW_DISCOVERY_E_NO_CACHE (SW_DISCOVERY_E_BASE + 11) +#define SW_DISCOVERY_E_ALREADY_REGISTERED (SW_DISCOVERY_E_BASE + 12) +#define SW_DISCOVERY_E_NAME_CONFLICT (SW_DISCOVERY_E_BASE + 13) +#define SW_DISCOVERY_E_INVALID (SW_DISCOVERY_E_BASE + 14) + + +#if defined(__cplusplus) +} +#endif + + +#endif