11a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/* 21a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Copyright (C) 2015 The Android Open Source Project 31a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 41a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Licensed under the Apache License, Version 2.0 (the "License"); 51a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * you may not use this file except in compliance with the License. 61a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * You may obtain a copy of the License at 71a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 81a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * http://www.apache.org/licenses/LICENSE-2.0 91a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 101a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Unless required by applicable law or agreed to in writing, software 111a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * distributed under the License is distributed on an "AS IS" BASIS, 121a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 131a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * See the License for the specific language governing permissions and 141a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * limitations under the License. 151a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 161a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 171a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#ifndef ANDROID_MULTINETWORK_H 181a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#define ANDROID_MULTINETWORK_H 191a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 201a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#include <netdb.h> 211a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#include <stdlib.h> 221a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#include <sys/cdefs.h> 231a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 241a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline__BEGIN_DECLS 251a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 261a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 271a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * The corresponding C type for android.net.Network#getNetworkHandle() return 281a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * values. The Java signed long value can be safely cast to a net_handle_t: 291a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 301a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * [C] ((net_handle_t) java_long_network_handle) 311a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * [C++] static_cast<net_handle_t>(java_long_network_handle) 321a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 331a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * as appropriate. 341a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 351a4b21e039194e8bf9b538431793873d9a9ce1fcErik Klinetypedef uint64_t net_handle_t; 361a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 371a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 381a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * The value NETWORK_UNSPECIFIED indicates no specific network. 391a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 401a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * For some functions (documented below), a previous binding may be cleared 411a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * by an invocation with NETWORK_UNSPECIFIED. 421a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 431a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Depending on the context it may indicate an error. It is expressly 441a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * not used to indicate some notion of the "current default network". 451a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 461a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#define NETWORK_UNSPECIFIED ((net_handle_t)0) 471a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 481a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 491a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 501a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * All functions below that return an int return 0 on success or -1 511a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * on failure with an appropriate errno value set. 521a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 531a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 54494ed550f5aea1332984fb9f0f11036fc58bd716Dan Albert#if __ANDROID_API__ >= 24 551a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 561a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 571a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Set the network to be used by the given socket file descriptor. 581a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 594b97f0fd6ca0f8e5ca509f1891eb84e20027b8c6Quddus Chong * To clear a previous socket binding, invoke with NETWORK_UNSPECIFIED. 601a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 614b97f0fd6ca0f8e5ca509f1891eb84e20027b8c6Quddus Chong * This is the equivalent of: [android.net.Network#bindSocket()](https://developer.android.com/reference/android/net/Network.html#bindSocket(java.net.Socket)) 621a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 631a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 641a4b21e039194e8bf9b538431793873d9a9ce1fcErik Klineint android_setsocknetwork(net_handle_t network, int fd); 651a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 661a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 671a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 681a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Binds the current process to |network|. All sockets created in the future 691a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * (and not explicitly bound via android_setsocknetwork()) will be bound to 701a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * |network|. All host name resolutions will be limited to |network| as well. 711a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Note that if the network identified by |network| ever disconnects, all 721a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * sockets created in this way will cease to work and all host name 731a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * resolutions will fail. This is by design so an application doesn't 741a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * accidentally use sockets it thinks are still bound to a particular network. 751a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 764b97f0fd6ca0f8e5ca509f1891eb84e20027b8c6Quddus Chong * To clear a previous process binding, invoke with NETWORK_UNSPECIFIED. 771a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 784b97f0fd6ca0f8e5ca509f1891eb84e20027b8c6Quddus Chong * This is the equivalent of: [android.net.ConnectivityManager#setProcessDefaultNetwork()](https://developer.android.com/reference/android/net/ConnectivityManager.html#setProcessDefaultNetwork(android.net.Network)) 791a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 801a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 811a4b21e039194e8bf9b538431793873d9a9ce1fcErik Klineint android_setprocnetwork(net_handle_t network); 821a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 831a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 841a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 851a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Perform hostname resolution via the DNS servers associated with |network|. 861a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 871a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * All arguments (apart from |network|) are used identically as those passed 881a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * to getaddrinfo(3). Return and error values are identical to those of 891a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * getaddrinfo(3), and in particular gai_strerror(3) can be used as expected. 901a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Similar to getaddrinfo(3): 911a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * - |hints| may be NULL (in which case man page documented defaults apply) 921a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * - either |node| or |service| may be NULL, but not both 931a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * - |res| must not be NULL 941a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 954b97f0fd6ca0f8e5ca509f1891eb84e20027b8c6Quddus Chong * This is the equivalent of: [android.net.Network#getAllByName()](https://developer.android.com/reference/android/net/Network.html#getAllByName(java.lang.String)) 961a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 971a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 981a4b21e039194e8bf9b538431793873d9a9ce1fcErik Klineint android_getaddrinfofornetwork(net_handle_t network, 991a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline const char *node, const char *service, 1001a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline const struct addrinfo *hints, struct addrinfo **res); 1011a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 102494ed550f5aea1332984fb9f0f11036fc58bd716Dan Albert#endif /* __ANDROID_API__ >= 24 */ 103494ed550f5aea1332984fb9f0f11036fc58bd716Dan Albert 1041a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline__END_DECLS 1051a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 1061a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#endif // ANDROID_MULTINETWORK_H 107