15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* From private/ppb_host_resolver_private.idl, 7eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * modified Mon Jun 24 09:49:40 2013. 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef PPAPI_C_PRIVATE_PPB_HOST_RESOLVER_PRIVATE_H_ 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPAPI_C_PRIVATE_PPB_HOST_RESOLVER_PRIVATE_H_ 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_bool.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_completion_callback.h" 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_instance.h" 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_macros.h" 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_resource.h" 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_stdint.h" 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/pp_var.h" 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/c/private/ppb_net_address_private.h" 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPB_HOSTRESOLVER_PRIVATE_INTERFACE_0_1 "PPB_HostResolver_Private;0.1" 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPB_HOSTRESOLVER_PRIVATE_INTERFACE \ 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PPB_HOSTRESOLVER_PRIVATE_INTERFACE_0_1 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @file 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This file defines the <code>PPB_HostResolver_Private</code> interface. 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @addtogroup Enums 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @{ 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The <code>PP_HostResolver_Flags</code> is an enumeration of the 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * different types of flags, that can be OR-ed and passed to host 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * resolver. 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum { 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * AI_CANONNAME 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 45eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch PP_HOST_RESOLVER_PRIVATE_FLAGS_CANONNAME = 1 << 0, 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Hint to the resolver that only loopback addresses are configured. 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 49eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch PP_HOST_RESOLVER_PRIVATE_FLAGS_LOOPBACK_ONLY = 1 << 1 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} PP_HostResolver_Private_Flags; 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_HostResolver_Private_Flags, 4); 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @} 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @addtogroup Structs 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @{ 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct PP_HostResolver_Private_Hint { 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_NetAddressFamily_Private family; 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t flags; 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_HostResolver_Private_Hint, 8); 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @} 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @addtogroup Interfaces 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @{ 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct PPB_HostResolver_Private_0_1 { 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Allocates a Host Resolver resource. 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Resource (*Create)(PP_Instance instance); 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Determines if a given resource is a Host Resolver. 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool (*IsHostResolver)(PP_Resource resource); 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Creates a new request to Host Resolver. |callback| is invoked 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * when request is processed and a list of network addresses is 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * obtained. These addresses can be be used in Connect, Bind or 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Listen calls to connect to a given |host| and |port|. 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t (*Resolve)(PP_Resource host_resolver, 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char* host, 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint16_t port, 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const struct PP_HostResolver_Private_Hint* hint, 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct PP_CompletionCallback callback); 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns canonical name of host. 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct PP_Var (*GetCanonicalName)(PP_Resource host_resolver); 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns number of network addresses obtained after Resolve call. 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t (*GetSize)(PP_Resource host_resolver); 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Stores in the |addr| |index|-th network address. |addr| can't be 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * NULL. Returns PP_TRUE if success or PP_FALSE if the given 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * resource is not a Host Resolver or |index| exceeds number of 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * available addresses. 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PP_Bool (*GetNetAddress)(PP_Resource host_resolver, 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t index, 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct PP_NetAddress_Private* addr); 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct PPB_HostResolver_Private_0_1 PPB_HostResolver_Private; 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @} 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif /* PPAPI_C_PRIVATE_PPB_HOST_RESOLVER_PRIVATE_H_ */ 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 119