IMountService.java revision 7d2af54a98358e9dea96f879ebd1ea915263522b
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 VolumeRecord[] getVolumeRecords(int _flags) throws RemoteException {
946                Parcel _data = Parcel.obtain();
947                Parcel _reply = Parcel.obtain();
948                VolumeRecord[] _result;
949                try {
950                    _data.writeInterfaceToken(DESCRIPTOR);
951                    _data.writeInt(_flags);
952                    mRemote.transact(Stub.TRANSACTION_getVolumeRecords, _data, _reply, 0);
953                    _reply.readException();
954                    _result = _reply.createTypedArray(VolumeRecord.CREATOR);
955                } finally {
956                    _reply.recycle();
957                    _data.recycle();
958                }
959                return _result;
960            }
961
962            @Override
963            public void mount(String volId) throws RemoteException {
964                Parcel _data = Parcel.obtain();
965                Parcel _reply = Parcel.obtain();
966                try {
967                    _data.writeInterfaceToken(DESCRIPTOR);
968                    _data.writeString(volId);
969                    mRemote.transact(Stub.TRANSACTION_mount, _data, _reply, 0);
970                    _reply.readException();
971                } finally {
972                    _reply.recycle();
973                    _data.recycle();
974                }
975            }
976
977            @Override
978            public void unmount(String volId) throws RemoteException {
979                Parcel _data = Parcel.obtain();
980                Parcel _reply = Parcel.obtain();
981                try {
982                    _data.writeInterfaceToken(DESCRIPTOR);
983                    _data.writeString(volId);
984                    mRemote.transact(Stub.TRANSACTION_unmount, _data, _reply, 0);
985                    _reply.readException();
986                } finally {
987                    _reply.recycle();
988                    _data.recycle();
989                }
990            }
991
992            @Override
993            public void format(String volId) throws RemoteException {
994                Parcel _data = Parcel.obtain();
995                Parcel _reply = Parcel.obtain();
996                try {
997                    _data.writeInterfaceToken(DESCRIPTOR);
998                    _data.writeString(volId);
999                    mRemote.transact(Stub.TRANSACTION_format, _data, _reply, 0);
1000                    _reply.readException();
1001                } finally {
1002                    _reply.recycle();
1003                    _data.recycle();
1004                }
1005            }
1006
1007            @Override
1008            public void partitionPublic(String diskId) throws RemoteException {
1009                Parcel _data = Parcel.obtain();
1010                Parcel _reply = Parcel.obtain();
1011                try {
1012                    _data.writeInterfaceToken(DESCRIPTOR);
1013                    _data.writeString(diskId);
1014                    mRemote.transact(Stub.TRANSACTION_partitionPublic, _data, _reply, 0);
1015                    _reply.readException();
1016                } finally {
1017                    _reply.recycle();
1018                    _data.recycle();
1019                }
1020            }
1021
1022            @Override
1023            public void partitionPrivate(String diskId) throws RemoteException {
1024                Parcel _data = Parcel.obtain();
1025                Parcel _reply = Parcel.obtain();
1026                try {
1027                    _data.writeInterfaceToken(DESCRIPTOR);
1028                    _data.writeString(diskId);
1029                    mRemote.transact(Stub.TRANSACTION_partitionPrivate, _data, _reply, 0);
1030                    _reply.readException();
1031                } finally {
1032                    _reply.recycle();
1033                    _data.recycle();
1034                }
1035            }
1036
1037            @Override
1038            public void partitionMixed(String diskId, int ratio) throws RemoteException {
1039                Parcel _data = Parcel.obtain();
1040                Parcel _reply = Parcel.obtain();
1041                try {
1042                    _data.writeInterfaceToken(DESCRIPTOR);
1043                    _data.writeString(diskId);
1044                    _data.writeInt(ratio);
1045                    mRemote.transact(Stub.TRANSACTION_partitionMixed, _data, _reply, 0);
1046                    _reply.readException();
1047                } finally {
1048                    _reply.recycle();
1049                    _data.recycle();
1050                }
1051            }
1052
1053            @Override
1054            public void setVolumeNickname(String fsUuid, String nickname) throws RemoteException {
1055                Parcel _data = Parcel.obtain();
1056                Parcel _reply = Parcel.obtain();
1057                try {
1058                    _data.writeInterfaceToken(DESCRIPTOR);
1059                    _data.writeString(fsUuid);
1060                    _data.writeString(nickname);
1061                    mRemote.transact(Stub.TRANSACTION_setVolumeNickname, _data, _reply, 0);
1062                    _reply.readException();
1063                } finally {
1064                    _reply.recycle();
1065                    _data.recycle();
1066                }
1067            }
1068
1069            @Override
1070            public void setVolumeUserFlags(String fsUuid, int flags, int mask) throws RemoteException {
1071                Parcel _data = Parcel.obtain();
1072                Parcel _reply = Parcel.obtain();
1073                try {
1074                    _data.writeInterfaceToken(DESCRIPTOR);
1075                    _data.writeString(fsUuid);
1076                    _data.writeInt(flags);
1077                    _data.writeInt(mask);
1078                    mRemote.transact(Stub.TRANSACTION_setVolumeUserFlags, _data, _reply, 0);
1079                    _reply.readException();
1080                } finally {
1081                    _reply.recycle();
1082                    _data.recycle();
1083                }
1084            }
1085
1086            @Override
1087            public void forgetVolume(String fsUuid) throws RemoteException {
1088                Parcel _data = Parcel.obtain();
1089                Parcel _reply = Parcel.obtain();
1090                try {
1091                    _data.writeInterfaceToken(DESCRIPTOR);
1092                    _data.writeString(fsUuid);
1093                    mRemote.transact(Stub.TRANSACTION_forgetVolume, _data, _reply, 0);
1094                    _reply.readException();
1095                } finally {
1096                    _reply.recycle();
1097                    _data.recycle();
1098                }
1099            }
1100
1101            @Override
1102            public void forgetAllVolumes() throws RemoteException {
1103                Parcel _data = Parcel.obtain();
1104                Parcel _reply = Parcel.obtain();
1105                try {
1106                    _data.writeInterfaceToken(DESCRIPTOR);
1107                    mRemote.transact(Stub.TRANSACTION_forgetAllVolumes, _data, _reply, 0);
1108                    _reply.readException();
1109                } finally {
1110                    _reply.recycle();
1111                    _data.recycle();
1112                }
1113            }
1114
1115            @Override
1116            public String getPrimaryStorageUuid() throws RemoteException {
1117                Parcel _data = Parcel.obtain();
1118                Parcel _reply = Parcel.obtain();
1119                String _result;
1120                try {
1121                    _data.writeInterfaceToken(DESCRIPTOR);
1122                    mRemote.transact(Stub.TRANSACTION_getPrimaryStorageUuid, _data, _reply, 0);
1123                    _reply.readException();
1124                    _result = _reply.readString();
1125                } finally {
1126                    _reply.recycle();
1127                    _data.recycle();
1128                }
1129                return _result;
1130            }
1131
1132            @Override
1133            public void setPrimaryStorageUuid(String volumeUuid, IPackageMoveObserver callback)
1134                    throws RemoteException {
1135                Parcel _data = Parcel.obtain();
1136                Parcel _reply = Parcel.obtain();
1137                try {
1138                    _data.writeInterfaceToken(DESCRIPTOR);
1139                    _data.writeString(volumeUuid);
1140                    _data.writeStrongBinder((callback != null ? callback.asBinder() : null));
1141                    mRemote.transact(Stub.TRANSACTION_setPrimaryStorageUuid, _data, _reply, 0);
1142                    _reply.readException();
1143                } finally {
1144                    _reply.recycle();
1145                    _data.recycle();
1146                }
1147            }
1148        }
1149
1150        private static final String DESCRIPTOR = "IMountService";
1151
1152        static final int TRANSACTION_registerListener = IBinder.FIRST_CALL_TRANSACTION + 0;
1153
1154        static final int TRANSACTION_unregisterListener = IBinder.FIRST_CALL_TRANSACTION + 1;
1155
1156        static final int TRANSACTION_isUsbMassStorageConnected = IBinder.FIRST_CALL_TRANSACTION + 2;
1157
1158        static final int TRANSACTION_setUsbMassStorageEnabled = IBinder.FIRST_CALL_TRANSACTION + 3;
1159
1160        static final int TRANSACTION_isUsbMassStorageEnabled = IBinder.FIRST_CALL_TRANSACTION + 4;
1161
1162        static final int TRANSACTION_mountVolume = IBinder.FIRST_CALL_TRANSACTION + 5;
1163
1164        static final int TRANSACTION_unmountVolume = IBinder.FIRST_CALL_TRANSACTION + 6;
1165
1166        static final int TRANSACTION_formatVolume = IBinder.FIRST_CALL_TRANSACTION + 7;
1167
1168        static final int TRANSACTION_getStorageUsers = IBinder.FIRST_CALL_TRANSACTION + 8;
1169
1170        static final int TRANSACTION_getVolumeState = IBinder.FIRST_CALL_TRANSACTION + 9;
1171
1172        static final int TRANSACTION_createSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 10;
1173
1174        static final int TRANSACTION_finalizeSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 11;
1175
1176        static final int TRANSACTION_destroySecureContainer = IBinder.FIRST_CALL_TRANSACTION + 12;
1177
1178        static final int TRANSACTION_mountSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 13;
1179
1180        static final int TRANSACTION_unmountSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 14;
1181
1182        static final int TRANSACTION_isSecureContainerMounted = IBinder.FIRST_CALL_TRANSACTION + 15;
1183
1184        static final int TRANSACTION_renameSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 16;
1185
1186        static final int TRANSACTION_getSecureContainerPath = IBinder.FIRST_CALL_TRANSACTION + 17;
1187
1188        static final int TRANSACTION_getSecureContainerList = IBinder.FIRST_CALL_TRANSACTION + 18;
1189
1190        static final int TRANSACTION_shutdown = IBinder.FIRST_CALL_TRANSACTION + 19;
1191
1192        static final int TRANSACTION_finishMediaUpdate = IBinder.FIRST_CALL_TRANSACTION + 20;
1193
1194        static final int TRANSACTION_mountObb = IBinder.FIRST_CALL_TRANSACTION + 21;
1195
1196        static final int TRANSACTION_unmountObb = IBinder.FIRST_CALL_TRANSACTION + 22;
1197
1198        static final int TRANSACTION_isObbMounted = IBinder.FIRST_CALL_TRANSACTION + 23;
1199
1200        static final int TRANSACTION_getMountedObbPath = IBinder.FIRST_CALL_TRANSACTION + 24;
1201
1202        static final int TRANSACTION_isExternalStorageEmulated = IBinder.FIRST_CALL_TRANSACTION + 25;
1203
1204        static final int TRANSACTION_decryptStorage = IBinder.FIRST_CALL_TRANSACTION + 26;
1205
1206        static final int TRANSACTION_encryptStorage = IBinder.FIRST_CALL_TRANSACTION + 27;
1207
1208        static final int TRANSACTION_changeEncryptionPassword = IBinder.FIRST_CALL_TRANSACTION + 28;
1209
1210        static final int TRANSACTION_getVolumeList = IBinder.FIRST_CALL_TRANSACTION + 29;
1211
1212        static final int TRANSACTION_getSecureContainerFilesystemPath = IBinder.FIRST_CALL_TRANSACTION + 30;
1213
1214        static final int TRANSACTION_getEncryptionState = IBinder.FIRST_CALL_TRANSACTION + 31;
1215
1216        static final int TRANSACTION_verifyEncryptionPassword = IBinder.FIRST_CALL_TRANSACTION + 32;
1217
1218        static final int TRANSACTION_fixPermissionsSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 33;
1219
1220        static final int TRANSACTION_mkdirs = IBinder.FIRST_CALL_TRANSACTION + 34;
1221
1222        static final int TRANSACTION_getPasswordType = IBinder.FIRST_CALL_TRANSACTION + 35;
1223
1224        static final int TRANSACTION_getPassword = IBinder.FIRST_CALL_TRANSACTION + 36;
1225
1226        static final int TRANSACTION_clearPassword = IBinder.FIRST_CALL_TRANSACTION + 37;
1227
1228        static final int TRANSACTION_setField = IBinder.FIRST_CALL_TRANSACTION + 38;
1229
1230        static final int TRANSACTION_getField = IBinder.FIRST_CALL_TRANSACTION + 39;
1231
1232        static final int TRANSACTION_resizeSecureContainer = IBinder.FIRST_CALL_TRANSACTION + 40;
1233
1234        static final int TRANSACTION_lastMaintenance = IBinder.FIRST_CALL_TRANSACTION + 41;
1235
1236        static final int TRANSACTION_runMaintenance = IBinder.FIRST_CALL_TRANSACTION + 42;
1237
1238        static final int TRANSACTION_waitForAsecScan = IBinder.FIRST_CALL_TRANSACTION + 43;
1239
1240        static final int TRANSACTION_getDisks = IBinder.FIRST_CALL_TRANSACTION + 44;
1241        static final int TRANSACTION_getVolumes = IBinder.FIRST_CALL_TRANSACTION + 45;
1242        static final int TRANSACTION_getVolumeRecords = IBinder.FIRST_CALL_TRANSACTION + 46;
1243
1244        static final int TRANSACTION_mount = IBinder.FIRST_CALL_TRANSACTION + 47;
1245        static final int TRANSACTION_unmount = IBinder.FIRST_CALL_TRANSACTION + 48;
1246        static final int TRANSACTION_format = IBinder.FIRST_CALL_TRANSACTION + 49;
1247
1248        static final int TRANSACTION_partitionPublic = IBinder.FIRST_CALL_TRANSACTION + 50;
1249        static final int TRANSACTION_partitionPrivate = IBinder.FIRST_CALL_TRANSACTION + 51;
1250        static final int TRANSACTION_partitionMixed = IBinder.FIRST_CALL_TRANSACTION + 52;
1251
1252        static final int TRANSACTION_setVolumeNickname = IBinder.FIRST_CALL_TRANSACTION + 53;
1253        static final int TRANSACTION_setVolumeUserFlags = IBinder.FIRST_CALL_TRANSACTION + 54;
1254        static final int TRANSACTION_forgetVolume = IBinder.FIRST_CALL_TRANSACTION + 55;
1255        static final int TRANSACTION_forgetAllVolumes = IBinder.FIRST_CALL_TRANSACTION + 56;
1256
1257        static final int TRANSACTION_getPrimaryStorageUuid = IBinder.FIRST_CALL_TRANSACTION + 57;
1258        static final int TRANSACTION_setPrimaryStorageUuid = IBinder.FIRST_CALL_TRANSACTION + 58;
1259
1260        /**
1261         * Cast an IBinder object into an IMountService interface, generating a
1262         * proxy if needed.
1263         */
1264        public static IMountService asInterface(IBinder obj) {
1265            if (obj == null) {
1266                return null;
1267            }
1268            IInterface iin = obj.queryLocalInterface(DESCRIPTOR);
1269            if (iin != null && iin instanceof IMountService) {
1270                return (IMountService) iin;
1271            }
1272            return new IMountService.Stub.Proxy(obj);
1273        }
1274
1275        /** Construct the stub at attach it to the interface. */
1276        public Stub() {
1277            attachInterface(this, DESCRIPTOR);
1278        }
1279
1280        public IBinder asBinder() {
1281            return this;
1282        }
1283
1284        @Override
1285        public boolean onTransact(int code, Parcel data, Parcel reply,
1286                int flags) throws RemoteException {
1287            switch (code) {
1288                case INTERFACE_TRANSACTION: {
1289                    reply.writeString(DESCRIPTOR);
1290                    return true;
1291                }
1292                case TRANSACTION_registerListener: {
1293                    data.enforceInterface(DESCRIPTOR);
1294                    IMountServiceListener listener;
1295                    listener = IMountServiceListener.Stub.asInterface(data.readStrongBinder());
1296                    registerListener(listener);
1297                    reply.writeNoException();
1298                    return true;
1299                }
1300                case TRANSACTION_unregisterListener: {
1301                    data.enforceInterface(DESCRIPTOR);
1302                    IMountServiceListener listener;
1303                    listener = IMountServiceListener.Stub.asInterface(data.readStrongBinder());
1304                    unregisterListener(listener);
1305                    reply.writeNoException();
1306                    return true;
1307                }
1308                case TRANSACTION_isUsbMassStorageConnected: {
1309                    data.enforceInterface(DESCRIPTOR);
1310                    boolean result = isUsbMassStorageConnected();
1311                    reply.writeNoException();
1312                    reply.writeInt((result ? 1 : 0));
1313                    return true;
1314                }
1315                case TRANSACTION_setUsbMassStorageEnabled: {
1316                    data.enforceInterface(DESCRIPTOR);
1317                    boolean enable;
1318                    enable = 0 != data.readInt();
1319                    setUsbMassStorageEnabled(enable);
1320                    reply.writeNoException();
1321                    return true;
1322                }
1323                case TRANSACTION_isUsbMassStorageEnabled: {
1324                    data.enforceInterface(DESCRIPTOR);
1325                    boolean result = isUsbMassStorageEnabled();
1326                    reply.writeNoException();
1327                    reply.writeInt((result ? 1 : 0));
1328                    return true;
1329                }
1330                case TRANSACTION_mountVolume: {
1331                    data.enforceInterface(DESCRIPTOR);
1332                    String mountPoint;
1333                    mountPoint = data.readString();
1334                    int resultCode = mountVolume(mountPoint);
1335                    reply.writeNoException();
1336                    reply.writeInt(resultCode);
1337                    return true;
1338                }
1339                case TRANSACTION_unmountVolume: {
1340                    data.enforceInterface(DESCRIPTOR);
1341                    String mountPoint;
1342                    mountPoint = data.readString();
1343                    boolean force = 0 != data.readInt();
1344                    boolean removeEncrypt = 0 != data.readInt();
1345                    unmountVolume(mountPoint, force, removeEncrypt);
1346                    reply.writeNoException();
1347                    return true;
1348                }
1349                case TRANSACTION_formatVolume: {
1350                    data.enforceInterface(DESCRIPTOR);
1351                    String mountPoint;
1352                    mountPoint = data.readString();
1353                    int result = formatVolume(mountPoint);
1354                    reply.writeNoException();
1355                    reply.writeInt(result);
1356                    return true;
1357                }
1358                case TRANSACTION_getStorageUsers: {
1359                    data.enforceInterface(DESCRIPTOR);
1360                    String path;
1361                    path = data.readString();
1362                    int[] pids = getStorageUsers(path);
1363                    reply.writeNoException();
1364                    reply.writeIntArray(pids);
1365                    return true;
1366                }
1367                case TRANSACTION_getVolumeState: {
1368                    data.enforceInterface(DESCRIPTOR);
1369                    String mountPoint;
1370                    mountPoint = data.readString();
1371                    String state = getVolumeState(mountPoint);
1372                    reply.writeNoException();
1373                    reply.writeString(state);
1374                    return true;
1375                }
1376                case TRANSACTION_createSecureContainer: {
1377                    data.enforceInterface(DESCRIPTOR);
1378                    String id;
1379                    id = data.readString();
1380                    int sizeMb;
1381                    sizeMb = data.readInt();
1382                    String fstype;
1383                    fstype = data.readString();
1384                    String key;
1385                    key = data.readString();
1386                    int ownerUid;
1387                    ownerUid = data.readInt();
1388                    boolean external;
1389                    external = 0 != data.readInt();
1390                    int resultCode = createSecureContainer(id, sizeMb, fstype, key, ownerUid,
1391                            external);
1392                    reply.writeNoException();
1393                    reply.writeInt(resultCode);
1394                    return true;
1395                }
1396                case TRANSACTION_finalizeSecureContainer: {
1397                    data.enforceInterface(DESCRIPTOR);
1398                    String id;
1399                    id = data.readString();
1400                    int resultCode = finalizeSecureContainer(id);
1401                    reply.writeNoException();
1402                    reply.writeInt(resultCode);
1403                    return true;
1404                }
1405                case TRANSACTION_destroySecureContainer: {
1406                    data.enforceInterface(DESCRIPTOR);
1407                    String id;
1408                    id = data.readString();
1409                    boolean force;
1410                    force = 0 != data.readInt();
1411                    int resultCode = destroySecureContainer(id, force);
1412                    reply.writeNoException();
1413                    reply.writeInt(resultCode);
1414                    return true;
1415                }
1416                case TRANSACTION_mountSecureContainer: {
1417                    data.enforceInterface(DESCRIPTOR);
1418                    String id;
1419                    id = data.readString();
1420                    String key;
1421                    key = data.readString();
1422                    int ownerUid;
1423                    ownerUid = data.readInt();
1424                    boolean readOnly;
1425                    readOnly = data.readInt() != 0;
1426                    int resultCode = mountSecureContainer(id, key, ownerUid, readOnly);
1427                    reply.writeNoException();
1428                    reply.writeInt(resultCode);
1429                    return true;
1430                }
1431                case TRANSACTION_unmountSecureContainer: {
1432                    data.enforceInterface(DESCRIPTOR);
1433                    String id;
1434                    id = data.readString();
1435                    boolean force;
1436                    force = 0 != data.readInt();
1437                    int resultCode = unmountSecureContainer(id, force);
1438                    reply.writeNoException();
1439                    reply.writeInt(resultCode);
1440                    return true;
1441                }
1442                case TRANSACTION_isSecureContainerMounted: {
1443                    data.enforceInterface(DESCRIPTOR);
1444                    String id;
1445                    id = data.readString();
1446                    boolean status = isSecureContainerMounted(id);
1447                    reply.writeNoException();
1448                    reply.writeInt((status ? 1 : 0));
1449                    return true;
1450                }
1451                case TRANSACTION_renameSecureContainer: {
1452                    data.enforceInterface(DESCRIPTOR);
1453                    String oldId;
1454                    oldId = data.readString();
1455                    String newId;
1456                    newId = data.readString();
1457                    int resultCode = renameSecureContainer(oldId, newId);
1458                    reply.writeNoException();
1459                    reply.writeInt(resultCode);
1460                    return true;
1461                }
1462                case TRANSACTION_getSecureContainerPath: {
1463                    data.enforceInterface(DESCRIPTOR);
1464                    String id;
1465                    id = data.readString();
1466                    String path = getSecureContainerPath(id);
1467                    reply.writeNoException();
1468                    reply.writeString(path);
1469                    return true;
1470                }
1471                case TRANSACTION_getSecureContainerList: {
1472                    data.enforceInterface(DESCRIPTOR);
1473                    String[] ids = getSecureContainerList();
1474                    reply.writeNoException();
1475                    reply.writeStringArray(ids);
1476                    return true;
1477                }
1478                case TRANSACTION_shutdown: {
1479                    data.enforceInterface(DESCRIPTOR);
1480                    IMountShutdownObserver observer;
1481                    observer = IMountShutdownObserver.Stub.asInterface(data
1482                            .readStrongBinder());
1483                    shutdown(observer);
1484                    reply.writeNoException();
1485                    return true;
1486                }
1487                case TRANSACTION_finishMediaUpdate: {
1488                    data.enforceInterface(DESCRIPTOR);
1489                    finishMediaUpdate();
1490                    reply.writeNoException();
1491                    return true;
1492                }
1493                case TRANSACTION_mountObb: {
1494                    data.enforceInterface(DESCRIPTOR);
1495                    final String rawPath = data.readString();
1496                    final String canonicalPath = data.readString();
1497                    final String key = data.readString();
1498                    IObbActionListener observer;
1499                    observer = IObbActionListener.Stub.asInterface(data.readStrongBinder());
1500                    int nonce;
1501                    nonce = data.readInt();
1502                    mountObb(rawPath, canonicalPath, key, observer, nonce);
1503                    reply.writeNoException();
1504                    return true;
1505                }
1506                case TRANSACTION_unmountObb: {
1507                    data.enforceInterface(DESCRIPTOR);
1508                    String filename;
1509                    filename = data.readString();
1510                    boolean force;
1511                    force = 0 != data.readInt();
1512                    IObbActionListener observer;
1513                    observer = IObbActionListener.Stub.asInterface(data.readStrongBinder());
1514                    int nonce;
1515                    nonce = data.readInt();
1516                    unmountObb(filename, force, observer, nonce);
1517                    reply.writeNoException();
1518                    return true;
1519                }
1520                case TRANSACTION_isObbMounted: {
1521                    data.enforceInterface(DESCRIPTOR);
1522                    String filename;
1523                    filename = data.readString();
1524                    boolean status = isObbMounted(filename);
1525                    reply.writeNoException();
1526                    reply.writeInt((status ? 1 : 0));
1527                    return true;
1528                }
1529                case TRANSACTION_getMountedObbPath: {
1530                    data.enforceInterface(DESCRIPTOR);
1531                    String filename;
1532                    filename = data.readString();
1533                    String mountedPath = getMountedObbPath(filename);
1534                    reply.writeNoException();
1535                    reply.writeString(mountedPath);
1536                    return true;
1537                }
1538                case TRANSACTION_isExternalStorageEmulated: {
1539                    data.enforceInterface(DESCRIPTOR);
1540                    boolean emulated = isExternalStorageEmulated();
1541                    reply.writeNoException();
1542                    reply.writeInt(emulated ? 1 : 0);
1543                    return true;
1544                }
1545                case TRANSACTION_decryptStorage: {
1546                    data.enforceInterface(DESCRIPTOR);
1547                    String password = data.readString();
1548                    int result = decryptStorage(password);
1549                    reply.writeNoException();
1550                    reply.writeInt(result);
1551                    return true;
1552                }
1553                case TRANSACTION_encryptStorage: {
1554                    data.enforceInterface(DESCRIPTOR);
1555                    int type = data.readInt();
1556                    String password = data.readString();
1557                    int result = encryptStorage(type, password);
1558                    reply.writeNoException();
1559                    reply.writeInt(result);
1560                    return true;
1561                }
1562                case TRANSACTION_changeEncryptionPassword: {
1563                    data.enforceInterface(DESCRIPTOR);
1564                    int type = data.readInt();
1565                    String password = data.readString();
1566                    int result = changeEncryptionPassword(type, password);
1567                    reply.writeNoException();
1568                    reply.writeInt(result);
1569                    return true;
1570                }
1571                case TRANSACTION_getVolumeList: {
1572                    data.enforceInterface(DESCRIPTOR);
1573                    int userId = data.readInt();
1574                    StorageVolume[] result = getVolumeList(userId);
1575                    reply.writeNoException();
1576                    reply.writeTypedArray(result, android.os.Parcelable.PARCELABLE_WRITE_RETURN_VALUE);
1577                    return true;
1578                }
1579                case TRANSACTION_getSecureContainerFilesystemPath: {
1580                    data.enforceInterface(DESCRIPTOR);
1581                    String id;
1582                    id = data.readString();
1583                    String path = getSecureContainerFilesystemPath(id);
1584                    reply.writeNoException();
1585                    reply.writeString(path);
1586                    return true;
1587                }
1588                case TRANSACTION_getEncryptionState: {
1589                    data.enforceInterface(DESCRIPTOR);
1590                    int result = getEncryptionState();
1591                    reply.writeNoException();
1592                    reply.writeInt(result);
1593                    return true;
1594                }
1595                case TRANSACTION_fixPermissionsSecureContainer: {
1596                    data.enforceInterface(DESCRIPTOR);
1597                    String id;
1598                    id = data.readString();
1599                    int gid;
1600                    gid = data.readInt();
1601                    String filename;
1602                    filename = data.readString();
1603                    int resultCode = fixPermissionsSecureContainer(id, gid, filename);
1604                    reply.writeNoException();
1605                    reply.writeInt(resultCode);
1606                    return true;
1607                }
1608                case TRANSACTION_mkdirs: {
1609                    data.enforceInterface(DESCRIPTOR);
1610                    String callingPkg = data.readString();
1611                    String path = data.readString();
1612                    int result = mkdirs(callingPkg, path);
1613                    reply.writeNoException();
1614                    reply.writeInt(result);
1615                    return true;
1616                }
1617                case TRANSACTION_getPasswordType: {
1618                    data.enforceInterface(DESCRIPTOR);
1619                    int result = getPasswordType();
1620                    reply.writeNoException();
1621                    reply.writeInt(result);
1622                    return true;
1623                }
1624                case TRANSACTION_getPassword: {
1625                    data.enforceInterface(DESCRIPTOR);
1626                    String result = getPassword();
1627                    reply.writeNoException();
1628                    reply.writeString(result);
1629                    return true;
1630                }
1631                case TRANSACTION_clearPassword: {
1632                    data.enforceInterface(DESCRIPTOR);
1633                    clearPassword();
1634                    reply.writeNoException();
1635                    return true;
1636                }
1637                case TRANSACTION_setField: {
1638                    data.enforceInterface(DESCRIPTOR);
1639                    String field = data.readString();
1640                    String contents = data.readString();
1641                    setField(field, contents);
1642                    reply.writeNoException();
1643                    return true;
1644                }
1645                case TRANSACTION_getField: {
1646                    data.enforceInterface(DESCRIPTOR);
1647                    String field = data.readString();
1648                    String contents = getField(field);
1649                    reply.writeNoException();
1650                    reply.writeString(contents);
1651                    return true;
1652                }
1653                case TRANSACTION_resizeSecureContainer: {
1654                    data.enforceInterface(DESCRIPTOR);
1655                    String id;
1656                    id = data.readString();
1657                    int sizeMb;
1658                    sizeMb = data.readInt();
1659                    String key;
1660                    key = data.readString();
1661                    int resultCode = resizeSecureContainer(id, sizeMb, key);
1662                    reply.writeNoException();
1663                    reply.writeInt(resultCode);
1664                    return true;
1665                }
1666                case TRANSACTION_lastMaintenance: {
1667                    data.enforceInterface(DESCRIPTOR);
1668                    long lastMaintenance = lastMaintenance();
1669                    reply.writeNoException();
1670                    reply.writeLong(lastMaintenance);
1671                    return true;
1672                }
1673                case TRANSACTION_runMaintenance: {
1674                    data.enforceInterface(DESCRIPTOR);
1675                    runMaintenance();
1676                    reply.writeNoException();
1677                    return true;
1678                }
1679                case TRANSACTION_waitForAsecScan: {
1680                    data.enforceInterface(DESCRIPTOR);
1681                    waitForAsecScan();
1682                    reply.writeNoException();
1683                    return true;
1684                }
1685                case TRANSACTION_getDisks: {
1686                    data.enforceInterface(DESCRIPTOR);
1687                    DiskInfo[] disks = getDisks();
1688                    reply.writeNoException();
1689                    reply.writeTypedArray(disks, android.os.Parcelable.PARCELABLE_WRITE_RETURN_VALUE);
1690                    return true;
1691                }
1692                case TRANSACTION_getVolumes: {
1693                    data.enforceInterface(DESCRIPTOR);
1694                    int _flags = data.readInt();
1695                    VolumeInfo[] volumes = getVolumes(_flags);
1696                    reply.writeNoException();
1697                    reply.writeTypedArray(volumes, android.os.Parcelable.PARCELABLE_WRITE_RETURN_VALUE);
1698                    return true;
1699                }
1700                case TRANSACTION_getVolumeRecords: {
1701                    data.enforceInterface(DESCRIPTOR);
1702                    int _flags = data.readInt();
1703                    VolumeRecord[] volumes = getVolumeRecords(_flags);
1704                    reply.writeNoException();
1705                    reply.writeTypedArray(volumes, android.os.Parcelable.PARCELABLE_WRITE_RETURN_VALUE);
1706                    return true;
1707                }
1708                case TRANSACTION_mount: {
1709                    data.enforceInterface(DESCRIPTOR);
1710                    String volId = data.readString();
1711                    mount(volId);
1712                    reply.writeNoException();
1713                    return true;
1714                }
1715                case TRANSACTION_unmount: {
1716                    data.enforceInterface(DESCRIPTOR);
1717                    String volId = data.readString();
1718                    unmount(volId);
1719                    reply.writeNoException();
1720                    return true;
1721                }
1722                case TRANSACTION_format: {
1723                    data.enforceInterface(DESCRIPTOR);
1724                    String volId = data.readString();
1725                    format(volId);
1726                    reply.writeNoException();
1727                    return true;
1728                }
1729                case TRANSACTION_partitionPublic: {
1730                    data.enforceInterface(DESCRIPTOR);
1731                    String diskId = data.readString();
1732                    partitionPublic(diskId);
1733                    reply.writeNoException();
1734                    return true;
1735                }
1736                case TRANSACTION_partitionPrivate: {
1737                    data.enforceInterface(DESCRIPTOR);
1738                    String diskId = data.readString();
1739                    partitionPrivate(diskId);
1740                    reply.writeNoException();
1741                    return true;
1742                }
1743                case TRANSACTION_partitionMixed: {
1744                    data.enforceInterface(DESCRIPTOR);
1745                    String diskId = data.readString();
1746                    int ratio = data.readInt();
1747                    partitionMixed(diskId, ratio);
1748                    reply.writeNoException();
1749                    return true;
1750                }
1751                case TRANSACTION_setVolumeNickname: {
1752                    data.enforceInterface(DESCRIPTOR);
1753                    String volId = data.readString();
1754                    String nickname = data.readString();
1755                    setVolumeNickname(volId, nickname);
1756                    reply.writeNoException();
1757                    return true;
1758                }
1759                case TRANSACTION_setVolumeUserFlags: {
1760                    data.enforceInterface(DESCRIPTOR);
1761                    String volId = data.readString();
1762                    int _flags = data.readInt();
1763                    int _mask = data.readInt();
1764                    setVolumeUserFlags(volId, _flags, _mask);
1765                    reply.writeNoException();
1766                    return true;
1767                }
1768                case TRANSACTION_forgetVolume: {
1769                    data.enforceInterface(DESCRIPTOR);
1770                    String fsUuid = data.readString();
1771                    forgetVolume(fsUuid);
1772                    reply.writeNoException();
1773                    return true;
1774                }
1775                case TRANSACTION_forgetAllVolumes: {
1776                    data.enforceInterface(DESCRIPTOR);
1777                    forgetAllVolumes();
1778                    reply.writeNoException();
1779                    return true;
1780                }
1781                case TRANSACTION_getPrimaryStorageUuid: {
1782                    data.enforceInterface(DESCRIPTOR);
1783                    String volumeUuid = getPrimaryStorageUuid();
1784                    reply.writeNoException();
1785                    reply.writeString(volumeUuid);
1786                    return true;
1787                }
1788                case TRANSACTION_setPrimaryStorageUuid: {
1789                    data.enforceInterface(DESCRIPTOR);
1790                    String volumeUuid = data.readString();
1791                    IPackageMoveObserver listener = IPackageMoveObserver.Stub.asInterface(
1792                            data.readStrongBinder());
1793                    setPrimaryStorageUuid(volumeUuid, listener);
1794                    reply.writeNoException();
1795                    return true;
1796                }
1797            }
1798            return super.onTransact(code, data, reply, flags);
1799        }
1800    }
1801
1802    /*
1803     * Creates a secure container with the specified parameters. Returns an int
1804     * consistent with MountServiceResultCode
1805     */
1806    public int createSecureContainer(String id, int sizeMb, String fstype, String key,
1807            int ownerUid, boolean external) throws RemoteException;
1808
1809    /*
1810     * Destroy a secure container, and free up all resources associated with it.
1811     * NOTE: Ensure all references are released prior to deleting. Returns an
1812     * int consistent with MountServiceResultCode
1813     */
1814    public int destroySecureContainer(String id, boolean force) throws RemoteException;
1815
1816    /*
1817     * Finalize a container which has just been created and populated. After
1818     * finalization, the container is immutable. Returns an int consistent with
1819     * MountServiceResultCode
1820     */
1821    public int finalizeSecureContainer(String id) throws RemoteException;
1822
1823    /**
1824     * Call into MountService by PackageManager to notify that its done
1825     * processing the media status update request.
1826     */
1827    public void finishMediaUpdate() throws RemoteException;
1828
1829    /**
1830     * Format external storage given a mount point. Returns an int consistent
1831     * with MountServiceResultCode
1832     */
1833    public int formatVolume(String mountPoint) throws RemoteException;
1834
1835    /**
1836     * Gets the path to the mounted Opaque Binary Blob (OBB).
1837     */
1838    public String getMountedObbPath(String rawPath) throws RemoteException;
1839
1840    /**
1841     * Gets an Array of currently known secure container IDs
1842     */
1843    public String[] getSecureContainerList() throws RemoteException;
1844
1845    /*
1846     * Returns the filesystem path of a mounted secure container.
1847     */
1848    public String getSecureContainerPath(String id) throws RemoteException;
1849
1850    /**
1851     * Returns an array of pids with open files on the specified path.
1852     */
1853    public int[] getStorageUsers(String path) throws RemoteException;
1854
1855    /**
1856     * Gets the state of a volume via its mountpoint.
1857     */
1858    public String getVolumeState(String mountPoint) throws RemoteException;
1859
1860    /**
1861     * Checks whether the specified Opaque Binary Blob (OBB) is mounted
1862     * somewhere.
1863     */
1864    public boolean isObbMounted(String rawPath) throws RemoteException;
1865
1866    /*
1867     * Returns true if the specified container is mounted
1868     */
1869    public boolean isSecureContainerMounted(String id) throws RemoteException;
1870
1871    /**
1872     * Returns true if a USB mass storage host is connected
1873     */
1874    public boolean isUsbMassStorageConnected() throws RemoteException;
1875
1876    /**
1877     * Returns true if a USB mass storage host is enabled (media is shared)
1878     */
1879    public boolean isUsbMassStorageEnabled() throws RemoteException;
1880
1881    /**
1882     * Mounts an Opaque Binary Blob (OBB) with the specified decryption key and
1883     * only allows the calling process's UID access to the contents.
1884     * MountService will call back to the supplied IObbActionListener to inform
1885     * it of the terminal state of the call.
1886     */
1887    public void mountObb(String rawPath, String canonicalPath, String key,
1888            IObbActionListener token, int nonce) throws RemoteException;
1889
1890    /*
1891     * Mount a secure container with the specified key and owner UID. Returns an
1892     * int consistent with MountServiceResultCode
1893     */
1894    public int mountSecureContainer(String id, String key, int ownerUid, boolean readOnly)
1895            throws RemoteException;
1896
1897    /**
1898     * Mount external storage at given mount point. Returns an int consistent
1899     * with MountServiceResultCode
1900     */
1901    public int mountVolume(String mountPoint) throws RemoteException;
1902
1903    /**
1904     * Registers an IMountServiceListener for receiving async notifications.
1905     */
1906    public void registerListener(IMountServiceListener listener) throws RemoteException;
1907
1908    /*
1909     * Rename an unmounted secure container. Returns an int consistent with
1910     * MountServiceResultCode
1911     */
1912    public int renameSecureContainer(String oldId, String newId) throws RemoteException;
1913
1914    /**
1915     * Enables / disables USB mass storage. The caller should check actual
1916     * status of enabling/disabling USB mass storage via StorageEventListener.
1917     */
1918    public void setUsbMassStorageEnabled(boolean enable) throws RemoteException;
1919
1920    /**
1921     * Shuts down the MountService and gracefully unmounts all external media.
1922     * Invokes call back once the shutdown is complete.
1923     */
1924    public void shutdown(IMountShutdownObserver observer) throws RemoteException;
1925
1926    /**
1927     * Unmounts an Opaque Binary Blob (OBB). When the force flag is specified,
1928     * any program using it will be forcibly killed to unmount the image.
1929     * MountService will call back to the supplied IObbActionListener to inform
1930     * it of the terminal state of the call.
1931     */
1932    public void unmountObb(String rawPath, boolean force, IObbActionListener token, int nonce)
1933            throws RemoteException;
1934
1935    /*
1936     * Unount a secure container. Returns an int consistent with
1937     * MountServiceResultCode
1938     */
1939    public int unmountSecureContainer(String id, boolean force) throws RemoteException;
1940
1941    /**
1942     * Safely unmount external storage at given mount point. The unmount is an
1943     * asynchronous operation. Applications should register StorageEventListener
1944     * for storage related status changes.
1945     * @param mountPoint the mount point
1946     * @param force whether or not to forcefully unmount it (e.g. even if programs are using this
1947     *     data currently)
1948     * @param removeEncryption whether or not encryption mapping should be removed from the volume.
1949     *     This value implies {@code force}.
1950     */
1951    public void unmountVolume(String mountPoint, boolean force, boolean removeEncryption)
1952            throws RemoteException;
1953
1954    /**
1955     * Unregisters an IMountServiceListener
1956     */
1957    public void unregisterListener(IMountServiceListener listener) throws RemoteException;
1958
1959    /**
1960     * Returns whether or not the external storage is emulated.
1961     */
1962    public boolean isExternalStorageEmulated() throws RemoteException;
1963
1964    /** The volume is not encrypted. */
1965    static final int ENCRYPTION_STATE_NONE = 1;
1966    /** The volume has been encrypted succesfully. */
1967    static final int ENCRYPTION_STATE_OK = 0;
1968    /** The volume is in a bad state.*/
1969    static final int ENCRYPTION_STATE_ERROR_UNKNOWN = -1;
1970    /** Encryption is incomplete */
1971    static final int ENCRYPTION_STATE_ERROR_INCOMPLETE = -2;
1972    /** Encryption is incomplete and irrecoverable */
1973    static final int ENCRYPTION_STATE_ERROR_INCONSISTENT = -3;
1974    /** Underlying data is corrupt */
1975    static final int ENCRYPTION_STATE_ERROR_CORRUPT = -4;
1976
1977    /**
1978     * Determines the encryption state of the volume.
1979     * @return a numerical value. See {@code ENCRYPTION_STATE_*} for possible values.
1980     */
1981    public int getEncryptionState() throws RemoteException;
1982
1983    /**
1984     * Decrypts any encrypted volumes.
1985     */
1986    public int decryptStorage(String password) throws RemoteException;
1987
1988    /**
1989     * Encrypts storage.
1990     */
1991    public int encryptStorage(int type, String password) throws RemoteException;
1992
1993    /**
1994     * Changes the encryption password.
1995     */
1996    public int changeEncryptionPassword(int type, String password)
1997        throws RemoteException;
1998
1999    /**
2000     * Verify the encryption password against the stored volume.  This method
2001     * may only be called by the system process.
2002     */
2003    public int verifyEncryptionPassword(String password) throws RemoteException;
2004
2005    /**
2006     * Returns list of all mountable volumes.
2007     */
2008    public StorageVolume[] getVolumeList(int userId) throws RemoteException;
2009
2010    /**
2011     * Gets the path on the filesystem for the ASEC container itself.
2012     *
2013     * @param cid ASEC container ID
2014     * @return path to filesystem or {@code null} if it's not found
2015     * @throws RemoteException
2016     */
2017    public String getSecureContainerFilesystemPath(String cid) throws RemoteException;
2018
2019    /*
2020     * Fix permissions in a container which has just been created and populated.
2021     * Returns an int consistent with MountServiceResultCode
2022     */
2023    public int fixPermissionsSecureContainer(String id, int gid, String filename)
2024            throws RemoteException;
2025
2026    /**
2027     * Ensure that all directories along given path exist, creating parent
2028     * directories as needed. Validates that given path is absolute and that it
2029     * contains no relative "." or ".." paths or symlinks. Also ensures that
2030     * path belongs to a volume managed by vold, and that path is either
2031     * external storage data or OBB directory belonging to calling app.
2032     */
2033    public int mkdirs(String callingPkg, String path) throws RemoteException;
2034
2035    /**
2036     * Determines the type of the encryption password
2037     * @return PasswordType
2038     */
2039    public int getPasswordType() throws RemoteException;
2040
2041    /**
2042     * Get password from vold
2043     * @return password or empty string
2044     */
2045    public String getPassword() throws RemoteException;
2046
2047    /**
2048     * Securely clear password from vold
2049     */
2050    public void clearPassword() throws RemoteException;
2051
2052    /**
2053     * Set a field in the crypto header.
2054     * @param field field to set
2055     * @param contents contents to set in field
2056     */
2057    public void setField(String field, String contents) throws RemoteException;
2058
2059    /**
2060     * Gets a field from the crypto header.
2061     * @param field field to get
2062     * @return contents of field
2063     */
2064    public String getField(String field) throws RemoteException;
2065
2066    public int resizeSecureContainer(String id, int sizeMb, String key) throws RemoteException;
2067
2068    /**
2069     * Report the time of the last maintenance operation such as fstrim.
2070     * @return Timestamp of the last maintenance operation, in the
2071     *     System.currentTimeMillis() time base
2072     * @throws RemoteException
2073     */
2074    public long lastMaintenance() throws RemoteException;
2075
2076    /**
2077     * Kick off an immediate maintenance operation
2078     * @throws RemoteException
2079     */
2080    public void runMaintenance() throws RemoteException;
2081
2082    public void waitForAsecScan() throws RemoteException;
2083
2084    public DiskInfo[] getDisks() throws RemoteException;
2085    public VolumeInfo[] getVolumes(int flags) throws RemoteException;
2086    public VolumeRecord[] getVolumeRecords(int flags) throws RemoteException;
2087
2088    public void mount(String volId) throws RemoteException;
2089    public void unmount(String volId) throws RemoteException;
2090    public void format(String volId) throws RemoteException;
2091
2092    public void partitionPublic(String diskId) throws RemoteException;
2093    public void partitionPrivate(String diskId) throws RemoteException;
2094    public void partitionMixed(String diskId, int ratio) throws RemoteException;
2095
2096    public void setVolumeNickname(String fsUuid, String nickname) throws RemoteException;
2097    public void setVolumeUserFlags(String fsUuid, int flags, int mask) throws RemoteException;
2098    public void forgetVolume(String fsUuid) throws RemoteException;
2099    public void forgetAllVolumes() throws RemoteException;
2100
2101    public String getPrimaryStorageUuid() throws RemoteException;
2102    public void setPrimaryStorageUuid(String volumeUuid, IPackageMoveObserver callback)
2103            throws RemoteException;
2104}
2105