Process.java revision 854060af30f928c0a65591e9c8314ae17056e6b8
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 /** 77d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani * Defines the UID/GID for the WIFI supplicant process. 78d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani * @hide 79d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani */ 80d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani public static final int WIFI_UID = 1010; 81d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani 82d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani /** 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the start of a range of UIDs (and GIDs), going from this 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * number to {@link #LAST_APPLICATION_UID} that are reserved for assigning 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to applications. 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FIRST_APPLICATION_UID = 10000; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Last of application-specific UIDs starting at 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FIRST_APPLICATION_UID}. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LAST_APPLICATION_UID = 99999; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines a secondary group id for access to the bluetooth hardware. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BLUETOOTH_GID = 2000; 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of application threads. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DEFAULT = 0; 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Keep in sync with utils/threads.h ** 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Lowest available thread priority. Only for those who really, really 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't want to run if anything else is happening. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LOWEST = 19; 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority background threads. This gives your thread a slightly 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lower than normal priority, so that it will have less chance of impacting 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the responsiveness of the user interface. 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_BACKGROUND = 10; 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of threads that are currently running a user interface 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that the user is interacting with. Applications can not normally 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority; the system will automatically adjust your 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application threads as the user moves through the UI. 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_FOREGROUND = -2; 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of system display threads, involved in updating 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the user interface. Applications can not 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * normally change to this priority. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DISPLAY = -4; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important display threads, for compositing 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the screen and retrieving input events. Applications can not normally 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_DISPLAY = -8; 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of audio threads. Applications can not normally 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_AUDIO = -16; 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important audio threads. 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications can not normally change to this priority. 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_AUDIO = -19; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority more favorable. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_MORE_FAVORABLE = -1; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority less favorable. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LESS_FAVORABLE = +1; 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 191e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 192e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Default thread group - gets a 'normal' share of the CPU 193e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 194e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 195e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_DEFAULT = 0; 196e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 197e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 198e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Background non-interactive thread group - All threads in 199e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * this group are scheduled with a reduced share of the CPU. 200e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 201e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 202e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_BG_NONINTERACTIVE = 1; 203e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 204e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 205e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Foreground 'boost' thread group - All threads in 206e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * this group are scheduled with an increased share of the CPU 207e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 208e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat **/ 209e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_FG_BOOST = 2; 210e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_QUIT = 3; 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_KILL = 9; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_USR1 = 10; 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // State for communicating with zygote process 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static LocalSocket sZygoteSocket; 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static DataInputStream sZygoteInputStream; 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static BufferedWriter sZygoteWriter; 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** true if previous zygote open failed */ 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static boolean sPreviousZygoteOpenFailed; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start a new process. 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are enabled, a new process is created and the 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * static main() function of a <var>processClass</var> is executed there. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The process will continue running after this function returns. 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are not enabled, a new thread in the caller's 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * process is created and main() of <var>processClass</var> called there. 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The niceName parameter, if not an empty string, is a custom name to 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * give to the process instead of using processClass. This allows you to 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make easily identifyable processes even if you are using the same base 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>processClass</var> to start them. 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass The class to use as the process's main entry 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * point. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName A more readable name to use for the process. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid The user-id under which the process will run. 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid The group-id under which the process will run. 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids Additional group-ids associated with the process. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enableDebugger True if debugging should be enabled for this process. 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param zygoteArgs Additional arguments to supply to the zygote process. 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int If > 0 the pid of the new process; if 0 the process is 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * being emulated by a thread 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException on fatal start failure 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int start(final String processClass, 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int uid, int gid, int[] gids, 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int debugFlags, 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] zygoteArgs) 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (supportsProcesses()) { 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return startViaZygote(processClass, niceName, uid, gid, gids, 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project debugFlags, zygoteArgs); 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ZygoteStartFailedEx ex) { 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG, 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Starting VM process through Zygote failed"); 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException( 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Starting VM process through Zygote failed", ex); 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Running in single-process mode 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Runnable runnable = new Runnable() { 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Process.invokeStaticMain(processClass); 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Thread constructors must not be called with null names (see spec). 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (niceName != null) { 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new Thread(runnable, niceName).start(); 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new Thread(runnable).start(); 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start a new process. Don't supply a custom nice name. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int start(String processClass, int uid, int gid, 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] gids, int debugFlags, String[] zygoteArgs) { 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return start(processClass, "", uid, gid, gids, 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project debugFlags, zygoteArgs); 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void invokeStaticMain(String className) { 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class cl; 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object args[] = new Object[1]; 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project args[0] = new String[0]; //this is argv 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cl = Class.forName(className); 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cl.getMethod("main", new Class[] { String[].class }) 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .invoke(null, args); 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Exception ex) { 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // can be: ClassNotFoundException, 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // NoSuchMethodException, SecurityException, 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // IllegalAccessException, IllegalArgumentException 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // InvocationTargetException 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // or uncaught exception from main() 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG, "Exception invoking static main on " 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + className, ex); 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException(ex); 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** retry interval for opening a zygote socket */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int ZYGOTE_RETRY_MILLIS = 500; 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to open socket to Zygote process if not already open. If 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * already open, does nothing. May block and retry. 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void openZygoteSocketIfNeeded() 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int retryCount; 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sPreviousZygoteOpenFailed) { 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If we've failed before, expect that we'll fail again and 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't pause for retries. 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 0; 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 10; 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See bug #811181: Sometimes runtime can make it up before zygote. 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Really, we'd like to do something better to avoid this condition, 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but for now just wait a bit... 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int retry = 0 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; (sZygoteSocket == null) && (retry < (retryCount + 1)) 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; retry++ ) { 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (retry > 0) { 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Zygote not up yet, sleeping..."); 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Thread.sleep(ZYGOTE_RETRY_MILLIS); 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InterruptedException ex) { 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // should never happen 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = new LocalSocket(); 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.connect(new LocalSocketAddress(ZYGOTE_SOCKET, 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LocalSocketAddress.Namespace.RESERVED)); 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteInputStream 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new DataInputStream(sZygoteSocket.getInputStream()); 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter = 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new BufferedWriter( 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new OutputStreamWriter( 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.getOutputStream()), 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 256); 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Process: zygote socket opened"); 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = false; 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on close after exception", 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ex2); 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket == null) { 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = true; 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("connect failed"); 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends an argument list to the zygote process, which starts a new child 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and returns the child's pid. Please note: the present implementation 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * replaces newlines in the argument list with spaces. 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param args argument list 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return PID of new child process 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static int zygoteSendArgsAndGetPid(ArrayList<String> args) 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int pid; 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project openZygoteSocketIfNeeded(); 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See com.android.internal.os.ZygoteInit.readArgumentList() 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Presently the wire format to the zygote process is: 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a) a count of arguments (argc, in essence) 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * b) a number of newline-separated argument strings equal to count 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After the zygote process reads these it will write the pid of 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the child or -1 on failure. 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(Integer.toString(args.size())); 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = args.size(); 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String arg = args.get(i); 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (arg.indexOf('\n') >= 0) { 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx( 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "embedded newlines not allowed"); 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(arg); 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.flush(); 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should there be a timeout on this? 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pid = sZygoteInputStream.readInt(); 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pid < 0) { 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("fork() failed"); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we're going to fail anyway 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on routine close", ex2); 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx(ex); 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return pid; 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts a new process via the zygote mechanism. 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass Class name whose static main() to run 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName 'nice' process name to appear in ps 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid a POSIX uid that the new process should setuid() to 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid a POSIX gid that the new process shuold setgid() to 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids null-ok; a list of supplementary group IDs that the 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new process should setgroup() to. 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enableDebugger True if debugging should be enabled for this process. 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extraArgs Additional arguments to supply to the zygote process. 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return PID 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static int startViaZygote(final String processClass, 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int uid, final int gid, 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int[] gids, 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int debugFlags, 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] extraArgs) 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int pid; 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(Process.class) { 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<String> argsForZygote = new ArrayList<String>(); 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --runtime-init, --setuid=, --setgid=, 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // and --setgroups= must go first 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--runtime-init"); 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setuid=" + uid); 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setgid=" + gid); 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_DEBUGGER) != 0) { 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-debugger"); 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_CHECKJNI) != 0) { 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-checkjni"); 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_ASSERT) != 0) { 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-assert"); 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //TODO optionally enable debuger 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //argsForZygote.add("--enable-debugger"); 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --setgroups is a comma-separated list 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (gids != null && gids.length > 0) { 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("--setgroups="); 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = gids.length; 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (i != 0) { 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(','); 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(gids[i]); 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(sb.toString()); 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (niceName != null) { 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--nice-name=" + niceName); 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(processClass); 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (extraArgs != null) { 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String arg : extraArgs) { 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(arg); 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pid = zygoteSendArgsAndGetPid(argsForZygote); 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pid <= 0) { 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("zygote start failed:" + pid); 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return pid; 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns elapsed milliseconds of the time this process has run. 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the number of milliseconds this process has return. 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getElapsedCpuTime(); 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process, which can be used with 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #killProcess} and {@link #sendSignal}. 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myPid(); 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of the calling thread, which be used with 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myTid(); 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process's user. 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myUid(); 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the UID assigned to a particular user name, or -1 if there is 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a uid. 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getUidForName(String name); 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the GID assigned to a particular user name, or -1 if there is 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a gid. 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getGidForName(String name); 588819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 589819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani /** 590819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * Returns a uid for a currently running process. 591819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @param pid the process id 592819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @return the uid of the process, or -1 if the process is not running. 593819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @hide pending API council review 594819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani */ 595819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani public static final int getUidForPid(int pid) { 596819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani String[] procStatusLabels = { "Uid:" }; 597819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani long[] procStatusValues = new long[1]; 598819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani procStatusValues[0] = -1; 599819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani Process.readProcLines("/proc/" + pid + "/status", procStatusLabels, procStatusValues); 600819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani return (int) procStatusValues[0]; 601819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani } 602819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of a thread, based on Linux priorities. 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int tid, int priority) 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 618e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 619e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 620e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Sets the scheduling group for a thread. 621e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 622e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @param tid The indentifier of the thread/process to change. 623e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @param group The target group for this thread/process. 624e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * 625e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 626e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * <var>tid</var> does not exist. 627e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws SecurityException Throws SecurityException if your process does 628e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * not have permission to modify the given thread, or to use the given 629e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * priority. 630e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 631e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final native void setThreadGroup(int tid, int group) 632e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat throws IllegalArgumentException, SecurityException; 6333e458241d9930465a20a861ecb42744355d48e48San Mehat /** 6343e458241d9930465a20a861ecb42744355d48e48San Mehat * Sets the scheduling group for a process and all child threads 6353e458241d9930465a20a861ecb42744355d48e48San Mehat * @hide 6363e458241d9930465a20a861ecb42744355d48e48San Mehat * @param pid The indentifier of the process to change. 6373e458241d9930465a20a861ecb42744355d48e48San Mehat * @param group The target group for this process. 6383e458241d9930465a20a861ecb42744355d48e48San Mehat * 6393e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 6403e458241d9930465a20a861ecb42744355d48e48San Mehat * <var>tid</var> does not exist. 6413e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws SecurityException Throws SecurityException if your process does 6423e458241d9930465a20a861ecb42744355d48e48San Mehat * not have permission to modify the given thread, or to use the given 6433e458241d9930465a20a861ecb42744355d48e48San Mehat * priority. 6443e458241d9930465a20a861ecb42744355d48e48San Mehat */ 6453e458241d9930465a20a861ecb42744355d48e48San Mehat public static final native void setProcessGroup(int pid, int group) 6463e458241d9930465a20a861ecb42744355d48e48San Mehat throws IllegalArgumentException, SecurityException; 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of the calling thread, based on Linux priorities. See 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)} for more information. 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setThreadPriority(int, int) 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int priority) 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the current priority of a thread, based on Linux priorities. 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the current priority, as a Linux priority level, 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from -20 for highest scheduling priority to 19 for lowest scheduling 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getThreadPriority(int tid) 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException; 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Determine whether the current environment supports multiple processes. 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the system can run in multiple processes, else 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if everything is running in a single process. 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean supportsProcesses(); 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the out-of-memory badness adjustment for a process. 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The process identifier to set. 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param amt Adjustment value -- linux allows -16 to +15. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the underlying system supports this 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * feature, else false. 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean setOomAdj(int pid, int amt); 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change this process's argv[0] parameter. This can be useful to show 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more descriptive information in things like the 'ps' command. 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The new name of this process. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setArgV0(String text); 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Kill the process with the given PID. 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that, though this API allows us to request to 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * kill any process based on its PID, the kernel will 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still impose standard restrictions on which PIDs you 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are actually able to kill. Typically this means only 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the process running the caller's packages/application 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and any additional processes created by that app; packages 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sharing a common UID will also be able to kill each 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other's processes. 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final void killProcess(int pid) { 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sendSignal(pid, SIGNAL_KILL); 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setUid(int uid); 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setGid(int uid); 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a signal to the given process. 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The pid of the target process. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param signal The signal to send. 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void sendSignal(int pid, int signal); 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getFreeMemory(); 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void readProcLines(String path, 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] reqFields, long[] outSizes); 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int[] getPids(String path, int[] lastArray); 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_TERM_MASK = 0xff; 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_ZERO_TERM = 0; 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_SPACE_TERM = (int)' '; 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 758c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final int PROC_TAB_TERM = (int)'\t'; 759c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_COMBINE = 0x100; 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_PARENS = 0x200; 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_STRING = 0x1000; 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_LONG = 0x2000; 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_FLOAT = 0x4000; 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean readProcFile(String file, int[] format, 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] outStrings, long[] outLongs, float[] outFloats); 773c64edde69d18498fb2954f71a546357b07ab996aEvan Millar 774c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 775c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final native boolean parseProcLine(byte[] buffer, int startIndex, 776c64edde69d18498fb2954f71a546357b07ab996aEvan Millar int endIndex, int[] format, String[] outStrings, long[] outLongs, float[] outFloats); 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the total Pss value for a given process, in bytes. 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid the process to the Pss for 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the total Pss value for the given process in bytes, 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or -1 if the value cannot be determined 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getPss(int pid); 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 788