-#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 <salt/salt.h>
-#include <salt/socket.h>
-
-
-#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