Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2014 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | package com.android.internal.os; |
| 18 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 19 | import static android.system.OsConstants.O_CLOEXEC; |
| 20 | |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 21 | import static com.android.internal.os.ZygoteConnectionConstants.MAX_ZYGOTE_ARGC; |
| 22 | |
Martijn Coenen | 4b98816 | 2019-01-28 13:58:45 +0100 | [diff] [blame] | 23 | import android.content.pm.ApplicationInfo; |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 24 | import android.net.Credentials; |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 25 | import android.net.LocalServerSocket; |
| 26 | import android.net.LocalSocket; |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 27 | import android.os.FactoryTest; |
Jeff Sharkey | ace874b | 2017-09-07 15:27:33 -0600 | [diff] [blame] | 28 | import android.os.IVold; |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 29 | import android.os.Process; |
| 30 | import android.os.SystemProperties; |
Narayan Kamath | fbb32f6 | 2015-06-12 15:34:35 +0100 | [diff] [blame] | 31 | import android.os.Trace; |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 32 | import android.provider.DeviceConfig; |
Elliott Hughes | 860c591 | 2014-04-28 19:19:13 -0700 | [diff] [blame] | 33 | import android.system.ErrnoException; |
| 34 | import android.system.Os; |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 35 | import android.util.Log; |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 36 | |
Jeff Sharkey | ace874b | 2017-09-07 15:27:33 -0600 | [diff] [blame] | 37 | import dalvik.system.ZygoteHooks; |
Tobias Sargeant | b9679dc | 2016-01-19 16:34:54 +0000 | [diff] [blame] | 38 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 39 | import libcore.io.IoUtils; |
| 40 | |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 41 | import java.io.BufferedReader; |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 42 | import java.io.ByteArrayOutputStream; |
| 43 | import java.io.DataOutputStream; |
| 44 | import java.io.FileDescriptor; |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 45 | import java.io.IOException; |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 46 | import java.io.InputStreamReader; |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 47 | |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 48 | /** @hide */ |
| 49 | public final class Zygote { |
| 50 | /* |
Nicolas Geoffray | 81edac4 | 2017-09-07 14:13:29 +0100 | [diff] [blame] | 51 | * Bit values for "runtimeFlags" argument. The definitions are duplicated |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 52 | * in the native code. |
| 53 | */ |
| 54 | |
| 55 | /** enable debugging over JDWP */ |
Nicolas Geoffray | 347b1df | 2016-12-20 14:05:05 +0000 | [diff] [blame] | 56 | public static final int DEBUG_ENABLE_JDWP = 1; |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 57 | /** enable JNI checks */ |
| 58 | public static final int DEBUG_ENABLE_CHECKJNI = 1 << 1; |
| 59 | /** enable Java programming language "assert" statements */ |
| 60 | public static final int DEBUG_ENABLE_ASSERT = 1 << 2; |
Mathieu Chartier | 7a49028 | 2015-03-17 09:51:36 -0700 | [diff] [blame] | 61 | /** disable the AOT compiler and JIT */ |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 62 | public static final int DEBUG_ENABLE_SAFEMODE = 1 << 3; |
| 63 | /** Enable logging of third-party JNI activity. */ |
| 64 | public static final int DEBUG_ENABLE_JNI_LOGGING = 1 << 4; |
David Srbecky | 065075e | 2015-05-28 17:16:09 +0100 | [diff] [blame] | 65 | /** Force generation of native debugging information. */ |
Nicolas Geoffray | 9abbf45 | 2015-11-05 11:29:42 +0000 | [diff] [blame] | 66 | public static final int DEBUG_GENERATE_DEBUG_INFO = 1 << 5; |
Tamas Berghammer | df6cb28 | 2016-01-29 12:07:00 +0000 | [diff] [blame] | 67 | /** Always use JIT-ed code. */ |
| 68 | public static final int DEBUG_ALWAYS_JIT = 1 << 6; |
Nicolas Geoffray | 347b1df | 2016-12-20 14:05:05 +0000 | [diff] [blame] | 69 | /** Make the code native debuggable by turning off some optimizations. */ |
Tamas Berghammer | df6cb28 | 2016-01-29 12:07:00 +0000 | [diff] [blame] | 70 | public static final int DEBUG_NATIVE_DEBUGGABLE = 1 << 7; |
Nicolas Geoffray | 347b1df | 2016-12-20 14:05:05 +0000 | [diff] [blame] | 71 | /** Make the code Java debuggable by turning off some optimizations. */ |
| 72 | public static final int DEBUG_JAVA_DEBUGGABLE = 1 << 8; |
Mathieu Chartier | 7a49028 | 2015-03-17 09:51:36 -0700 | [diff] [blame] | 73 | |
Nicolas Geoffray | 1f88ad6 | 2017-09-13 14:21:00 +0100 | [diff] [blame] | 74 | /** Turn off the verifier. */ |
| 75 | public static final int DISABLE_VERIFIER = 1 << 9; |
| 76 | /** Only use oat files located in /system. Otherwise use dex/jar/apk . */ |
| 77 | public static final int ONLY_USE_SYSTEM_OAT_FILES = 1 << 10; |
David Srbecky | 156ed92 | 2018-01-30 14:37:37 +0000 | [diff] [blame] | 78 | /** Force generation of native debugging information for backtraces. */ |
Mathew Inwood | 16073b8 | 2018-03-23 10:05:01 +0000 | [diff] [blame] | 79 | public static final int DEBUG_GENERATE_MINI_DEBUG_INFO = 1 << 11; |
| 80 | /** |
| 81 | * Hidden API access restrictions. This is a mask for bits representing the API enforcement |
| 82 | * policy, defined by {@code @ApplicationInfo.HiddenApiEnforcementPolicy}. |
| 83 | */ |
| 84 | public static final int API_ENFORCEMENT_POLICY_MASK = (1 << 12) | (1 << 13); |
| 85 | /** |
| 86 | * Bit shift for use with {@link #API_ENFORCEMENT_POLICY_MASK}. |
| 87 | * |
| 88 | * (flags & API_ENFORCEMENT_POLICY_MASK) >> API_ENFORCEMENT_POLICY_SHIFT gives |
| 89 | * @ApplicationInfo.ApiEnforcementPolicy values. |
| 90 | */ |
| 91 | public static final int API_ENFORCEMENT_POLICY_SHIFT = |
| 92 | Integer.numberOfTrailingZeros(API_ENFORCEMENT_POLICY_MASK); |
Calin Juravle | 8eb891b | 2018-05-03 19:51:18 -0700 | [diff] [blame] | 93 | /** |
| 94 | * Enable system server ART profiling. |
| 95 | */ |
| 96 | public static final int PROFILE_SYSTEM_SERVER = 1 << 14; |
Nicolas Geoffray | 1f88ad6 | 2017-09-13 14:21:00 +0100 | [diff] [blame] | 97 | |
Yabin Cui | 4d8546d | 2019-01-29 16:29:20 -0800 | [diff] [blame] | 98 | /** |
| 99 | * Enable profiling from shell. |
| 100 | */ |
| 101 | public static final int PROFILE_FROM_SHELL = 1 << 15; |
| 102 | |
Mathieu Chartier | ced7e08 | 2019-02-04 13:28:36 -0800 | [diff] [blame] | 103 | /* |
| 104 | * Enable using the ART app image startup cache |
| 105 | */ |
| 106 | public static final int USE_APP_IMAGE_STARTUP_CACHE = 1 << 16; |
| 107 | |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 108 | /** No external storage should be mounted. */ |
Jeff Sharkey | ace874b | 2017-09-07 15:27:33 -0600 | [diff] [blame] | 109 | public static final int MOUNT_EXTERNAL_NONE = IVold.REMOUNT_MODE_NONE; |
Jeff Sharkey | 9527b22 | 2015-06-24 15:24:48 -0700 | [diff] [blame] | 110 | /** Default external storage should be mounted. */ |
Jeff Sharkey | ace874b | 2017-09-07 15:27:33 -0600 | [diff] [blame] | 111 | public static final int MOUNT_EXTERNAL_DEFAULT = IVold.REMOUNT_MODE_DEFAULT; |
Jeff Sharkey | 9527b22 | 2015-06-24 15:24:48 -0700 | [diff] [blame] | 112 | /** Read-only external storage should be mounted. */ |
Jeff Sharkey | ace874b | 2017-09-07 15:27:33 -0600 | [diff] [blame] | 113 | public static final int MOUNT_EXTERNAL_READ = IVold.REMOUNT_MODE_READ; |
Jeff Sharkey | 9527b22 | 2015-06-24 15:24:48 -0700 | [diff] [blame] | 114 | /** Read-write external storage should be mounted. */ |
Jeff Sharkey | ace874b | 2017-09-07 15:27:33 -0600 | [diff] [blame] | 115 | public static final int MOUNT_EXTERNAL_WRITE = IVold.REMOUNT_MODE_WRITE; |
Sudheer Shanka | 3a0df3b | 2018-12-12 12:43:43 -0800 | [diff] [blame] | 116 | /** |
Sudheer Shanka | 0b6da53 | 2019-01-09 12:06:51 -0800 | [diff] [blame] | 117 | * Mount mode for apps that are already installed on the device before the isolated_storage |
| 118 | * feature is enabled. |
| 119 | */ |
| 120 | public static final int MOUNT_EXTERNAL_LEGACY = IVold.REMOUNT_MODE_LEGACY; |
| 121 | /** |
Sudheer Shanka | 3a0df3b | 2018-12-12 12:43:43 -0800 | [diff] [blame] | 122 | * Mount mode for package installers which should give them access to |
| 123 | * all obb dirs in addition to their package sandboxes |
| 124 | */ |
| 125 | public static final int MOUNT_EXTERNAL_INSTALLER = IVold.REMOUNT_MODE_INSTALLER; |
Sudheer Shanka | 98cb3f0 | 2018-08-17 16:10:29 -0700 | [diff] [blame] | 126 | /** Read-write external storage should be mounted instead of package sandbox */ |
| 127 | public static final int MOUNT_EXTERNAL_FULL = IVold.REMOUNT_MODE_FULL; |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 128 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 129 | /** Number of bytes sent to the Zygote over blastula pipes or the pool event FD */ |
| 130 | public static final int BLASTULA_MANAGEMENT_MESSAGE_BYTES = 8; |
| 131 | |
Chris Wailes | ba4c2eb | 2019-01-11 17:13:00 -0800 | [diff] [blame] | 132 | /** |
Robert Sesek | d0a190df | 2018-02-12 18:46:01 -0500 | [diff] [blame] | 133 | * An extraArg passed when a zygote process is forking a child-zygote, specifying a name |
| 134 | * in the abstract socket namespace. This socket name is what the new child zygote |
| 135 | * should listen for connections on. |
| 136 | */ |
| 137 | public static final String CHILD_ZYGOTE_SOCKET_NAME_ARG = "--zygote-socket="; |
| 138 | |
Martijn Coenen | 7e6fa67 | 2018-11-05 11:45:26 +0100 | [diff] [blame] | 139 | /** |
| 140 | * An extraArg passed when a zygote process is forking a child-zygote, specifying the |
| 141 | * requested ABI for the child Zygote. |
| 142 | */ |
| 143 | public static final String CHILD_ZYGOTE_ABI_LIST_ARG = "--abi-list="; |
| 144 | |
Martijn Coenen | 86f08a5 | 2019-01-03 16:23:01 +0100 | [diff] [blame] | 145 | /** |
| 146 | * An extraArg passed when a zygote process is forking a child-zygote, specifying the |
| 147 | * start of the UID range the children of the Zygote may setuid()/setgid() to. This |
| 148 | * will be enforced with a seccomp filter. |
| 149 | */ |
| 150 | public static final String CHILD_ZYGOTE_UID_RANGE_START = "--uid-range-start="; |
| 151 | |
| 152 | /** |
| 153 | * An extraArg passed when a zygote process is forking a child-zygote, specifying the |
| 154 | * end of the UID range the children of the Zygote may setuid()/setgid() to. This |
| 155 | * will be enforced with a seccomp filter. |
| 156 | */ |
| 157 | public static final String CHILD_ZYGOTE_UID_RANGE_END = "--uid-range-end="; |
| 158 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 159 | /** Prefix prepended to socket names created by init */ |
| 160 | private static final String ANDROID_SOCKET_PREFIX = "ANDROID_SOCKET_"; |
| 161 | |
| 162 | /** |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 163 | * The duration to wait before re-checking Zygote related system properties. |
| 164 | * |
| 165 | * Five minutes in milliseconds. |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 166 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 167 | public static final long PROPERTY_CHECK_INTERVAL = 300000; |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 168 | |
Chris Wailes | ba4c2eb | 2019-01-11 17:13:00 -0800 | [diff] [blame] | 169 | /** |
| 170 | * @hide for internal use only |
| 171 | */ |
| 172 | public static final int SOCKET_BUFFER_SIZE = 256; |
| 173 | |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 174 | /** a prototype instance for a future List.toArray() */ |
| 175 | protected static final int[][] INT_ARRAY_2D = new int[0][0]; |
| 176 | |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 177 | /** |
| 178 | * @hide for internal use only. |
| 179 | */ |
| 180 | public static final String PRIMARY_SOCKET_NAME = "zygote"; |
| 181 | |
| 182 | /** |
| 183 | * @hide for internal use only. |
| 184 | */ |
| 185 | public static final String SECONDARY_SOCKET_NAME = "zygote_secondary"; |
| 186 | |
| 187 | /** |
| 188 | * @hide for internal use only |
| 189 | */ |
| 190 | public static final String BLASTULA_POOL_PRIMARY_SOCKET_NAME = "blastula_pool"; |
| 191 | |
| 192 | /** |
| 193 | * @hide for internal use only |
| 194 | */ |
| 195 | public static final String BLASTULA_POOL_SECONDARY_SOCKET_NAME = "blastula_pool_secondary"; |
| 196 | |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 197 | private Zygote() {} |
| 198 | |
Victor Hsieh | c8176ef | 2018-01-08 12:43:00 -0800 | [diff] [blame] | 199 | /** Called for some security initialization before any fork. */ |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 200 | static native void nativeSecurityInit(); |
Victor Hsieh | c8176ef | 2018-01-08 12:43:00 -0800 | [diff] [blame] | 201 | |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 202 | /** |
| 203 | * Forks a new VM instance. The current VM must have been started |
| 204 | * with the -Xzygote flag. <b>NOTE: new instance keeps all |
| 205 | * root capabilities. The new process is expected to call capset()</b>. |
| 206 | * |
| 207 | * @param uid the UNIX uid that the new process should setuid() to after |
| 208 | * fork()ing and and before spawning any threads. |
| 209 | * @param gid the UNIX gid that the new process should setgid() to after |
| 210 | * fork()ing and and before spawning any threads. |
| 211 | * @param gids null-ok; a list of UNIX gids that the new process should |
| 212 | * setgroups() to after fork and before spawning any threads. |
Nicolas Geoffray | 81edac4 | 2017-09-07 14:13:29 +0100 | [diff] [blame] | 213 | * @param runtimeFlags bit flags that enable ART features. |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 214 | * @param rlimits null-ok an array of rlimit tuples, with the second |
| 215 | * dimension having a length of 3 and representing |
| 216 | * (resource, rlim_cur, rlim_max). These are set via the posix |
| 217 | * setrlimit(2) call. |
| 218 | * @param seInfo null-ok a string specifying SELinux information for |
| 219 | * the new process. |
| 220 | * @param niceName null-ok a string specifying the process name. |
| 221 | * @param fdsToClose an array of ints, holding one or more POSIX |
| 222 | * file descriptor numbers that are to be closed by the child |
| 223 | * (and replaced by /dev/null) after forking. An integer value |
| 224 | * of -1 in any entry in the array means "ignore this one". |
Andreas Gampe | 8dfa178 | 2017-01-05 12:45:58 -0800 | [diff] [blame] | 225 | * @param fdsToIgnore null-ok an array of ints, either null or holding |
| 226 | * one or more POSIX file descriptor numbers that are to be ignored |
| 227 | * in the file descriptor table check. |
Robert Sesek | d0a190df | 2018-02-12 18:46:01 -0500 | [diff] [blame] | 228 | * @param startChildZygote if true, the new child process will itself be a |
| 229 | * new zygote process. |
Andreas Gampe | aec67dc | 2014-09-02 21:23:06 -0700 | [diff] [blame] | 230 | * @param instructionSet null-ok the instruction set to use. |
jgu21 | 2eacd06 | 2014-09-10 06:55:07 -0400 | [diff] [blame] | 231 | * @param appDataDir null-ok the data directory of the app. |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 232 | * |
| 233 | * @return 0 if this is the child, pid of the child |
| 234 | * if this is the parent, or -1 on error. |
| 235 | */ |
Nicolas Geoffray | 81edac4 | 2017-09-07 14:13:29 +0100 | [diff] [blame] | 236 | public static int forkAndSpecialize(int uid, int gid, int[] gids, int runtimeFlags, |
Sudheer Shanka | 3f0645b | 2018-09-18 13:07:59 -0700 | [diff] [blame] | 237 | int[][] rlimits, int mountExternal, String seInfo, String niceName, int[] fdsToClose, |
| 238 | int[] fdsToIgnore, boolean startChildZygote, String instructionSet, String appDataDir, |
Sudheer Shanka | e51005d | 2019-02-24 10:24:09 -0800 | [diff] [blame^] | 239 | String packageName, String[] packagesForUID, String sandboxId) { |
Neil Fuller | 555d8b7 | 2019-01-28 18:29:20 +0000 | [diff] [blame] | 240 | ZygoteHooks.preFork(); |
Hiroshi Yamauchi | 1e3db87 | 2017-03-02 13:39:07 -0800 | [diff] [blame] | 241 | // Resets nice priority for zygote process. |
| 242 | resetNicePriority(); |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 243 | int pid = nativeForkAndSpecialize( |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 244 | uid, gid, gids, runtimeFlags, rlimits, mountExternal, seInfo, niceName, fdsToClose, |
| 245 | fdsToIgnore, startChildZygote, instructionSet, appDataDir, packageName, |
Sudheer Shanka | e51005d | 2019-02-24 10:24:09 -0800 | [diff] [blame^] | 246 | packagesForUID, sandboxId); |
Narayan Kamath | fbb32f6 | 2015-06-12 15:34:35 +0100 | [diff] [blame] | 247 | // Enable tracing as soon as possible for the child process. |
| 248 | if (pid == 0) { |
Andreas Gampe | 8f4eab2 | 2017-09-13 18:16:13 -0700 | [diff] [blame] | 249 | Trace.setTracingEnabled(true, runtimeFlags); |
Narayan Kamath | fbb32f6 | 2015-06-12 15:34:35 +0100 | [diff] [blame] | 250 | |
| 251 | // Note that this event ends at the end of handleChildProc, |
| 252 | Trace.traceBegin(Trace.TRACE_TAG_ACTIVITY_MANAGER, "PostFork"); |
| 253 | } |
Neil Fuller | 555d8b7 | 2019-01-28 18:29:20 +0000 | [diff] [blame] | 254 | ZygoteHooks.postForkCommon(); |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 255 | return pid; |
| 256 | } |
| 257 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 258 | private static native int nativeForkAndSpecialize(int uid, int gid, int[] gids, |
| 259 | int runtimeFlags, int[][] rlimits, int mountExternal, String seInfo, String niceName, |
| 260 | int[] fdsToClose, int[] fdsToIgnore, boolean startChildZygote, String instructionSet, |
Sudheer Shanka | e51005d | 2019-02-24 10:24:09 -0800 | [diff] [blame^] | 261 | String appDataDir, String packageName, String[] packagesForUID, |
Sudheer Shanka | 03fd40b | 2019-02-06 12:39:14 -0800 | [diff] [blame] | 262 | String sandboxId); |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 263 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 264 | /** |
| 265 | * Specialize a Blastula instance. The current VM must have been started |
| 266 | * with the -Xzygote flag. |
| 267 | * |
| 268 | * @param uid The UNIX uid that the new process should setuid() to before spawning any threads |
| 269 | * @param gid The UNIX gid that the new process should setgid() to before spawning any threads |
| 270 | * @param gids null-ok; A list of UNIX gids that the new process should |
| 271 | * setgroups() to before spawning any threads |
| 272 | * @param runtimeFlags Bit flags that enable ART features |
| 273 | * @param rlimits null-ok An array of rlimit tuples, with the second |
| 274 | * dimension having a length of 3 and representing |
| 275 | * (resource, rlim_cur, rlim_max). These are set via the posix |
| 276 | * setrlimit(2) call. |
| 277 | * @param seInfo null-ok A string specifying SELinux information for |
| 278 | * the new process. |
| 279 | * @param niceName null-ok A string specifying the process name. |
| 280 | * @param startChildZygote If true, the new child process will itself be a |
| 281 | * new zygote process. |
| 282 | * @param instructionSet null-ok The instruction set to use. |
| 283 | * @param appDataDir null-ok The data directory of the app. |
| 284 | */ |
| 285 | public static void specializeBlastula(int uid, int gid, int[] gids, int runtimeFlags, |
| 286 | int[][] rlimits, int mountExternal, String seInfo, String niceName, |
Chris Wailes | ba4c2eb | 2019-01-11 17:13:00 -0800 | [diff] [blame] | 287 | boolean startChildZygote, String instructionSet, String appDataDir, String packageName, |
Sudheer Shanka | e51005d | 2019-02-24 10:24:09 -0800 | [diff] [blame^] | 288 | String[] packagesForUID, String sandboxId) { |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 289 | |
| 290 | nativeSpecializeBlastula(uid, gid, gids, runtimeFlags, rlimits, mountExternal, seInfo, |
| 291 | niceName, startChildZygote, instructionSet, appDataDir, |
Sudheer Shanka | e51005d | 2019-02-24 10:24:09 -0800 | [diff] [blame^] | 292 | packageName, packagesForUID, sandboxId); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 293 | |
| 294 | // Enable tracing as soon as possible for the child process. |
| 295 | Trace.setTracingEnabled(true, runtimeFlags); |
| 296 | |
| 297 | // Note that this event ends at the end of handleChildProc. |
| 298 | Trace.traceBegin(Trace.TRACE_TAG_ACTIVITY_MANAGER, "PostFork"); |
| 299 | |
| 300 | /* |
| 301 | * This is called here (instead of after the fork but before the specialize) to maintain |
| 302 | * consistancy with the code paths for forkAndSpecialize. |
| 303 | * |
| 304 | * TODO (chriswailes): Look into moving this to immediately after the fork. |
| 305 | */ |
Neil Fuller | 555d8b7 | 2019-01-28 18:29:20 +0000 | [diff] [blame] | 306 | ZygoteHooks.postForkCommon(); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 307 | } |
| 308 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 309 | private static native void nativeSpecializeBlastula(int uid, int gid, int[] gids, |
| 310 | int runtimeFlags, int[][] rlimits, int mountExternal, String seInfo, String niceName, |
| 311 | boolean startChildZygote, String instructionSet, String appDataDir, String packageName, |
Sudheer Shanka | e51005d | 2019-02-24 10:24:09 -0800 | [diff] [blame^] | 312 | String[] packagesForUID, String sandboxId); |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 313 | |
| 314 | /** |
Christopher Ferris | 2980de4 | 2017-06-20 16:13:40 -0700 | [diff] [blame] | 315 | * Called to do any initialization before starting an application. |
| 316 | */ |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 317 | static native void nativePreApplicationInit(); |
Christopher Ferris | 2980de4 | 2017-06-20 16:13:40 -0700 | [diff] [blame] | 318 | |
| 319 | /** |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 320 | * Special method to start the system server process. In addition to the |
| 321 | * common actions performed in forkAndSpecialize, the pid of the child |
| 322 | * process is recorded such that the death of the child process will cause |
| 323 | * zygote to exit. |
| 324 | * |
| 325 | * @param uid the UNIX uid that the new process should setuid() to after |
| 326 | * fork()ing and and before spawning any threads. |
| 327 | * @param gid the UNIX gid that the new process should setgid() to after |
| 328 | * fork()ing and and before spawning any threads. |
| 329 | * @param gids null-ok; a list of UNIX gids that the new process should |
| 330 | * setgroups() to after fork and before spawning any threads. |
Nicolas Geoffray | 81edac4 | 2017-09-07 14:13:29 +0100 | [diff] [blame] | 331 | * @param runtimeFlags bit flags that enable ART features. |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 332 | * @param rlimits null-ok an array of rlimit tuples, with the second |
| 333 | * dimension having a length of 3 and representing |
| 334 | * (resource, rlim_cur, rlim_max). These are set via the posix |
| 335 | * setrlimit(2) call. |
| 336 | * @param permittedCapabilities argument for setcap() |
| 337 | * @param effectiveCapabilities argument for setcap() |
| 338 | * |
| 339 | * @return 0 if this is the child, pid of the child |
| 340 | * if this is the parent, or -1 on error. |
| 341 | */ |
Nicolas Geoffray | 81edac4 | 2017-09-07 14:13:29 +0100 | [diff] [blame] | 342 | public static int forkSystemServer(int uid, int gid, int[] gids, int runtimeFlags, |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 343 | int[][] rlimits, long permittedCapabilities, long effectiveCapabilities) { |
Neil Fuller | 555d8b7 | 2019-01-28 18:29:20 +0000 | [diff] [blame] | 344 | ZygoteHooks.preFork(); |
Hiroshi Yamauchi | 1e3db87 | 2017-03-02 13:39:07 -0800 | [diff] [blame] | 345 | // Resets nice priority for zygote process. |
| 346 | resetNicePriority(); |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 347 | int pid = nativeForkSystemServer( |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 348 | uid, gid, gids, runtimeFlags, rlimits, |
| 349 | permittedCapabilities, effectiveCapabilities); |
Narayan Kamath | fbb32f6 | 2015-06-12 15:34:35 +0100 | [diff] [blame] | 350 | // Enable tracing as soon as we enter the system_server. |
| 351 | if (pid == 0) { |
Andreas Gampe | 8f4eab2 | 2017-09-13 18:16:13 -0700 | [diff] [blame] | 352 | Trace.setTracingEnabled(true, runtimeFlags); |
Narayan Kamath | fbb32f6 | 2015-06-12 15:34:35 +0100 | [diff] [blame] | 353 | } |
Neil Fuller | 555d8b7 | 2019-01-28 18:29:20 +0000 | [diff] [blame] | 354 | ZygoteHooks.postForkCommon(); |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 355 | return pid; |
| 356 | } |
| 357 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 358 | private static native int nativeForkSystemServer(int uid, int gid, int[] gids, int runtimeFlags, |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 359 | int[][] rlimits, long permittedCapabilities, long effectiveCapabilities); |
| 360 | |
doheon1.lee | 885b742 | 2016-01-20 13:07:27 +0900 | [diff] [blame] | 361 | /** |
Robert Sesek | 54e387d | 2016-12-02 17:27:50 -0500 | [diff] [blame] | 362 | * Lets children of the zygote inherit open file descriptors to this path. |
| 363 | */ |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 364 | protected static native void nativeAllowFileAcrossFork(String path); |
Robert Sesek | 54e387d | 2016-12-02 17:27:50 -0500 | [diff] [blame] | 365 | |
| 366 | /** |
Martijn Coenen | 4b98816 | 2019-01-28 13:58:45 +0100 | [diff] [blame] | 367 | * Lets children of the zygote inherit open file descriptors that belong to the |
| 368 | * ApplicationInfo that is passed in. |
| 369 | * |
| 370 | * @param appInfo ApplicationInfo of the application |
| 371 | */ |
| 372 | protected static void allowAppFilesAcrossFork(ApplicationInfo appInfo) { |
| 373 | Zygote.nativeAllowFileAcrossFork(appInfo.sourceDir); |
| 374 | if (appInfo.splitSourceDirs != null) { |
| 375 | for (String path : appInfo.splitSourceDirs) { |
| 376 | Zygote.nativeAllowFileAcrossFork(path); |
| 377 | } |
| 378 | } |
| 379 | // As well as its shared libs |
| 380 | if (appInfo.sharedLibraryFiles != null) { |
| 381 | for (String path : appInfo.sharedLibraryFiles) { |
| 382 | Zygote.nativeAllowFileAcrossFork(path); |
| 383 | } |
| 384 | } |
| 385 | } |
| 386 | |
| 387 | /** |
Martijn Coenen | 86f08a5 | 2019-01-03 16:23:01 +0100 | [diff] [blame] | 388 | * Installs a seccomp filter that limits setresuid()/setresgid() to the passed-in range |
| 389 | * @param uidGidMin The smallest allowed uid/gid |
| 390 | * @param uidGidMax The largest allowed uid/gid |
| 391 | */ |
| 392 | native protected static void nativeInstallSeccompUidGidFilter(int uidGidMin, int uidGidMax); |
| 393 | |
| 394 | /** |
doheon1.lee | 885b742 | 2016-01-20 13:07:27 +0900 | [diff] [blame] | 395 | * Zygote unmount storage space on initializing. |
| 396 | * This method is called once. |
| 397 | */ |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 398 | protected static native void nativeUnmountStorageOnInit(); |
| 399 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 400 | /** |
| 401 | * Get socket file descriptors (opened by init) from the environment and |
| 402 | * store them for access from native code later. |
| 403 | * |
| 404 | * @param isPrimary True if this is the zygote process, false if it is zygote_secondary |
| 405 | */ |
| 406 | public static void getSocketFDs(boolean isPrimary) { |
| 407 | nativeGetSocketFDs(isPrimary); |
| 408 | } |
| 409 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 410 | protected static native void nativeGetSocketFDs(boolean isPrimary); |
| 411 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 412 | /** |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 413 | * Returns the raw string value of a system property. |
| 414 | * |
| 415 | * Note that Device Config is not available without an application so SystemProperties is used |
| 416 | * instead. |
| 417 | * |
| 418 | * TODO (chriswailes): Cache the system property location in native code and then write a JNI |
| 419 | * function to fetch it. |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 420 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 421 | public static String getSystemProperty(String propertyName, String defaultValue) { |
| 422 | return SystemProperties.get( |
| 423 | String.join(".", |
| 424 | "persist.device_config", |
| 425 | DeviceConfig.RuntimeNative.NAMESPACE, |
| 426 | propertyName), |
| 427 | defaultValue); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 428 | } |
| 429 | |
| 430 | /** |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 431 | * Returns the value of a system property converted to a boolean using specific logic. |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 432 | * |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 433 | * Note that Device Config is not available without an application so SystemProperties is used |
| 434 | * instead. |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 435 | * |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 436 | * @see SystemProperties.getBoolean |
| 437 | * |
| 438 | * TODO (chriswailes): Cache the system property location in native code and then write a JNI |
| 439 | * function to fetch it. |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 440 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 441 | public static boolean getSystemPropertyBoolean(String propertyName, Boolean defaultValue) { |
| 442 | return SystemProperties.getBoolean( |
| 443 | String.join(".", |
| 444 | "persist.device_config", |
| 445 | DeviceConfig.RuntimeNative.NAMESPACE, |
| 446 | propertyName), |
| 447 | defaultValue); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 448 | } |
| 449 | |
| 450 | /** |
| 451 | * @return Number of blastulas currently in the pool |
| 452 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 453 | static int getBlastulaPoolCount() { |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 454 | return nativeGetBlastulaPoolCount(); |
| 455 | } |
| 456 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 457 | private static native int nativeGetBlastulaPoolCount(); |
| 458 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 459 | /** |
| 460 | * @return The event FD used for communication between the signal handler and the ZygoteServer |
| 461 | * poll loop |
| 462 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 463 | static FileDescriptor getBlastulaPoolEventFD() { |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 464 | FileDescriptor fd = new FileDescriptor(); |
| 465 | fd.setInt$(nativeGetBlastulaPoolEventFD()); |
| 466 | |
| 467 | return fd; |
| 468 | } |
| 469 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 470 | private static native int nativeGetBlastulaPoolEventFD(); |
| 471 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 472 | /** |
| 473 | * Fork a new blastula process from the zygote |
| 474 | * |
| 475 | * @param sessionSocketRawFDs Anonymous session sockets that are currently open |
| 476 | * @return In the Zygote process this function will always return null; in blastula processes |
| 477 | * this function will return a Runnable object representing the new application that is |
| 478 | * passed up from blastulaMain. |
| 479 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 480 | static Runnable forkBlastula(LocalServerSocket blastulaPoolSocket, |
| 481 | int[] sessionSocketRawFDs) { |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 482 | FileDescriptor[] pipeFDs = null; |
| 483 | |
| 484 | try { |
| 485 | pipeFDs = Os.pipe2(O_CLOEXEC); |
| 486 | } catch (ErrnoException errnoEx) { |
| 487 | throw new IllegalStateException("Unable to create blastula pipe.", errnoEx); |
| 488 | } |
| 489 | |
| 490 | int pid = |
| 491 | nativeForkBlastula(pipeFDs[0].getInt$(), pipeFDs[1].getInt$(), sessionSocketRawFDs); |
| 492 | |
| 493 | if (pid == 0) { |
| 494 | IoUtils.closeQuietly(pipeFDs[0]); |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 495 | return blastulaMain(blastulaPoolSocket, pipeFDs[1]); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 496 | } else { |
| 497 | // The read-end of the pipe will be closed by the native code. |
| 498 | // See removeBlastulaTableEntry(); |
| 499 | IoUtils.closeQuietly(pipeFDs[1]); |
| 500 | return null; |
| 501 | } |
| 502 | } |
| 503 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 504 | private static native int nativeForkBlastula(int readPipeFD, |
| 505 | int writePipeFD, |
| 506 | int[] sessionSocketRawFDs); |
| 507 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 508 | /** |
| 509 | * This function is used by blastulas to wait for specialization requests from the system |
| 510 | * server. |
| 511 | * |
| 512 | * @param writePipe The write end of the reporting pipe used to communicate with the poll loop |
| 513 | * of the ZygoteServer. |
| 514 | * @return A runnable oject representing the new application. |
| 515 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 516 | private static Runnable blastulaMain(LocalServerSocket blastulaPoolSocket, |
| 517 | FileDescriptor writePipe) { |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 518 | final int pid = Process.myPid(); |
| 519 | |
| 520 | LocalSocket sessionSocket = null; |
| 521 | DataOutputStream blastulaOutputStream = null; |
| 522 | Credentials peerCredentials = null; |
| 523 | String[] argStrings = null; |
| 524 | |
| 525 | while (true) { |
| 526 | try { |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 527 | sessionSocket = blastulaPoolSocket.accept(); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 528 | |
| 529 | BufferedReader blastulaReader = |
| 530 | new BufferedReader(new InputStreamReader(sessionSocket.getInputStream())); |
| 531 | blastulaOutputStream = |
| 532 | new DataOutputStream(sessionSocket.getOutputStream()); |
| 533 | |
| 534 | peerCredentials = sessionSocket.getPeerCredentials(); |
| 535 | |
| 536 | argStrings = readArgumentList(blastulaReader); |
| 537 | |
| 538 | if (argStrings != null) { |
| 539 | break; |
| 540 | } else { |
| 541 | Log.e("Blastula", "Truncated command received."); |
| 542 | IoUtils.closeQuietly(sessionSocket); |
| 543 | } |
| 544 | } catch (IOException ioEx) { |
| 545 | Log.e("Blastula", "Failed to read command: " + ioEx.getMessage()); |
| 546 | IoUtils.closeQuietly(sessionSocket); |
| 547 | } |
| 548 | } |
| 549 | |
| 550 | ZygoteArguments args = new ZygoteArguments(argStrings); |
| 551 | |
| 552 | // TODO (chriswailes): Should this only be run for debug builds? |
| 553 | validateBlastulaCommand(args); |
| 554 | |
| 555 | applyUidSecurityPolicy(args, peerCredentials); |
| 556 | applyDebuggerSystemProperty(args); |
| 557 | |
| 558 | int[][] rlimits = null; |
| 559 | |
| 560 | if (args.mRLimits != null) { |
| 561 | rlimits = args.mRLimits.toArray(INT_ARRAY_2D); |
| 562 | } |
| 563 | |
| 564 | // This must happen before the SELinux policy for this process is |
| 565 | // changed when specializing. |
| 566 | try { |
| 567 | // Used by ZygoteProcess.zygoteSendArgsAndGetResult to fill in a |
| 568 | // Process.ProcessStartResult object. |
| 569 | blastulaOutputStream.writeInt(pid); |
| 570 | } catch (IOException ioEx) { |
| 571 | Log.e("Blastula", "Failed to write response to session socket: " + ioEx.getMessage()); |
| 572 | System.exit(-1); |
| 573 | } finally { |
| 574 | IoUtils.closeQuietly(sessionSocket); |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 575 | IoUtils.closeQuietly(blastulaPoolSocket); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 576 | } |
| 577 | |
| 578 | try { |
| 579 | ByteArrayOutputStream buffer = |
| 580 | new ByteArrayOutputStream(Zygote.BLASTULA_MANAGEMENT_MESSAGE_BYTES); |
| 581 | DataOutputStream outputStream = new DataOutputStream(buffer); |
| 582 | |
| 583 | // This is written as a long so that the blastula reporting pipe and blastula pool |
| 584 | // event FD handlers in ZygoteServer.runSelectLoop can be unified. These two cases |
| 585 | // should both send/receive 8 bytes. |
| 586 | outputStream.writeLong(pid); |
| 587 | outputStream.flush(); |
| 588 | |
| 589 | Os.write(writePipe, buffer.toByteArray(), 0, buffer.size()); |
| 590 | } catch (Exception ex) { |
| 591 | Log.e("Blastula", |
| 592 | String.format("Failed to write PID (%d) to pipe (%d): %s", |
| 593 | pid, writePipe.getInt$(), ex.getMessage())); |
| 594 | System.exit(-1); |
| 595 | } finally { |
| 596 | IoUtils.closeQuietly(writePipe); |
| 597 | } |
| 598 | |
| 599 | specializeBlastula(args.mUid, args.mGid, args.mGids, |
| 600 | args.mRuntimeFlags, rlimits, args.mMountExternal, |
| 601 | args.mSeInfo, args.mNiceName, args.mStartChildZygote, |
| 602 | args.mInstructionSet, args.mAppDataDir, args.mPackageName, |
Sudheer Shanka | e51005d | 2019-02-24 10:24:09 -0800 | [diff] [blame^] | 603 | args.mPackagesForUid, args.mSandboxId); |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 604 | |
| 605 | if (args.mNiceName != null) { |
| 606 | Process.setArgV0(args.mNiceName); |
| 607 | } |
| 608 | |
| 609 | // End of the postFork event. |
| 610 | Trace.traceEnd(Trace.TRACE_TAG_ACTIVITY_MANAGER); |
| 611 | |
| 612 | return ZygoteInit.zygoteInit(args.mTargetSdkVersion, |
| 613 | args.mRemainingArgs, |
| 614 | null /* classLoader */); |
| 615 | } |
| 616 | |
| 617 | private static final String BLASTULA_ERROR_PREFIX = "Invalid command to blastula: "; |
| 618 | |
| 619 | /** |
| 620 | * Checks a set of zygote arguments to see if they can be handled by a blastula. Throws an |
| 621 | * exception if an invalid arugment is encountered. |
| 622 | * @param args The arguments to test |
| 623 | */ |
Mathieu Chartier | 0bccbf7 | 2019-01-30 15:56:17 -0800 | [diff] [blame] | 624 | private static void validateBlastulaCommand(ZygoteArguments args) { |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 625 | if (args.mAbiListQuery) { |
| 626 | throw new IllegalArgumentException(BLASTULA_ERROR_PREFIX + "--query-abi-list"); |
| 627 | } else if (args.mPidQuery) { |
| 628 | throw new IllegalArgumentException(BLASTULA_ERROR_PREFIX + "--get-pid"); |
| 629 | } else if (args.mPreloadDefault) { |
| 630 | throw new IllegalArgumentException(BLASTULA_ERROR_PREFIX + "--preload-default"); |
| 631 | } else if (args.mPreloadPackage != null) { |
| 632 | throw new IllegalArgumentException(BLASTULA_ERROR_PREFIX + "--preload-package"); |
| 633 | } else if (args.mPreloadApp != null) { |
| 634 | throw new IllegalArgumentException(BLASTULA_ERROR_PREFIX + "--preload-app"); |
| 635 | } else if (args.mStartChildZygote) { |
| 636 | throw new IllegalArgumentException(BLASTULA_ERROR_PREFIX + "--start-child-zygote"); |
| 637 | } else if (args.mApiBlacklistExemptions != null) { |
| 638 | throw new IllegalArgumentException( |
| 639 | BLASTULA_ERROR_PREFIX + "--set-api-blacklist-exemptions"); |
| 640 | } else if (args.mHiddenApiAccessLogSampleRate != -1) { |
| 641 | throw new IllegalArgumentException( |
| 642 | BLASTULA_ERROR_PREFIX + "--hidden-api-log-sampling-rate="); |
| 643 | } else if (args.mInvokeWith != null) { |
| 644 | throw new IllegalArgumentException(BLASTULA_ERROR_PREFIX + "--invoke-with"); |
| 645 | } else if (args.mPermittedCapabilities != 0 || args.mEffectiveCapabilities != 0) { |
| 646 | throw new ZygoteSecurityException("Client may not specify capabilities: " |
| 647 | + "permitted=0x" + Long.toHexString(args.mPermittedCapabilities) |
| 648 | + ", effective=0x" + Long.toHexString(args.mEffectiveCapabilities)); |
| 649 | } |
| 650 | } |
| 651 | |
| 652 | /** |
| 653 | * @return Raw file descriptors for the read-end of blastula reporting pipes. |
| 654 | */ |
| 655 | protected static int[] getBlastulaPipeFDs() { |
| 656 | return nativeGetBlastulaPipeFDs(); |
| 657 | } |
| 658 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 659 | private static native int[] nativeGetBlastulaPipeFDs(); |
| 660 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 661 | /** |
| 662 | * Remove the blastula table entry for the provided process ID. |
| 663 | * |
| 664 | * @param blastulaPID Process ID of the entry to remove |
| 665 | * @return True if the entry was removed; false if it doesn't exist |
| 666 | */ |
| 667 | protected static boolean removeBlastulaTableEntry(int blastulaPID) { |
| 668 | return nativeRemoveBlastulaTableEntry(blastulaPID); |
| 669 | } |
| 670 | |
Chris Wailes | aa1c962 | 2019-01-10 16:55:32 -0800 | [diff] [blame] | 671 | private static native boolean nativeRemoveBlastulaTableEntry(int blastulaPID); |
| 672 | |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 673 | /** |
| 674 | * uid 1000 (Process.SYSTEM_UID) may specify any uid > 1000 in normal |
| 675 | * operation. It may also specify any gid and setgroups() list it chooses. |
| 676 | * In factory test mode, it may specify any UID. |
| 677 | * |
| 678 | * @param args non-null; zygote spawner arguments |
| 679 | * @param peer non-null; peer credentials |
| 680 | * @throws ZygoteSecurityException |
| 681 | */ |
| 682 | protected static void applyUidSecurityPolicy(ZygoteArguments args, Credentials peer) |
| 683 | throws ZygoteSecurityException { |
| 684 | |
| 685 | if (peer.getUid() == Process.SYSTEM_UID) { |
| 686 | /* In normal operation, SYSTEM_UID can only specify a restricted |
| 687 | * set of UIDs. In factory test mode, SYSTEM_UID may specify any uid. |
| 688 | */ |
| 689 | boolean uidRestricted = FactoryTest.getMode() == FactoryTest.FACTORY_TEST_OFF; |
| 690 | |
| 691 | if (uidRestricted && args.mUidSpecified && (args.mUid < Process.SYSTEM_UID)) { |
| 692 | throw new ZygoteSecurityException( |
| 693 | "System UID may not launch process with UID < " |
| 694 | + Process.SYSTEM_UID); |
| 695 | } |
| 696 | } |
| 697 | |
| 698 | // If not otherwise specified, uid and gid are inherited from peer |
| 699 | if (!args.mUidSpecified) { |
| 700 | args.mUid = peer.getUid(); |
| 701 | args.mUidSpecified = true; |
| 702 | } |
| 703 | if (!args.mGidSpecified) { |
| 704 | args.mGid = peer.getGid(); |
| 705 | args.mGidSpecified = true; |
| 706 | } |
| 707 | } |
| 708 | |
| 709 | /** |
| 710 | * Applies debugger system properties to the zygote arguments. |
| 711 | * |
| 712 | * If "ro.debuggable" is "1", all apps are debuggable. Otherwise, |
| 713 | * the debugger state is specified via the "--enable-jdwp" flag |
| 714 | * in the spawn request. |
| 715 | * |
| 716 | * @param args non-null; zygote spawner args |
| 717 | */ |
| 718 | protected static void applyDebuggerSystemProperty(ZygoteArguments args) { |
| 719 | if (RoSystemProperties.DEBUGGABLE) { |
| 720 | args.mRuntimeFlags |= Zygote.DEBUG_ENABLE_JDWP; |
| 721 | } |
| 722 | } |
| 723 | |
| 724 | /** |
| 725 | * Applies zygote security policy. |
| 726 | * Based on the credentials of the process issuing a zygote command: |
| 727 | * <ol> |
| 728 | * <li> uid 0 (root) may specify --invoke-with to launch Zygote with a |
| 729 | * wrapper command. |
| 730 | * <li> Any other uid may not specify any invoke-with argument. |
| 731 | * </ul> |
| 732 | * |
| 733 | * @param args non-null; zygote spawner arguments |
| 734 | * @param peer non-null; peer credentials |
| 735 | * @throws ZygoteSecurityException |
| 736 | */ |
| 737 | protected static void applyInvokeWithSecurityPolicy(ZygoteArguments args, Credentials peer) |
| 738 | throws ZygoteSecurityException { |
| 739 | int peerUid = peer.getUid(); |
| 740 | |
| 741 | if (args.mInvokeWith != null && peerUid != 0 |
| 742 | && (args.mRuntimeFlags & Zygote.DEBUG_ENABLE_JDWP) == 0) { |
| 743 | throw new ZygoteSecurityException("Peer is permitted to specify an" |
| 744 | + "explicit invoke-with wrapper command only for debuggable" |
| 745 | + "applications."); |
| 746 | } |
| 747 | } |
| 748 | |
| 749 | /** |
| 750 | * Applies invoke-with system properties to the zygote arguments. |
| 751 | * |
| 752 | * @param args non-null; zygote args |
| 753 | */ |
| 754 | protected static void applyInvokeWithSystemProperty(ZygoteArguments args) { |
| 755 | if (args.mInvokeWith == null && args.mNiceName != null) { |
| 756 | String property = "wrap." + args.mNiceName; |
| 757 | args.mInvokeWith = SystemProperties.get(property); |
| 758 | if (args.mInvokeWith != null && args.mInvokeWith.length() == 0) { |
| 759 | args.mInvokeWith = null; |
| 760 | } |
| 761 | } |
| 762 | } |
| 763 | |
| 764 | /** |
| 765 | * Reads an argument list from the provided socket |
| 766 | * @return Argument list or null if EOF is reached |
| 767 | * @throws IOException passed straight through |
| 768 | */ |
| 769 | static String[] readArgumentList(BufferedReader socketReader) throws IOException { |
Chris Wailes | 2be2626 | 2019-01-11 16:14:43 -0800 | [diff] [blame] | 770 | int argc; |
| 771 | |
| 772 | try { |
| 773 | String argc_string = socketReader.readLine(); |
| 774 | |
| 775 | if (argc_string == null) { |
| 776 | // EOF reached. |
| 777 | return null; |
| 778 | } |
| 779 | argc = Integer.parseInt(argc_string); |
| 780 | |
| 781 | } catch (NumberFormatException ex) { |
| 782 | Log.e("Zygote", "Invalid Zygote wire format: non-int at argc"); |
| 783 | throw new IOException("Invalid wire format"); |
| 784 | } |
| 785 | |
| 786 | // See bug 1092107: large argc can be used for a DOS attack |
| 787 | if (argc > MAX_ZYGOTE_ARGC) { |
| 788 | throw new IOException("Max arg count exceeded"); |
| 789 | } |
| 790 | |
| 791 | String[] args = new String[argc]; |
| 792 | for (int arg_index = 0; arg_index < argc; arg_index++) { |
| 793 | args[arg_index] = socketReader.readLine(); |
| 794 | if (args[arg_index] == null) { |
| 795 | // We got an unexpected EOF. |
| 796 | throw new IOException("Truncated request"); |
| 797 | } |
| 798 | } |
| 799 | |
| 800 | return args; |
| 801 | } |
| 802 | |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 803 | /** |
Chris Wailes | cb0b37f | 2019-01-11 17:04:41 -0800 | [diff] [blame] | 804 | * Creates a managed LocalServerSocket object using a file descriptor |
| 805 | * created by an init.rc script. The init scripts that specify the |
| 806 | * sockets name can be found in system/core/rootdir. The socket is bound |
| 807 | * to the file system in the /dev/sockets/ directory, and the file |
| 808 | * descriptor is shared via the ANDROID_SOCKET_<socketName> environment |
| 809 | * variable. |
| 810 | */ |
| 811 | static LocalServerSocket createManagedSocketFromInitSocket(String socketName) { |
| 812 | int fileDesc; |
| 813 | final String fullSocketName = ANDROID_SOCKET_PREFIX + socketName; |
| 814 | |
| 815 | try { |
| 816 | String env = System.getenv(fullSocketName); |
| 817 | fileDesc = Integer.parseInt(env); |
| 818 | } catch (RuntimeException ex) { |
| 819 | throw new RuntimeException("Socket unset or invalid: " + fullSocketName, ex); |
| 820 | } |
| 821 | |
| 822 | try { |
| 823 | FileDescriptor fd = new FileDescriptor(); |
| 824 | fd.setInt$(fileDesc); |
| 825 | return new LocalServerSocket(fd); |
| 826 | } catch (IOException ex) { |
| 827 | throw new RuntimeException( |
| 828 | "Error building socket from file descriptor: " + fileDesc, ex); |
| 829 | } |
| 830 | } |
doheon1.lee | 885b742 | 2016-01-20 13:07:27 +0900 | [diff] [blame] | 831 | |
Orion Hodson | 46724e7 | 2018-10-19 13:05:33 +0100 | [diff] [blame] | 832 | private static void callPostForkSystemServerHooks() { |
| 833 | // SystemServer specific post fork hooks run before child post fork hooks. |
Neil Fuller | 555d8b7 | 2019-01-28 18:29:20 +0000 | [diff] [blame] | 834 | ZygoteHooks.postForkSystemServer(); |
Orion Hodson | 46724e7 | 2018-10-19 13:05:33 +0100 | [diff] [blame] | 835 | } |
| 836 | |
Nicolas Geoffray | 81edac4 | 2017-09-07 14:13:29 +0100 | [diff] [blame] | 837 | private static void callPostForkChildHooks(int runtimeFlags, boolean isSystemServer, |
Robert Sesek | d0a190df | 2018-02-12 18:46:01 -0500 | [diff] [blame] | 838 | boolean isZygote, String instructionSet) { |
Neil Fuller | 555d8b7 | 2019-01-28 18:29:20 +0000 | [diff] [blame] | 839 | ZygoteHooks.postForkChild(runtimeFlags, isSystemServer, isZygote, instructionSet); |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 840 | } |
| 841 | |
Narayan Kamath | b49996d | 2017-02-06 20:24:08 +0000 | [diff] [blame] | 842 | /** |
Hiroshi Yamauchi | 1e3db87 | 2017-03-02 13:39:07 -0800 | [diff] [blame] | 843 | * Resets the calling thread priority to the default value (Thread.NORM_PRIORITY |
| 844 | * or nice value 0). This updates both the priority value in java.lang.Thread and |
| 845 | * the nice value (setpriority). |
Narayan Kamath | b49996d | 2017-02-06 20:24:08 +0000 | [diff] [blame] | 846 | */ |
Hiroshi Yamauchi | 1e3db87 | 2017-03-02 13:39:07 -0800 | [diff] [blame] | 847 | static void resetNicePriority() { |
| 848 | Thread.currentThread().setPriority(Thread.NORM_PRIORITY); |
| 849 | } |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 850 | |
| 851 | /** |
| 852 | * Executes "/system/bin/sh -c <command>" using the exec() system call. |
| 853 | * This method throws a runtime exception if exec() failed, otherwise, this |
| 854 | * method never returns. |
| 855 | * |
| 856 | * @param command The shell command to execute. |
| 857 | */ |
| 858 | public static void execShell(String command) { |
| 859 | String[] args = { "/system/bin/sh", "-c", command }; |
| 860 | try { |
Elliott Hughes | 860c591 | 2014-04-28 19:19:13 -0700 | [diff] [blame] | 861 | Os.execv(args[0], args); |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 862 | } catch (ErrnoException e) { |
| 863 | throw new RuntimeException(e); |
| 864 | } |
| 865 | } |
| 866 | |
| 867 | /** |
| 868 | * Appends quotes shell arguments to the specified string builder. |
| 869 | * The arguments are quoted using single-quotes, escaped if necessary, |
| 870 | * prefixed with a space, and appended to the command. |
| 871 | * |
| 872 | * @param command A string builder for the shell command being constructed. |
| 873 | * @param args An array of argument strings to be quoted and appended to the command. |
| 874 | * @see #execShell(String) |
| 875 | */ |
| 876 | public static void appendQuotedShellArgs(StringBuilder command, String[] args) { |
| 877 | for (String arg : args) { |
| 878 | command.append(" '").append(arg.replace("'", "'\\''")).append("'"); |
| 879 | } |
| 880 | } |
Narayan Kamath | 973b466 | 2014-03-31 13:41:26 +0100 | [diff] [blame] | 881 | } |