1 /* 2 * Copyright (C) 2011 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 #ifndef _RESOLV_IFACE_H 29 #define _RESOLV_IFACE_H 30 31 /* This header contains declarations related to per-interface DNS 32 * server selection. They are used by system/netd/ and should not be 33 * exposed by the C library's public NDK headers. 34 * 35 * NOTE: <resolv.h> contains the same declarations, this will be removed 36 * when we change system/netd to use this header instead. 37 */ 38 #include <sys/cdefs.h> 39 #include <netinet/in.h> 40 41 __BEGIN_DECLS 42 43 /* Use a guard macro until we remove the same definitions from <resolv.h> */ 44 #ifndef _BIONIC_RESOLV_IFACE_FUNCTIONS_DECLARED 45 #define _BIONIC_RESOLV_IFACE_FUNCTIONS_DECLARED 46 47 /* Set name of default interface */ 48 extern void _resolv_set_default_iface(const char* ifname); 49 50 /* set name servers for an interface */ 51 extern void _resolv_set_nameservers_for_iface(const char* ifname, const char** servers, int numservers, 52 const char *domains); 53 54 /* tell resolver of the address of an interface */ 55 extern void _resolv_set_addr_of_iface(const char* ifname, struct in_addr* addr); 56 57 /* flush the cache associated with the default interface */ 58 extern void _resolv_flush_cache_for_default_iface(); 59 60 /* flush the cache associated with a certain interface */ 61 extern void _resolv_flush_cache_for_iface(const char* ifname); 62 63 /* set a pid to use the name servers of the specified interface */ 64 extern void _resolv_set_iface_for_pid(const char* ifname, int pid); 65 66 /* clear pid from being associated with an interface */ 67 extern void _resolv_clear_iface_for_pid(int pid); 68 69 /* clear the entire mapping of pids to interfaces. */ 70 extern void _resolv_clear_iface_pid_mapping(); 71 72 /** Gets the name of the interface to which the pid is attached. 73 * On error, -1 is returned. 74 * If no interface is found, 0 is returned and buff is set to empty ('\0'). 75 * If an interface is found, the name is copied to buff and the length of the name is returned. 76 * Arguments: pid The pid to find an interface for 77 * buff A buffer to copy the result to 78 * buffLen Length of buff. An interface is at most IF_NAMESIZE in length */ 79 extern int _resolv_get_pids_associated_interface(int pid, char* buff, int buffLen); 80 81 82 /** set a uid range to use the name servers of the specified interface */ 83 extern int _resolv_set_iface_for_uid_range(const char* ifname, int uid_start, int uid_end); 84 85 /** Remove a mapping added by _resolv_set_iface_for_uid_range. 86 * If no such rule exists -1 is returned. */ 87 extern int _resolv_clear_iface_for_uid_range(const char* ifname, int uid_start, int uid_end); 88 89 /* clear the entire mapping of uid ranges to interfaces. */ 90 extern void _resolv_clear_iface_uid_range_mapping(); 91 92 /** Gets the name of the interface to which the uid is attached. 93 * On error, -1 is returned. 94 * If no interface is found, 0 is returned and buff is set to empty ('\0'). 95 * If an interface is found, the name is copied to buff and the length of the name is returned. 96 * If there are multiple rules covering uid the most recently added rule will be returned. 97 * Arguments: uid The uid to find an interface for 98 * buff A buffer to copy the result to 99 * buffLen Length of buff. An interface is at most IF_NAMESIZE in length */ 100 extern int _resolv_get_uids_associated_interface(int uid, char* buff, int buffLen); 101 102 #endif /* _BIONIC_RESOLV_IFACE_FUNCTIONS_DECLARED */ 103 104 __END_DECLS 105 106 #endif /* _RESOLV_IFACE_H */ 107
