1 /* 2 * Copyright (C) 2007 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 /* This file is used to define the properties of the filesystem 18 ** images generated by build tools (mkbootfs and mkyaffs2image) and 19 ** by the device side of adb. 20 */ 21 22 #ifndef _ANDROID_FILESYSTEM_CONFIG_H_ 23 #define _ANDROID_FILESYSTEM_CONFIG_H_ 24 25 #include <sys/cdefs.h> 26 #include <sys/types.h> 27 #include <stdint.h> 28 29 #if defined(__ANDROID__) 30 #include <linux/capability.h> 31 #else 32 #include "android_filesystem_capability.h" 33 #endif 34 35 #define CAP_MASK_LONG(cap_name) (1ULL << (cap_name)) 36 37 /* This is the master Users and Groups config for the platform. 38 * DO NOT EVER RENUMBER 39 */ 40 41 #define AID_ROOT 0 /* traditional unix root user */ 42 43 #define AID_SYSTEM 1000 /* system server */ 44 45 #define AID_RADIO 1001 /* telephony subsystem, RIL */ 46 #define AID_BLUETOOTH 1002 /* bluetooth subsystem */ 47 #define AID_GRAPHICS 1003 /* graphics devices */ 48 #define AID_INPUT 1004 /* input devices */ 49 #define AID_AUDIO 1005 /* audio devices */ 50 #define AID_CAMERA 1006 /* camera devices */ 51 #define AID_LOG 1007 /* log devices */ 52 #define AID_COMPASS 1008 /* compass device */ 53 #define AID_MOUNT 1009 /* mountd socket */ 54 #define AID_WIFI 1010 /* wifi subsystem */ 55 #define AID_ADB 1011 /* android debug bridge (adbd) */ 56 #define AID_INSTALL 1012 /* group for installing packages */ 57 #define AID_MEDIA 1013 /* mediaserver process */ 58 #define AID_DHCP 1014 /* dhcp client */ 59 #define AID_SDCARD_RW 1015 /* external storage write access */ 60 #define AID_VPN 1016 /* vpn system */ 61 #define AID_KEYSTORE 1017 /* keystore subsystem */ 62 #define AID_USB 1018 /* USB devices */ 63 #define AID_DRM 1019 /* DRM server */ 64 #define AID_MDNSR 1020 /* MulticastDNSResponder (service discovery) */ 65 #define AID_GPS 1021 /* GPS daemon */ 66 #define AID_UNUSED1 1022 /* deprecated, DO NOT USE */ 67 #define AID_MEDIA_RW 1023 /* internal media storage write access */ 68 #define AID_MTP 1024 /* MTP USB driver access */ 69 #define AID_UNUSED2 1025 /* deprecated, DO NOT USE */ 70 #define AID_DRMRPC 1026 /* group for drm rpc */ 71 #define AID_NFC 1027 /* nfc subsystem */ 72 #define AID_SDCARD_R 1028 /* external storage read access */ 73 #define AID_CLAT 1029 /* clat part of nat464 */ 74 #define AID_LOOP_RADIO 1030 /* loop radio devices */ 75 #define AID_MEDIA_DRM 1031 /* MediaDrm plugins */ 76 #define AID_PACKAGE_INFO 1032 /* access to installed package details */ 77 #define AID_SDCARD_PICS 1033 /* external storage photos access */ 78 #define AID_SDCARD_AV 1034 /* external storage audio/video access */ 79 #define AID_SDCARD_ALL 1035 /* access all users external storage */ 80 #define AID_LOGD 1036 /* log daemon */ 81 #define AID_SHARED_RELRO 1037 /* creator of shared GNU RELRO files */ 82 #define AID_DBUS 1038 /* dbus-daemon IPC broker process */ 83 #define AID_TLSDATE 1039 /* tlsdate unprivileged user */ 84 #define AID_MEDIA_EX 1040 /* mediaextractor process */ 85 #define AID_AUDIOSERVER 1041 /* audioserver process */ 86 #define AID_METRICS_COLL 1042 /* metrics_collector process */ 87 #define AID_METRICSD 1043 /* metricsd process */ 88 #define AID_WEBSERV 1044 /* webservd process */ 89 #define AID_DEBUGGERD 1045 /* debuggerd unprivileged user */ 90 #define AID_MEDIA_CODEC 1046 /* mediacodec process */ 91 #define AID_CAMERASERVER 1047 /* cameraserver process */ 92 93 #define AID_SHELL 2000 /* adb and debug shell user */ 94 #define AID_CACHE 2001 /* cache access */ 95 #define AID_DIAG 2002 /* access to diagnostic resources */ 96 97 /* The range 2900-2999 is reserved for OEM, and must never be 98 * used here */ 99 #define AID_OEM_RESERVED_START 2900 100 #define AID_OEM_RESERVED_END 2999 101 102 /* The 3000 series are intended for use as supplemental group id's only. 103 * They indicate special Android capabilities that the kernel is aware of. */ 104 #define AID_NET_BT_ADMIN 3001 /* bluetooth: create any socket */ 105 #define AID_NET_BT 3002 /* bluetooth: create sco, rfcomm or l2cap sockets */ 106 #define AID_INET 3003 /* can create AF_INET and AF_INET6 sockets */ 107 #define AID_NET_RAW 3004 /* can create raw INET sockets */ 108 #define AID_NET_ADMIN 3005 /* can configure interfaces and routing tables. */ 109 #define AID_NET_BW_STATS 3006 /* read bandwidth statistics */ 110 #define AID_NET_BW_ACCT 3007 /* change bandwidth statistics accounting */ 111 #define AID_NET_BT_STACK 3008 /* bluetooth: access config files */ 112 #define AID_READPROC 3009 /* Allow /proc read access */ 113 #define AID_WAKELOCK 3010 /* Allow system wakelock read/write access */ 114 115 /* The range 5000-5999 is also reserved for OEM, and must never be used here. */ 116 #define AID_OEM_RESERVED_2_START 5000 117 #define AID_OEM_RESERVED_2_END 5999 118 119 #define AID_EVERYBODY 9997 /* shared between all apps in the same profile */ 120 #define AID_MISC 9998 /* access to misc storage */ 121 #define AID_NOBODY 9999 122 123 #define AID_APP 10000 /* first app user */ 124 125 #define AID_ISOLATED_START 99000 /* start of uids for fully isolated sandboxed processes */ 126 #define AID_ISOLATED_END 99999 /* end of uids for fully isolated sandboxed processes */ 127 128 #define AID_USER 100000 /* offset for uid ranges for each user */ 129 130 #define AID_SHARED_GID_START 50000 /* start of gids for apps in each user to share */ 131 #define AID_SHARED_GID_END 59999 /* start of gids for apps in each user to share */ 132 133 #if !defined(EXCLUDE_FS_CONFIG_STRUCTURES) 134 /* 135 * Used in: 136 * bionic/libc/bionic/stubs.cpp 137 * external/libselinux/src/android.c 138 * system/core/logd/LogStatistics.cpp 139 * system/core/init/ueventd.cpp 140 * system/core/init/util.cpp 141 */ 142 struct android_id_info { 143 const char *name; 144 unsigned aid; 145 }; 146 147 static const struct android_id_info android_ids[] = { 148 { "root", AID_ROOT, }, 149 150 { "system", AID_SYSTEM, }, 151 152 { "radio", AID_RADIO, }, 153 { "bluetooth", AID_BLUETOOTH, }, 154 { "graphics", AID_GRAPHICS, }, 155 { "input", AID_INPUT, }, 156 { "audio", AID_AUDIO, }, 157 { "camera", AID_CAMERA, }, 158 { "log", AID_LOG, }, 159 { "compass", AID_COMPASS, }, 160 { "mount", AID_MOUNT, }, 161 { "wifi", AID_WIFI, }, 162 { "adb", AID_ADB, }, 163 { "install", AID_INSTALL, }, 164 { "media", AID_MEDIA, }, 165 { "dhcp", AID_DHCP, }, 166 { "sdcard_rw", AID_SDCARD_RW, }, 167 { "vpn", AID_VPN, }, 168 { "keystore", AID_KEYSTORE, }, 169 { "usb", AID_USB, }, 170 { "drm", AID_DRM, }, 171 { "mdnsr", AID_MDNSR, }, 172 { "gps", AID_GPS, }, 173 // AID_UNUSED1 174 { "media_rw", AID_MEDIA_RW, }, 175 { "mtp", AID_MTP, }, 176 // AID_UNUSED2 177 { "drmrpc", AID_DRMRPC, }, 178 { "nfc", AID_NFC, }, 179 { "sdcard_r", AID_SDCARD_R, }, 180 { "clat", AID_CLAT, }, 181 { "loop_radio", AID_LOOP_RADIO, }, 182 { "mediadrm", AID_MEDIA_DRM, }, 183 { "package_info", AID_PACKAGE_INFO, }, 184 { "sdcard_pics", AID_SDCARD_PICS, }, 185 { "sdcard_av", AID_SDCARD_AV, }, 186 { "sdcard_all", AID_SDCARD_ALL, }, 187 { "logd", AID_LOGD, }, 188 { "shared_relro", AID_SHARED_RELRO, }, 189 { "dbus", AID_DBUS, }, 190 { "tlsdate", AID_TLSDATE, }, 191 { "mediaex", AID_MEDIA_EX, }, 192 { "audioserver", AID_AUDIOSERVER, }, 193 { "metrics_coll", AID_METRICS_COLL }, 194 { "metricsd", AID_METRICSD }, 195 { "webserv", AID_WEBSERV }, 196 { "debuggerd", AID_DEBUGGERD, }, 197 { "mediacodec", AID_MEDIA_CODEC, }, 198 { "cameraserver", AID_CAMERASERVER, }, 199 200 { "shell", AID_SHELL, }, 201 { "cache", AID_CACHE, }, 202 { "diag", AID_DIAG, }, 203 204 { "net_bt_admin", AID_NET_BT_ADMIN, }, 205 { "net_bt", AID_NET_BT, }, 206 { "inet", AID_INET, }, 207 { "net_raw", AID_NET_RAW, }, 208 { "net_admin", AID_NET_ADMIN, }, 209 { "net_bw_stats", AID_NET_BW_STATS, }, 210 { "net_bw_acct", AID_NET_BW_ACCT, }, 211 { "net_bt_stack", AID_NET_BT_STACK, }, 212 { "readproc", AID_READPROC, }, 213 { "wakelock", AID_WAKELOCK, }, 214 215 { "everybody", AID_EVERYBODY, }, 216 { "misc", AID_MISC, }, 217 { "nobody", AID_NOBODY, }, 218 }; 219 220 #define android_id_count \ 221 (sizeof(android_ids) / sizeof(android_ids[0])) 222 223 struct fs_path_config { 224 unsigned mode; 225 unsigned uid; 226 unsigned gid; 227 uint64_t capabilities; 228 const char *prefix; 229 }; 230 231 /* Rules for directories and files has moved to system/code/libcutils/fs_config.c */ 232 233 __BEGIN_DECLS 234 235 /* 236 * Used in: 237 * build/tools/fs_config/fs_config.c 238 * build/tools/fs_get_stats/fs_get_stats.c 239 * system/extras/ext4_utils/make_ext4fs_main.c 240 * external/squashfs-tools/squashfs-tools/android.c 241 * system/core/cpio/mkbootfs.c 242 * system/core/adb/file_sync_service.cpp 243 * system/extras/ext4_utils/canned_fs_config.c 244 */ 245 void fs_config(const char *path, int dir, const char *target_out_path, 246 unsigned *uid, unsigned *gid, unsigned *mode, uint64_t *capabilities); 247 248 ssize_t fs_config_generate(char *buffer, size_t length, const struct fs_path_config *pc); 249 250 __END_DECLS 251 252 #endif 253 #endif 254