Home | History | Annotate | Download | only in cutils
      1 /*
      2  * Copyright (C) 2006 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #ifndef __CUTILS_SOCKETS_H
     18 #define __CUTILS_SOCKETS_H
     19 
     20 #include <errno.h>
     21 #include <stdio.h>
     22 #include <stdlib.h>
     23 #include <string.h>
     24 #include <stdbool.h>
     25 
     26 #ifdef HAVE_WINSOCK
     27 #include <winsock2.h>
     28 typedef int  socklen_t;
     29 #else
     30 #include <sys/socket.h>
     31 #endif
     32 
     33 #define ANDROID_SOCKET_ENV_PREFIX	"ANDROID_SOCKET_"
     34 #define ANDROID_SOCKET_DIR		"/dev/socket"
     35 
     36 #ifdef __cplusplus
     37 extern "C" {
     38 #endif
     39 
     40 /*
     41  * android_get_control_socket - simple helper function to get the file
     42  * descriptor of our init-managed Unix domain socket. `name' is the name of the
     43  * socket, as given in init.rc. Returns -1 on error.
     44  *
     45  * This is inline and not in libcutils proper because we want to use this in
     46  * third-party daemons with minimal modification.
     47  */
     48 static inline int android_get_control_socket(const char *name)
     49 {
     50 	char key[64];
     51 	snprintf(key, sizeof(key), ANDROID_SOCKET_ENV_PREFIX "%s", name);
     52 
     53 	const char* val = getenv(key);
     54 	if (!val) {
     55 		return -1;
     56 	}
     57 
     58 	errno = 0;
     59 	int fd = strtol(val, NULL, 10);
     60 	if (errno) {
     61 		return -1;
     62 	}
     63 
     64 	return fd;
     65 }
     66 
     67 /*
     68  * See also android.os.LocalSocketAddress.Namespace
     69  */
     70 // Linux "abstract" (non-filesystem) namespace
     71 #define ANDROID_SOCKET_NAMESPACE_ABSTRACT 0
     72 // Android "reserved" (/dev/socket) namespace
     73 #define ANDROID_SOCKET_NAMESPACE_RESERVED 1
     74 // Normal filesystem namespace
     75 #define ANDROID_SOCKET_NAMESPACE_FILESYSTEM 2
     76 
     77 extern int socket_loopback_client(int port, int type);
     78 extern int socket_network_client(const char *host, int port, int type);
     79 extern int socket_network_client_timeout(const char *host, int port, int type,
     80                                          int timeout);
     81 extern int socket_loopback_server(int port, int type);
     82 extern int socket_local_server(const char *name, int namespaceId, int type);
     83 extern int socket_local_server_bind(int s, const char *name, int namespaceId);
     84 extern int socket_local_client_connect(int fd,
     85         const char *name, int namespaceId, int type);
     86 extern int socket_local_client(const char *name, int namespaceId, int type);
     87 extern int socket_inaddr_any_server(int port, int type);
     88 
     89 /*
     90  * socket_peer_is_trusted - Takes a socket which is presumed to be a
     91  * connected local socket (e.g. AF_LOCAL) and returns whether the peer
     92  * (the userid that owns the process on the other end of that socket)
     93  * is one of the two trusted userids, root or shell.
     94  *
     95  * Note: This only works as advertised on the Android OS and always
     96  * just returns true when called on other operating systems.
     97  */
     98 extern bool socket_peer_is_trusted(int fd);
     99 
    100 #ifdef __cplusplus
    101 }
    102 #endif
    103 
    104 #endif /* __CUTILS_SOCKETS_H */
    105