cmds/installd/installd.h

   1 /*
   2 **
   3 ** Copyright 2008, The Android Open Source Project
   4 **
   5 ** Licensed under the Apache License, Version 2.0 (the "License");
   6 ** you may not use this file except in compliance with the License.
   7 ** You may obtain a copy of the License at
   8 **
   9 **     http://www.apache.org/licenses/LICENSE-2.0
  10 **
  11 ** Unless required by applicable law or agreed to in writing, software
  12 ** distributed under the License is distributed on an "AS IS" BASIS,
  13 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 ** See the License for the specific language governing permissions and
  15 ** limitations under the License.
  16 */
  17
  18 #define LOG_TAG "installd"
  19
  20 #include <stdio.h>
  21 #include <stdlib.h>
  22 #include <stdint.h>
  23 #include <inttypes.h>
  24 #include <sys/stat.h>
  25 #include <dirent.h>
  26 #include <unistd.h>
  27 #include <ctype.h>
  28 #include <fcntl.h>
  29 #include <errno.h>
  30 #include <utime.h>
  31 #include <sys/socket.h>
  32 #include <sys/types.h>
  33 #include <sys/wait.h>
  34
  35 #include <cutils/fs.h>
  36 #include <cutils/sockets.h>
  37 #include <cutils/log.h>
  38 #include <cutils/properties.h>
  39 #include <cutils/multiuser.h>
  40
  41 #include <private/android_filesystem_config.h>
  42
  43 #if INCLUDE_SYS_MOUNT_FOR_STATFS
  44 #include <sys/mount.h>
  45 #else
  46 #include <sys/statfs.h>
  47 #endif
  48
  49 #define SOCKET_PATH "installd"
  50
  51
  52 /* elements combined with a valid package name to form paths */
  53
  54 #define PRIMARY_USER_PREFIX    "data/"
  55 #define SECONDARY_USER_PREFIX  "user/"
  56
  57 #define PKG_DIR_POSTFIX        ""
  58
  59 #define PKG_LIB_POSTFIX        "/lib"
  60
  61 #define CACHE_DIR_POSTFIX      "/cache"
  62
  63 #define APP_SUBDIR             "app/" // sub-directory under ANDROID_DATA
  64
  65 #define APP_LIB_SUBDIR         "app-lib/" // sub-directory under ANDROID_DATA
  66
  67 #define MEDIA_SUBDIR           "media/" // sub-directory under ANDROID_DATA
  68
  69 /* other handy constants */
  70
  71 #define PRIVATE_APP_SUBDIR     "app-private/" // sub-directory under ANDROID_DATA
  72
  73 #define DALVIK_CACHE_PREFIX    "/data/dalvik-cache/"
  74 #define DALVIK_CACHE_POSTFIX   "/classes.dex"
  75
  76 #define UPDATE_COMMANDS_DIR_PREFIX  "/system/etc/updatecmds/"
  77
  78 #define PKG_NAME_MAX  128   /* largest allowed package name */
  79 #define PKG_PATH_MAX  256   /* max size of any path we use */
  80
  81 #define PER_USER_RANGE ((uid_t)100000)   /* range of uids per user
  82                                             uid = persona * PER_USER_RANGE + appid */
  83
  84 /* data structures */
  85
  86 typedef struct {
  87     char* path;
  88     size_t len;
  89 } dir_rec_t;
  90
  91 typedef struct {
  92     size_t count;
  93     dir_rec_t* dirs;
  94 } dir_rec_array_t;
  95
  96 extern dir_rec_t android_app_dir;
  97 extern dir_rec_t android_app_private_dir;
  98 extern dir_rec_t android_app_lib_dir;
  99 extern dir_rec_t android_data_dir;
 100 extern dir_rec_t android_asec_dir;
 101 extern dir_rec_t android_media_dir;
 102 extern dir_rec_array_t android_system_dirs;
 103
 104 typedef struct cache_dir_struct {
 105     struct cache_dir_struct* parent;
 106     int32_t childCount;
 107     int32_t hiddenCount;
 108     int32_t deleted;
 109     char name[];
 110 } cache_dir_t;
 111
 112 typedef struct {
 113     cache_dir_t* dir;
 114     time_t modTime;
 115     char name[];
 116 } cache_file_t;
 117
 118 typedef struct {
 119     size_t numDirs;
 120     size_t availDirs;
 121     cache_dir_t** dirs;
 122     size_t numFiles;
 123     size_t availFiles;
 124     cache_file_t** files;
 125     size_t numCollected;
 126     void* memBlocks;
 127     int8_t* curMemBlockAvail;
 128     int8_t* curMemBlockEnd;
 129 } cache_t;
 130
 131 /* util.c */
 132
 133 int create_pkg_path_in_dir(char path[PKG_PATH_MAX],
 134                                 const dir_rec_t* dir,
 135                                 const char* pkgname,
 136                                 const char* postfix);
 137
 138 int create_pkg_path(char path[PKG_PATH_MAX],
 139                     const char *pkgname,
 140                     const char *postfix,
 141                     uid_t persona);
 142
 143 int create_persona_path(char path[PKG_PATH_MAX],
 144                     uid_t persona);
 145
 146 int create_persona_media_path(char path[PKG_PATH_MAX], userid_t userid);
 147
 148 int create_move_path(char path[PKG_PATH_MAX],
 149                      const char* pkgname,
 150                      const char* leaf,
 151                      uid_t persona);
 152
 153 int is_valid_package_name(const char* pkgname);
 154
 155 int create_cache_path(char path[PKG_PATH_MAX], const char *src);
 156
 157 int delete_dir_contents(const char *pathname,
 158                         int also_delete_dir,
 159                         const char *ignore);
 160
 161 int delete_dir_contents_fd(int dfd, const char *name);
 162
 163 int lookup_media_dir(char basepath[PATH_MAX], const char *dir);
 164
 165 int64_t data_disk_free();
 166
 167 cache_t* start_cache_collection();
 168
 169 void add_cache_files(cache_t* cache, const char *basepath, const char *cachedir);
 170
 171 void clear_cache_files(cache_t* cache, int64_t free_size);
 172
 173 void finish_cache_collection(cache_t* cache);
 174
 175 int validate_system_app_path(const char* path);
 176
 177 int get_path_from_env(dir_rec_t* rec, const char* var);
 178
 179 int get_path_from_string(dir_rec_t* rec, const char* path);
 180
 181 int copy_and_append(dir_rec_t* dst, const dir_rec_t* src, const char* suffix);
 182
 183 int validate_apk_path(const char *path);
 184
 185 int append_and_increment(char** dst, const char* src, size_t* dst_size);
 186
 187 char *build_string2(char *s1, char *s2);
 188 char *build_string3(char *s1, char *s2, char *s3);
 189
 190 int ensure_dir(const char* path, mode_t mode, uid_t uid, gid_t gid);
 191 int ensure_media_user_dirs(userid_t userid);
 192
 193 /* commands.c */
 194
 195 int install(const char *pkgname, uid_t uid, gid_t gid, const char *seinfo);
 196 int uninstall(const char *pkgname, uid_t persona);
 197 int renamepkg(const char *oldpkgname, const char *newpkgname);
 198 int fix_uid(const char *pkgname, uid_t uid, gid_t gid);
 199 int delete_user_data(const char *pkgname, uid_t persona);
 200 int make_user_data(const char *pkgname, uid_t uid, uid_t persona);
 201 int delete_persona(uid_t persona);
 202 int delete_cache(const char *pkgname, uid_t persona);
 203 int move_dex(const char *src, const char *dst);
 204 int rm_dex(const char *path);
 205 int protect(char *pkgname, gid_t gid);
 206 int get_size(const char *pkgname, int persona, const char *apkpath, const char *libdirpath,
 207              const char *fwdlock_apkpath, const char *asecpath, int64_t *codesize,
 208              int64_t *datasize, int64_t *cachesize, int64_t *asecsize);
 209 int free_cache(int64_t free_size);
 210 int dexopt(const char *apk_path, uid_t uid, int is_public);
 211 int movefiles();
 212 int linklib(const char* target, const char* source, int userId);