installd.h revision 86c9584559439504fc57ece2ccd9b6cbd568430c 
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/* data structures */
76
77typedef struct {
78    char* path;
79    size_t len;
80} dir_rec_t;
81
82typedef struct {
83    size_t count;
84    dir_rec_t* dirs;
85} dir_rec_array_t;
86
87extern dir_rec_t android_app_dir;
88extern dir_rec_t android_app_private_dir;
89extern dir_rec_t android_data_dir;
90extern dir_rec_t android_asec_dir;
91extern dir_rec_array_t android_system_dirs;
92
93/* util.c */
94
95int create_pkg_path_in_dir(char path[PKG_PATH_MAX],
96                                const dir_rec_t* dir,
97                                const char* pkgname,
98                                const char* postfix);
99
100int create_pkg_path(char path[PKG_PATH_MAX],
101                    const char *pkgname,
102                    const char *postfix,
103                    uid_t persona);
104
105int is_valid_package_name(const char* pkgname);
106
107int create_cache_path(char path[PKG_PATH_MAX], const char *src);
108
109int delete_dir_contents(const char *pathname,
110                        int also_delete_dir,
111                        const char *ignore);
112
113int delete_dir_contents_fd(int dfd, const char *name);
114
115int validate_system_app_path(const char* path);
116
117int get_path_from_env(dir_rec_t* rec, const char* var);
118
119int get_path_from_string(dir_rec_t* rec, const char* path);
120
121int copy_and_append(dir_rec_t* dst, const dir_rec_t* src, const char* suffix);
122
123int validate_apk_path(const char *path);
124
125int append_and_increment(char** dst, const char* src, size_t* dst_size);
126
127/* commands.c */
128
129int install(const char *pkgname, uid_t uid, gid_t gid);
130int uninstall(const char *pkgname);
131int renamepkg(const char *oldpkgname, const char *newpkgname);
132int delete_user_data(const char *pkgname);
133int delete_cache(const char *pkgname);
134int move_dex(const char *src, const char *dst);
135int rm_dex(const char *path);
136int protect(char *pkgname, gid_t gid);
137int get_size(const char *pkgname, const char *apkpath, const char *fwdlock_apkpath,
138             int64_t *codesize, int64_t *datasize, int64_t *cachesize);
139int free_cache(int64_t free_size);
140int dexopt(const char *apk_path, uid_t uid, int is_public);
141int movefiles();
142int linklib(const char* target, const char* source);
143int unlinklib(const char* libPath);
144