media/mtransport/third_party/nICEr/src/net/nr_resolver.h@6474c204b198 (annotated)
media/mtransport/third_party/nICEr/src/net/nr_resolver.h
Wed, 31 Dec 2014 06:09:35 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 06:09:35 +0100
- changeset 0
- 6474c204b198
- permissions
- -rw-r--r--
Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.
| michael@0 | 1 | /* |
| michael@0 | 2 | Copyright (c) 2007, Adobe Systems, Incorporated |
| michael@0 | 3 | Copyright (c) 2013, Mozilla |
| michael@0 | 4 | |
| michael@0 | 5 | All rights reserved. |
| michael@0 | 6 | |
| michael@0 | 7 | Redistribution and use in source and binary forms, with or without |
| michael@0 | 8 | modification, are permitted provided that the following conditions are |
| michael@0 | 9 | met: |
| michael@0 | 10 | |
| michael@0 | 11 | * Redistributions of source code must retain the above copyright |
| michael@0 | 12 | notice, this list of conditions and the following disclaimer. |
| michael@0 | 13 | |
| michael@0 | 14 | * Redistributions in binary form must reproduce the above copyright |
| michael@0 | 15 | notice, this list of conditions and the following disclaimer in the |
| michael@0 | 16 | documentation and/or other materials provided with the distribution. |
| michael@0 | 17 | |
| michael@0 | 18 | * Neither the name of Adobe Systems, Network Resonance, Mozilla nor |
| michael@0 | 19 | the names of its contributors may be used to endorse or promote |
| michael@0 | 20 | products derived from this software without specific prior written |
| michael@0 | 21 | permission. |
| michael@0 | 22 | |
| michael@0 | 23 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| michael@0 | 24 | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| michael@0 | 25 | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| michael@0 | 26 | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| michael@0 | 27 | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| michael@0 | 28 | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| michael@0 | 29 | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| michael@0 | 30 | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| michael@0 | 31 | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| michael@0 | 32 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| michael@0 | 33 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| michael@0 | 34 | */ |
| michael@0 | 35 | |
| michael@0 | 36 | #ifndef _nr_resolver_h |
| michael@0 | 37 | #define _nr_resolver_h |
| michael@0 | 38 | |
| michael@0 | 39 | #include "transport_addr.h" |
| michael@0 | 40 | |
| michael@0 | 41 | #define NR_RESOLVE_PROTOCOL_STUN 1 |
| michael@0 | 42 | #define NR_RESOLVE_PROTOCOL_TURN 2 |
| michael@0 | 43 | |
| michael@0 | 44 | typedef struct nr_resolver_resource_ { |
| michael@0 | 45 | char *domain_name; |
| michael@0 | 46 | UINT2 port; |
| michael@0 | 47 | int stun_turn; |
| michael@0 | 48 | UCHAR transport_protocol; |
| michael@0 | 49 | } nr_resolver_resource; |
| michael@0 | 50 | |
| michael@0 | 51 | typedef struct nr_resolver_vtbl_ { |
| michael@0 | 52 | int (*destroy)(void **obj); |
| michael@0 | 53 | int (*resolve)(void *obj, |
| michael@0 | 54 | nr_resolver_resource *resource, |
| michael@0 | 55 | int (*cb)(void *cb_arg, nr_transport_addr *addr), |
| michael@0 | 56 | void *cb_arg, |
| michael@0 | 57 | void **handle); |
| michael@0 | 58 | int (*cancel)(void *obj, void *handle); |
| michael@0 | 59 | } nr_resolver_vtbl; |
| michael@0 | 60 | |
| michael@0 | 61 | typedef struct nr_resolver_ { |
| michael@0 | 62 | void *obj; |
| michael@0 | 63 | nr_resolver_vtbl *vtbl; |
| michael@0 | 64 | } nr_resolver; |
| michael@0 | 65 | |
| michael@0 | 66 | |
| michael@0 | 67 | /* |
| michael@0 | 68 | The convention here is that the provider of this interface |
| michael@0 | 69 | must generate a void *obj, and a vtbl and then call |
| michael@0 | 70 | nr_resolver_create_int() to allocate the generic wrapper |
| michael@0 | 71 | object. |
| michael@0 | 72 | |
| michael@0 | 73 | The vtbl must contain implementations for all the functions |
| michael@0 | 74 | listed. |
| michael@0 | 75 | |
| michael@0 | 76 | The nr_resolver_destroy() function (and hence vtbl->destroy) |
| michael@0 | 77 | will be called when the consumer of the resolver is done |
| michael@0 | 78 | with it. That is the signal that it is safe to clean up |
| michael@0 | 79 | the resources associated with obj. No other function will |
| michael@0 | 80 | be called afterwards. |
| michael@0 | 81 | */ |
| michael@0 | 82 | int nr_resolver_create_int(void *obj, nr_resolver_vtbl *vtbl, |
| michael@0 | 83 | nr_resolver **resolverp); |
| michael@0 | 84 | int nr_resolver_destroy(nr_resolver **resolverp); |
| michael@0 | 85 | |
| michael@0 | 86 | /* Request resolution of a domain */ |
| michael@0 | 87 | int nr_resolver_resolve(nr_resolver *resolver, |
| michael@0 | 88 | nr_resolver_resource *resource, |
| michael@0 | 89 | int (*cb)(void *cb_arg, nr_transport_addr *addr), |
| michael@0 | 90 | void *cb_arg, |
| michael@0 | 91 | void **handle); |
| michael@0 | 92 | |
| michael@0 | 93 | /* Cancel a requested resolution. No callback will fire. */ |
| michael@0 | 94 | int nr_resolver_cancel(nr_resolver *resolver, void *handle); |
| michael@0 | 95 | #endif |
