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