resolv_cache.h revision 1dc9e472e19acfe6dc7f41e429236e7eef7ceda1
11dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project/* 21dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 31dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * All rights reserved. 41dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * 51dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * Redistribution and use in source and binary forms, with or without 61dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * modification, are permitted provided that the following conditions 71dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * are met: 81dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * * Redistributions of source code must retain the above copyright 91dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * notice, this list of conditions and the following disclaimer. 101dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * * Redistributions in binary form must reproduce the above copyright 111dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * notice, this list of conditions and the following disclaimer in 121dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * the documentation and/or other materials provided with the 131dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * distribution. 141dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * 151dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 161dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 171dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 181dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 191dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 201dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 211dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 221dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 231dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 241dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 251dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 261dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * SUCH DAMAGE. 271dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project */ 281dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project#ifndef _RESOLV_CACHE_H_ 291dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project#define _RESOLV_CACHE_H_ 301dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 311dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Projectstruct resolv_cache; /* forward */ 321dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 331dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project/* get cache instance, can be NULL if cache is disabled 341dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * (e.g. through an environment variable) */ 351dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Projectextern struct resolv_cache* __get_res_cache(void); 361dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 371dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project/* this gets called everytime we detect some changes in the DNS configuration 381dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * and will flush the cache */ 391dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Projectextern void _resolv_cache_reset( unsigned generation ); 401dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 411dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Projecttypedef enum { 421dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project RESOLV_CACHE_UNSUPPORTED, /* the cache can't handle that kind of queries */ 431dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project /* or the answer buffer is too small */ 441dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project RESOLV_CACHE_NOTFOUND, /* the cache doesn't know about this query */ 451dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project RESOLV_CACHE_FOUND /* the cache found the answer */ 461dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project} ResolvCacheStatus; 471dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 481dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Projectextern ResolvCacheStatus 491dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project_resolv_cache_lookup( struct resolv_cache* cache, 501dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project const void* query, 511dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project int querylen, 521dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project void* answer, 531dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project int answersize, 541dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project int *answerlen ); 551dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 561dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project/* add a (query,answer) to the cache, only call if _resolv_cache_lookup 571dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project * did return RESOLV_CACHE_NOTFOUND 581dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project */ 591dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Projectextern void 601dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project_resolv_cache_add( struct resolv_cache* cache, 611dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project const void* query, 621dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project int querylen, 631dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project const void* answer, 641dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project int answerlen ); 651dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project 661dc9e472e19acfe6dc7f41e429236e7eef7ceda1The Android Open Source Project#endif /* _RESOLV_CACHE_H_ */ 67