chenqiyang
2021-08-24 ba1338606ed6a499fe4f320af30851291490f45f
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
/*
 * Copyright (c) 2012-2019 Belledonne Communications SARL.
 *
 * This file is part of belle-sip.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef BELLE_SIP_MDNS_REGISTER_H
#define BELLE_SIP_MDNS_REGISTER_H
 
typedef struct belle_sip_mdns_register belle_sip_mdns_register_t;
#define BELLE_SIP_MDNS_REGISTER(obj) BELLE_SIP_CAST(obj,belle_sip_mdns_register_t)
 
/**
 * Callback prototype for asynchronous multicast DNS registration (advertisement).
 */
typedef void (*belle_sip_mdns_register_callback_t)(void *data, int error);
 
BELLE_SIP_BEGIN_DECLS
 
#ifdef __cplusplus
extern "C"
{
#endif
 
/**
 * Tells if multicast DNS is available.
 * @return true if it is available, false otherwise.
**/
BELLESIP_EXPORT int belle_sip_mdns_register_available(void);
 
/**
 * Asynchronously performs the mdns registration (advertisement).
 * @param service the queried service ("sip", "stun", "turn"...).
 * @param transport the queried transport ("udp", "tcp", "tls").
 * @param domain the local domain name in which the service will be registered.
 * @param name the name of the mdns service, if NULL it is the computer's name. Only useful for multiple registrations to avoid conflicts.
 * @param port the port of the service.
 * @param priority the priority of the service, lower value means more preferred.
 * @param weight a relative weight for services within the same local domain that have the same priority, higher value means more preferred.
 * @param ttl the time to live of the resulted srv
 * @param cb a callback function that will be called to notify the results.
 * @param data a user pointer passed through the callback as first argument.
 * @return a #belle_sip_register_t that can be used to cancel the registration if needed. The context must have been ref'd with belle_sip_object_ref().
**/
BELLESIP_EXPORT belle_sip_mdns_register_t *belle_sip_mdns_register(const char *service, const char *transport, const char *domain, const char* name, int port, int prio, int weight, int ttl,  belle_sip_mdns_register_callback_t cb, void *data);
 
/**
 * Cancels the mdns registration.
 * @param context the belle_sip_mdns_register_t used to register the service.
**/
BELLESIP_EXPORT void belle_sip_mdns_unregister(belle_sip_mdns_register_t *context);
 
#ifdef __cplusplus
} /* end extern "C" */
#endif
 
BELLE_SIP_END_DECLS
 
#endif /* BELLE_SIP_MDNS_REGISTER_H */