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 /** 955294a2fc2f401cd248a4bc3f0f9ee1e2854f4e9aJeff Sharkey * Defines the UID/GID for the DRM process. 965294a2fc2f401cd248a4bc3f0f9ee1e2854f4e9aJeff Sharkey * @hide 975294a2fc2f401cd248a4bc3f0f9ee1e2854f4e9aJeff Sharkey */ 985294a2fc2f401cd248a4bc3f0f9ee1e2854f4e9aJeff Sharkey public static final int DRM_UID = 1019; 995294a2fc2f401cd248a4bc3f0f9ee1e2854f4e9aJeff Sharkey 1005294a2fc2f401cd248a4bc3f0f9ee1e2854f4e9aJeff Sharkey /** 10158fd98accbff409601587b3357f2b3acf370f606Mike Lockwood * Defines the GID for the group that allows write access to the SD card. 10258fd98accbff409601587b3357f2b3acf370f606Mike Lockwood * @hide 10358fd98accbff409601587b3357f2b3acf370f606Mike Lockwood */ 10458fd98accbff409601587b3357f2b3acf370f606Mike Lockwood public static final int SDCARD_RW_GID = 1015; 10558fd98accbff409601587b3357f2b3acf370f606Mike Lockwood 10658fd98accbff409601587b3357f2b3acf370f606Mike Lockwood /** 10726993b37d525fd64efebd51daec1b4abfebd8a74Kenny Root * Defines the UID/GID for the group that controls VPN services. 10826993b37d525fd64efebd51daec1b4abfebd8a74Kenny Root * @hide 10926993b37d525fd64efebd51daec1b4abfebd8a74Kenny Root */ 11026993b37d525fd64efebd51daec1b4abfebd8a74Kenny Root public static final int VPN_UID = 1016; 11126993b37d525fd64efebd51daec1b4abfebd8a74Kenny Root 11226993b37d525fd64efebd51daec1b4abfebd8a74Kenny Root /** 113cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly * Defines the UID/GID for the NFC service process. 114cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly * @hide 115cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly */ 116a5cb9f42174a52afbeb7e33dab64282f52f8cedbNick Pelly public static final int NFC_UID = 1027; 117cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly 118cd0e839a2448deea50f79bddeba782c546b33893Nick Pelly /** 119dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood * Defines the GID for the group that allows write access to the internal media storage. 120dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood * @hide 121dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood */ 122dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood public static final int MEDIA_RW_GID = 1023; 123dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood 124dcaa10cd361a543cfa93bbb5c53444f437bd07a4Mike Lockwood /** 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines the start of a range of UIDs (and GIDs), going from this 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * number to {@link #LAST_APPLICATION_UID} that are reserved for assigning 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to applications. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FIRST_APPLICATION_UID = 10000; 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Last of application-specific UIDs starting at 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FIRST_APPLICATION_UID}. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13421fbd1f7da53dc044737803dccddf8099f1fc1e9Dianne Hackborn public static final int LAST_APPLICATION_UID = 19999; 135a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn 136a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn /** 137a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * First uid used for fully isolated sandboxed processes (with no permissions of their own) 138a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * @hide 139a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn */ 140a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn public static final int FIRST_ISOLATED_UID = 99000; 141a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn 142a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn /** 143a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * Last uid used for fully isolated sandboxed processes (with no permissions of their own) 144a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * @hide 145a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn */ 146a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn public static final int LAST_ISOLATED_UID = 99999; 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Defines a secondary group id for access to the bluetooth hardware. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BLUETOOTH_GID = 2000; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of application threads. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DEFAULT = 0; 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ** Keep in sync with utils/threads.h ** 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * *************************************** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Lowest available thread priority. Only for those who really, really 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't want to run if anything else is happening. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LOWEST = 19; 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority background threads. This gives your thread a slightly 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lower than normal priority, so that it will have less chance of impacting 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the responsiveness of the user interface. 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_BACKGROUND = 10; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of threads that are currently running a user interface 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that the user is interacting with. Applications can not normally 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority; the system will automatically adjust your 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application threads as the user moves through the UI. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_FOREGROUND = -2; 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of system display threads, involved in updating 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the user interface. Applications can not 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * normally change to this priority. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_DISPLAY = -4; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important display threads, for compositing 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the screen and retrieving input events. Applications can not normally 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_DISPLAY = -8; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of audio threads. Applications can not normally 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change to this priority. 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_AUDIO = -16; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Standard priority of the most important audio threads. 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications can not normally change to this priority. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use with {@link #setThreadPriority(int)} and 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}, <b>not</b> with the normal 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link java.lang.Thread} class. 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_URGENT_AUDIO = -19; 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority more favorable. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_MORE_FAVORABLE = -1; 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Minimum increment to make a priority less favorable. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int THREAD_PRIORITY_LESS_FAVORABLE = +1; 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 245e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 2466793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Default scheduling policy 2476793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2486793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2496793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_OTHER = 0; 2506793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2516793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2526793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * First-In First-Out scheduling policy 2536793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2546793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2556793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_FIFO = 1; 2566793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2576793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2586793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Round-Robin scheduling policy 2596793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2606793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2616793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_RR = 2; 2626793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2636793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2646793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Batch scheduling policy 2656793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2666793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2676793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_BATCH = 3; 2686793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 2696793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 2706793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Idle scheduling policy 2716793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @hide 2726793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 2736793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final int SCHED_IDLE = 5; 2746793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 275f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten // Keep in sync with SP_* constants of enum type SchedPolicy 276f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten // declared in system/core/include/cutils/sched_policy.h, 277f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten // except THREAD_GROUP_DEFAULT does not correspond to any SP_* value. 278f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten 2796793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 280f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * Default thread group - 281f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * has meaning with setProcessGroup() only, cannot be used with setThreadGroup(). 282f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * When used with setProcessGroup(), the group of each thread in the process 283f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * is conditionally changed based on that thread's current priority, as follows: 284f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * threads with priority numerically less than THREAD_PRIORITY_BACKGROUND 285f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * are moved to foreground thread group. All other threads are left unchanged. 286e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 287e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 288f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten public static final int THREAD_GROUP_DEFAULT = -1; 289e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 290e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 291f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * Background thread group - All threads in 292e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * this group are scheduled with a reduced share of the CPU. 293f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * Value is same as constant SP_BACKGROUND of enum SchedPolicy. 294f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * FIXME rename to THREAD_GROUP_BACKGROUND. 295e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 296e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 297f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten public static final int THREAD_GROUP_BG_NONINTERACTIVE = 0; 298e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 299e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 300f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * Foreground thread group - All threads in 301f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * this group are scheduled with a normal share of the CPU. 302f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * Value is same as constant SP_FOREGROUND of enum SchedPolicy. 303f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * Not used at this level. 304e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 305e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat **/ 306f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten private static final int THREAD_GROUP_FOREGROUND = 1; 307e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 30807b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten /** 30907b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * System thread group. 31007b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * @hide 31107b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten **/ 31207b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten public static final int THREAD_GROUP_SYSTEM = 2; 31307b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten 31407b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten /** 31507b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * Application audio thread group. 31607b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * @hide 31707b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten **/ 31807b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten public static final int THREAD_GROUP_AUDIO_APP = 3; 31907b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten 32007b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten /** 32107b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * System audio thread group. 32207b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * @hide 32307b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten **/ 32407b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten public static final int THREAD_GROUP_AUDIO_SYS = 4; 32507b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_QUIT = 3; 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_KILL = 9; 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SIGNAL_USR1 = 10; 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // State for communicating with zygote process 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static LocalSocket sZygoteSocket; 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static DataInputStream sZygoteInputStream; 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static BufferedWriter sZygoteWriter; 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** true if previous zygote open failed */ 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static boolean sPreviousZygoteOpenFailed; 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start a new process. 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are enabled, a new process is created and the 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * static main() function of a <var>processClass</var> is executed there. 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The process will continue running after this function returns. 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If processes are not enabled, a new thread in the caller's 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * process is created and main() of <var>processClass</var> called there. 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The niceName parameter, if not an empty string, is a custom name to 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * give to the process instead of using processClass. This allows you to 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make easily identifyable processes even if you are using the same base 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>processClass</var> to start them. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass The class to use as the process's main entry 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * point. 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName A more readable name to use for the process. 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid The user-id under which the process will run. 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid The group-id under which the process will run. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids Additional group-ids associated with the process. 360e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param debugFlags Additional flags. 361e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param targetSdkVersion The target SDK version for the app. 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param zygoteArgs Additional arguments to supply to the zygote process. 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3643f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @return An object that describes the result of the attempt to start the process. 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws RuntimeException on fatal start failure 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3693f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public static final ProcessStartResult start(final String processClass, 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int uid, int gid, int[] gids, 372e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes int debugFlags, int targetSdkVersion, 37310e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown String[] zygoteArgs) { 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 37510e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown return startViaZygote(processClass, niceName, uid, gid, gids, 37610e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown debugFlags, targetSdkVersion, zygoteArgs); 37710e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown } catch (ZygoteStartFailedEx ex) { 37810e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown Log.e(LOG_TAG, 37910e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown "Starting VM process through Zygote failed"); 38010e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown throw new RuntimeException( 38110e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown "Starting VM process through Zygote failed", ex); 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** retry interval for opening a zygote socket */ 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int ZYGOTE_RETRY_MILLIS = 500; 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to open socket to Zygote process if not already open. If 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * already open, does nothing. May block and retry. 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void openZygoteSocketIfNeeded() 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int retryCount; 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sPreviousZygoteOpenFailed) { 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If we've failed before, expect that we'll fail again and 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * don't pause for retries. 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 0; 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project retryCount = 10; 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See bug #811181: Sometimes runtime can make it up before zygote. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Really, we'd like to do something better to avoid this condition, 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but for now just wait a bit... 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int retry = 0 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; (sZygoteSocket == null) && (retry < (retryCount + 1)) 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; retry++ ) { 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (retry > 0) { 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Zygote not up yet, sleeping..."); 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Thread.sleep(ZYGOTE_RETRY_MILLIS); 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InterruptedException ex) { 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // should never happen 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = new LocalSocket(); 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.connect(new LocalSocketAddress(ZYGOTE_SOCKET, 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LocalSocketAddress.Namespace.RESERVED)); 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteInputStream 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new DataInputStream(sZygoteSocket.getInputStream()); 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter = 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new BufferedWriter( 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new OutputStreamWriter( 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.getOutputStream()), 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 256); 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.i("Zygote", "Process: zygote socket opened"); 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = false; 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on close after exception", 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ex2); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket == null) { 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sPreviousZygoteOpenFailed = true; 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("connect failed"); 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends an argument list to the zygote process, which starts a new child 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and returns the child's pid. Please note: the present implementation 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * replaces newlines in the argument list with spaces. 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param args argument list 4693f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @return An object that describes the result of the attempt to start the process. 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4723f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown private static ProcessStartResult zygoteSendArgsAndGetResult(ArrayList<String> args) 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project openZygoteSocketIfNeeded(); 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See com.android.internal.os.ZygoteInit.readArgumentList() 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Presently the wire format to the zygote process is: 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a) a count of arguments (argc, in essence) 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * b) a number of newline-separated argument strings equal to count 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After the zygote process reads these it will write the pid of 4843f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * the child or -1 on failure, followed by boolean to 4853f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * indicate whether a wrapper process was used. 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(Integer.toString(args.size())); 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = args.size(); 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String arg = args.get(i); 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (arg.indexOf('\n') >= 0) { 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx( 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "embedded newlines not allowed"); 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.write(arg); 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.newLine(); 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteWriter.flush(); 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should there be a timeout on this? 5053f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown ProcessStartResult result = new ProcessStartResult(); 5063f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown result.pid = sZygoteInputStream.readInt(); 5073f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown if (result.pid < 0) { 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx("fork() failed"); 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5103f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown result.usingWrapper = sZygoteInputStream.readBoolean(); 5113f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown return result; 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex) { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sZygoteSocket != null) { 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket.close(); 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ex2) { 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we're going to fail anyway 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(LOG_TAG,"I/O exception on routine close", ex2); 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sZygoteSocket = null; 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ZygoteStartFailedEx(ex); 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Starts a new process via the zygote mechanism. 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param processClass Class name whose static main() to run 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param niceName 'nice' process name to appear in ps 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param uid a POSIX uid that the new process should setuid() to 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gid a POSIX gid that the new process shuold setgid() to 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gids null-ok; a list of supplementary group IDs that the 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new process should setgroup() to. 537e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param debugFlags Additional flags. 538e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes * @param targetSdkVersion The target SDK version for the app. 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extraArgs Additional arguments to supply to the zygote process. 5403f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @return An object that describes the result of the attempt to start the process. 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ZygoteStartFailedEx if process start failed for any reason 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5433f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown private static ProcessStartResult startViaZygote(final String processClass, 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String niceName, 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int uid, final int gid, 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int[] gids, 547e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes int debugFlags, int targetSdkVersion, 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] extraArgs) 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws ZygoteStartFailedEx { 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(Process.class) { 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<String> argsForZygote = new ArrayList<String>(); 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --runtime-init, --setuid=, --setgid=, 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // and --setgroups= must go first 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--runtime-init"); 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setuid=" + uid); 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--setgid=" + gid); 558ae07ecf3766c38af1c12822458b98036b28bd4c0Elliott Hughes if ((debugFlags & Zygote.DEBUG_ENABLE_JNI_LOGGING) != 0) { 559ae07ecf3766c38af1c12822458b98036b28bd4c0Elliott Hughes argsForZygote.add("--enable-jni-logging"); 560ae07ecf3766c38af1c12822458b98036b28bd4c0Elliott Hughes } 56123085b781e145ed684e7270af1d5ced6800b8effBen Cheng if ((debugFlags & Zygote.DEBUG_ENABLE_SAFEMODE) != 0) { 56223085b781e145ed684e7270af1d5ced6800b8effBen Cheng argsForZygote.add("--enable-safemode"); 56323085b781e145ed684e7270af1d5ced6800b8effBen Cheng } 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_DEBUGGER) != 0) { 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-debugger"); 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_CHECKJNI) != 0) { 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-checkjni"); 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((debugFlags & Zygote.DEBUG_ENABLE_ASSERT) != 0) { 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--enable-assert"); 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 573e1dfcb7ab01fb991079ec1f70f75281a0ca9073eElliott Hughes argsForZygote.add("--target-sdk-version=" + targetSdkVersion); 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //TODO optionally enable debuger 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //argsForZygote.add("--enable-debugger"); 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --setgroups is a comma-separated list 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (gids != null && gids.length > 0) { 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuilder sb = new StringBuilder(); 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("--setgroups="); 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int sz = gids.length; 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < sz; i++) { 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (i != 0) { 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(','); 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append(gids[i]); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(sb.toString()); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (niceName != null) { 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add("--nice-name=" + niceName); 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(processClass); 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (extraArgs != null) { 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (String arg : extraArgs) { 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project argsForZygote.add(arg); 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6063f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown return zygoteSendArgsAndGetResult(argsForZygote); 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns elapsed milliseconds of the time this process has run. 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the number of milliseconds this process has return. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getElapsedCpuTime(); 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process, which can be used with 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #killProcess} and {@link #sendSignal}. 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myPid(); 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of the calling thread, which be used with 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)}. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myTid(); 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the identifier of this process's user. 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int myUid(); 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 634a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * Returns whether the current process is in an isolated sandbox. 635a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn * @hide 636a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn */ 637a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn public static final boolean isIsolated() { 638a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn int uid = UserId.getAppId(myUid()); 639a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn return uid >= FIRST_ISOLATED_UID && uid <= LAST_ISOLATED_UID; 640a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn } 641a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn 642a0c283eac33dd2da72235751bbfa4f2d9898d5eaDianne Hackborn /** 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the UID assigned to a particular user name, or -1 if there is 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a uid. 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getUidForName(String name); 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the GID assigned to a particular user name, or -1 if there is 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none. If the given string consists of only numbers, it is converted 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * directly to a gid. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getGidForName(String name); 655819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 656819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani /** 657819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * Returns a uid for a currently running process. 658819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @param pid the process id 659819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @return the uid of the process, or -1 if the process is not running. 660819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani * @hide pending API council review 661819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani */ 662819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani public static final int getUidForPid(int pid) { 663819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani String[] procStatusLabels = { "Uid:" }; 664819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani long[] procStatusValues = new long[1]; 665819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani procStatusValues[0] = -1; 666819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani Process.readProcLines("/proc/" + pid + "/status", procStatusLabels, procStatusValues); 667819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani return (int) procStatusValues[0]; 668819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani } 669819f928f6a9dc3fdf408236f33e17f03a7dfed2cAmith Yamasani 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 671ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * Returns the parent process id for a currently running process. 672ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * @param pid the process id 673ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * @return the parent process id of the process, or -1 if the process is not running. 674ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown * @hide 675ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown */ 676ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown public static final int getParentPid(int pid) { 677ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown String[] procStatusLabels = { "PPid:" }; 678ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown long[] procStatusValues = new long[1]; 679ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown procStatusValues[0] = -1; 680ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown Process.readProcLines("/proc/" + pid + "/status", procStatusLabels, procStatusValues); 681ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown return (int) procStatusValues[0]; 682ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown } 683ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown 684ebed7d6e35f7f960e6e6add2b8ab7c7a31a511c3Jeff Brown /** 68507b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * Returns the thread group leader id for a currently running thread. 68607b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * @param tid the thread id 68707b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * @return the thread group leader id of the thread, or -1 if the thread is not running. 68807b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * This is same as what getpid(2) would return if called by tid. 68907b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten * @hide 69007b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten */ 69107b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten public static final int getThreadGroupLeader(int tid) { 69207b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten String[] procStatusLabels = { "Tgid:" }; 69307b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten long[] procStatusValues = new long[1]; 69407b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten procStatusValues[0] = -1; 69507b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten Process.readProcLines("/proc/" + tid + "/status", procStatusLabels, procStatusValues); 69607b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten return (int) procStatusValues[0]; 69707b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten } 69807b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten 69907b0465095bd9ab3412caefa4fcacbdc3825c64bGlenn Kasten /** 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of a thread, based on Linux priorities. 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int tid, int priority) 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 714e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat 715e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat /** 716160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * Call with 'false' to cause future calls to {@link #setThreadPriority(int)} to 717160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * throw an exception if passed a background-level thread priority. This is only 718160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * effective if the JNI layer is built with GUARD_THREAD_PRIORITY defined to 1. 719160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * 720160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate * @hide 721160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate */ 722160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate public static final native void setCanSelfBackground(boolean backgroundOk); 723160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate 724160edb3645f8b7012bab70ae6e6e8c4a5733082bChristopher Tate /** 725e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * Sets the scheduling group for a thread. 726e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @hide 727f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * @param tid The identifier of the thread to change. 728f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * @param group The target group for this thread from THREAD_GROUP_*. 729e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * 730e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 731e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * <var>tid</var> does not exist. 732e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * @throws SecurityException Throws SecurityException if your process does 733e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * not have permission to modify the given thread, or to use the given 734e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat * priority. 735f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * If the thread is a thread group leader, that is it's gettid() == getpid(), 736f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * then the other threads in the same thread group are _not_ affected. 737e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat */ 738e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat public static final native void setThreadGroup(int tid, int group) 739e9d376b801b7890b1ef5006ed55de4208e64bb63San Mehat throws IllegalArgumentException, SecurityException; 740f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten 7413e458241d9930465a20a861ecb42744355d48e48San Mehat /** 7423e458241d9930465a20a861ecb42744355d48e48San Mehat * Sets the scheduling group for a process and all child threads 7433e458241d9930465a20a861ecb42744355d48e48San Mehat * @hide 744f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * @param pid The identifier of the process to change. 745f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * @param group The target group for this process from THREAD_GROUP_*. 7463e458241d9930465a20a861ecb42744355d48e48San Mehat * 7473e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws IllegalArgumentException Throws IllegalArgumentException if 7483e458241d9930465a20a861ecb42744355d48e48San Mehat * <var>tid</var> does not exist. 7493e458241d9930465a20a861ecb42744355d48e48San Mehat * @throws SecurityException Throws SecurityException if your process does 7503e458241d9930465a20a861ecb42744355d48e48San Mehat * not have permission to modify the given thread, or to use the given 7513e458241d9930465a20a861ecb42744355d48e48San Mehat * priority. 752f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * 753f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * group == THREAD_GROUP_DEFAULT means to move all non-background priority 754f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * threads to the foreground scheduling group, but to leave background 755f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * priority threads alone. group == THREAD_GROUP_BG_NONINTERACTIVE moves all 756f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * threads, regardless of priority, to the background scheduling group. 757f1b56449f58963e4f0473d5e26961f68c31759f4Glenn Kasten * group == THREAD_GROUP_FOREGROUND is not allowed. 7583e458241d9930465a20a861ecb42744355d48e48San Mehat */ 7593e458241d9930465a20a861ecb42744355d48e48San Mehat public static final native void setProcessGroup(int pid, int group) 7603e458241d9930465a20a861ecb42744355d48e48San Mehat throws IllegalArgumentException, SecurityException; 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the priority of the calling thread, based on Linux priorities. See 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #setThreadPriority(int, int)} for more information. 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param priority A Linux priority level, from -20 for highest scheduling 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority to 19 for lowest scheduling priority. 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws SecurityException Throws SecurityException if your process does 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not have permission to modify the given thread, or to use the given 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setThreadPriority(int, int) 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setThreadPriority(int priority) 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException, SecurityException; 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the current priority of a thread, based on Linux priorities. 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tid The identifier of the thread/process to change. 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the current priority, as a Linux priority level, 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from -20 for highest scheduling priority to 19 for lowest scheduling 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * priority. 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException Throws IllegalArgumentException if 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>tid</var> does not exist. 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int getThreadPriority(int tid) 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IllegalArgumentException; 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7966793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * Set the scheduling policy and priority of a thread, based on Linux. 7976793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * 7986793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @param tid The identifier of the thread/process to change. 7996793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @param policy A Linux scheduling policy such as SCHED_OTHER etc. 8006793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @param priority A Linux priority level in a range appropriate for the given policy. 8016793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * 8026793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @throws IllegalArgumentException Throws IllegalArgumentException if 8036793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * <var>tid</var> does not exist, or if <var>priority</var> is out of range for the policy. 8046793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * @throws SecurityException Throws SecurityException if your process does 8056793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * not have permission to modify the given thread, or to use the given 8066793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * scheduling policy or priority. 8076793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * 8086793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten * {@hide} 8096793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten */ 8106793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten public static final native void setThreadScheduler(int tid, int policy, int priority) 8116793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten throws IllegalArgumentException; 8126793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten 8136793ac943afeb16642f477c43ddfd27e498db37bGlenn Kasten /** 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Determine whether the current environment supports multiple processes. 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the system can run in multiple processes, else 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false if everything is running in a single process. 81810e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown * 81910e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown * @deprecated This method always returns true. Do not use. 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 82110e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown @Deprecated 82210e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown public static final boolean supportsProcesses() { 82310e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown return true; 82410e89712863f5b91a2982dc1783fbdfe39c1485dJeff Brown } 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the out-of-memory badness adjustment for a process. 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The process identifier to set. 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param amt Adjustment value -- linux allows -16 to +15. 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the underlying system supports this 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * feature, else false. 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean setOomAdj(int pid, int amt); 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change this process's argv[0] parameter. This can be useful to show 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more descriptive information in things like the 'ps' command. 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The new name of this process. 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void setArgV0(String text); 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Kill the process with the given PID. 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that, though this API allows us to request to 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * kill any process based on its PID, the kernel will 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still impose standard restrictions on which PIDs you 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are actually able to kill. Typically this means only 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the process running the caller's packages/application 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and any additional processes created by that app; packages 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sharing a common UID will also be able to kill each 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other's processes. 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final void killProcess(int pid) { 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sendSignal(pid, SIGNAL_KILL); 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setUid(int uid); 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int setGid(int uid); 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Send a signal to the given process. 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid The pid of the target process. 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param signal The signal to send. 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void sendSignal(int pid, int signal); 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 878906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn /** 879906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * @hide 880906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * Private impl for avoiding a log message... DO NOT USE without doing 881906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * your own log, or the Android Illuminati will find you some night and 882906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * beat you up. 883906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn */ 884906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn public static final void killProcessQuiet(int pid) { 885906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn sendSignalQuiet(pid, SIGNAL_KILL); 886906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn } 887906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn 888906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn /** 889906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * @hide 890906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * Private impl for avoiding a log message... DO NOT USE without doing 891906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * your own log, or the Android Illuminati will find you some night and 892906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn * beat you up. 893906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn */ 894906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn public static final native void sendSignalQuiet(int pid, int signal); 895906497c574d45d8dfd295b16dece0d0bc32c0895Dianne Hackborn 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 8970bca96bcbfe559f9330a01f723c5c9cba51ec05aMarco Nelissen public static final native long getFreeMemory(); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 90059325eb31f25704bb88c348160bb69e7c1aa3b48Dianne Hackborn public static final native long getTotalMemory(); 90159325eb31f25704bb88c348160bb69e7c1aa3b48Dianne Hackborn 90259325eb31f25704bb88c348160bb69e7c1aa3b48Dianne Hackborn /** @hide */ 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native void readProcLines(String path, 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] reqFields, long[] outSizes); 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native int[] getPids(String path, int[] lastArray); 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_TERM_MASK = 0xff; 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_ZERO_TERM = 0; 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_SPACE_TERM = (int)' '; 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 916c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final int PROC_TAB_TERM = (int)'\t'; 917c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_COMBINE = 0x100; 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_PARENS = 0x200; 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_STRING = 0x1000; 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_LONG = 0x2000; 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int PROC_OUT_FLOAT = 0x4000; 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** @hide */ 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native boolean readProcFile(String file, int[] format, 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] outStrings, long[] outLongs, float[] outFloats); 931c64edde69d18498fb2954f71a546357b07ab996aEvan Millar 932c64edde69d18498fb2954f71a546357b07ab996aEvan Millar /** @hide */ 933c64edde69d18498fb2954f71a546357b07ab996aEvan Millar public static final native boolean parseProcLine(byte[] buffer, int startIndex, 934c64edde69d18498fb2954f71a546357b07ab996aEvan Millar int endIndex, int[] format, String[] outStrings, long[] outLongs, float[] outFloats); 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 936f72467ad9843bf5d4b75fb308386e77ebb5c3447Dianne Hackborn /** @hide */ 937f72467ad9843bf5d4b75fb308386e77ebb5c3447Dianne Hackborn public static final native int[] getPidsForCommands(String[] cmds); 938f72467ad9843bf5d4b75fb308386e77ebb5c3447Dianne Hackborn 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the total Pss value for a given process, in bytes. 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pid the process to the Pss for 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the total Pss value for the given process in bytes, 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or -1 if the value cannot be determined 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final native long getPss(int pid); 9483f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown 9493f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown /** 9503f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * Specifies the outcome of having started a process. 9513f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * @hide 9523f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown */ 9533f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public static final class ProcessStartResult { 9543f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown /** 9553f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * The PID of the newly started process. 9563f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * Always >= 0. (If the start failed, an exception will have been thrown instead.) 9573f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown */ 9583f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public int pid; 9593f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown 9603f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown /** 9613f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown * True if the process was started with a wrapper attached. 9623f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown */ 9633f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown public boolean usingWrapper; 9643f9dd287b99340efaaa257759e71a8f81b2ed113Jeff Brown } 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 966