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 541a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 551a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 561a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Set the network to be used by the given socket file descriptor. 571a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 581a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * To clear a previous socket binding invoke with NETWORK_UNSPECIFIED. 591a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 601a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * This is the equivalent of: 611a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 621a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * [ android.net.Network#bindSocket() ] 631a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * https://developer.android.com/reference/android/net/Network.html#bindSocket(java.net.Socket) 641a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 651a4b21e039194e8bf9b538431793873d9a9ce1fcErik Klineint android_setsocknetwork(net_handle_t network, int fd); 661a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 671a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 681a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 691a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Binds the current process to |network|. All sockets created in the future 701a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * (and not explicitly bound via android_setsocknetwork()) will be bound to 711a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * |network|. All host name resolutions will be limited to |network| as well. 721a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Note that if the network identified by |network| ever disconnects, all 731a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * sockets created in this way will cease to work and all host name 741a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * resolutions will fail. This is by design so an application doesn't 751a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * accidentally use sockets it thinks are still bound to a particular network. 761a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 771a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * To clear a previous process binding invoke with NETWORK_UNSPECIFIED. 781a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 791a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * This is the equivalent of: 801a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 811a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * [ android.net.ConnectivityManager#setProcessDefaultNetwork() ] 821a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * https://developer.android.com/reference/android/net/ConnectivityManager.html#setProcessDefaultNetwork(android.net.Network) 831a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 841a4b21e039194e8bf9b538431793873d9a9ce1fcErik Klineint android_setprocnetwork(net_handle_t network); 851a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 861a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 871a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline/** 881a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Perform hostname resolution via the DNS servers associated with |network|. 891a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 901a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * All arguments (apart from |network|) are used identically as those passed 911a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * to getaddrinfo(3). Return and error values are identical to those of 921a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * getaddrinfo(3), and in particular gai_strerror(3) can be used as expected. 931a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * Similar to getaddrinfo(3): 941a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * - |hints| may be NULL (in which case man page documented defaults apply) 951a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * - either |node| or |service| may be NULL, but not both 961a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * - |res| must not be NULL 971a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 981a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * This is the equivalent of: 991a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * 1001a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * [ android.net.Network#getAllByName() ] 1011a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline * https://developer.android.com/reference/android/net/Network.html#getAllByName(java.lang.String) 1021a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline */ 1031a4b21e039194e8bf9b538431793873d9a9ce1fcErik Klineint android_getaddrinfofornetwork(net_handle_t network, 1041a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline const char *node, const char *service, 1051a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline const struct addrinfo *hints, struct addrinfo **res); 1061a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 1071a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline__END_DECLS 1081a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline 1091a4b21e039194e8bf9b538431793873d9a9ce1fcErik Kline#endif // ANDROID_MULTINETWORK_H 110