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 Project/** 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Basic interface for finding and publishing system services. 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An implementation of this interface is usually published as the 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * global context object, which can be retrieved via 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * BinderNative.getContextObject(). An easy way to retrieve this 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is with the static method BnServiceManager.getDefault(). 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface IServiceManager extends IInterface 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve an existing service called @a name from the 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * service manager. Blocks for a few seconds waiting for it to be 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * published if it does not already exist. 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public IBinder getService(String name) throws RemoteException; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve an existing service called @a name from the 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * service manager. Non-blocking. 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public IBinder checkService(String name) throws RemoteException; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Place a new @a service called @a name into the service 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * manager. 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 48a573f6a1d9b12393fbdfd2c0850499973849854bDianne Hackborn public void addService(String name, IBinder service, boolean allowIsolated) 49a573f6a1d9b12393fbdfd2c0850499973849854bDianne Hackborn throws RemoteException; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all currently running services. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] listServices() throws RemoteException; 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Assign a permission controller to the service manager. After set, this 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interface is checked before any services are added. 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPermissionController(IPermissionController controller) 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws RemoteException; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String descriptor = "android.os.IServiceManager"; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int GET_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int CHECK_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+1; 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int ADD_SERVICE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+2; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int LIST_SERVICES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+3; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int CHECK_SERVICES_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+4; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int SET_PERMISSION_CONTROLLER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+5; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 72