installd.h revision d845c96128a40ca5802c0840ae190fa0af7d4735 
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#include <string>
35#include <vector>
36
37#include <cutils/fs.h>
38#include <cutils/sockets.h>
39#include <cutils/log.h>
40#include <cutils/properties.h>
41#include <cutils/multiuser.h>
42
43#include <private/android_filesystem_config.h>
44
45#if defined(__APPLE__)
46#include <sys/mount.h>
47#else
48#include <sys/statfs.h>
49#endif
50
51#define SOCKET_PATH "installd"
52
53
54/* elements combined with a valid package name to form paths */
55
56#define PRIMARY_USER_PREFIX    "data/"
57#define SECONDARY_USER_PREFIX  "user/"
58
59#define PKG_DIR_POSTFIX        ""
60
61#define PKG_LIB_POSTFIX        "/lib"
62
63#define CACHE_DIR_POSTFIX      "/cache"
64#define CODE_CACHE_DIR_POSTFIX "/code_cache"
65
66#define APP_SUBDIR             "app/" // sub-directory under ANDROID_DATA
67#define PRIV_APP_SUBDIR        "priv-app/" // sub-directory under ANDROID_DATA
68
69#define APP_LIB_SUBDIR         "app-lib/" // sub-directory under ANDROID_DATA
70
71#define MEDIA_SUBDIR           "media/" // sub-directory under ANDROID_DATA
72
73/* other handy constants */
74
75#define PRIVATE_APP_SUBDIR     "app-private/" // sub-directory under ANDROID_DATA
76
77#define DALVIK_CACHE_PREFIX    "/data/dalvik-cache/"
78#define DALVIK_CACHE_POSTFIX   "/classes.dex"
79
80#define UPDATE_COMMANDS_DIR_PREFIX  "/system/etc/updatecmds/"
81
82#define IDMAP_PREFIX           "/data/resource-cache/"
83#define IDMAP_SUFFIX           "@idmap"
84
85#define PKG_NAME_MAX  128   /* largest allowed package name */
86#define PKG_PATH_MAX  256   /* max size of any path we use */
87
88/* dexopt needed flags matching those in dalvik.system.DexFile */
89#define DEXOPT_DEX2OAT_NEEDED        1
90#define DEXOPT_PATCHOAT_NEEDED       2
91#define DEXOPT_SELF_PATCHOAT_NEEDED  3
92
93#define ARRAY_SIZE(a) (sizeof(a) / sizeof(*(a)))
94
95/* data structures */
96
97typedef struct {
98    char* path;
99    size_t len;
100} dir_rec_t;
101
102typedef struct {
103    size_t count;
104    dir_rec_t* dirs;
105} dir_rec_array_t;
106
107extern dir_rec_t android_app_dir;
108extern dir_rec_t android_app_private_dir;
109extern dir_rec_t android_app_lib_dir;
110extern dir_rec_t android_data_dir;
111extern dir_rec_t android_asec_dir;
112extern dir_rec_t android_media_dir;
113extern dir_rec_t android_mnt_expand_dir;
114extern dir_rec_array_t android_system_dirs;
115
116typedef struct cache_dir_struct {
117    struct cache_dir_struct* parent;
118    int32_t childCount;
119    int32_t hiddenCount;
120    int32_t deleted;
121    char name[];
122} cache_dir_t;
123
124typedef struct {
125    cache_dir_t* dir;
126    time_t modTime;
127    char name[];
128} cache_file_t;
129
130typedef struct {
131    size_t numDirs;
132    size_t availDirs;
133    cache_dir_t** dirs;
134    size_t numFiles;
135    size_t availFiles;
136    cache_file_t** files;
137    size_t numCollected;
138    void* memBlocks;
139    int8_t* curMemBlockAvail;
140    int8_t* curMemBlockEnd;
141} cache_t;
142
143/* util.c */
144
145int create_pkg_path(char path[PKG_PATH_MAX],
146                    const char *pkgname,
147                    const char *postfix,
148                    userid_t userid);
149
150std::string create_data_path(const char* volume_uuid);
151
152std::string create_data_app_path(const char* volume_uuid);
153
154std::string create_data_app_package_path(const char* volume_uuid, const char* package_name);
155
156std::string create_data_user_path(const char* volume_uuid, userid_t userid);
157
158std::string create_data_user_package_path(const char* volume_uuid,
159        userid_t user, const char* package_name);
160
161std::string create_data_media_path(const char* volume_uuid, userid_t userid);
162
163std::vector<userid_t> get_known_users(const char* volume_uuid);
164
165int create_user_config_path(char path[PKG_PATH_MAX], userid_t userid);
166
167int create_move_path(char path[PKG_PATH_MAX],
168                     const char* pkgname,
169                     const char* leaf,
170                     userid_t userid);
171
172int is_valid_package_name(const char* pkgname);
173
174int create_cache_path(char path[PKG_PATH_MAX], const char *src,
175                      const char *instruction_set);
176
177int delete_dir_contents(const char *pathname,
178                        int also_delete_dir,
179                        int (*exclusion_predicate)(const char *name, const int is_dir));
180
181int delete_dir_contents_fd(int dfd, const char *name);
182
183int copy_dir_files(const char *srcname, const char *dstname, uid_t owner, gid_t group);
184
185int lookup_media_dir(char basepath[PATH_MAX], const char *dir);
186
187int64_t data_disk_free(const std::string& data_path);
188
189cache_t* start_cache_collection();
190
191void add_cache_files(cache_t* cache, const char *basepath, const char *cachedir);
192
193void clear_cache_files(const std::string& data_path, cache_t* cache, int64_t free_size);
194
195void finish_cache_collection(cache_t* cache);
196
197int validate_system_app_path(const char* path);
198
199int get_path_from_env(dir_rec_t* rec, const char* var);
200
201int get_path_from_string(dir_rec_t* rec, const char* path);
202
203int copy_and_append(dir_rec_t* dst, const dir_rec_t* src, const char* suffix);
204
205int validate_apk_path(const char *path);
206int validate_apk_path_subdirs(const char *path);
207
208int append_and_increment(char** dst, const char* src, size_t* dst_size);
209
210char *build_string2(const char *s1, const char *s2);
211char *build_string3(const char *s1, const char *s2, const char *s3);
212
213int ensure_dir(const char* path, mode_t mode, uid_t uid, gid_t gid);
214int ensure_media_user_dirs(const char* uuid, userid_t userid);
215int ensure_config_user_dirs(userid_t userid);
216int create_profile_file(const char *pkgname, gid_t gid);
217void remove_profile_file(const char *pkgname);
218
219/* commands.c */
220
221int install(const char *uuid, const char *pkgname, uid_t uid, gid_t gid, const char *seinfo);
222int uninstall(const char *uuid, const char *pkgname, userid_t userid);
223int renamepkg(const char *oldpkgname, const char *newpkgname);
224int fix_uid(const char *uuid, const char *pkgname, uid_t uid, gid_t gid);
225int delete_user_data(const char *uuid, const char *pkgname, userid_t userid);
226int make_user_data(const char *uuid, const char *pkgname, uid_t uid,
227        userid_t userid, const char* seinfo);
228int move_complete_app(const char* from_uuid, const char *to_uuid,
229        const char *package_name, const char *data_app_name, appid_t appid,
230        const char* seinfo);
231int make_user_config(userid_t userid);
232int delete_user(const char *uuid, userid_t userid);
233int delete_cache(const char *uuid, const char *pkgname, userid_t userid);
234int delete_code_cache(const char *uuid, const char *pkgname, userid_t userid);
235int move_dex(const char *src, const char *dst, const char *instruction_set);
236int rm_dex(const char *path, const char *instruction_set);
237int protect(char *pkgname, gid_t gid);
238int get_size(const char *uuid, const char *pkgname, int userid,
239        const char *apkpath, const char *libdirpath,
240        const char *fwdlock_apkpath, const char *asecpath,
241        const char *instruction_set, int64_t *codesize, int64_t *datasize,
242        int64_t *cachesize, int64_t *asecsize);
243int free_cache(const char *uuid, int64_t free_size);
244int dexopt(const char *apk_path, uid_t uid, bool is_public, const char *pkgName,
245           const char *instruction_set, int dexopt_needed, bool vm_safe_mode,
246           bool debuggable, const char* oat_dir);
247int mark_boot_complete(const char *instruction_set);
248int movefiles();
249int linklib(const char* uuid, const char* pkgname, const char* asecLibDir, int userId);
250int idmap(const char *target_path, const char *overlay_path, uid_t uid);
251int restorecon_data(const char *uuid, const char* pkgName, const char* seinfo, uid_t uid);
252int create_oat_dir(const char* oat_dir, const char *instruction_set);
253int rm_package_dir(const char* apk_path);
254int calculate_oat_file_path(char path[PKG_PATH_MAX], const char *oat_dir, const char *apk_path,
255                            const char *instruction_set);
256int move_package_dir(char path[PKG_PATH_MAX], const char *oat_dir, const char *apk_path,
257                            const char *instruction_set);
258int link_file(const char *relative_path, const char *from_base, const char *to_base);
259