installd.h revision 19803807cd7ae01868fcfa50305f4a7dd13765e2 
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 defined(__APPLE__)
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#define CODE_CACHE_DIR_POSTFIX "/code_cache"
63
64#define APP_SUBDIR             "app/" // sub-directory under ANDROID_DATA
65#define PRIV_APP_SUBDIR        "priv-app/" // sub-directory under ANDROID_DATA
66
67#define APP_LIB_SUBDIR         "app-lib/" // sub-directory under ANDROID_DATA
68
69#define MEDIA_SUBDIR           "media/" // sub-directory under ANDROID_DATA
70
71/* other handy constants */
72
73#define PRIVATE_APP_SUBDIR     "app-private/" // sub-directory under ANDROID_DATA
74
75#define DALVIK_CACHE_PREFIX    "/data/dalvik-cache/"
76#define DALVIK_CACHE_POSTFIX   "/classes.dex"
77
78#define UPDATE_COMMANDS_DIR_PREFIX  "/system/etc/updatecmds/"
79
80#define IDMAP_PREFIX           "/data/resource-cache/"
81#define IDMAP_SUFFIX           "@idmap"
82
83#define PKG_NAME_MAX  128   /* largest allowed package name */
84#define PKG_PATH_MAX  256   /* max size of any path we use */
85
86/* data structures */
87
88typedef struct {
89    char* path;
90    size_t len;
91} dir_rec_t;
92
93typedef struct {
94    size_t count;
95    dir_rec_t* dirs;
96} dir_rec_array_t;
97
98extern dir_rec_t android_app_dir;
99extern dir_rec_t android_app_private_dir;
100extern dir_rec_t android_app_lib_dir;
101extern dir_rec_t android_data_dir;
102extern dir_rec_t android_asec_dir;
103extern dir_rec_t android_media_dir;
104extern dir_rec_t android_mnt_expand_dir;
105extern dir_rec_array_t android_system_dirs;
106
107typedef struct cache_dir_struct {
108    struct cache_dir_struct* parent;
109    int32_t childCount;
110    int32_t hiddenCount;
111    int32_t deleted;
112    char name[];
113} cache_dir_t;
114
115typedef struct {
116    cache_dir_t* dir;
117    time_t modTime;
118    char name[];
119} cache_file_t;
120
121typedef struct {
122    size_t numDirs;
123    size_t availDirs;
124    cache_dir_t** dirs;
125    size_t numFiles;
126    size_t availFiles;
127    cache_file_t** files;
128    size_t numCollected;
129    void* memBlocks;
130    int8_t* curMemBlockAvail;
131    int8_t* curMemBlockEnd;
132} cache_t;
133
134/* util.c */
135
136int create_pkg_path_in_dir(char path[PKG_PATH_MAX],
137                                const dir_rec_t* dir,
138                                const char* pkgname,
139                                const char* postfix);
140
141int create_pkg_path(char path[PKG_PATH_MAX],
142                    const char *pkgname,
143                    const char *postfix,
144                    userid_t userid);
145
146int create_user_path(char path[PKG_PATH_MAX],
147                    userid_t userid);
148
149int create_user_media_path(char path[PKG_PATH_MAX], userid_t userid);
150
151int create_user_config_path(char path[PKG_PATH_MAX], userid_t userid);
152
153int create_move_path(char path[PKG_PATH_MAX],
154                     const char* pkgname,
155                     const char* leaf,
156                     userid_t userid);
157
158int is_valid_package_name(const char* pkgname);
159
160int create_cache_path(char path[PKG_PATH_MAX], const char *src,
161                      const char *instruction_set);
162
163int delete_dir_contents(const char *pathname,
164                        int also_delete_dir,
165                        int (*exclusion_predicate)(const char *name, const int is_dir));
166
167int delete_dir_contents_fd(int dfd, const char *name);
168
169int copy_dir_files(const char *srcname, const char *dstname, uid_t owner, gid_t group);
170
171int lookup_media_dir(char basepath[PATH_MAX], const char *dir);
172
173int64_t data_disk_free();
174
175cache_t* start_cache_collection();
176
177void add_cache_files(cache_t* cache, const char *basepath, const char *cachedir);
178
179void clear_cache_files(cache_t* cache, int64_t free_size);
180
181void finish_cache_collection(cache_t* cache);
182
183int validate_system_app_path(const char* path);
184
185int get_path_from_env(dir_rec_t* rec, const char* var);
186
187int get_path_from_string(dir_rec_t* rec, const char* path);
188
189int copy_and_append(dir_rec_t* dst, const dir_rec_t* src, const char* suffix);
190
191int validate_apk_path(const char *path);
192
193int append_and_increment(char** dst, const char* src, size_t* dst_size);
194
195char *build_string2(const char *s1, const char *s2);
196char *build_string3(const char *s1, const char *s2, const char *s3);
197
198int ensure_dir(const char* path, mode_t mode, uid_t uid, gid_t gid);
199int ensure_media_user_dirs(userid_t userid);
200int ensure_config_user_dirs(userid_t userid);
201int create_profile_file(const char *pkgname, gid_t gid);
202void remove_profile_file(const char *pkgname);
203
204/* commands.c */
205
206int install(const char *pkgname, uid_t uid, gid_t gid, const char *seinfo);
207int uninstall(const char *pkgname, userid_t userid);
208int renamepkg(const char *oldpkgname, const char *newpkgname);
209int fix_uid(const char *pkgname, uid_t uid, gid_t gid);
210int delete_user_data(const char *pkgname, userid_t userid);
211int make_user_data(const char *pkgname, uid_t uid, userid_t userid, const char* seinfo);
212int make_user_config(userid_t userid);
213int delete_user(userid_t userid);
214int delete_cache(const char *pkgname, userid_t userid);
215int delete_code_cache(const char *pkgname, userid_t userid);
216int move_dex(const char *src, const char *dst, const char *instruction_set);
217int rm_dex(const char *path, const char *instruction_set);
218int protect(char *pkgname, gid_t gid);
219int get_size(const char *pkgname, userid_t userid, const char *apkpath, const char *libdirpath,
220             const char *fwdlock_apkpath, const char *asecpath, const char *instruction_set,
221             int64_t *codesize, int64_t *datasize, int64_t *cachesize, int64_t *asecsize);
222int free_cache(int64_t free_size);
223int dexopt(const char *apk_path, uid_t uid, bool is_public, const char *pkgName,
224           const char *instruction_set, bool vm_safe_mode, bool should_relocate, bool debuggable,
225           const char* outputPath);
226int mark_boot_complete(const char *instruction_set);
227int movefiles();
228int linklib(const char* target, const char* source, int userId);
229int idmap(const char *target_path, const char *overlay_path, uid_t uid);
230int restorecon_data(const char* pkgName, const char* seinfo, uid_t uid);
231int create_oat_dir(const char* oat_dir, const char *instruction_set);
232int rm_package_dir(const char* apk_path);
233int calculate_oat_file_path(char path[PKG_PATH_MAX], const char *oat_dir, const char *apk_path,
234                            const char *instruction_set);
235