installd.h revision d0c5f515c05d05c9d24971695337daf9d6ce409c 
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/sockets.h>
36#include <cutils/log.h>
37#include <cutils/properties.h>
38
39#include <private/android_filesystem_config.h>
40
41#if INCLUDE_SYS_MOUNT_FOR_STATFS
42#include <sys/mount.h>
43#else
44#include <sys/statfs.h>
45#endif
46
47#define SOCKET_PATH "installd"
48
49
50/* elements combined with a valid package name to form paths */
51
52#define PRIMARY_USER_PREFIX    "data/"
53#define SECONDARY_USER_PREFIX  "user/"
54
55#define PKG_DIR_POSTFIX        ""
56
57#define PKG_LIB_POSTFIX        "/lib"
58
59#define CACHE_DIR_POSTFIX      "/cache"
60
61#define APP_SUBDIR             "app/" // sub-directory under ANDROID_DATA
62
63/* other handy constants */
64
65#define PRIVATE_APP_SUBDIR     "app-private/" // sub-directory under ANDROID_DATA
66
67#define DALVIK_CACHE_PREFIX    "/data/dalvik-cache/"
68#define DALVIK_CACHE_POSTFIX   "/classes.dex"
69
70#define UPDATE_COMMANDS_DIR_PREFIX  "/system/etc/updatecmds/"
71
72#define PKG_NAME_MAX  128   /* largest allowed package name */
73#define PKG_PATH_MAX  256   /* max size of any path we use */
74
75#define PER_USER_RANGE ((uid_t)100000)   /* range of uids per user
76                                            uid = persona * PER_USER_RANGE + appid */
77
78/* data structures */
79
80typedef struct {
81    char* path;
82    size_t len;
83} dir_rec_t;
84
85typedef struct {
86    size_t count;
87    dir_rec_t* dirs;
88} dir_rec_array_t;
89
90extern dir_rec_t android_app_dir;
91extern dir_rec_t android_app_private_dir;
92extern dir_rec_t android_data_dir;
93extern dir_rec_t android_asec_dir;
94extern dir_rec_array_t android_system_dirs;
95
96/* util.c */
97
98int create_pkg_path_in_dir(char path[PKG_PATH_MAX],
99                                const dir_rec_t* dir,
100                                const char* pkgname,
101                                const char* postfix);
102
103int create_pkg_path(char path[PKG_PATH_MAX],
104                    const char *pkgname,
105                    const char *postfix,
106                    uid_t persona);
107
108int create_persona_path(char path[PKG_PATH_MAX],
109                    uid_t persona);
110
111int create_move_path(char path[PKG_PATH_MAX],
112                     const char* pkgname,
113                     const char* leaf,
114                     uid_t persona);
115
116int is_valid_package_name(const char* pkgname);
117
118int create_cache_path(char path[PKG_PATH_MAX], const char *src);
119
120int delete_dir_contents(const char *pathname,
121                        int also_delete_dir,
122                        const char *ignore);
123
124int delete_dir_contents_fd(int dfd, const char *name);
125
126int validate_system_app_path(const char* path);
127
128int get_path_from_env(dir_rec_t* rec, const char* var);
129
130int get_path_from_string(dir_rec_t* rec, const char* path);
131
132int copy_and_append(dir_rec_t* dst, const dir_rec_t* src, const char* suffix);
133
134int validate_apk_path(const char *path);
135
136int append_and_increment(char** dst, const char* src, size_t* dst_size);
137
138char *build_string2(char *s1, char *s2);
139char *build_string3(char *s1, char *s2, char *s3);
140
141/* commands.c */
142
143int install(const char *pkgname, uid_t uid, gid_t gid);
144int uninstall(const char *pkgname, uid_t persona);
145int renamepkg(const char *oldpkgname, const char *newpkgname);
146int fix_uid(const char *pkgname, uid_t uid, gid_t gid);
147int delete_user_data(const char *pkgname, uid_t persona);
148int make_user_data(const char *pkgname, uid_t uid, uid_t persona);
149int delete_persona(uid_t persona);
150int clone_persona_data(uid_t src_persona, uid_t target_persona, int copy);
151int delete_cache(const char *pkgname);
152int move_dex(const char *src, const char *dst);
153int rm_dex(const char *path);
154int protect(char *pkgname, gid_t gid);
155int get_size(const char *pkgname, const char *apkpath, const char *fwdlock_apkpath,
156             const char *asecpath, int64_t *codesize, int64_t *datasize, int64_t *cachesize,
157             int64_t *asecsize);
158int free_cache(int64_t free_size);
159int dexopt(const char *apk_path, uid_t uid, int is_public);
160int movefiles();
161int linklib(const char* target, const char* source);
162int unlinklib(const char* libPath);
163