android_filesystem_config.h revision c2f59d87d85e4c7ec9a7f899dd4f55a36b3627f5 
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 <string.h>
26#include <sys/stat.h>
27#include <sys/types.h>
28
29/* This is the master Users and Groups config for the platform.
30** DO NOT EVER RENUMBER.
31*/
32
33#define AID_ROOT             0  /* traditional unix root user */
34
35#define AID_SYSTEM        1000  /* system server */
36
37#define AID_RADIO         1001  /* telephony subsystem, RIL */
38#define AID_BLUETOOTH     1002  /* bluetooth subsystem */
39#define AID_GRAPHICS      1003  /* graphics devices */
40#define AID_INPUT         1004  /* input devices */
41#define AID_AUDIO         1005  /* audio devices */
42#define AID_CAMERA        1006  /* camera devices */
43#define AID_LOG           1007  /* log devices */
44#define AID_COMPASS       1008  /* compass device */
45#define AID_MOUNT         1009  /* mountd socket */
46#define AID_WIFI          1010  /* wifi subsystem */
47#define AID_ADB           1011  /* android debug bridge (adbd) */
48#define AID_INSTALL       1012  /* group for installing packages */
49#define AID_MEDIA         1013  /* mediaserver process */
50#define AID_DHCP          1014  /* dhcp client */
51#define AID_SDCARD_RW     1015  /* external storage write access */
52#define AID_VPN           1016  /* vpn system */
53#define AID_KEYSTORE      1017  /* keystore subsystem */
54#define AID_USB           1018  /* USB devices */
55#define AID_DRM           1019  /* DRM server */
56#define AID_MDNSR         1020  /* MulticastDNSResponder (service discovery) */
57#define AID_GPS           1021  /* GPS daemon */
58#define AID_UNUSED1       1022  /* deprecated, DO NOT USE */
59#define AID_MEDIA_RW      1023  /* internal media storage write access */
60#define AID_MTP           1024  /* MTP USB driver access */
61#define AID_UNUSED2       1025  /* deprecated, DO NOT USE */
62#define AID_DRMRPC        1026  /* group for drm rpc */
63#define AID_NFC           1027  /* nfc subsystem */
64#define AID_SDCARD_R      1028  /* external storage read access */
65
66#define AID_SHELL         2000  /* adb and debug shell user */
67#define AID_CACHE         2001  /* cache access */
68#define AID_DIAG          2002  /* access to diagnostic resources */
69
70/* The 3000 series are intended for use as supplemental group id's only.
71 * They indicate special Android capabilities that the kernel is aware of. */
72#define AID_NET_BT_ADMIN  3001  /* bluetooth: create any socket */
73#define AID_NET_BT        3002  /* bluetooth: create sco, rfcomm or l2cap sockets */
74#define AID_INET          3003  /* can create AF_INET and AF_INET6 sockets */
75#define AID_NET_RAW       3004  /* can create raw INET sockets */
76#define AID_NET_ADMIN     3005  /* can configure interfaces and routing tables. */
77#define AID_NET_BW_STATS  3006  /* read bandwidth statistics */
78#define AID_NET_BW_ACCT   3007  /* change bandwidth statistics accounting */
79
80#define AID_MISC          9998  /* access to misc storage */
81#define AID_NOBODY        9999
82
83#define AID_APP          10000  /* first app user */
84
85#define AID_ISOLATED_START 99000 /* start of uids for fully isolated sandboxed processes */
86#define AID_ISOLATED_END   99999 /* end of uids for fully isolated sandboxed processes */
87
88#define AID_USER        100000  /* offset for uid ranges for each user */
89
90#define AID_SHARED_GID_START 50000 /* start of gids for apps in each user to share */
91#define AID_SHARED_GID_END   59999 /* start of gids for apps in each user to share */
92
93#if !defined(EXCLUDE_FS_CONFIG_STRUCTURES)
94struct android_id_info {
95    const char *name;
96    unsigned aid;
97};
98
99static const struct android_id_info android_ids[] = {
100    { "root",      AID_ROOT, },
101    { "system",    AID_SYSTEM, },
102    { "radio",     AID_RADIO, },
103    { "bluetooth", AID_BLUETOOTH, },
104    { "graphics",  AID_GRAPHICS, },
105    { "input",     AID_INPUT, },
106    { "audio",     AID_AUDIO, },
107    { "camera",    AID_CAMERA, },
108    { "log",       AID_LOG, },
109    { "compass",   AID_COMPASS, },
110    { "mount",     AID_MOUNT, },
111    { "wifi",      AID_WIFI, },
112    { "dhcp",      AID_DHCP, },
113    { "adb",       AID_ADB, },
114    { "install",   AID_INSTALL, },
115    { "media",     AID_MEDIA, },
116    { "drm",       AID_DRM, },
117    { "mdnsr",     AID_MDNSR, },
118    { "nfc",       AID_NFC, },
119    { "drmrpc",    AID_DRMRPC, },
120    { "shell",     AID_SHELL, },
121    { "cache",     AID_CACHE, },
122    { "diag",      AID_DIAG, },
123    { "net_bt_admin", AID_NET_BT_ADMIN, },
124    { "net_bt",    AID_NET_BT, },
125    { "sdcard_r",  AID_SDCARD_R, },
126    { "sdcard_rw", AID_SDCARD_RW, },
127    { "media_rw",  AID_MEDIA_RW, },
128    { "vpn",       AID_VPN, },
129    { "keystore",  AID_KEYSTORE, },
130    { "usb",       AID_USB, },
131    { "mtp",       AID_MTP, },
132    { "gps",       AID_GPS, },
133    { "inet",      AID_INET, },
134    { "net_raw",   AID_NET_RAW, },
135    { "net_admin", AID_NET_ADMIN, },
136    { "net_bw_stats", AID_NET_BW_STATS, },
137    { "net_bw_acct", AID_NET_BW_ACCT, },
138    { "misc",      AID_MISC, },
139    { "nobody",    AID_NOBODY, },
140};
141
142#define android_id_count \
143    (sizeof(android_ids) / sizeof(android_ids[0]))
144
145struct fs_path_config {
146    unsigned mode;
147    unsigned uid;
148    unsigned gid;
149    const char *prefix;
150};
151
152/* Rules for directories.
153** These rules are applied based on "first match", so they
154** should start with the most specific path and work their
155** way up to the root.
156*/
157
158static struct fs_path_config android_dirs[] = {
159    { 00770, AID_SYSTEM, AID_CACHE,  "cache" },
160    { 00771, AID_SYSTEM, AID_SYSTEM, "data/app" },
161    { 00771, AID_SYSTEM, AID_SYSTEM, "data/app-private" },
162    { 00771, AID_SYSTEM, AID_SYSTEM, "data/dalvik-cache" },
163    { 00771, AID_SYSTEM, AID_SYSTEM, "data/data" },
164    { 00771, AID_SHELL,  AID_SHELL,  "data/local/tmp" },
165    { 00771, AID_SHELL,  AID_SHELL,  "data/local" },
166    { 01771, AID_SYSTEM, AID_MISC,   "data/misc" },
167    { 00770, AID_DHCP,   AID_DHCP,   "data/misc/dhcp" },
168    { 00775, AID_MEDIA_RW, AID_MEDIA_RW, "data/media" },
169    { 00775, AID_MEDIA_RW, AID_MEDIA_RW, "data/media/Music" },
170    { 00771, AID_SYSTEM, AID_SYSTEM, "data" },
171    { 00750, AID_ROOT,   AID_SHELL,  "sbin" },
172    { 00755, AID_ROOT,   AID_SHELL,  "system/bin" },
173    { 00755, AID_ROOT,   AID_SHELL,  "system/vendor" },
174    { 00755, AID_ROOT,   AID_SHELL,  "system/xbin" },
175    { 00755, AID_ROOT,   AID_ROOT,   "system/etc/ppp" },
176    { 00777, AID_ROOT,   AID_ROOT,   "sdcard" },
177    { 00755, AID_ROOT,   AID_ROOT,   0 },
178};
179
180/* Rules for files.
181** These rules are applied based on "first match", so they
182** should start with the most specific path and work their
183** way up to the root. Prefixes ending in * denotes wildcard
184** and will allow partial matches.
185*/
186static struct fs_path_config android_files[] = {
187    { 00440, AID_ROOT,      AID_SHELL,     "system/etc/init.goldfish.rc" },
188    { 00550, AID_ROOT,      AID_SHELL,     "system/etc/init.goldfish.sh" },
189    { 00440, AID_ROOT,      AID_SHELL,     "system/etc/init.trout.rc" },
190    { 00550, AID_ROOT,      AID_SHELL,     "system/etc/init.ril" },
191    { 00550, AID_ROOT,      AID_SHELL,     "system/etc/init.testmenu" },
192    { 00550, AID_DHCP,      AID_SHELL,     "system/etc/dhcpcd/dhcpcd-run-hooks" },
193    { 00440, AID_BLUETOOTH, AID_BLUETOOTH, "system/etc/dbus.conf" },
194    { 00444, AID_RADIO,     AID_AUDIO,     "system/etc/AudioPara4.csv" },
195    { 00555, AID_ROOT,      AID_ROOT,      "system/etc/ppp/*" },
196    { 00555, AID_ROOT,      AID_ROOT,      "system/etc/rc.*" },
197    { 00644, AID_SYSTEM,    AID_SYSTEM,    "data/app/*" },
198    { 00644, AID_MEDIA_RW,  AID_MEDIA_RW,  "data/media/*" },
199    { 00644, AID_SYSTEM,    AID_SYSTEM,    "data/app-private/*" },
200    { 00644, AID_APP,       AID_APP,       "data/data/*" },
201        /* the following two files are INTENTIONALLY set-gid and not set-uid.
202         * Do not change. */
203    { 02755, AID_ROOT,      AID_NET_RAW,   "system/bin/ping" },
204    { 02750, AID_ROOT,      AID_INET,      "system/bin/netcfg" },
205    	/* the following five files are INTENTIONALLY set-uid, but they
206	 * are NOT included on user builds. */
207    { 06755, AID_ROOT,      AID_ROOT,      "system/xbin/su" },
208    { 06755, AID_ROOT,      AID_ROOT,      "system/xbin/librank" },
209    { 06755, AID_ROOT,      AID_ROOT,      "system/xbin/procrank" },
210    { 06755, AID_ROOT,      AID_ROOT,      "system/xbin/procmem" },
211    { 06755, AID_ROOT,      AID_ROOT,      "system/xbin/tcpdump" },
212    { 04770, AID_ROOT,      AID_RADIO,     "system/bin/pppd-ril" },
213		/* the following file is INTENTIONALLY set-uid, and IS included
214		 * in user builds. */
215    { 06750, AID_ROOT,      AID_SHELL,     "system/bin/run-as" },
216    { 00755, AID_ROOT,      AID_SHELL,     "system/bin/*" },
217    { 00755, AID_ROOT,      AID_ROOT,      "system/lib/valgrind/*" },
218    { 00755, AID_ROOT,      AID_SHELL,     "system/xbin/*" },
219    { 00755, AID_ROOT,      AID_SHELL,     "system/vendor/bin/*" },
220    { 00750, AID_ROOT,      AID_SHELL,     "sbin/*" },
221    { 00755, AID_ROOT,      AID_ROOT,      "bin/*" },
222    { 00750, AID_ROOT,      AID_SHELL,     "init*" },
223    { 00750, AID_ROOT,      AID_SHELL,     "charger*" },
224    { 00750, AID_ROOT,      AID_SHELL,     "sbin/fs_mgr" },
225    { 00640, AID_ROOT,      AID_SHELL,     "fstab.*" },
226    { 00644, AID_ROOT,      AID_ROOT,       0 },
227};
228
229static inline void fs_config(const char *path, int dir,
230                             unsigned *uid, unsigned *gid, unsigned *mode)
231{
232    struct fs_path_config *pc;
233    int plen;
234
235    pc = dir ? android_dirs : android_files;
236    plen = strlen(path);
237    for(; pc->prefix; pc++){
238        int len = strlen(pc->prefix);
239        if (dir) {
240            if(plen < len) continue;
241            if(!strncmp(pc->prefix, path, len)) break;
242            continue;
243        }
244        /* If name ends in * then allow partial matches. */
245        if (pc->prefix[len -1] == '*') {
246            if(!strncmp(pc->prefix, path, len - 1)) break;
247        } else if (plen == len){
248            if(!strncmp(pc->prefix, path, len)) break;
249        }
250    }
251    *uid = pc->uid;
252    *gid = pc->gid;
253    *mode = (*mode & (~07777)) | pc->mode;
254
255#if 0
256    fprintf(stderr,"< '%s' '%s' %d %d %o >\n",
257            path, pc->prefix ? pc->prefix : "", *uid, *gid, *mode);
258#endif
259}
260#endif
261#endif
262