IMountService.java revision 275e3e43f2fba72fa99001cafa2a70e5478fc545
1/* 2 * Copyright (C) 2010 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package android.os.storage; 18 19import android.content.pm.IPackageMoveObserver; 20import android.os.Binder; 21import android.os.IBinder; 22import android.os.IInterface; 23import android.os.Parcel; 24import android.os.RemoteException; 25 26/** 27 * WARNING! Update IMountService.h and IMountService.cpp if you change this 28 * file. In particular, the ordering of the methods below must match the 29 * _TRANSACTION enum in IMountService.cpp 30 * 31 * @hide - Applications should use android.os.storage.StorageManager to access 32 * storage functions. 33 */ 34public interface IMountService extends IInterface { 35 /** Local-side IPC implementation stub class. */ 36 public static abstract class Stub extends Binder implements IMountService { 37 private static class Proxy implements IMountService { 38 private final IBinder mRemote; 39 40 Proxy(IBinder remote) { 41 mRemote = remote; 42 } 43 44 public IBinder asBinder() { 45 return mRemote; 46 } 47 48 public String getInterfaceDescriptor() { 49 return DESCRIPTOR; 50 } 51 52 /** 53 * Registers an IMountServiceListener for receiving async 54 * notifications. 55 */ 56 public void registerListener(IMountServiceListener listener) throws RemoteException { 57 Parcel _data = Parcel.obtain(); 58 Parcel _reply = Parcel.obtain(); 59 try { 60 _data.writeInterfaceToken(DESCRIPTOR); 61 _data.writeStrongBinder((listener != null ? listener.asBinder() : null)); 62 mRemote.transact(Stub.TRANSACTION_registerListener, _data, _reply, 0); 63 _reply.readException(); 64 } finally { 65 _reply.recycle(); 66 _data.recycle(); 67 } 68 } 69 70 /** 71 * Unregisters an IMountServiceListener 72 */ 73 public void unregisterListener(IMountServiceListener listener) throws RemoteException { 74 Parcel _data = Parcel.obtain(); 75 Parcel _reply = Parcel.obtain(); 76 try { 77 _data.writeInterfaceToken(DESCRIPTOR); 78 _data.writeStrongBinder((listener != null ? listener.asBinder() : null)); 79 mRemote.transact(Stub.TRANSACTION_unregisterListener, _data, _reply, 0); 80 _reply.readException(); 81 } finally { 82 _reply.recycle(); 83 _data.recycle(); 84 } 85 } 86 87 /** 88 * Returns true if a USB mass storage host is connected 89 */ 90 public boolean isUsbMassStorageConnected() throws RemoteException { 91 Parcel _data = Parcel.obtain(); 92 Parcel _reply = Parcel.obtain(); 93 boolean _result; 94 try { 95 _data.writeInterfaceToken(DESCRIPTOR); 96 mRemote.transact(Stub.TRANSACTION_isUsbMassStorageConnected, _data, _reply, 0); 97 _reply.readException(); 98 _result = 0 != _reply.readInt(); 99 } finally { 100 _reply.recycle(); 101 _data.recycle(); 102 } 103 return _result; 104 } 105 106 /** 107 * Enables / disables USB mass storage. The caller should check 108 * actual status of enabling/disabling USB mass storage via 109 * StorageEventListener. 110 */ 111 public void setUsbMassStorageEnabled(boolean enable) throws RemoteException { 112 Parcel _data = Parcel.obtain(); 113 Parcel _reply = Parcel.obtain(); 114 try { 115 _data.writeInterfaceToken(DESCRIPTOR); 116 _data.writeInt((enable ? 1 : 0)); 117 mRemote.transact(Stub.TRANSACTION_setUsbMassStorageEnabled, _data, _reply, 0); 118 _reply.readException(); 119 } finally { 120 _reply.recycle(); 121 _data.recycle(); 122 } 123 } 124 125 /** 126 * Returns true if a USB mass storage host is enabled (media is 127 * shared) 128 */ 129 public boolean isUsbMassStorageEnabled() throws RemoteException { 130 Parcel _data = Parcel.obtain(); 131 Parcel _reply = Parcel.obtain(); 132 boolean _result; 133 try { 134 _data.writeInterfaceToken(DESCRIPTOR); 135 mRemote.transact(Stub.TRANSACTION_isUsbMassStorageEnabled, _data, _reply, 0); 136 _reply.readException(); 137 _result = 0 != _reply.readInt(); 138 } finally { 139 _reply.recycle(); 140 _data.recycle(); 141 } 142 return _result; 143 } 144 145 /** 146 * Mount external storage at given mount point. Returns an int 147 * consistent with MountServiceResultCode 148 */ 149 public int mountVolume(String mountPoint) throws RemoteException { 150 Parcel _data = Parcel.obtain(); 151 Parcel _reply = Parcel.obtain(); 152 int _result; 153 try { 154 _data.writeInterfaceToken(DESCRIPTOR); 155 _data.writeString(mountPoint); 156 mRemote.transact(Stub.TRANSACTION_mountVolume, _data, _reply, 0); 157 _reply.readException(); 158 _result = _reply.readInt(); 159 } finally { 160 _reply.recycle(); 161 _data.recycle(); 162 } 163 return _result; 164 } 165 166 /** 167 * Safely unmount external storage at given mount point. The unmount 168 * is an asynchronous operation. Applications should register 169 * StorageEventListener for storage related status changes. 170 */ 171 public void unmountVolume(String mountPoint, boolean force, boolean removeEncryption) 172 throws RemoteException { 173 Parcel _data = Parcel.obtain(); 174 Parcel _reply = Parcel.obtain(); 175 try { 176 _data.writeInterfaceToken(DESCRIPTOR); 177 _data.writeString(mountPoint); 178 _data.writeInt((force ? 1 : 0)); 179 _data.writeInt((removeEncryption ? 1 : 0)); 180 mRemote.transact(Stub.TRANSACTION_unmountVolume, _data, _reply, 0); 181 _reply.readException(); 182 } finally { 183 _reply.recycle(); 184 _data.recycle(); 185 } 186 } 187 188 /** 189 * Format external storage given a mount point. Returns an int 190 * consistent with MountServiceResultCode 191 */ 192 public int formatVolume(String mountPoint) throws RemoteException { 193 Parcel _data = Parcel.obtain(); 194 Parcel _reply = Parcel.obtain(); 195 int _result; 196 try { 197 _data.writeInterfaceToken(DESCRIPTOR); 198 _data.writeString(mountPoint); 199 mRemote.transact(Stub.TRANSACTION_formatVolume, _data, _reply, 0); 200 _reply.readException(); 201 _result = _reply.readInt(); 202 } finally { 203 _reply.recycle(); 204 _data.recycle(); 205 } 206 return _result; 207 } 208 209 /** 210 * Returns an array of pids with open files on the specified path. 211 */ 212 public int[] getStorageUsers(String path) throws RemoteException { 213 Parcel _data = Parcel.obtain(); 214 Parcel _reply = Parcel.obtain(); 215 int[] _result; 216 try { 217 _data.writeInterfaceToken(DESCRIPTOR); 218 _data.writeString(path); 219 mRemote.transact(Stub.TRANSACTION_getStorageUsers, _data, _reply, 0); 220 _reply.readException(); 221 _result = _reply.createIntArray(); 222 } finally { 223 _reply.recycle(); 224 _data.recycle(); 225 } 226 return _result; 227 } 228 229 /** 230 * Gets the state of a volume via its mountpoint. 231 */ 232 public String getVolumeState(String mountPoint) throws RemoteException { 233 Parcel _data = Parcel.obtain(); 234 Parcel _reply = Parcel.obtain(); 235 String _result; 236 try { 237 _data.writeInterfaceToken(DESCRIPTOR); 238 _data.writeString(mountPoint); 239 mRemote.transact(Stub.TRANSACTION_getVolumeState, _data, _reply, 0); 240 _reply.readException(); 241 _result = _reply.readString(); 242 } finally { 243 _reply.recycle(); 244 _data.recycle(); 245 } 246 return _result; 247 } 248 249 /* 250 * Creates a secure container with the specified parameters. Returns 251 * an int consistent with MountServiceResultCode 252 */ 253 public int createSecureContainer(String id, int sizeMb, String fstype, String key, 254 int ownerUid, boolean external) throws RemoteException { 255 Parcel _data = Parcel.obtain(); 256 Parcel _reply = Parcel.obtain(); 257 int _result; 258 try { 259 _data.writeInterfaceToken(DESCRIPTOR); 260 _data.writeString(id); 261 _data.writeInt(sizeMb); 262 _data.writeString(fstype); 263 _data.writeString(key); 264 _data.writeInt(ownerUid); 265 _data.writeInt(external ? 1 : 0); 266 mRemote.transact(Stub.TRANSACTION_createSecureContainer, _data, _reply, 0); 267 _reply.readException(); 268 _result = _reply.readInt(); 269 } finally { 270 _reply.recycle(); 271 _data.recycle(); 272 } 273 return _result; 274 } 275 276 /* 277 * Destroy a secure container, and free up all resources associated 278 * with it. NOTE: Ensure all references are released prior to 279 * deleting. Returns an int consistent with MountServiceResultCode 280 */ 281 public int destroySecureContainer(String id, boolean force) throws RemoteException { 282 Parcel _data = Parcel.obtain(); 283 Parcel _reply = Parcel.obtain(); 284 int _result; 285 try { 286 _data.writeInterfaceToken(DESCRIPTOR); 287 _data.writeString(id); 288 _data.writeInt((force ? 1 : 0)); 289 mRemote.transact(Stub.TRANSACTION_destroySecureContainer, _data, _reply, 0); 290 _reply.readException(); 291 _result = _reply.readInt(); 292 } finally { 293 _reply.recycle(); 294 _data.recycle(); 295 } 296 return _result; 297 } 298 299 /* 300 * Finalize a container which has just been created and populated. 301 * After finalization, the container is immutable. Returns an int 302 * consistent with MountServiceResultCode 303 */ 304 public int finalizeSecureContainer(String id) throws RemoteException { 305 Parcel _data = Parcel.obtain(); 306 Parcel _reply = Parcel.obtain(); 307 int _result; 308 try { 309 _data.writeInterfaceToken(DESCRIPTOR); 310 _data.writeString(id); 311 mRemote.transact(Stub.TRANSACTION_finalizeSecureContainer, _data, _reply, 0); 312 _reply.readException(); 313 _result = _reply.readInt(); 314 } finally { 315 _reply.recycle(); 316 _data.recycle(); 317 } 318 return _result; 319 } 320 321 /* 322 * Mount a secure container with the specified key and owner UID. 323 * Returns an int consistent with MountServiceResultCode 324 */ 325 public int mountSecureContainer(String id, String key, int ownerUid, boolean readOnly) 326 throws RemoteException { 327 Parcel _data = Parcel.obtain(); 328 Parcel _reply = Parcel.obtain(); 329 int _result; 330 try { 331 _data.writeInterfaceToken(DESCRIPTOR); 332 _data.writeString(id); 333 _data.writeString(key); 334 _data.writeInt(ownerUid); 335 _data.writeInt(readOnly ? 1 : 0); 336 mRemote.transact(Stub.TRANSACTION_mountSecureContainer, _data, _reply, 0); 337 _reply.readException(); 338 _result = _reply.readInt(); 339 } finally { 340 _reply.recycle(); 341 _data.recycle(); 342 } 343 return _result; 344 } 345 346 /* 347 * Unount a secure container. Returns an int consistent with 348 * MountServiceResultCode 349 */ 350 public int unmountSecureContainer(String id, boolean force) throws RemoteException { 351 Parcel _data = Parcel.obtain(); 352 Parcel _reply = Parcel.obtain(); 353 int _result; 354 try { 355 _data.writeInterfaceToken(DESCRIPTOR); 356 _data.writeString(id); 357 _data.writeInt((force ? 1 : 0)); 358 mRemote.transact(Stub.TRANSACTION_unmountSecureContainer, _data, _reply, 0); 359 _reply.readException(); 360 _result = _reply.readInt(); 361 } finally { 362 _reply.recycle(); 363 _data.recycle(); 364 } 365 return _result; 366 } 367 368 /* 369 * Returns true if the specified container is mounted 370 */ 371 public boolean isSecureContainerMounted(String id) throws RemoteException { 372 Parcel _data = Parcel.obtain(); 373 Parcel _reply = Parcel.obtain(); 374 boolean _result; 375 try { 376 _data.writeInterfaceToken(DESCRIPTOR); 377 _data.writeString(id); 378 mRemote.transact(Stub.TRANSACTION_isSecureContainerMounted, _data, _reply, 0); 379 _reply.readException(); 380 _result = 0 != _reply.readInt(); 381 } finally { 382 _reply.recycle(); 383 _data.recycle(); 384 } 385 return _result; 386 } 387 388 /* 389 * Rename an unmounted secure container. Returns an int consistent 390 * with MountServiceResultCode 391 */ 392 public int renameSecureContainer(String oldId, String newId) throws RemoteException { 393 Parcel _data = Parcel.obtain(); 394 Parcel _reply = Parcel.obtain(); 395 int _result; 396 try { 397 _data.writeInterfaceToken(DESCRIPTOR); 398 _data.writeString(oldId); 399 _data.writeString(newId); 400 mRemote.transact(Stub.TRANSACTION_renameSecureContainer, _data, _reply, 0); 401 _reply.readException(); 402 _result = _reply.readInt(); 403 } finally { 404 _reply.recycle(); 405 _data.recycle(); 406 } 407 return _result; 408 } 409 410 /* 411 * Returns the filesystem path of a mounted secure container. 412 */ 413 public String getSecureContainerPath(String id) throws RemoteException { 414 Parcel _data = Parcel.obtain(); 415 Parcel _reply = Parcel.obtain(); 416 String _result; 417 try { 418 _data.writeInterfaceToken(DESCRIPTOR); 419 _data.writeString(id); 420 mRemote.transact(Stub.TRANSACTION_getSecureContainerPath, _data, _reply, 0); 421 _reply.readException(); 422 _result = _reply.readString(); 423 } finally { 424 _reply.recycle(); 425 _data.recycle(); 426 } 427 return _result; 428 } 429 430 /** 431 * Gets an Array of currently known secure container IDs 432 */ 433 public String[] getSecureContainerList() throws RemoteException { 434 Parcel _data = Parcel.obtain(); 435 Parcel _reply = Parcel.obtain(); 436 String[] _result; 437 try { 438 _data.writeInterfaceToken(DESCRIPTOR); 439 mRemote.transact(Stub.TRANSACTION_getSecureContainerList, _data, _reply, 0); 440 _reply.readException(); 441 _result = _reply.createStringArray(); 442 } finally { 443 _reply.recycle(); 444 _data.recycle(); 445 } 446 return _result; 447 } 448 449 /** 450 * Shuts down the MountService and gracefully unmounts all external 451 * media. Invokes call back once the shutdown is complete. 452 */ 453 public void shutdown(IMountShutdownObserver observer) 454 throws RemoteException { 455 Parcel _data = Parcel.obtain(); 456 Parcel _reply = Parcel.obtain(); 457 try { 458 _data.writeInterfaceToken(DESCRIPTOR); 459 _data.writeStrongBinder((observer != null ? observer.asBinder() : null)); 460 mRemote.transact(Stub.TRANSACTION_shutdown, _data, _reply, 0); 461 _reply.readException(); 462 } finally { 463 _reply.recycle(); 464 _data.recycle(); 465 } 466 } 467 468 /** 469 * Call into MountService by PackageManager to notify that its done 470 * processing the media status update request. 471 */ 472 public void finishMediaUpdate() throws RemoteException { 473 Parcel _data = Parcel.obtain(); 474 Parcel _reply = Parcel.obtain(); 475 try { 476 _data.writeInterfaceToken(DESCRIPTOR); 477 mRemote.transact(Stub.TRANSACTION_finishMediaUpdate, _data, _reply, 0); 478 _reply.readException(); 479 } finally { 480 _reply.recycle(); 481 _data.recycle(); 482 } 483 } 484 485 /** 486 * Mounts an Opaque Binary Blob (OBB) with the specified decryption 487 * key and only allows the calling process's UID access to the 488 * contents. MountService will call back to the supplied 489 * IObbActionListener to inform it of the terminal state of the 490 * call. 491 */ 492 public void mountObb(String rawPath, String canonicalPath, String key, 493 IObbActionListener token, int nonce) throws RemoteException { 494 Parcel _data = Parcel.obtain(); 495 Parcel _reply = Parcel.obtain(); 496 try { 497 _data.writeInterfaceToken(DESCRIPTOR); 498 _data.writeString(rawPath); 499 _data.writeString(canonicalPath); 500 _data.writeString(key); 501 _data.writeStrongBinder((token != null ? token.asBinder() : null)); 502 _data.writeInt(nonce); 503 mRemote.transact(Stub.TRANSACTION_mountObb, _data, _reply, 0); 504 _reply.readException(); 505 } finally { 506 _reply.recycle(); 507 _data.recycle(); 508 } 509 } 510 511 /** 512 * Unmounts an Opaque Binary Blob (OBB). When the force flag is 513 * specified, any program using it will be forcibly killed to 514 * unmount the image. MountService will call back to the supplied 515 * IObbActionListener to inform it of the terminal state of the 516 * call. 517 */ 518 public void unmountObb( 519 String rawPath, boolean force, IObbActionListener token, int nonce) 520 throws RemoteException { 521 Parcel _data = Parcel.obtain(); 522 Parcel _reply = Parcel.obtain(); 523 try { 524 _data.writeInterfaceToken(DESCRIPTOR); 525 _data.writeString(rawPath); 526 _data.writeInt((force ? 1 : 0)); 527 _data.writeStrongBinder((token != null ? token.asBinder() : null)); 528 _data.writeInt(nonce); 529 mRemote.transact(Stub.TRANSACTION_unmountObb, _data, _reply, 0); 530 _reply.readException(); 531 } finally { 532 _reply.recycle(); 533 _data.recycle(); 534 } 535 } 536 537 /** 538 * Checks whether the specified Opaque Binary Blob (OBB) is mounted 539 * somewhere. 540 */ 541 public boolean isObbMounted(String rawPath) throws RemoteException { 542 Parcel _data = Parcel.obtain(); 543 Parcel _reply = Parcel.obtain(); 544 boolean _result; 545 try { 546 _data.writeInterfaceToken(DESCRIPTOR); 547 _data.writeString(rawPath); 548 mRemote.transact(Stub.TRANSACTION_isObbMounted, _data, _reply, 0); 549 _reply.readException(); 550 _result = 0 != _reply.readInt(); 551 } finally { 552 _reply.recycle(); 553 _data.recycle(); 554 } 555 return _result; 556 } 557 558 /** 559 * Gets the path to the mounted Opaque Binary Blob (OBB). 560 */ 561 public String getMountedObbPath(String rawPath) throws RemoteException { 562 Parcel _data = Parcel.obtain(); 563 Parcel _reply = Parcel.obtain(); 564 String _result; 565 try { 566 _data.writeInterfaceToken(DESCRIPTOR); 567 _data.writeString(rawPath); 568 mRemote.transact(Stub.TRANSACTION_getMountedObbPath, _data, _reply, 0); 569 _reply.readException(); 570 _result = _reply.readString(); 571 } finally { 572 _reply.recycle(); 573 _data.recycle(); 574 } 575 return _result; 576 } 577 578 /** 579 * Returns whether the external storage is emulated. 580 */ 581 public boolean isExternalStorageEmulated() throws RemoteException { 582 Parcel _data = Parcel.obtain(); 583 Parcel _reply = Parcel.obtain(); 584 boolean _result; 585 try { 586 _data.writeInterfaceToken(DESCRIPTOR); 587 mRemote.transact(Stub.TRANSACTION_isExternalStorageEmulated, _data, _reply, 0); 588 _reply.readException(); 589 _result = 0 != _reply.readInt(); 590 } finally { 591 _reply.recycle(); 592 _data.recycle(); 593 } 594 return _result; 595 } 596 597 public int getEncryptionState() throws RemoteException { 598 Parcel _data = Parcel.obtain(); 599 Parcel _reply = Parcel.obtain(); 600 int _result; 601 try { 602 _data.writeInterfaceToken(DESCRIPTOR); 603 mRemote.transact(Stub.TRANSACTION_getEncryptionState, _data, _reply, 0); 604 _reply.readException(); 605 _result = _reply.readInt(); 606 } finally { 607 _reply.recycle(); 608 _data.recycle(); 609 } 610 return _result; 611 } 612 613 public int decryptStorage(String password) throws RemoteException { 614 Parcel _data = Parcel.obtain(); 615 Parcel _reply = Parcel.obtain(); 616 int _result; 617 try { 618 _data.writeInterfaceToken(DESCRIPTOR); 619 _data.writeString(password); 620 mRemote.transact(Stub.TRANSACTION_decryptStorage, _data, _reply, 0); 621 _reply.readException(); 622 _result = _reply.readInt(); 623 } finally { 624 _reply.recycle(); 625 _data.recycle(); 626 } 627 return _result; 628 } 629 630 public int encryptStorage(int type, String password) throws RemoteException { 631 Parcel _data = Parcel.obtain(); 632 Parcel _reply = Parcel.obtain(); 633 int _result; 634 try { 635 _data.writeInterfaceToken(DESCRIPTOR); 636 _data.writeInt(type); 637 _data.writeString(password); 638 mRemote.transact(Stub.TRANSACTION_encryptStorage, _data, _reply, 0); 639 _reply.readException(); 640 _result = _reply.readInt(); 641 } finally { 642 _reply.recycle(); 643 _data.recycle(); 644 } 645 return _result; 646 } 647 648 public int changeEncryptionPassword(int type, String password) throws RemoteException { 649 Parcel _data = Parcel.obtain(); 650 Parcel _reply = Parcel.obtain(); 651 int _result; 652 try { 653 _data.writeInterfaceToken(DESCRIPTOR); 654 _data.writeInt(type); 655 _data.writeString(password); 656 mRemote.transact(Stub.TRANSACTION_changeEncryptionPassword, _data, _reply, 0); 657 _reply.readException(); 658 _result = _reply.readInt(); 659 } finally { 660 _reply.recycle(); 661 _data.recycle(); 662 } 663 return _result; 664 } 665 666 @Override 667 public int verifyEncryptionPassword(String password) throws RemoteException { 668 Parcel _data = Parcel.obtain(); 669 Parcel _reply = Parcel.obtain(); 670 int _result; 671 try { 672 _data.writeInterfaceToken(DESCRIPTOR); 673 _data.writeString(password); 674 mRemote.transact(Stub.TRANSACTION_verifyEncryptionPassword, _data, _reply, 0); 675 _reply.readException(); 676 _result = _reply.readInt(); 677 } finally { 678 _reply.recycle(); 679 _data.recycle(); 680 } 681 return _result; 682 } 683 684 public int getPasswordType() throws RemoteException { 685 Parcel _data = Parcel.obtain(); 686 Parcel _reply = Parcel.obtain(); 687 int _result; 688 try { 689 _data.writeInterfaceToken(DESCRIPTOR); 690 mRemote.transact(Stub.TRANSACTION_getPasswordType, _data, _reply, 0); 691 _reply.readException(); 692 _result = _reply.readInt(); 693 } finally { 694 _reply.recycle(); 695 _data.recycle(); 696 } 697 return _result; 698 } 699 700 public String getPassword() throws RemoteException { 701 Parcel _data = Parcel.obtain(); 702 Parcel _reply = Parcel.obtain(); 703 String _result; 704 try { 705 _data.writeInterfaceToken(DESCRIPTOR); 706 mRemote.transact(Stub.TRANSACTION_getPassword, _data, _reply, 0); 707 _reply.readException(); 708 _result = _reply.readString(); 709 } finally { 710 _reply.recycle(); 711 _data.recycle(); 712 } 713 return _result; 714 } 715 716 public void clearPassword() throws RemoteException { 717 Parcel _data = Parcel.obtain(); 718 Parcel _reply = Parcel.obtain(); 719 try { 720 _data.writeInterfaceToken(DESCRIPTOR); 721 mRemote.transact(Stub.TRANSACTION_clearPassword, _data, _reply, IBinder.FLAG_ONEWAY); 722 _reply.readException(); 723 } finally { 724 _reply.recycle(); 725 _data.recycle(); 726 } 727 } 728 729 public void setField(String field, String data) throws RemoteException { 730 Parcel _data = Parcel.obtain(); 731 Parcel _reply = Parcel.obtain(); 732 try { 733 _data.writeInterfaceToken(DESCRIPTOR); 734 _data.writeString(field); 735 _data.writeString(data); 736 mRemote.transact(Stub.TRANSACTION_setField, _data, _reply, IBinder.FLAG_ONEWAY); 737 _reply.readException(); 738 } finally { 739 _reply.recycle(); 740 _data.recycle(); 741 } 742 } 743 744 public String getField(String field) throws RemoteException { 745 Parcel _data = Parcel.obtain(); 746 Parcel _reply = Parcel.obtain(); 747 String _result; 748 try { 749 _data.writeInterfaceToken(DESCRIPTOR); 750 _data.writeString(field); 751 mRemote.transact(Stub.TRANSACTION_getField, _data, _reply, 0); 752 _reply.readException(); 753 _result = _reply.readString(); 754 } finally { 755 _reply.recycle(); 756 _data.recycle(); 757 } 758 return _result; 759 } 760 761 public StorageVolume[] getVolumeList(int userId) throws RemoteException { 762 Parcel _data = Parcel.obtain(); 763 Parcel _reply = Parcel.obtain(); 764 StorageVolume[] _result; 765 try { 766 _data.writeInterfaceToken(DESCRIPTOR); 767 _data.writeInt(userId); 768 mRemote.transact(Stub.TRANSACTION_getVolumeList, _data, _reply, 0); 769 _reply.readException(); 770 _result = _reply.createTypedArray(StorageVolume.CREATOR); 771 } finally { 772 _reply.recycle(); 773 _data.recycle(); 774 } 775 return _result; 776 } 777 778 /* 779 * Returns the filesystem path of a mounted secure container. 780 */ 781 public String getSecureContainerFilesystemPath(String id) throws RemoteException { 782 Parcel _data = Parcel.obtain(); 783 Parcel _reply = Parcel.obtain(); 784 String _result; 785 try { 786 _data.writeInterfaceToken(DESCRIPTOR); 787 _data.writeString(id); 788 mRemote.transact(Stub.TRANSACTION_getSecureContainerFilesystemPath, _data, _reply, 0); 789 _reply.readException(); 790 _result = _reply.readString(); 791 } finally { 792 _reply.recycle(); 793 _data.recycle(); 794 } 795 return _result; 796 } 797 798 /** 799 * Fix permissions in a container which has just been created and 800 * populated. Returns an int consistent with MountServiceResultCode 801 */ 802 public int fixPermissionsSecureContainer(String id, int gid, String filename) 803 throws RemoteException { 804 Parcel _data = Parcel.obtain(); 805 Parcel _reply = Parcel.obtain(); 806 int _result; 807 try { 808 _data.writeInterfaceToken(DESCRIPTOR); 809 _data.writeString(id); 810 _data.writeInt(gid); 811 _data.writeString(filename); 812 mRemote.transact(Stub.TRANSACTION_fixPermissionsSecureContainer, _data, _reply, 0); 813 _reply.readException(); 814 _result = _reply.readInt(); 815 } finally { 816 _reply.recycle(); 817 _data.recycle(); 818 } 819 return _result; 820 } 821 822 @Override 823 public int mkdirs(String callingPkg, String path) throws RemoteException { 824 Parcel _data = Parcel.obtain(); 825 Parcel _reply = Parcel.obtain(); 826 int _result; 827 try { 828 _data.writeInterfaceToken(DESCRIPTOR); 829 _data.writeString(callingPkg); 830 _data.writeString(path); 831 mRemote.transact(Stub.TRANSACTION_mkdirs, _data, _reply, 0); 832 _reply.readException(); 833 _result = _reply.readInt(); 834 } finally { 835 _reply.recycle(); 836 _data.recycle(); 837 } 838 return _result; 839 } 840 841 @Override 842 public int resizeSecureContainer(String id, int sizeMb, String key) 843 throws RemoteException { 844 Parcel _data = Parcel.obtain(); 845 Parcel _reply = Parcel.obtain(); 846 int _result; 847 try { 848 _data.writeInterfaceToken(DESCRIPTOR); 849 _data.writeString(id); 850 _data.writeInt(sizeMb); 851 _data.writeString(key); 852 mRemote.transact(Stub.TRANSACTION_resizeSecureContainer, _data, _reply, 0); 853 _reply.readException(); 854 _result = _reply.readInt(); 855 } finally { 856 _reply.recycle(); 857 _data.recycle(); 858 } 859 return _result; 860 } 861 862 @Override 863 public long lastMaintenance() throws RemoteException { 864 Parcel _data = Parcel.obtain(); 865 Parcel _reply = Parcel.obtain(); 866 long _result; 867 try { 868 _data.writeInterfaceToken(DESCRIPTOR); 869 mRemote.transact(Stub.TRANSACTION_lastMaintenance, _data, _reply, 0); 870 _reply.readException(); 871 _result = _reply.readLong(); 872 } finally { 873 _reply.recycle(); 874 _data.recycle(); 875 } 876 return _result; 877 } 878 879 @Override 880 public void runMaintenance() throws RemoteException { 881 Parcel _data = Parcel.obtain(); 882 Parcel _reply = Parcel.obtain(); 883 try { 884 _data.writeInterfaceToken(DESCRIPTOR); 885 mRemote.transact(Stub.TRANSACTION_runMaintenance, _data, _reply, 0); 886 _reply.readException(); 887 } finally { 888 _reply.recycle(); 889 _data.recycle(); 890 } 891 return; 892 } 893 894 @Override 895 public void waitForAsecScan() throws RemoteException { 896 Parcel _data = Parcel.obtain(); 897 Parcel _reply = Parcel.obtain(); 898 try { 899 _data.writeInterfaceToken(DESCRIPTOR); 900 mRemote.transact(Stub.TRANSACTION_waitForAsecScan, _data, _reply, 0); 901 _reply.readException(); 902 } finally { 903 _reply.recycle(); 904 _data.recycle(); 905 } 906 return; 907 } 908 909 @Override 910 public DiskInfo[] getDisks() throws RemoteException { 911 Parcel _data = Parcel.obtain(); 912 Parcel _reply = Parcel.obtain(); 913 DiskInfo[] _result; 914 try { 915 _data.writeInterfaceToken(DESCRIPTOR); 916 mRemote.transact(Stub.TRANSACTION_getDisks, _data, _reply, 0); 917 _reply.readException(); 918 _result = _reply.createTypedArray(DiskInfo.CREATOR); 919 } finally { 920 _reply.recycle(); 921 _data.recycle(); 922 } 923 return _result; 924 } 925 926 @Override 927 public VolumeInfo[] getVolumes(int _flags) throws RemoteException { 928 Parcel _data = Parcel.obtain(); 929 Parcel _reply = Parcel.obtain(); 930 VolumeInfo[] _result; 931 try { 932 _data.writeInterfaceToken(DESCRIPTOR); 933 _data.writeInt(_flags); 934 mRemote.transact(Stub.TRANSACTION_getVolumes, _data, _reply, 0); 935 _reply.readException(); 936 _result = _reply.createTypedArray(VolumeInfo.CREATOR); 937 } finally { 938 _reply.recycle(); 939 _data.recycle(); 940 } 941 return _result; 942 } 943 944 @Override 945 public void mount(String volId) throws RemoteException { 946 Parcel _data = Parcel.obtain(); 947 Parcel _reply = Parcel.obtain(); 948 try { 949 _data.writeInterfaceToken(DESCRIPTOR); 950 _data.writeString(volId); 951 mRemote.transact(Stub.TRANSACTION_mount, _data, _reply, 0); 952 _reply.readException(); 953 } finally { 954 _reply.recycle(); 955 _data.recycle(); 956 } 957 } 958 959 @Override 960 public void unmount(String volId) throws RemoteException { 961 Parcel _data = Parcel.obtain(); 962 Parcel _reply = Parcel.obtain(); 963 try { 964 _data.writeInterfaceToken(DESCRIPTOR); 965 _data.writeString(volId); 966 mRemote.transact(Stub.TRANSACTION_unmount, _data, _reply, 0); 967 _reply.readException(); 968 } finally { 969 _reply.recycle(); 970 _data.recycle(); 971 } 972 } 973 974 @Override 975 public void format(String volId) throws RemoteException { 976 Parcel _data = Parcel.obtain(); 977 Parcel _reply = Parcel.obtain(); 978 try { 979 _data.writeInterfaceToken(DESCRIPTOR); 980 _data.writeString(volId); 981 mRemote.transact(Stub.TRANSACTION_format, _data, _reply, 0); 982 _reply.readException(); 983 } finally { 984 _reply.recycle(); 985 _data.recycle(); 986 } 987 } 988 989 @Override 990 public void partitionPublic(String diskId) throws RemoteException { 991 Parcel _data = Parcel.obtain(); 992 Parcel _reply = Parcel.obtain(); 993 try { 994 _data.writeInterfaceToken(DESCRIPTOR); 995 _data.writeString(diskId); 996 mRemote.transact(Stub.TRANSACTION_partitionPublic, _data, _reply, 0); 997 _reply.readException(); 998 } finally { 999 _reply.recycle(); 1000 _data.recycle(); 1001 } 1002 } 1003 1004 @Override 1005 public void partitionPrivate(String diskId) throws RemoteException { 1006 Parcel _data = Parcel.obtain(); 1007 Parcel _reply = Parcel.obtain(); 1008 try { 1009 _data.writeInterfaceToken(DESCRIPTOR); 1010 _data.writeString(diskId); 1011 mRemote.transact(Stub.TRANSACTION_partitionPrivate, _data, _reply, 0); 1012 _reply.readException(); 1013 } finally { 1014 _reply.recycle(); 1015 _data.recycle(); 1016 } 1017 } 1018 1019 @Override 1020 public void partitionMixed(String diskId, int ratio) throws RemoteException { 1021 Parcel _data = Parcel.obtain(); 1022 Parcel _reply = Parcel.obtain(); 1023 try { 1024 _data.writeInterfaceToken(DESCRIPTOR); 1025 _data.writeString(diskId); 1026 _data.writeInt(ratio); 1027 mRemote.transact(Stub.TRANSACTION_partitionMixed, _data, _reply, 0); 1028 _reply.readException(); 1029 } finally { 1030 _reply.recycle(); 1031 _data.recycle(); 1032 } 1033 } 1034 1035 @Override 1036 public void setVolumeNickname(String volId, String nickname) throws RemoteException { 1037 Parcel _data = Parcel.obtain(); 1038 Parcel _reply = Parcel.obtain(); 1039 try { 1040 _data.writeInterfaceToken(DESCRIPTOR); 1041 _data.writeString(volId); 1042 _data.writeString(nickname); 1043 mRemote.transact(Stub.TRANSACTION_setVolumeNickname, _data, _reply, 0); 1044 _reply.readException(); 1045 } finally { 1046 _reply.recycle(); 1047 _data.recycle(); 1048 } 1049 } 1050 1051 @Override 1052 public void setVolumeUserFlags(String volId, int flags, int mask) throws RemoteException { 1053 Parcel _data = Parcel.obtain(); 1054 Parcel _reply = Parcel.obtain(); 1055 try { 1056 _data.writeInterfaceToken(DESCRIPTOR); 1057 _data.writeString(volId); 1058 _data.writeInt(flags); 1059 _data.writeInt(mask); 1060 mRemote.transact(Stub.TRANSACTION_setVolumeUserFlags, _data, _reply, 0); 1061 _reply.readException(); 1062 } finally { 1063 _reply.recycle(); 1064 _data.recycle(); 1065 } 1066 } 1067 1068 @Override 1069 public String getPrimaryStorageUuid() throws RemoteException { 1070 Parcel _data = Parcel.obtain(); 1071 Parcel _reply = Parcel.obtain(); 1072 String _result; 1073 try { 1074 _data.writeInterfaceToken(DESCRIPTOR); 1075 mRemote.transact(Stub.TRANSACTION_getPrimaryStorageUuid, _data, _reply, 0); 1076 _reply.readException(); 1077 _result = _reply.readString(); 1078 } finally { 1079 _reply.recycle(); 1080 _data.recycle(); 1081 } 1082 return _result; 1083 } 1084 1085 @Override 1086 public void setPrimaryStorageUuid(String volumeUuid, IPackageMoveObserver callback) 1087 throws RemoteException { 1088 Parcel _data = Parcel.obtain(); 1089 Parcel _reply = Parcel.obtain(); 1090 try { 1091 _data.writeInterfaceToken(DESCRIPTOR); 1092 _data.writeString(volumeUuid); 1093 _data.writeStrongBinder((callback != null ? callback.asBinder() : null)); 1094 mRemote.transact(Stub.TRANSACTION_setPrimaryStorageUuid, _data, _reply, 0); 1095 _reply.readException(); 1096 } finally { 1097 _reply.recycle(); 1098 _data.recycle(); 1099 } 1100 } 1101 } 1102 1103 private static final String DESCRIPTOR = "IMountService"; 1104 1105 static final int TRANSACTION_registerListener = IBinder.FIRST_CALL_TRANSACTION + 0; 1106 1107 static final int TRANSACTION_unregisterListener = IBinder.FIRST_CALL_TRANSACTION + 1; 1108 1109 static final int TRANSACTION_isUsbMassStorageConnected = IBinder.FIRST_CALL_TRANSACTION + 2; 1110 1111 static final int TRANSACTION_setUsbMassStorageEnabled = IBinder.FIRST_CALL_TRANSACTION + 3; 1112 1113 static final int TRANSACTION_isUsbMassStorageEnabled = IBinder.FIRST_CALL_TRANSACTION + 4; 1114 1115 static final int TRANSACTION_mountVolume = IBinder.FIRST_CALL_TRANSACTION + 5; 1116 1117 static final int TRANSACTION_unmountVolume = IBinder.FIRST_CALL_TRANSACTION + 6; 1118 1119 static final int TRANSACTION_formatVolume = IBinder.FIRST_CALL_TRANSACTION + 7; 1120 1121 static final int TRANSACTION_getStorageUsers = IBinder.FIRST_CALL_TRANSACTION + 8; 1122 1123 static final int TRANSACTION_getVolumeState = IBinder.FIRST_CALL_TRANSACTION + 9; 1124 1125 static final int TRANSACTION_createSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 10; 1126 1127 static final int TRANSACTION_finalizeSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 11; 1128 1129 static final int TRANSACTION_destroySecureContainer = IBinder.FIRST_CALL_TRANSACTION + 12; 1130 1131 static final int TRANSACTION_mountSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 13; 1132 1133 static final int TRANSACTION_unmountSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 14; 1134 1135 static final int TRANSACTION_isSecureContainerMounted = IBinder.FIRST_CALL_TRANSACTION + 15; 1136 1137 static final int TRANSACTION_renameSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 16; 1138 1139 static final int TRANSACTION_getSecureContainerPath = IBinder.FIRST_CALL_TRANSACTION + 17; 1140 1141 static final int TRANSACTION_getSecureContainerList = IBinder.FIRST_CALL_TRANSACTION + 18; 1142 1143 static final int TRANSACTION_shutdown = IBinder.FIRST_CALL_TRANSACTION + 19; 1144 1145 static final int TRANSACTION_finishMediaUpdate = IBinder.FIRST_CALL_TRANSACTION + 20; 1146 1147 static final int TRANSACTION_mountObb = IBinder.FIRST_CALL_TRANSACTION + 21; 1148 1149 static final int TRANSACTION_unmountObb = IBinder.FIRST_CALL_TRANSACTION + 22; 1150 1151 static final int TRANSACTION_isObbMounted = IBinder.FIRST_CALL_TRANSACTION + 23; 1152 1153 static final int TRANSACTION_getMountedObbPath = IBinder.FIRST_CALL_TRANSACTION + 24; 1154 1155 static final int TRANSACTION_isExternalStorageEmulated = IBinder.FIRST_CALL_TRANSACTION + 25; 1156 1157 static final int TRANSACTION_decryptStorage = IBinder.FIRST_CALL_TRANSACTION + 26; 1158 1159 static final int TRANSACTION_encryptStorage = IBinder.FIRST_CALL_TRANSACTION + 27; 1160 1161 static final int TRANSACTION_changeEncryptionPassword = IBinder.FIRST_CALL_TRANSACTION + 28; 1162 1163 static final int TRANSACTION_getVolumeList = IBinder.FIRST_CALL_TRANSACTION + 29; 1164 1165 static final int TRANSACTION_getSecureContainerFilesystemPath = IBinder.FIRST_CALL_TRANSACTION + 30; 1166 1167 static final int TRANSACTION_getEncryptionState = IBinder.FIRST_CALL_TRANSACTION + 31; 1168 1169 static final int TRANSACTION_verifyEncryptionPassword = IBinder.FIRST_CALL_TRANSACTION + 32; 1170 1171 static final int TRANSACTION_fixPermissionsSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 33; 1172 1173 static final int TRANSACTION_mkdirs = IBinder.FIRST_CALL_TRANSACTION + 34; 1174 1175 static final int TRANSACTION_getPasswordType = IBinder.FIRST_CALL_TRANSACTION + 35; 1176 1177 static final int TRANSACTION_getPassword = IBinder.FIRST_CALL_TRANSACTION + 36; 1178 1179 static final int TRANSACTION_clearPassword = IBinder.FIRST_CALL_TRANSACTION + 37; 1180 1181 static final int TRANSACTION_setField = IBinder.FIRST_CALL_TRANSACTION + 38; 1182 1183 static final int TRANSACTION_getField = IBinder.FIRST_CALL_TRANSACTION + 39; 1184 1185 static final int TRANSACTION_resizeSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 40; 1186 1187 static final int TRANSACTION_lastMaintenance = IBinder.FIRST_CALL_TRANSACTION + 41; 1188 1189 static final int TRANSACTION_runMaintenance = IBinder.FIRST_CALL_TRANSACTION + 42; 1190 1191 static final int TRANSACTION_waitForAsecScan = IBinder.FIRST_CALL_TRANSACTION + 43; 1192 1193 static final int TRANSACTION_getDisks = IBinder.FIRST_CALL_TRANSACTION + 44; 1194 static final int TRANSACTION_getVolumes = IBinder.FIRST_CALL_TRANSACTION + 45; 1195 1196 static final int TRANSACTION_mount = IBinder.FIRST_CALL_TRANSACTION + 46; 1197 static final int TRANSACTION_unmount = IBinder.FIRST_CALL_TRANSACTION + 47; 1198 static final int TRANSACTION_format = IBinder.FIRST_CALL_TRANSACTION + 48; 1199 1200 static final int TRANSACTION_partitionPublic = IBinder.FIRST_CALL_TRANSACTION + 49; 1201 static final int TRANSACTION_partitionPrivate = IBinder.FIRST_CALL_TRANSACTION + 50; 1202 static final int TRANSACTION_partitionMixed = IBinder.FIRST_CALL_TRANSACTION + 51; 1203 1204 static final int TRANSACTION_setVolumeNickname = IBinder.FIRST_CALL_TRANSACTION + 52; 1205 static final int TRANSACTION_setVolumeUserFlags = IBinder.FIRST_CALL_TRANSACTION + 53; 1206 1207 static final int TRANSACTION_getPrimaryStorageUuid = IBinder.FIRST_CALL_TRANSACTION + 54; 1208 static final int TRANSACTION_setPrimaryStorageUuid = IBinder.FIRST_CALL_TRANSACTION + 55; 1209 1210 /** 1211 * Cast an IBinder object into an IMountService interface, generating a 1212 * proxy if needed. 1213 */ 1214 public static IMountService asInterface(IBinder obj) { 1215 if (obj == null) { 1216 return null; 1217 } 1218 IInterface iin = obj.queryLocalInterface(DESCRIPTOR); 1219 if (iin != null && iin instanceof IMountService) { 1220 return (IMountService) iin; 1221 } 1222 return new IMountService.Stub.Proxy(obj); 1223 } 1224 1225 /** Construct the stub at attach it to the interface. */ 1226 public Stub() { 1227 attachInterface(this, DESCRIPTOR); 1228 } 1229 1230 public IBinder asBinder() { 1231 return this; 1232 } 1233 1234 @Override 1235 public boolean onTransact(int code, Parcel data, Parcel reply, 1236 int flags) throws RemoteException { 1237 switch (code) { 1238 case INTERFACE_TRANSACTION: { 1239 reply.writeString(DESCRIPTOR); 1240 return true; 1241 } 1242 case TRANSACTION_registerListener: { 1243 data.enforceInterface(DESCRIPTOR); 1244 IMountServiceListener listener; 1245 listener = IMountServiceListener.Stub.asInterface(data.readStrongBinder()); 1246 registerListener(listener); 1247 reply.writeNoException(); 1248 return true; 1249 } 1250 case TRANSACTION_unregisterListener: { 1251 data.enforceInterface(DESCRIPTOR); 1252 IMountServiceListener listener; 1253 listener = IMountServiceListener.Stub.asInterface(data.readStrongBinder()); 1254 unregisterListener(listener); 1255 reply.writeNoException(); 1256 return true; 1257 } 1258 case TRANSACTION_isUsbMassStorageConnected: { 1259 data.enforceInterface(DESCRIPTOR); 1260 boolean result = isUsbMassStorageConnected(); 1261 reply.writeNoException(); 1262 reply.writeInt((result ? 1 : 0)); 1263 return true; 1264 } 1265 case TRANSACTION_setUsbMassStorageEnabled: { 1266 data.enforceInterface(DESCRIPTOR); 1267 boolean enable; 1268 enable = 0 != data.readInt(); 1269 setUsbMassStorageEnabled(enable); 1270 reply.writeNoException(); 1271 return true; 1272 } 1273 case TRANSACTION_isUsbMassStorageEnabled: { 1274 data.enforceInterface(DESCRIPTOR); 1275 boolean result = isUsbMassStorageEnabled(); 1276 reply.writeNoException(); 1277 reply.writeInt((result ? 1 : 0)); 1278 return true; 1279 } 1280 case TRANSACTION_mountVolume: { 1281 data.enforceInterface(DESCRIPTOR); 1282 String mountPoint; 1283 mountPoint = data.readString(); 1284 int resultCode = mountVolume(mountPoint); 1285 reply.writeNoException(); 1286 reply.writeInt(resultCode); 1287 return true; 1288 } 1289 case TRANSACTION_unmountVolume: { 1290 data.enforceInterface(DESCRIPTOR); 1291 String mountPoint; 1292 mountPoint = data.readString(); 1293 boolean force = 0 != data.readInt(); 1294 boolean removeEncrypt = 0 != data.readInt(); 1295 unmountVolume(mountPoint, force, removeEncrypt); 1296 reply.writeNoException(); 1297 return true; 1298 } 1299 case TRANSACTION_formatVolume: { 1300 data.enforceInterface(DESCRIPTOR); 1301 String mountPoint; 1302 mountPoint = data.readString(); 1303 int result = formatVolume(mountPoint); 1304 reply.writeNoException(); 1305 reply.writeInt(result); 1306 return true; 1307 } 1308 case TRANSACTION_getStorageUsers: { 1309 data.enforceInterface(DESCRIPTOR); 1310 String path; 1311 path = data.readString(); 1312 int[] pids = getStorageUsers(path); 1313 reply.writeNoException(); 1314 reply.writeIntArray(pids); 1315 return true; 1316 } 1317 case TRANSACTION_getVolumeState: { 1318 data.enforceInterface(DESCRIPTOR); 1319 String mountPoint; 1320 mountPoint = data.readString(); 1321 String state = getVolumeState(mountPoint); 1322 reply.writeNoException(); 1323 reply.writeString(state); 1324 return true; 1325 } 1326 case TRANSACTION_createSecureContainer: { 1327 data.enforceInterface(DESCRIPTOR); 1328 String id; 1329 id = data.readString(); 1330 int sizeMb; 1331 sizeMb = data.readInt(); 1332 String fstype; 1333 fstype = data.readString(); 1334 String key; 1335 key = data.readString(); 1336 int ownerUid; 1337 ownerUid = data.readInt(); 1338 boolean external; 1339 external = 0 != data.readInt(); 1340 int resultCode = createSecureContainer(id, sizeMb, fstype, key, ownerUid, 1341 external); 1342 reply.writeNoException(); 1343 reply.writeInt(resultCode); 1344 return true; 1345 } 1346 case TRANSACTION_finalizeSecureContainer: { 1347 data.enforceInterface(DESCRIPTOR); 1348 String id; 1349 id = data.readString(); 1350 int resultCode = finalizeSecureContainer(id); 1351 reply.writeNoException(); 1352 reply.writeInt(resultCode); 1353 return true; 1354 } 1355 case TRANSACTION_destroySecureContainer: { 1356 data.enforceInterface(DESCRIPTOR); 1357 String id; 1358 id = data.readString(); 1359 boolean force; 1360 force = 0 != data.readInt(); 1361 int resultCode = destroySecureContainer(id, force); 1362 reply.writeNoException(); 1363 reply.writeInt(resultCode); 1364 return true; 1365 } 1366 case TRANSACTION_mountSecureContainer: { 1367 data.enforceInterface(DESCRIPTOR); 1368 String id; 1369 id = data.readString(); 1370 String key; 1371 key = data.readString(); 1372 int ownerUid; 1373 ownerUid = data.readInt(); 1374 boolean readOnly; 1375 readOnly = data.readInt() != 0; 1376 int resultCode = mountSecureContainer(id, key, ownerUid, readOnly); 1377 reply.writeNoException(); 1378 reply.writeInt(resultCode); 1379 return true; 1380 } 1381 case TRANSACTION_unmountSecureContainer: { 1382 data.enforceInterface(DESCRIPTOR); 1383 String id; 1384 id = data.readString(); 1385 boolean force; 1386 force = 0 != data.readInt(); 1387 int resultCode = unmountSecureContainer(id, force); 1388 reply.writeNoException(); 1389 reply.writeInt(resultCode); 1390 return true; 1391 } 1392 case TRANSACTION_isSecureContainerMounted: { 1393 data.enforceInterface(DESCRIPTOR); 1394 String id; 1395 id = data.readString(); 1396 boolean status = isSecureContainerMounted(id); 1397 reply.writeNoException(); 1398 reply.writeInt((status ? 1 : 0)); 1399 return true; 1400 } 1401 case TRANSACTION_renameSecureContainer: { 1402 data.enforceInterface(DESCRIPTOR); 1403 String oldId; 1404 oldId = data.readString(); 1405 String newId; 1406 newId = data.readString(); 1407 int resultCode = renameSecureContainer(oldId, newId); 1408 reply.writeNoException(); 1409 reply.writeInt(resultCode); 1410 return true; 1411 } 1412 case TRANSACTION_getSecureContainerPath: { 1413 data.enforceInterface(DESCRIPTOR); 1414 String id; 1415 id = data.readString(); 1416 String path = getSecureContainerPath(id); 1417 reply.writeNoException(); 1418 reply.writeString(path); 1419 return true; 1420 } 1421 case TRANSACTION_getSecureContainerList: { 1422 data.enforceInterface(DESCRIPTOR); 1423 String[] ids = getSecureContainerList(); 1424 reply.writeNoException(); 1425 reply.writeStringArray(ids); 1426 return true; 1427 } 1428 case TRANSACTION_shutdown: { 1429 data.enforceInterface(DESCRIPTOR); 1430 IMountShutdownObserver observer; 1431 observer = IMountShutdownObserver.Stub.asInterface(data 1432 .readStrongBinder()); 1433 shutdown(observer); 1434 reply.writeNoException(); 1435 return true; 1436 } 1437 case TRANSACTION_finishMediaUpdate: { 1438 data.enforceInterface(DESCRIPTOR); 1439 finishMediaUpdate(); 1440 reply.writeNoException(); 1441 return true; 1442 } 1443 case TRANSACTION_mountObb: { 1444 data.enforceInterface(DESCRIPTOR); 1445 final String rawPath = data.readString(); 1446 final String canonicalPath = data.readString(); 1447 final String key = data.readString(); 1448 IObbActionListener observer; 1449 observer = IObbActionListener.Stub.asInterface(data.readStrongBinder()); 1450 int nonce; 1451 nonce = data.readInt(); 1452 mountObb(rawPath, canonicalPath, key, observer, nonce); 1453 reply.writeNoException(); 1454 return true; 1455 } 1456 case TRANSACTION_unmountObb: { 1457 data.enforceInterface(DESCRIPTOR); 1458 String filename; 1459 filename = data.readString(); 1460 boolean force; 1461 force = 0 != data.readInt(); 1462 IObbActionListener observer; 1463 observer = IObbActionListener.Stub.asInterface(data.readStrongBinder()); 1464 int nonce; 1465 nonce = data.readInt(); 1466 unmountObb(filename, force, observer, nonce); 1467 reply.writeNoException(); 1468 return true; 1469 } 1470 case TRANSACTION_isObbMounted: { 1471 data.enforceInterface(DESCRIPTOR); 1472 String filename; 1473 filename = data.readString(); 1474 boolean status = isObbMounted(filename); 1475 reply.writeNoException(); 1476 reply.writeInt((status ? 1 : 0)); 1477 return true; 1478 } 1479 case TRANSACTION_getMountedObbPath: { 1480 data.enforceInterface(DESCRIPTOR); 1481 String filename; 1482 filename = data.readString(); 1483 String mountedPath = getMountedObbPath(filename); 1484 reply.writeNoException(); 1485 reply.writeString(mountedPath); 1486 return true; 1487 } 1488 case TRANSACTION_isExternalStorageEmulated: { 1489 data.enforceInterface(DESCRIPTOR); 1490 boolean emulated = isExternalStorageEmulated(); 1491 reply.writeNoException(); 1492 reply.writeInt(emulated ? 1 : 0); 1493 return true; 1494 } 1495 case TRANSACTION_decryptStorage: { 1496 data.enforceInterface(DESCRIPTOR); 1497 String password = data.readString(); 1498 int result = decryptStorage(password); 1499 reply.writeNoException(); 1500 reply.writeInt(result); 1501 return true; 1502 } 1503 case TRANSACTION_encryptStorage: { 1504 data.enforceInterface(DESCRIPTOR); 1505 int type = data.readInt(); 1506 String password = data.readString(); 1507 int result = encryptStorage(type, password); 1508 reply.writeNoException(); 1509 reply.writeInt(result); 1510 return true; 1511 } 1512 case TRANSACTION_changeEncryptionPassword: { 1513 data.enforceInterface(DESCRIPTOR); 1514 int type = data.readInt(); 1515 String password = data.readString(); 1516 int result = changeEncryptionPassword(type, password); 1517 reply.writeNoException(); 1518 reply.writeInt(result); 1519 return true; 1520 } 1521 case TRANSACTION_getVolumeList: { 1522 data.enforceInterface(DESCRIPTOR); 1523 int userId = data.readInt(); 1524 StorageVolume[] result = getVolumeList(userId); 1525 reply.writeNoException(); 1526 reply.writeTypedArray(result, android.os.Parcelable.PARCELABLE_WRITE_RETURN_VALUE); 1527 return true; 1528 } 1529 case TRANSACTION_getSecureContainerFilesystemPath: { 1530 data.enforceInterface(DESCRIPTOR); 1531 String id; 1532 id = data.readString(); 1533 String path = getSecureContainerFilesystemPath(id); 1534 reply.writeNoException(); 1535 reply.writeString(path); 1536 return true; 1537 } 1538 case TRANSACTION_getEncryptionState: { 1539 data.enforceInterface(DESCRIPTOR); 1540 int result = getEncryptionState(); 1541 reply.writeNoException(); 1542 reply.writeInt(result); 1543 return true; 1544 } 1545 case TRANSACTION_fixPermissionsSecureContainer: { 1546 data.enforceInterface(DESCRIPTOR); 1547 String id; 1548 id = data.readString(); 1549 int gid; 1550 gid = data.readInt(); 1551 String filename; 1552 filename = data.readString(); 1553 int resultCode = fixPermissionsSecureContainer(id, gid, filename); 1554 reply.writeNoException(); 1555 reply.writeInt(resultCode); 1556 return true; 1557 } 1558 case TRANSACTION_mkdirs: { 1559 data.enforceInterface(DESCRIPTOR); 1560 String callingPkg = data.readString(); 1561 String path = data.readString(); 1562 int result = mkdirs(callingPkg, path); 1563 reply.writeNoException(); 1564 reply.writeInt(result); 1565 return true; 1566 } 1567 case TRANSACTION_getPasswordType: { 1568 data.enforceInterface(DESCRIPTOR); 1569 int result = getPasswordType(); 1570 reply.writeNoException(); 1571 reply.writeInt(result); 1572 return true; 1573 } 1574 case TRANSACTION_getPassword: { 1575 data.enforceInterface(DESCRIPTOR); 1576 String result = getPassword(); 1577 reply.writeNoException(); 1578 reply.writeString(result); 1579 return true; 1580 } 1581 case TRANSACTION_clearPassword: { 1582 data.enforceInterface(DESCRIPTOR); 1583 clearPassword(); 1584 reply.writeNoException(); 1585 return true; 1586 } 1587 case TRANSACTION_setField: { 1588 data.enforceInterface(DESCRIPTOR); 1589 String field = data.readString(); 1590 String contents = data.readString(); 1591 setField(field, contents); 1592 reply.writeNoException(); 1593 return true; 1594 } 1595 case TRANSACTION_getField: { 1596 data.enforceInterface(DESCRIPTOR); 1597 String field = data.readString(); 1598 String contents = getField(field); 1599 reply.writeNoException(); 1600 reply.writeString(contents); 1601 return true; 1602 } 1603 case TRANSACTION_resizeSecureContainer: { 1604 data.enforceInterface(DESCRIPTOR); 1605 String id; 1606 id = data.readString(); 1607 int sizeMb; 1608 sizeMb = data.readInt(); 1609 String key; 1610 key = data.readString(); 1611 int resultCode = resizeSecureContainer(id, sizeMb, key); 1612 reply.writeNoException(); 1613 reply.writeInt(resultCode); 1614 return true; 1615 } 1616 case TRANSACTION_lastMaintenance: { 1617 data.enforceInterface(DESCRIPTOR); 1618 long lastMaintenance = lastMaintenance(); 1619 reply.writeNoException(); 1620 reply.writeLong(lastMaintenance); 1621 return true; 1622 } 1623 case TRANSACTION_runMaintenance: { 1624 data.enforceInterface(DESCRIPTOR); 1625 runMaintenance(); 1626 reply.writeNoException(); 1627 return true; 1628 } 1629 case TRANSACTION_waitForAsecScan: { 1630 data.enforceInterface(DESCRIPTOR); 1631 waitForAsecScan(); 1632 reply.writeNoException(); 1633 return true; 1634 } 1635 case TRANSACTION_getDisks: { 1636 data.enforceInterface(DESCRIPTOR); 1637 DiskInfo[] disks = getDisks(); 1638 reply.writeNoException(); 1639 reply.writeTypedArray(disks, android.os.Parcelable.PARCELABLE_WRITE_RETURN_VALUE); 1640 return true; 1641 } 1642 case TRANSACTION_getVolumes: { 1643 data.enforceInterface(DESCRIPTOR); 1644 int _flags = data.readInt(); 1645 VolumeInfo[] volumes = getVolumes(_flags); 1646 reply.writeNoException(); 1647 reply.writeTypedArray(volumes, android.os.Parcelable.PARCELABLE_WRITE_RETURN_VALUE); 1648 return true; 1649 } 1650 case TRANSACTION_mount: { 1651 data.enforceInterface(DESCRIPTOR); 1652 String volId = data.readString(); 1653 mount(volId); 1654 reply.writeNoException(); 1655 return true; 1656 } 1657 case TRANSACTION_unmount: { 1658 data.enforceInterface(DESCRIPTOR); 1659 String volId = data.readString(); 1660 unmount(volId); 1661 reply.writeNoException(); 1662 return true; 1663 } 1664 case TRANSACTION_format: { 1665 data.enforceInterface(DESCRIPTOR); 1666 String volId = data.readString(); 1667 format(volId); 1668 reply.writeNoException(); 1669 return true; 1670 } 1671 case TRANSACTION_partitionPublic: { 1672 data.enforceInterface(DESCRIPTOR); 1673 String diskId = data.readString(); 1674 partitionPublic(diskId); 1675 reply.writeNoException(); 1676 return true; 1677 } 1678 case TRANSACTION_partitionPrivate: { 1679 data.enforceInterface(DESCRIPTOR); 1680 String diskId = data.readString(); 1681 partitionPrivate(diskId); 1682 reply.writeNoException(); 1683 return true; 1684 } 1685 case TRANSACTION_partitionMixed: { 1686 data.enforceInterface(DESCRIPTOR); 1687 String diskId = data.readString(); 1688 int ratio = data.readInt(); 1689 partitionMixed(diskId, ratio); 1690 reply.writeNoException(); 1691 return true; 1692 } 1693 case TRANSACTION_setVolumeNickname: { 1694 data.enforceInterface(DESCRIPTOR); 1695 String volId = data.readString(); 1696 String nickname = data.readString(); 1697 setVolumeNickname(volId, nickname); 1698 reply.writeNoException(); 1699 return true; 1700 } 1701 case TRANSACTION_setVolumeUserFlags: { 1702 data.enforceInterface(DESCRIPTOR); 1703 String volId = data.readString(); 1704 int _flags = data.readInt(); 1705 int _mask = data.readInt(); 1706 setVolumeUserFlags(volId, _flags, _mask); 1707 reply.writeNoException(); 1708 return true; 1709 } 1710 case TRANSACTION_getPrimaryStorageUuid: { 1711 data.enforceInterface(DESCRIPTOR); 1712 String volumeUuid = getPrimaryStorageUuid(); 1713 reply.writeNoException(); 1714 reply.writeString(volumeUuid); 1715 return true; 1716 } 1717 case TRANSACTION_setPrimaryStorageUuid: { 1718 data.enforceInterface(DESCRIPTOR); 1719 String volumeUuid = data.readString(); 1720 IPackageMoveObserver listener = IPackageMoveObserver.Stub.asInterface( 1721 data.readStrongBinder()); 1722 setPrimaryStorageUuid(volumeUuid, listener); 1723 reply.writeNoException(); 1724 return true; 1725 } 1726 } 1727 return super.onTransact(code, data, reply, flags); 1728 } 1729 } 1730 1731 /* 1732 * Creates a secure container with the specified parameters. Returns an int 1733 * consistent with MountServiceResultCode 1734 */ 1735 public int createSecureContainer(String id, int sizeMb, String fstype, String key, 1736 int ownerUid, boolean external) throws RemoteException; 1737 1738 /* 1739 * Destroy a secure container, and free up all resources associated with it. 1740 * NOTE: Ensure all references are released prior to deleting. Returns an 1741 * int consistent with MountServiceResultCode 1742 */ 1743 public int destroySecureContainer(String id, boolean force) throws RemoteException; 1744 1745 /* 1746 * Finalize a container which has just been created and populated. After 1747 * finalization, the container is immutable. Returns an int consistent with 1748 * MountServiceResultCode 1749 */ 1750 public int finalizeSecureContainer(String id) throws RemoteException; 1751 1752 /** 1753 * Call into MountService by PackageManager to notify that its done 1754 * processing the media status update request. 1755 */ 1756 public void finishMediaUpdate() throws RemoteException; 1757 1758 /** 1759 * Format external storage given a mount point. Returns an int consistent 1760 * with MountServiceResultCode 1761 */ 1762 public int formatVolume(String mountPoint) throws RemoteException; 1763 1764 /** 1765 * Gets the path to the mounted Opaque Binary Blob (OBB). 1766 */ 1767 public String getMountedObbPath(String rawPath) throws RemoteException; 1768 1769 /** 1770 * Gets an Array of currently known secure container IDs 1771 */ 1772 public String[] getSecureContainerList() throws RemoteException; 1773 1774 /* 1775 * Returns the filesystem path of a mounted secure container. 1776 */ 1777 public String getSecureContainerPath(String id) throws RemoteException; 1778 1779 /** 1780 * Returns an array of pids with open files on the specified path. 1781 */ 1782 public int[] getStorageUsers(String path) throws RemoteException; 1783 1784 /** 1785 * Gets the state of a volume via its mountpoint. 1786 */ 1787 public String getVolumeState(String mountPoint) throws RemoteException; 1788 1789 /** 1790 * Checks whether the specified Opaque Binary Blob (OBB) is mounted 1791 * somewhere. 1792 */ 1793 public boolean isObbMounted(String rawPath) throws RemoteException; 1794 1795 /* 1796 * Returns true if the specified container is mounted 1797 */ 1798 public boolean isSecureContainerMounted(String id) throws RemoteException; 1799 1800 /** 1801 * Returns true if a USB mass storage host is connected 1802 */ 1803 public boolean isUsbMassStorageConnected() throws RemoteException; 1804 1805 /** 1806 * Returns true if a USB mass storage host is enabled (media is shared) 1807 */ 1808 public boolean isUsbMassStorageEnabled() throws RemoteException; 1809 1810 /** 1811 * Mounts an Opaque Binary Blob (OBB) with the specified decryption key and 1812 * only allows the calling process's UID access to the contents. 1813 * MountService will call back to the supplied IObbActionListener to inform 1814 * it of the terminal state of the call. 1815 */ 1816 public void mountObb(String rawPath, String canonicalPath, String key, 1817 IObbActionListener token, int nonce) throws RemoteException; 1818 1819 /* 1820 * Mount a secure container with the specified key and owner UID. Returns an 1821 * int consistent with MountServiceResultCode 1822 */ 1823 public int mountSecureContainer(String id, String key, int ownerUid, boolean readOnly) 1824 throws RemoteException; 1825 1826 /** 1827 * Mount external storage at given mount point. Returns an int consistent 1828 * with MountServiceResultCode 1829 */ 1830 public int mountVolume(String mountPoint) throws RemoteException; 1831 1832 /** 1833 * Registers an IMountServiceListener for receiving async notifications. 1834 */ 1835 public void registerListener(IMountServiceListener listener) throws RemoteException; 1836 1837 /* 1838 * Rename an unmounted secure container. Returns an int consistent with 1839 * MountServiceResultCode 1840 */ 1841 public int renameSecureContainer(String oldId, String newId) throws RemoteException; 1842 1843 /** 1844 * Enables / disables USB mass storage. The caller should check actual 1845 * status of enabling/disabling USB mass storage via StorageEventListener. 1846 */ 1847 public void setUsbMassStorageEnabled(boolean enable) throws RemoteException; 1848 1849 /** 1850 * Shuts down the MountService and gracefully unmounts all external media. 1851 * Invokes call back once the shutdown is complete. 1852 */ 1853 public void shutdown(IMountShutdownObserver observer) throws RemoteException; 1854 1855 /** 1856 * Unmounts an Opaque Binary Blob (OBB). When the force flag is specified, 1857 * any program using it will be forcibly killed to unmount the image. 1858 * MountService will call back to the supplied IObbActionListener to inform 1859 * it of the terminal state of the call. 1860 */ 1861 public void unmountObb(String rawPath, boolean force, IObbActionListener token, int nonce) 1862 throws RemoteException; 1863 1864 /* 1865 * Unount a secure container. Returns an int consistent with 1866 * MountServiceResultCode 1867 */ 1868 public int unmountSecureContainer(String id, boolean force) throws RemoteException; 1869 1870 /** 1871 * Safely unmount external storage at given mount point. The unmount is an 1872 * asynchronous operation. Applications should register StorageEventListener 1873 * for storage related status changes. 1874 * @param mountPoint the mount point 1875 * @param force whether or not to forcefully unmount it (e.g. even if programs are using this 1876 * data currently) 1877 * @param removeEncryption whether or not encryption mapping should be removed from the volume. 1878 * This value implies {@code force}. 1879 */ 1880 public void unmountVolume(String mountPoint, boolean force, boolean removeEncryption) 1881 throws RemoteException; 1882 1883 /** 1884 * Unregisters an IMountServiceListener 1885 */ 1886 public void unregisterListener(IMountServiceListener listener) throws RemoteException; 1887 1888 /** 1889 * Returns whether or not the external storage is emulated. 1890 */ 1891 public boolean isExternalStorageEmulated() throws RemoteException; 1892 1893 /** The volume is not encrypted. */ 1894 static final int ENCRYPTION_STATE_NONE = 1; 1895 /** The volume has been encrypted succesfully. */ 1896 static final int ENCRYPTION_STATE_OK = 0; 1897 /** The volume is in a bad state.*/ 1898 static final int ENCRYPTION_STATE_ERROR_UNKNOWN = -1; 1899 /** Encryption is incomplete */ 1900 static final int ENCRYPTION_STATE_ERROR_INCOMPLETE = -2; 1901 /** Encryption is incomplete and irrecoverable */ 1902 static final int ENCRYPTION_STATE_ERROR_INCONSISTENT = -3; 1903 /** Underlying data is corrupt */ 1904 static final int ENCRYPTION_STATE_ERROR_CORRUPT = -4; 1905 1906 /** 1907 * Determines the encryption state of the volume. 1908 * @return a numerical value. See {@code ENCRYPTION_STATE_*} for possible values. 1909 */ 1910 public int getEncryptionState() throws RemoteException; 1911 1912 /** 1913 * Decrypts any encrypted volumes. 1914 */ 1915 public int decryptStorage(String password) throws RemoteException; 1916 1917 /** 1918 * Encrypts storage. 1919 */ 1920 public int encryptStorage(int type, String password) throws RemoteException; 1921 1922 /** 1923 * Changes the encryption password. 1924 */ 1925 public int changeEncryptionPassword(int type, String password) 1926 throws RemoteException; 1927 1928 /** 1929 * Verify the encryption password against the stored volume. This method 1930 * may only be called by the system process. 1931 */ 1932 public int verifyEncryptionPassword(String password) throws RemoteException; 1933 1934 /** 1935 * Returns list of all mountable volumes. 1936 */ 1937 public StorageVolume[] getVolumeList(int userId) throws RemoteException; 1938 1939 /** 1940 * Gets the path on the filesystem for the ASEC container itself. 1941 * 1942 * @param cid ASEC container ID 1943 * @return path to filesystem or {@code null} if it's not found 1944 * @throws RemoteException 1945 */ 1946 public String getSecureContainerFilesystemPath(String cid) throws RemoteException; 1947 1948 /* 1949 * Fix permissions in a container which has just been created and populated. 1950 * Returns an int consistent with MountServiceResultCode 1951 */ 1952 public int fixPermissionsSecureContainer(String id, int gid, String filename) 1953 throws RemoteException; 1954 1955 /** 1956 * Ensure that all directories along given path exist, creating parent 1957 * directories as needed. Validates that given path is absolute and that it 1958 * contains no relative "." or ".." paths or symlinks. Also ensures that 1959 * path belongs to a volume managed by vold, and that path is either 1960 * external storage data or OBB directory belonging to calling app. 1961 */ 1962 public int mkdirs(String callingPkg, String path) throws RemoteException; 1963 1964 /** 1965 * Determines the type of the encryption password 1966 * @return PasswordType 1967 */ 1968 public int getPasswordType() throws RemoteException; 1969 1970 /** 1971 * Get password from vold 1972 * @return password or empty string 1973 */ 1974 public String getPassword() throws RemoteException; 1975 1976 /** 1977 * Securely clear password from vold 1978 */ 1979 public void clearPassword() throws RemoteException; 1980 1981 /** 1982 * Set a field in the crypto header. 1983 * @param field field to set 1984 * @param contents contents to set in field 1985 */ 1986 public void setField(String field, String contents) throws RemoteException; 1987 1988 /** 1989 * Gets a field from the crypto header. 1990 * @param field field to get 1991 * @return contents of field 1992 */ 1993 public String getField(String field) throws RemoteException; 1994 1995 public int resizeSecureContainer(String id, int sizeMb, String key) throws RemoteException; 1996 1997 /** 1998 * Report the time of the last maintenance operation such as fstrim. 1999 * @return Timestamp of the last maintenance operation, in the 2000 * System.currentTimeMillis() time base 2001 * @throws RemoteException 2002 */ 2003 public long lastMaintenance() throws RemoteException; 2004 2005 /** 2006 * Kick off an immediate maintenance operation 2007 * @throws RemoteException 2008 */ 2009 public void runMaintenance() throws RemoteException; 2010 2011 public void waitForAsecScan() throws RemoteException; 2012 2013 public DiskInfo[] getDisks() throws RemoteException; 2014 public VolumeInfo[] getVolumes(int flags) throws RemoteException; 2015 2016 public void mount(String volId) throws RemoteException; 2017 public void unmount(String volId) throws RemoteException; 2018 public void format(String volId) throws RemoteException; 2019 2020 public void partitionPublic(String diskId) throws RemoteException; 2021 public void partitionPrivate(String diskId) throws RemoteException; 2022 public void partitionMixed(String diskId, int ratio) throws RemoteException; 2023 2024 public void setVolumeNickname(String volId, String nickname) throws RemoteException; 2025 public void setVolumeUserFlags(String volId, int flags, int mask) throws RemoteException; 2026 2027 public String getPrimaryStorageUuid() throws RemoteException; 2028 public void setPrimaryStorageUuid(String volumeUuid, IPackageMoveObserver callback) 2029 throws RemoteException; 2030} 2031