Home | History | Annotate | Download | only in private
      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 
     76 #define AID_SHELL         2000  /* adb and debug shell user */
     77 #define AID_CACHE         2001  /* cache access */
     78 #define AID_DIAG          2002  /* access to diagnostic resources */
     79 
     80 /* The 3000 series are intended for use as supplemental group id's only.
     81  * They indicate special Android capabilities that the kernel is aware of. */
     82 #define AID_NET_BT_ADMIN  3001  /* bluetooth: create any socket */
     83 #define AID_NET_BT        3002  /* bluetooth: create sco, rfcomm or l2cap sockets */
     84 #define AID_INET          3003  /* can create AF_INET and AF_INET6 sockets */
     85 #define AID_NET_RAW       3004  /* can create raw INET sockets */
     86 #define AID_NET_ADMIN     3005  /* can configure interfaces and routing tables. */
     87 #define AID_NET_BW_STATS  3006  /* read bandwidth statistics */
     88 #define AID_NET_BW_ACCT   3007  /* change bandwidth statistics accounting */
     89 #define AID_NET_BT_STACK  3008  /* bluetooth: access config files */
     90 
     91 #define AID_MISC          9998  /* access to misc storage */
     92 #define AID_NOBODY        9999
     93 
     94 #define AID_APP          10000  /* first app user */
     95 
     96 #define AID_ISOLATED_START 99000 /* start of uids for fully isolated sandboxed processes */
     97 #define AID_ISOLATED_END   99999 /* end of uids for fully isolated sandboxed processes */
     98 
     99 #define AID_USER        100000  /* offset for uid ranges for each user */
    100 
    101 #define AID_SHARED_GID_START 50000 /* start of gids for apps in each user to share */
    102 #define AID_SHARED_GID_END   59999 /* start of gids for apps in each user to share */
    103 
    104 #if !defined(EXCLUDE_FS_CONFIG_STRUCTURES)
    105 struct android_id_info {
    106     const char *name;
    107     unsigned aid;
    108 };
    109 
    110 static const struct android_id_info android_ids[] = {
    111     { "root",      AID_ROOT, },
    112     { "system",    AID_SYSTEM, },
    113     { "radio",     AID_RADIO, },
    114     { "bluetooth", AID_BLUETOOTH, },
    115     { "graphics",  AID_GRAPHICS, },
    116     { "input",     AID_INPUT, },
    117     { "audio",     AID_AUDIO, },
    118     { "camera",    AID_CAMERA, },
    119     { "log",       AID_LOG, },
    120     { "compass",   AID_COMPASS, },
    121     { "mount",     AID_MOUNT, },
    122     { "wifi",      AID_WIFI, },
    123     { "dhcp",      AID_DHCP, },
    124     { "adb",       AID_ADB, },
    125     { "install",   AID_INSTALL, },
    126     { "media",     AID_MEDIA, },
    127     { "drm",       AID_DRM, },
    128     { "mdnsr",     AID_MDNSR, },
    129     { "nfc",       AID_NFC, },
    130     { "drmrpc",    AID_DRMRPC, },
    131     { "shell",     AID_SHELL, },
    132     { "cache",     AID_CACHE, },
    133     { "diag",      AID_DIAG, },
    134     { "net_bt_admin", AID_NET_BT_ADMIN, },
    135     { "net_bt",    AID_NET_BT, },
    136     { "net_bt_stack",    AID_NET_BT_STACK, },
    137     { "sdcard_r",  AID_SDCARD_R, },
    138     { "sdcard_rw", AID_SDCARD_RW, },
    139     { "media_rw",  AID_MEDIA_RW, },
    140     { "vpn",       AID_VPN, },
    141     { "keystore",  AID_KEYSTORE, },
    142     { "usb",       AID_USB, },
    143     { "mtp",       AID_MTP, },
    144     { "gps",       AID_GPS, },
    145     { "inet",      AID_INET, },
    146     { "net_raw",   AID_NET_RAW, },
    147     { "net_admin", AID_NET_ADMIN, },
    148     { "net_bw_stats", AID_NET_BW_STATS, },
    149     { "net_bw_acct", AID_NET_BW_ACCT, },
    150     { "loop_radio", AID_LOOP_RADIO, },
    151     { "misc",      AID_MISC, },
    152     { "nobody",    AID_NOBODY, },
    153     { "clat",      AID_CLAT, },
    154     { "mediadrm",  AID_MEDIA_DRM, },
    155 };
    156 
    157 #define android_id_count \
    158     (sizeof(android_ids) / sizeof(android_ids[0]))
    159 
    160 struct fs_path_config {
    161     unsigned mode;
    162     unsigned uid;
    163     unsigned gid;
    164     uint64_t capabilities;
    165     const char *prefix;
    166 };
    167 
    168 /* Rules for directories.
    169 ** These rules are applied based on "first match", so they
    170 ** should start with the most specific path and work their
    171 ** way up to the root.
    172 */
    173 
    174 static const struct fs_path_config android_dirs[] = {
    175     { 00770, AID_SYSTEM, AID_CACHE,  0, "cache" },
    176     { 00771, AID_SYSTEM, AID_SYSTEM, 0, "data/app" },
    177     { 00771, AID_SYSTEM, AID_SYSTEM, 0, "data/app-private" },
    178     { 00771, AID_SYSTEM, AID_SYSTEM, 0, "data/dalvik-cache" },
    179     { 00771, AID_SYSTEM, AID_SYSTEM, 0, "data/data" },
    180     { 00771, AID_SHELL,  AID_SHELL,  0, "data/local/tmp" },
    181     { 00771, AID_SHELL,  AID_SHELL,  0, "data/local" },
    182     { 01771, AID_SYSTEM, AID_MISC,   0, "data/misc" },
    183     { 00770, AID_DHCP,   AID_DHCP,   0, "data/misc/dhcp" },
    184     { 00775, AID_MEDIA_RW, AID_MEDIA_RW, 0, "data/media" },
    185     { 00775, AID_MEDIA_RW, AID_MEDIA_RW, 0, "data/media/Music" },
    186     { 00771, AID_SYSTEM, AID_SYSTEM, 0, "data" },
    187     { 00750, AID_ROOT,   AID_SHELL,  0, "sbin" },
    188     { 00755, AID_ROOT,   AID_SHELL,  0, "system/bin" },
    189     { 00755, AID_ROOT,   AID_SHELL,  0, "system/vendor" },
    190     { 00755, AID_ROOT,   AID_SHELL,  0, "system/xbin" },
    191     { 00755, AID_ROOT,   AID_ROOT,   0, "system/etc/ppp" },
    192     { 00755, AID_ROOT,   AID_SHELL,  0, "vendor" },
    193     { 00777, AID_ROOT,   AID_ROOT,   0, "sdcard" },
    194     { 00755, AID_ROOT,   AID_ROOT,   0, 0 },
    195 };
    196 
    197 /* Rules for files.
    198 ** These rules are applied based on "first match", so they
    199 ** should start with the most specific path and work their
    200 ** way up to the root. Prefixes ending in * denotes wildcard
    201 ** and will allow partial matches.
    202 */
    203 static const struct fs_path_config android_files[] = {
    204     { 00440, AID_ROOT,      AID_SHELL,     0, "system/etc/init.goldfish.rc" },
    205     { 00550, AID_ROOT,      AID_SHELL,     0, "system/etc/init.goldfish.sh" },
    206     { 00440, AID_ROOT,      AID_SHELL,     0, "system/etc/init.trout.rc" },
    207     { 00550, AID_ROOT,      AID_SHELL,     0, "system/etc/init.ril" },
    208     { 00550, AID_ROOT,      AID_SHELL,     0, "system/etc/init.testmenu" },
    209     { 00550, AID_DHCP,      AID_SHELL,     0, "system/etc/dhcpcd/dhcpcd-run-hooks" },
    210     { 00444, AID_RADIO,     AID_AUDIO,     0, "system/etc/AudioPara4.csv" },
    211     { 00555, AID_ROOT,      AID_ROOT,      0, "system/etc/ppp/*" },
    212     { 00555, AID_ROOT,      AID_ROOT,      0, "system/etc/rc.*" },
    213     { 00644, AID_SYSTEM,    AID_SYSTEM,    0, "data/app/*" },
    214     { 00644, AID_MEDIA_RW,  AID_MEDIA_RW,  0, "data/media/*" },
    215     { 00644, AID_SYSTEM,    AID_SYSTEM,    0, "data/app-private/*" },
    216     { 00644, AID_APP,       AID_APP,       0, "data/data/*" },
    217     { 00755, AID_ROOT,      AID_ROOT,      0, "system/bin/ping" },
    218 
    219     /* the following file is INTENTIONALLY set-gid and not set-uid.
    220      * Do not change. */
    221     { 02750, AID_ROOT,      AID_INET,      0, "system/bin/netcfg" },
    222 
    223     /* the following five files are INTENTIONALLY set-uid, but they
    224      * are NOT included on user builds. */
    225     { 06755, AID_ROOT,      AID_ROOT,      0, "system/xbin/su" },
    226     { 06755, AID_ROOT,      AID_ROOT,      0, "system/xbin/librank" },
    227     { 06755, AID_ROOT,      AID_ROOT,      0, "system/xbin/procrank" },
    228     { 06755, AID_ROOT,      AID_ROOT,      0, "system/xbin/procmem" },
    229     { 06755, AID_ROOT,      AID_ROOT,      0, "system/xbin/tcpdump" },
    230     { 04770, AID_ROOT,      AID_RADIO,     0, "system/bin/pppd-ril" },
    231 
    232     /* the following file has enhanced capabilities and IS included in user builds. */
    233     { 00750, AID_ROOT,      AID_SHELL,     (1 << CAP_SETUID) | (1 << CAP_SETGID), "system/bin/run-as" },
    234 
    235     { 00755, AID_ROOT,      AID_SHELL,     0, "system/bin/*" },
    236     { 00755, AID_ROOT,      AID_ROOT,      0, "system/lib/valgrind/*" },
    237     { 00755, AID_ROOT,      AID_SHELL,     0, "system/xbin/*" },
    238     { 00755, AID_ROOT,      AID_SHELL,     0, "system/vendor/bin/*" },
    239     { 00755, AID_ROOT,      AID_SHELL,     0, "vendor/bin/*" },
    240     { 00750, AID_ROOT,      AID_SHELL,     0, "sbin/*" },
    241     { 00755, AID_ROOT,      AID_ROOT,      0, "bin/*" },
    242     { 00750, AID_ROOT,      AID_SHELL,     0, "init*" },
    243     { 00750, AID_ROOT,      AID_SHELL,     0, "charger*" },
    244     { 00750, AID_ROOT,      AID_SHELL,     0, "sbin/fs_mgr" },
    245     { 00640, AID_ROOT,      AID_SHELL,     0, "fstab.*" },
    246     { 00644, AID_ROOT,      AID_ROOT,      0, 0 },
    247 };
    248 
    249 static inline void fs_config(const char *path, int dir,
    250                              unsigned *uid, unsigned *gid, unsigned *mode, uint64_t *capabilities)
    251 {
    252     const struct fs_path_config *pc;
    253     int plen;
    254 
    255     if (path[0] == '/') {
    256         path++;
    257     }
    258 
    259     pc = dir ? android_dirs : android_files;
    260     plen = strlen(path);
    261     for(; pc->prefix; pc++){
    262         int len = strlen(pc->prefix);
    263         if (dir) {
    264             if(plen < len) continue;
    265             if(!strncmp(pc->prefix, path, len)) break;
    266             continue;
    267         }
    268         /* If name ends in * then allow partial matches. */
    269         if (pc->prefix[len -1] == '*') {
    270             if(!strncmp(pc->prefix, path, len - 1)) break;
    271         } else if (plen == len){
    272             if(!strncmp(pc->prefix, path, len)) break;
    273         }
    274     }
    275     *uid = pc->uid;
    276     *gid = pc->gid;
    277     *mode = (*mode & (~07777)) | pc->mode;
    278     *capabilities = pc->capabilities;
    279 
    280 #if 0
    281     fprintf(stderr,"< '%s' '%s' %d %d %o >\n",
    282             path, pc->prefix ? pc->prefix : "", *uid, *gid, *mode);
    283 #endif
    284 }
    285 #endif
    286 #endif
    287