Process.java revision a0c283eac33dd2da72235751bbfa4f2d9898d5ea
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.os; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.LocalSocketAddress; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.LocalSocket; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport dalvik.system.Zygote; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.BufferedWriter; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.DataInputStream; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.IOException; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.OutputStreamWriter; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.ArrayList; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/*package*/ class ZygoteStartFailedEx extends Exception { 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Something prevented the zygote process startup from happening normally 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ZygoteStartFailedEx() {}; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ZygoteStartFailedEx(String s) {super(s);} 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ZygoteStartFailedEx(Throwable cause) {super(cause);} 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tools for managing OS processes. 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Process { 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String LOG_TAG = "Process"; 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String ZYGOTE_SOCKET = "zygote"; 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Name of a process for running the platform's media services. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ANDROID_SHARED_MEDIA = "com.android.process.media"; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Name of the process that Google content providers can share. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String GOOGLE_SHARED_APP_CONTENT = "com.google.process.content"; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the UID/GID under which system code runs. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SYSTEM_UID = 1000; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the UID/GID under which the telephony code runs. 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PHONE_UID = 1001; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 71854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn * Defines the UID/GID for the user shell. 72854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn * @hide 73854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn */ 74854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn public static final int SHELL_UID = 2000; 75854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn 76854060af30f928c0a65591e9c8314ae17056e6b8Dianne Hackborn /** 77d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood * Defines the UID/GID for the log group. 78d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood * @hide 79d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood */ 80d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood public static final int LOG_UID = 1007; 81d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood 82d42685d5de1dbd6d75b48d42418f370adaa4daefMike Lockwood /** 83d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani * Defines the UID/GID for the WIFI supplicant process. 84d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani * @hide 85d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani */ 86d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani public static final int WIFI_UID = 1010; 87d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani 88d158214511a3c04753de04fa6389e46d33135c38Amith Yamasani /** 898b7d1b4d4a33e9429c5cedaa6317efcaad95da68Glenn Kasten * Defines the UID/GID for the mediaserver process. 908b7d1b4d4a33e9429c5cedaa6317efcaad95da68Glenn Kasten * @hide 918b7d1b4d4a33e9429c5cedaa6317efcaad95da68Glenn Kasten */ 928b7d1b4d4a33e9429c5cedaa6317efcaad95da68Glenn Kasten public static final int MEDIA_UID = 1013; 938b7d1b4d4a33e9429c5cedaa6317efcaad95da68Glenn Kasten 948b7d1b4d4a33e9429c5cedaa6317efcaad95da68Glenn Kasten /** 9558fd98accbff409601587b3357f2b3acf370f606Mike Lockwood * Defines the GID for the group that allows write access to the SD card. 9658fd98accbff409601587b3357f2b3acf370f606Mike Lockwood * @hide 9758fd98accbff409601587b3357f2b3acf370f606Mike Lockwood */ 9858fd98accbff409601587b3357f2b3acf370f606Mike Lockwood public static final int SDCARD_RW_GID = 1015; 9958fd98accbff409601587b3357f2b3acf370f606Mike Lockwood 10058fd98accbff409601587b3357f2b3acf370f606Mike Lockwood /** 101cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly * Defines the UID/GID for the NFC service process. 102cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly * @hide 103cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly */ 104a5cb9f42174a52afbeb7e33dab64282f52f8cedbNick Pelly public static final int NFC_UID = 1027; 105cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly 106cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly /** 107dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood * Defines the GID for the group that allows write access to the internal media storage. 108dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood * @hide 109dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood */ 110dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood public static final int MEDIA_RW_GID = 1023; 111dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood 112dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood /** 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the start of a range of UIDs (and GIDs), going from this 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * number to {@link #LAST_APPLICATION_UID} that are reserved for assigning 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to applications. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FIRST_APPLICATION_UID = 10000; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Last of application-specific UIDs starting at 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FIRST_APPLICATION_UID}. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 122a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn public static final int LAST_APPLICATION_UID = 89999; 123a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn 124a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn /** 125a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * First uid used for fully isolated sandboxed processes (with no permissions of their own) 126a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * @hide 127a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn */ 128a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn public static final int FIRST_ISOLATED_UID = 99000; 129a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn 130a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn /** 131a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * Last uid used for fully isolated sandboxed processes (with no permissions of their own) 132a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * @hide 133a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn */ 134a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn public static final int LAST_ISOLATED_UID = 99999; 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines a secondary group id for access to the bluetooth hardware. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BLUETOOTH_GID = 2000; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of application threads. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DEFAULT = 0; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Keep in sync with utils/threads.h ** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Lowest available thread priority. Only for those who really, really 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't want to run if anything else is happening. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LOWEST = 19; 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority background threads. This gives your thread a slightly 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lower than normal priority, so that it will have less chance of impacting 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the responsiveness of the user interface. 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_BACKGROUND = 10; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of threads that are currently running a user interface 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that the user is interacting with. Applications can not normally 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority; the system will automatically adjust your 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application threads as the user moves through the UI. 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_FOREGROUND = -2; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of system display threads, involved in updating 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the user interface. Applications can not 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * normally change to this priority. 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DISPLAY = -4; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important display threads, for compositing 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the screen and retrieving input events. Applications can not normally 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_DISPLAY = -8; 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of audio threads. Applications can not normally 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_AUDIO = -16; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important audio threads. 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications can not normally change to this priority. 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_AUDIO = -19; 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority more favorable. 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_MORE_FAVORABLE = -1; 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority less favorable. 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LESS_FAVORABLE = +1; 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 233e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 2346793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Default scheduling policy 2356793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2366793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2376793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_OTHER = 0; 2386793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2396793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2406793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * First-In First-Out scheduling policy 2416793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2426793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2436793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_FIFO = 1; 2446793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2456793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2466793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Round-Robin scheduling policy 2476793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2486793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2496793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_RR = 2; 2506793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2516793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2526793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Batch scheduling policy 2536793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2546793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2556793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_BATCH = 3; 2566793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2576793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2586793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Idle scheduling policy 2596793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2606793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2616793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_IDLE = 5; 2626793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2636793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 264e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Default thread group - gets a 'normal' share of the CPU 265e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 266e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 267e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_DEFAULT = 0; 268e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 269e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 270e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Background non-interactive thread group - All threads in 271e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * this group are scheduled with a reduced share of the CPU. 272e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 273e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 274e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_BG_NONINTERACTIVE = 1; 275e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 276e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 277e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Foreground 'boost' thread group - All threads in 278e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * this group are scheduled with an increased share of the CPU 279e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 280e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat **/ 281e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final int THREAD_GROUP_FG_BOOST = 2; 282e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_QUIT = 3; 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_KILL = 9; 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_USR1 = 10; 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // State for communicating with zygote process 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static LocalSocket sZygoteSocket; 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static DataInputStream sZygoteInputStream; 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static BufferedWriter sZygoteWriter; 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** true if previous zygote open failed */ 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static boolean sPreviousZygoteOpenFailed; 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start a new process. 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are enabled, a new process is created and the 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * static main() function of a <var>processClass</var> is executed there. 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The process will continue running after this function returns. 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are not enabled, a new thread in the caller's 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * process is created and main() of <var>processClass</var> called there. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The niceName parameter, if not an empty string, is a custom name to 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * give to the process instead of using processClass. This allows you to 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make easily identifyable processes even if you are using the same base 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>processClass</var> to start them. 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass The class to use as the process's main entry 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * point. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName A more readable name to use for the process. 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid The user-id under which the process will run. 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid The group-id under which the process will run. 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids Additional group-ids associated with the process. 317e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param debugFlags Additional flags. 318e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param targetSdkVersion The target SDK version for the app. 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param zygoteArgs Additional arguments to supply to the zygote process. 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3213f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @return An object that describes the result of the attempt to start the process. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException on fatal start failure 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3263f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public static final ProcessStartResult start(final String processClass, 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int uid, int gid, int[] gids, 329e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes int debugFlags, int targetSdkVersion, 33010e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown String[] zygoteArgs) { 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 33210e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown return startViaZygote(processClass, niceName, uid, gid, gids, 33310e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown debugFlags, targetSdkVersion, zygoteArgs); 33410e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown } catch (ZygoteStartFailedEx ex) { 33510e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown Log.e(LOG_TAG, 33610e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown "Starting VM process through Zygote failed"); 33710e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown throw new RuntimeException( 33810e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown "Starting VM process through Zygote failed", ex); 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** retry interval for opening a zygote socket */ 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int ZYGOTE_RETRY_MILLIS = 500; 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to open socket to Zygote process if not already open. If 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * already open, does nothing. May block and retry. 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void openZygoteSocketIfNeeded() 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int retryCount; 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sPreviousZygoteOpenFailed) { 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If we've failed before, expect that we'll fail again and 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't pause for retries. 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 0; 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 10; 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See bug #811181: Sometimes runtime can make it up before zygote. 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Really, we'd like to do something better to avoid this condition, 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but for now just wait a bit... 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int retry = 0 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; (sZygoteSocket == null) && (retry < (retryCount + 1)) 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; retry++ ) { 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (retry > 0) { 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Zygote not up yet, sleeping..."); 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Thread.sleep(ZYGOTE_RETRY_MILLIS); 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InterruptedException ex) { 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // should never happen 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = new LocalSocket(); 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.connect(new LocalSocketAddress(ZYGOTE_SOCKET, 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LocalSocketAddress.Namespace.RESERVED)); 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteInputStream 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new DataInputStream(sZygoteSocket.getInputStream()); 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter = 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new BufferedWriter( 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new OutputStreamWriter( 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.getOutputStream()), 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 256); 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Process: zygote socket opened"); 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = false; 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on close after exception", 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ex2); 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket == null) { 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = true; 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("connect failed"); 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends an argument list to the zygote process, which starts a new child 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and returns the child's pid. Please note: the present implementation 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * replaces newlines in the argument list with spaces. 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param args argument list 4263f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @return An object that describes the result of the attempt to start the process. 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4293f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown private static ProcessStartResult zygoteSendArgsAndGetResult(ArrayList<String> args) 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project openZygoteSocketIfNeeded(); 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See com.android.internal.os.ZygoteInit.readArgumentList() 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Presently the wire format to the zygote process is: 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a) a count of arguments (argc, in essence) 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * b) a number of newline-separated argument strings equal to count 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After the zygote process reads these it will write the pid of 4413f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * the child or -1 on failure, followed by boolean to 4423f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * indicate whether a wrapper process was used. 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(Integer.toString(args.size())); 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = args.size(); 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String arg = args.get(i); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (arg.indexOf('\n') >= 0) { 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx( 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "embedded newlines not allowed"); 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(arg); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.flush(); 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should there be a timeout on this? 4623f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown ProcessStartResult result = new ProcessStartResult(); 4633f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown result.pid = sZygoteInputStream.readInt(); 4643f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown if (result.pid < 0) { 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("fork() failed"); 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4673f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown result.usingWrapper = sZygoteInputStream.readBoolean(); 4683f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown return result; 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we're going to fail anyway 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on routine close", ex2); 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx(ex); 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts a new process via the zygote mechanism. 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass Class name whose static main() to run 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName 'nice' process name to appear in ps 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid a POSIX uid that the new process should setuid() to 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid a POSIX gid that the new process shuold setgid() to 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids null-ok; a list of supplementary group IDs that the 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new process should setgroup() to. 494e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param debugFlags Additional flags. 495e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param targetSdkVersion The target SDK version for the app. 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extraArgs Additional arguments to supply to the zygote process. 4973f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @return An object that describes the result of the attempt to start the process. 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5003f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown private static ProcessStartResult startViaZygote(final String processClass, 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int uid, final int gid, 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int[] gids, 504e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes int debugFlags, int targetSdkVersion, 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] extraArgs) 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(Process.class) { 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<String> argsForZygote = new ArrayList<String>(); 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --runtime-init, --setuid=, --setgid=, 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // and --setgroups= must go first 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--runtime-init"); 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setuid=" + uid); 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setgid=" + gid); 515ae07ecf3766c38af1c12822458b98036b28bd4c0Elliott Hughes if ((debugFlags & Zygote.DEBUG_ENABLE_JNI_LOGGING) != 0) { 516ae07ecf3766c38af1c12822458b98036b28bd4c0Elliott Hughes argsForZygote.add("--enable-jni-logging"); 517ae07ecf3766c38af1c12822458b98036b28bd4c0Elliott Hughes } 51823085b781e145ed684e7270af1d5ced6800b8effBen Cheng if ((debugFlags & Zygote.DEBUG_ENABLE_SAFEMODE) != 0) { 51923085b781e145ed684e7270af1d5ced6800b8effBen Cheng argsForZygote.add("--enable-safemode"); 52023085b781e145ed684e7270af1d5ced6800b8effBen Cheng } 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_DEBUGGER) != 0) { 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-debugger"); 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_CHECKJNI) != 0) { 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-checkjni"); 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_ASSERT) != 0) { 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-assert"); 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 530e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes argsForZygote.add("--target-sdk-version=" + targetSdkVersion); 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //TODO optionally enable debuger 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //argsForZygote.add("--enable-debugger"); 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --setgroups is a comma-separated list 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (gids != null && gids.length > 0) { 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("--setgroups="); 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = gids.length; 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (i != 0) { 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(','); 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(gids[i]); 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(sb.toString()); 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (niceName != null) { 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--nice-name=" + niceName); 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(processClass); 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (extraArgs != null) { 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String arg : extraArgs) { 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(arg); 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5633f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown return zygoteSendArgsAndGetResult(argsForZygote); 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns elapsed milliseconds of the time this process has run. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the number of milliseconds this process has return. 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getElapsedCpuTime(); 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process, which can be used with 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #killProcess} and {@link #sendSignal}. 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myPid(); 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of the calling thread, which be used with 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myTid(); 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process's user. 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myUid(); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 591a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * Returns whether the current process is in an isolated sandbox. 592a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * @hide 593a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn */ 594a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn public static final boolean isIsolated() { 595a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn int uid = UserId.getAppId(myUid()); 596a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn return uid >= FIRST_ISOLATED_UID && uid <= LAST_ISOLATED_UID; 597a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn } 598a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn 599a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn /** 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the UID assigned to a particular user name, or -1 if there is 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a uid. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getUidForName(String name); 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the GID assigned to a particular user name, or -1 if there is 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a gid. 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getGidForName(String name); 612819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 613819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani /** 614819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * Returns a uid for a currently running process. 615819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @param pid the process id 616819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @return the uid of the process, or -1 if the process is not running. 617819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @hide pending API council review 618819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani */ 619819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani public static final int getUidForPid(int pid) { 620819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani String[] procStatusLabels = { "Uid:" }; 621819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani long[] procStatusValues = new long[1]; 622819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani procStatusValues[0] = -1; 623819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani Process.readProcLines("/proc/" + pid + "/status", procStatusLabels, procStatusValues); 624819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani return (int) procStatusValues[0]; 625819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani } 626819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 628ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * Returns the parent process id for a currently running process. 629ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * @param pid the process id 630ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * @return the parent process id of the process, or -1 if the process is not running. 631ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * @hide 632ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown */ 633ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown public static final int getParentPid(int pid) { 634ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown String[] procStatusLabels = { "PPid:" }; 635ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown long[] procStatusValues = new long[1]; 636ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown procStatusValues[0] = -1; 637ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown Process.readProcLines("/proc/" + pid + "/status", procStatusLabels, procStatusValues); 638ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown return (int) procStatusValues[0]; 639ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown } 640ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown 641ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown /** 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of a thread, based on Linux priorities. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int tid, int priority) 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 656e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 657e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 658160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * Call with 'false' to cause future calls to {@link #setThreadPriority(int)} to 659160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * throw an exception if passed a background-level thread priority. This is only 660160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * effective if the JNI layer is built with GUARD_THREAD_PRIORITY defined to 1. 661160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * 662160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * @hide 663160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate */ 664160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate public static final native void setCanSelfBackground(boolean backgroundOk); 665160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate 666160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate /** 667e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Sets the scheduling group for a thread. 668e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 669e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @param tid The indentifier of the thread/process to change. 670e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @param group The target group for this thread/process. 671e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * 672e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 673e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * <var>tid</var> does not exist. 674e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws SecurityException Throws SecurityException if your process does 675e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * not have permission to modify the given thread, or to use the given 676e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * priority. 677e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 678e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final native void setThreadGroup(int tid, int group) 679e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat throws IllegalArgumentException, SecurityException; 6803e458241d9930465a20a861ecb42744355d48e48San Mehat /** 6813e458241d9930465a20a861ecb42744355d48e48San Mehat * Sets the scheduling group for a process and all child threads 6823e458241d9930465a20a861ecb42744355d48e48San Mehat * @hide 6833e458241d9930465a20a861ecb42744355d48e48San Mehat * @param pid The indentifier of the process to change. 6843e458241d9930465a20a861ecb42744355d48e48San Mehat * @param group The target group for this process. 6853e458241d9930465a20a861ecb42744355d48e48San Mehat * 6863e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 6873e458241d9930465a20a861ecb42744355d48e48San Mehat * <var>tid</var> does not exist. 6883e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws SecurityException Throws SecurityException if your process does 6893e458241d9930465a20a861ecb42744355d48e48San Mehat * not have permission to modify the given thread, or to use the given 6903e458241d9930465a20a861ecb42744355d48e48San Mehat * priority. 6913e458241d9930465a20a861ecb42744355d48e48San Mehat */ 6923e458241d9930465a20a861ecb42744355d48e48San Mehat public static final native void setProcessGroup(int pid, int group) 6933e458241d9930465a20a861ecb42744355d48e48San Mehat throws IllegalArgumentException, SecurityException; 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of the calling thread, based on Linux priorities. See 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)} for more information. 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setThreadPriority(int, int) 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int priority) 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the current priority of a thread, based on Linux priorities. 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the current priority, as a Linux priority level, 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from -20 for highest scheduling priority to 19 for lowest scheduling 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getThreadPriority(int tid) 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException; 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7296793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Set the scheduling policy and priority of a thread, based on Linux. 7306793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * 7316793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @param tid The identifier of the thread/process to change. 7326793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @param policy A Linux scheduling policy such as SCHED_OTHER etc. 7336793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @param priority A Linux priority level in a range appropriate for the given policy. 7346793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * 7356793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @throws IllegalArgumentException Throws IllegalArgumentException if 7366793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * <var>tid</var> does not exist, or if <var>priority</var> is out of range for the policy. 7376793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @throws SecurityException Throws SecurityException if your process does 7386793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * not have permission to modify the given thread, or to use the given 7396793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * scheduling policy or priority. 7406793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * 7416793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * {@hide} 7426793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 7436793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final native void setThreadScheduler(int tid, int policy, int priority) 7446793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten throws IllegalArgumentException; 7456793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 7466793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Determine whether the current environment supports multiple processes. 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the system can run in multiple processes, else 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if everything is running in a single process. 75110e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown * 75210e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown * @deprecated This method always returns true. Do not use. 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 75410e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown @Deprecated 75510e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown public static final boolean supportsProcesses() { 75610e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown return true; 75710e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown } 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the out-of-memory badness adjustment for a process. 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The process identifier to set. 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param amt Adjustment value -- linux allows -16 to +15. 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the underlying system supports this 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * feature, else false. 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean setOomAdj(int pid, int amt); 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change this process's argv[0] parameter. This can be useful to show 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more descriptive information in things like the 'ps' command. 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The new name of this process. 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setArgV0(String text); 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Kill the process with the given PID. 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that, though this API allows us to request to 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * kill any process based on its PID, the kernel will 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still impose standard restrictions on which PIDs you 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are actually able to kill. Typically this means only 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the process running the caller's packages/application 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and any additional processes created by that app; packages 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sharing a common UID will also be able to kill each 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other's processes. 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final void killProcess(int pid) { 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sendSignal(pid, SIGNAL_KILL); 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setUid(int uid); 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setGid(int uid); 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a signal to the given process. 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The pid of the target process. 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param signal The signal to send. 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void sendSignal(int pid, int signal); 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 811906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn /** 812906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * @hide 813906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * Private impl for avoiding a log message... DO NOT USE without doing 814906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * your own log, or the Android Illuminati will find you some night and 815906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * beat you up. 816906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn */ 817906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn public static final void killProcessQuiet(int pid) { 818906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn sendSignalQuiet(pid, SIGNAL_KILL); 819906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn } 820906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn 821906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn /** 822906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * @hide 823906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * Private impl for avoiding a log message... DO NOT USE without doing 824906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * your own log, or the Android Illuminati will find you some night and 825906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * beat you up. 826906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn */ 827906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn public static final native void sendSignalQuiet(int pid, int signal); 828906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8300bca96bcbfe559f9330a01f723c5c9cba51ec05aMarco Nelissen public static final native long getFreeMemory(); 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void readProcLines(String path, 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] reqFields, long[] outSizes); 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int[] getPids(String path, int[] lastArray); 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_TERM_MASK = 0xff; 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_ZERO_TERM = 0; 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_SPACE_TERM = (int)' '; 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 846c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final int PROC_TAB_TERM = (int)'\t'; 847c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_COMBINE = 0x100; 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_PARENS = 0x200; 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_STRING = 0x1000; 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_LONG = 0x2000; 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_FLOAT = 0x4000; 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean readProcFile(String file, int[] format, 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] outStrings, long[] outLongs, float[] outFloats); 861c64edde69d18498fb2954f71a546357b07ab996aEvan Millar 862c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 863c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final native boolean parseProcLine(byte[] buffer, int startIndex, 864c64edde69d18498fb2954f71a546357b07ab996aEvan Millar int endIndex, int[] format, String[] outStrings, long[] outLongs, float[] outFloats); 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the total Pss value for a given process, in bytes. 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid the process to the Pss for 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the total Pss value for the given process in bytes, 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or -1 if the value cannot be determined 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getPss(int pid); 8753f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown 8763f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown /** 8773f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * Specifies the outcome of having started a process. 8783f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @hide 8793f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown */ 8803f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public static final class ProcessStartResult { 8813f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown /** 8823f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * The PID of the newly started process. 8833f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * Always >= 0. (If the start failed, an exception will have been thrown instead.) 8843f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown */ 8853f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public int pid; 8863f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown 8873f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown /** 8883f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * True if the process was started with a wrapper attached. 8893f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown */ 8903f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public boolean usingWrapper; 8913f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown } 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 893