• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2008 The Android Open Source Project
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *  * Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  *  * Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in
12  *    the documentation and/or other materials provided with the
13  *    distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
22  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
23  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #pragma once
30 
31 #include "netd_resolv/resolv.h"
32 
33 #include <stddef.h>
34 
35 #include <vector>
36 
37 struct __res_state;
38 
39 /* sets the name server addresses to the provided res_state structure. The
40  * name servers are retrieved from the cache which is associated
41  * with the network to which the res_state structure is associated */
42 void _resolv_populate_res_for_net(struct __res_state* statp);
43 
44 std::vector<unsigned> resolv_list_caches();
45 
46 typedef enum {
47     RESOLV_CACHE_UNSUPPORTED, /* the cache can't handle that kind of queries */
48                               /* or the answer buffer is too small */
49     RESOLV_CACHE_NOTFOUND,    /* the cache doesn't know about this query */
50     RESOLV_CACHE_FOUND,       /* the cache found the answer */
51     RESOLV_CACHE_SKIP         /* Don't do anything on cache */
52 } ResolvCacheStatus;
53 
54 ResolvCacheStatus _resolv_cache_lookup(unsigned netid, const void* query, int querylen,
55                                        void* answer, int answersize, int* answerlen,
56                                        uint32_t flags);
57 
58 /* add a (query,answer) to the cache, only call if _resolv_cache_lookup
59  * did return RESOLV_CACHE_NOTFOUND
60  */
61 void _resolv_cache_add(unsigned netid, const void* query, int querylen, const void* answer,
62                        int answerlen);
63 
64 /* Notify the cache a request failed */
65 void _resolv_cache_query_failed(unsigned netid, const void* query, int querylen, uint32_t flags);
66 
67 // Sets name servers for a given network.
68 int resolv_set_nameservers_for_net(unsigned netid, const char** servers, int numservers,
69                                    const char* domains, const res_params* params);
70 
71 // Creates the cache associated with the given network.
72 int resolv_create_cache_for_net(unsigned netid);
73 
74 // Deletes the cache associated with the given network.
75 void resolv_delete_cache_for_net(unsigned netid);
76