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