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