Process.java revision 58fd98accbff409601587b3357f2b3acf370f606
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.os; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.LocalSocketAddress; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.LocalSocket; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport dalvik.system.Zygote; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.BufferedWriter; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.DataInputStream; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.IOException; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.OutputStreamWriter; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.ArrayList; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/*package*/ class ZygoteStartFailedEx extends Exception { 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Something prevented the zygote process startup from happening normally 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ZygoteStartFailedEx() {}; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ZygoteStartFailedEx(String s) {super(s);} 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ZygoteStartFailedEx(Throwable cause) {super(cause);} 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tools for managing OS processes. 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Process { 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String LOG_TAG = "Process"; 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String ZYGOTE_SOCKET = "zygote"; 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Name of a process for running the platform's media services. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ANDROID_SHARED_MEDIA = "com.android.process.media"; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Name of the process that Google content providers can share. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String GOOGLE_SHARED_APP_CONTENT = "com.google.process.content"; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the UID/GID under which system code runs. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SYSTEM_UID = 1000; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the UID/GID under which the telephony code runs. 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PHONE_UID = 1001; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 71854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn * Defines the UID/GID for the user shell. 72854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn * @hide 73854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn */ 74854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn public static final int SHELL_UID = 2000; 75854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn 76854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn /** 77d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood * Defines the UID/GID for the log group. 78d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood * @hide 79d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood */ 80d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood public static final int LOG_UID = 1007; 81d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood 82d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood /** 83d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani * Defines the UID/GID for the WIFI supplicant process. 84d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani * @hide 85d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani */ 86d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani public static final int WIFI_UID = 1010; 87d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani 88d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani /** 8958fd98accbff409601587b3357f2b3acf370f606Mike Lockwood * Defines the GID for the group that allows write access to the SD card. 9058fd98accbff409601587b3357f2b3acf370f606Mike Lockwood * @hide 9158fd98accbff409601587b3357f2b3acf370f606Mike Lockwood */ 9258fd98accbff409601587b3357f2b3acf370f606Mike Lockwood public static final int SDCARD_RW_GID = 1015; 9358fd98accbff409601587b3357f2b3acf370f606Mike Lockwood 9458fd98accbff409601587b3357f2b3acf370f606Mike Lockwood /** 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the start of a range of UIDs (and GIDs), going from this 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * number to {@link #LAST_APPLICATION_UID} that are reserved for assigning 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to applications. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FIRST_APPLICATION_UID = 10000; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Last of application-specific UIDs starting at 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FIRST_APPLICATION_UID}. 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LAST_APPLICATION_UID = 99999; 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines a secondary group id for access to the bluetooth hardware. 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BLUETOOTH_GID = 2000; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of application threads. 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DEFAULT = 0; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Keep in sync with utils/threads.h ** 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Lowest available thread priority. Only for those who really, really 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't want to run if anything else is happening. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LOWEST = 19; 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority background threads. This gives your thread a slightly 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lower than normal priority, so that it will have less chance of impacting 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the responsiveness of the user interface. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_BACKGROUND = 10; 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of threads that are currently running a user interface 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that the user is interacting with. Applications can not normally 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority; the system will automatically adjust your 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application threads as the user moves through the UI. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_FOREGROUND = -2; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of system display threads, involved in updating 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the user interface. Applications can not 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * normally change to this priority. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DISPLAY = -4; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important display threads, for compositing 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the screen and retrieving input events. Applications can not normally 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_DISPLAY = -8; 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of audio threads. Applications can not normally 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_AUDIO = -16; 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important audio threads. 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications can not normally change to this priority. 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_AUDIO = -19; 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority more favorable. 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_MORE_FAVORABLE = -1; 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority less favorable. 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LESS_FAVORABLE = +1; 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 203e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 204e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Default thread group - gets a 'normal' share of the CPU 205e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 206e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 207e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_DEFAULT = 0; 208e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 209e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 210e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Background non-interactive thread group - All threads in 211e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * this group are scheduled with a reduced share of the CPU. 212e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 213e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 214e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_BG_NONINTERACTIVE = 1; 215e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 216e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 217e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Foreground 'boost' thread group - All threads in 218e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * this group are scheduled with an increased share of the CPU 219e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 220e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat **/ 221e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_FG_BOOST = 2; 222e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_QUIT = 3; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_KILL = 9; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_USR1 = 10; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // State for communicating with zygote process 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static LocalSocket sZygoteSocket; 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static DataInputStream sZygoteInputStream; 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static BufferedWriter sZygoteWriter; 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** true if previous zygote open failed */ 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static boolean sPreviousZygoteOpenFailed; 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start a new process. 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are enabled, a new process is created and the 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * static main() function of a <var>processClass</var> is executed there. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The process will continue running after this function returns. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are not enabled, a new thread in the caller's 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * process is created and main() of <var>processClass</var> called there. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The niceName parameter, if not an empty string, is a custom name to 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * give to the process instead of using processClass. This allows you to 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make easily identifyable processes even if you are using the same base 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>processClass</var> to start them. 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass The class to use as the process's main entry 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * point. 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName A more readable name to use for the process. 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid The user-id under which the process will run. 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid The group-id under which the process will run. 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids Additional group-ids associated with the process. 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enableDebugger True if debugging should be enabled for this process. 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param zygoteArgs Additional arguments to supply to the zygote process. 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int If > 0 the pid of the new process; if 0 the process is 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * being emulated by a thread 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException on fatal start failure 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int start(final String processClass, 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int uid, int gid, int[] gids, 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int debugFlags, 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] zygoteArgs) 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (supportsProcesses()) { 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return startViaZygote(processClass, niceName, uid, gid, gids, 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project debugFlags, zygoteArgs); 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ZygoteStartFailedEx ex) { 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG, 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Starting VM process through Zygote failed"); 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException( 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Starting VM process through Zygote failed", ex); 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Running in single-process mode 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Runnable runnable = new Runnable() { 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Process.invokeStaticMain(processClass); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Thread constructors must not be called with null names (see spec). 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (niceName != null) { 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new Thread(runnable, niceName).start(); 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new Thread(runnable).start(); 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start a new process. Don't supply a custom nice name. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int start(String processClass, int uid, int gid, 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] gids, int debugFlags, String[] zygoteArgs) { 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return start(processClass, "", uid, gid, gids, 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project debugFlags, zygoteArgs); 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void invokeStaticMain(String className) { 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class cl; 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object args[] = new Object[1]; 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project args[0] = new String[0]; //this is argv 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cl = Class.forName(className); 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cl.getMethod("main", new Class[] { String[].class }) 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .invoke(null, args); 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Exception ex) { 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // can be: ClassNotFoundException, 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // NoSuchMethodException, SecurityException, 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // IllegalAccessException, IllegalArgumentException 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // InvocationTargetException 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or uncaught exception from main() 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG, "Exception invoking static main on " 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + className, ex); 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException(ex); 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** retry interval for opening a zygote socket */ 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int ZYGOTE_RETRY_MILLIS = 500; 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to open socket to Zygote process if not already open. If 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * already open, does nothing. May block and retry. 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void openZygoteSocketIfNeeded() 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int retryCount; 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sPreviousZygoteOpenFailed) { 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If we've failed before, expect that we'll fail again and 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't pause for retries. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 0; 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 10; 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See bug #811181: Sometimes runtime can make it up before zygote. 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Really, we'd like to do something better to avoid this condition, 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but for now just wait a bit... 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int retry = 0 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; (sZygoteSocket == null) && (retry < (retryCount + 1)) 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; retry++ ) { 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (retry > 0) { 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Zygote not up yet, sleeping..."); 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Thread.sleep(ZYGOTE_RETRY_MILLIS); 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InterruptedException ex) { 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // should never happen 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = new LocalSocket(); 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.connect(new LocalSocketAddress(ZYGOTE_SOCKET, 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LocalSocketAddress.Namespace.RESERVED)); 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteInputStream 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new DataInputStream(sZygoteSocket.getInputStream()); 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter = 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new BufferedWriter( 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new OutputStreamWriter( 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.getOutputStream()), 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 256); 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Process: zygote socket opened"); 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = false; 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on close after exception", 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ex2); 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket == null) { 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = true; 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("connect failed"); 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends an argument list to the zygote process, which starts a new child 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and returns the child's pid. Please note: the present implementation 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * replaces newlines in the argument list with spaces. 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param args argument list 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return PID of new child process 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static int zygoteSendArgsAndGetPid(ArrayList<String> args) 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int pid; 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project openZygoteSocketIfNeeded(); 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See com.android.internal.os.ZygoteInit.readArgumentList() 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Presently the wire format to the zygote process is: 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a) a count of arguments (argc, in essence) 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * b) a number of newline-separated argument strings equal to count 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After the zygote process reads these it will write the pid of 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the child or -1 on failure. 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(Integer.toString(args.size())); 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = args.size(); 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String arg = args.get(i); 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (arg.indexOf('\n') >= 0) { 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx( 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "embedded newlines not allowed"); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(arg); 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.flush(); 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should there be a timeout on this? 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pid = sZygoteInputStream.readInt(); 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pid < 0) { 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("fork() failed"); 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we're going to fail anyway 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on routine close", ex2); 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx(ex); 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return pid; 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts a new process via the zygote mechanism. 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass Class name whose static main() to run 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName 'nice' process name to appear in ps 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid a POSIX uid that the new process should setuid() to 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid a POSIX gid that the new process shuold setgid() to 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids null-ok; a list of supplementary group IDs that the 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new process should setgroup() to. 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enableDebugger True if debugging should be enabled for this process. 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extraArgs Additional arguments to supply to the zygote process. 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return PID 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static int startViaZygote(final String processClass, 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int uid, final int gid, 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int[] gids, 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int debugFlags, 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] extraArgs) 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int pid; 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(Process.class) { 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<String> argsForZygote = new ArrayList<String>(); 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --runtime-init, --setuid=, --setgid=, 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // and --setgroups= must go first 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--runtime-init"); 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setuid=" + uid); 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setgid=" + gid); 51323085b781e145ed684e7270af1d5ced6800b8effBen Cheng if ((debugFlags & Zygote.DEBUG_ENABLE_SAFEMODE) != 0) { 51423085b781e145ed684e7270af1d5ced6800b8effBen Cheng argsForZygote.add("--enable-safemode"); 51523085b781e145ed684e7270af1d5ced6800b8effBen Cheng } 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_DEBUGGER) != 0) { 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-debugger"); 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_CHECKJNI) != 0) { 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-checkjni"); 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_ASSERT) != 0) { 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-assert"); 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //TODO optionally enable debuger 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //argsForZygote.add("--enable-debugger"); 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --setgroups is a comma-separated list 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (gids != null && gids.length > 0) { 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("--setgroups="); 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = gids.length; 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (i != 0) { 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(','); 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(gids[i]); 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(sb.toString()); 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (niceName != null) { 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--nice-name=" + niceName); 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(processClass); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (extraArgs != null) { 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String arg : extraArgs) { 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(arg); 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pid = zygoteSendArgsAndGetPid(argsForZygote); 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pid <= 0) { 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("zygote start failed:" + pid); 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return pid; 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns elapsed milliseconds of the time this process has run. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the number of milliseconds this process has return. 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getElapsedCpuTime(); 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process, which can be used with 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #killProcess} and {@link #sendSignal}. 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myPid(); 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of the calling thread, which be used with 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myTid(); 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process's user. 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myUid(); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the UID assigned to a particular user name, or -1 if there is 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a uid. 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getUidForName(String name); 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the GID assigned to a particular user name, or -1 if there is 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a gid. 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getGidForName(String name); 603819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 604819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani /** 605819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * Returns a uid for a currently running process. 606819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @param pid the process id 607819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @return the uid of the process, or -1 if the process is not running. 608819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @hide pending API council review 609819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani */ 610819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani public static final int getUidForPid(int pid) { 611819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani String[] procStatusLabels = { "Uid:" }; 612819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani long[] procStatusValues = new long[1]; 613819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani procStatusValues[0] = -1; 614819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani Process.readProcLines("/proc/" + pid + "/status", procStatusLabels, procStatusValues); 615819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani return (int) procStatusValues[0]; 616819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani } 617819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of a thread, based on Linux priorities. 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int tid, int priority) 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 633e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 634e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 635160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * Call with 'false' to cause future calls to {@link #setThreadPriority(int)} to 636160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * throw an exception if passed a background-level thread priority. This is only 637160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * effective if the JNI layer is built with GUARD_THREAD_PRIORITY defined to 1. 638160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * 639160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * @hide 640160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate */ 641160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate public static final native void setCanSelfBackground(boolean backgroundOk); 642160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate 643160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate /** 644e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Sets the scheduling group for a thread. 645e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 646e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @param tid The indentifier of the thread/process to change. 647e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @param group The target group for this thread/process. 648e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * 649e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 650e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * <var>tid</var> does not exist. 651e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws SecurityException Throws SecurityException if your process does 652e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * not have permission to modify the given thread, or to use the given 653e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * priority. 654e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 655e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final native void setThreadGroup(int tid, int group) 656e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat throws IllegalArgumentException, SecurityException; 6573e458241d9930465a20a861ecb42744355d48e48San Mehat /** 6583e458241d9930465a20a861ecb42744355d48e48San Mehat * Sets the scheduling group for a process and all child threads 6593e458241d9930465a20a861ecb42744355d48e48San Mehat * @hide 6603e458241d9930465a20a861ecb42744355d48e48San Mehat * @param pid The indentifier of the process to change. 6613e458241d9930465a20a861ecb42744355d48e48San Mehat * @param group The target group for this process. 6623e458241d9930465a20a861ecb42744355d48e48San Mehat * 6633e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 6643e458241d9930465a20a861ecb42744355d48e48San Mehat * <var>tid</var> does not exist. 6653e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws SecurityException Throws SecurityException if your process does 6663e458241d9930465a20a861ecb42744355d48e48San Mehat * not have permission to modify the given thread, or to use the given 6673e458241d9930465a20a861ecb42744355d48e48San Mehat * priority. 6683e458241d9930465a20a861ecb42744355d48e48San Mehat */ 6693e458241d9930465a20a861ecb42744355d48e48San Mehat public static final native void setProcessGroup(int pid, int group) 6703e458241d9930465a20a861ecb42744355d48e48San Mehat throws IllegalArgumentException, SecurityException; 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of the calling thread, based on Linux priorities. See 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)} for more information. 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setThreadPriority(int, int) 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int priority) 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the current priority of a thread, based on Linux priorities. 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the current priority, as a Linux priority level, 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from -20 for highest scheduling priority to 19 for lowest scheduling 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getThreadPriority(int tid) 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException; 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Determine whether the current environment supports multiple processes. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the system can run in multiple processes, else 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if everything is running in a single process. 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean supportsProcesses(); 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the out-of-memory badness adjustment for a process. 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The process identifier to set. 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param amt Adjustment value -- linux allows -16 to +15. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the underlying system supports this 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * feature, else false. 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean setOomAdj(int pid, int amt); 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change this process's argv[0] parameter. This can be useful to show 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more descriptive information in things like the 'ps' command. 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The new name of this process. 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setArgV0(String text); 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Kill the process with the given PID. 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that, though this API allows us to request to 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * kill any process based on its PID, the kernel will 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still impose standard restrictions on which PIDs you 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are actually able to kill. Typically this means only 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the process running the caller's packages/application 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and any additional processes created by that app; packages 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sharing a common UID will also be able to kill each 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other's processes. 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final void killProcess(int pid) { 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sendSignal(pid, SIGNAL_KILL); 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setUid(int uid); 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setGid(int uid); 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a signal to the given process. 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The pid of the target process. 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param signal The signal to send. 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void sendSignal(int pid, int signal); 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 765906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn /** 766906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * @hide 767906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * Private impl for avoiding a log message... DO NOT USE without doing 768906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * your own log, or the Android Illuminati will find you some night and 769906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * beat you up. 770906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn */ 771906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn public static final void killProcessQuiet(int pid) { 772906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn sendSignalQuiet(pid, SIGNAL_KILL); 773906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn } 774906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn 775906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn /** 776906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * @hide 777906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * Private impl for avoiding a log message... DO NOT USE without doing 778906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * your own log, or the Android Illuminati will find you some night and 779906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * beat you up. 780906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn */ 781906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn public static final native void sendSignalQuiet(int pid, int signal); 782906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7840bca96bcbfe559f9330a01f723c5c9cba51ec05aMarco Nelissen public static final native long getFreeMemory(); 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void readProcLines(String path, 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] reqFields, long[] outSizes); 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int[] getPids(String path, int[] lastArray); 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_TERM_MASK = 0xff; 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_ZERO_TERM = 0; 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_SPACE_TERM = (int)' '; 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 800c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final int PROC_TAB_TERM = (int)'\t'; 801c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_COMBINE = 0x100; 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_PARENS = 0x200; 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_STRING = 0x1000; 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_LONG = 0x2000; 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_FLOAT = 0x4000; 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean readProcFile(String file, int[] format, 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] outStrings, long[] outLongs, float[] outFloats); 815c64edde69d18498fb2954f71a546357b07ab996aEvan Millar 816c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 817c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final native boolean parseProcLine(byte[] buffer, int startIndex, 818c64edde69d18498fb2954f71a546357b07ab996aEvan Millar int endIndex, int[] format, String[] outStrings, long[] outLongs, float[] outFloats); 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the total Pss value for a given process, in bytes. 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid the process to the Pss for 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the total Pss value for the given process in bytes, 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or -1 if the value cannot be determined 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getPss(int pid); 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 830