VolumeBase.h revision ce6a913aeac7db94a41362c63bab74092767bb3e
1/* 2 * Copyright (C) 2008 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 17#ifndef ANDROID_VOLD_VOLUME_BASE_H 18#define ANDROID_VOLD_VOLUME_BASE_H 19 20#include "Utils.h" 21 22#include <cutils/multiuser.h> 23#include <utils/Errors.h> 24 25#include <sys/types.h> 26#include <list> 27#include <string> 28 29namespace android { 30namespace vold { 31 32/* 33 * Representation of a mounted volume ready for presentation. 34 * 35 * Various subclasses handle the different mounting prerequisites, such as 36 * encryption details, etc. Volumes can also be "stacked" above other 37 * volumes to help communicate dependencies. For example, an ASEC volume 38 * can be stacked on a vfat volume. 39 * 40 * Mounted volumes can be asked to manage bind mounts to present themselves 41 * to specific users on the device. 42 * 43 * When an unmount is requested, the volume recursively unmounts any stacked 44 * volumes and removes any bind mounts before finally unmounting itself. 45 */ 46class VolumeBase { 47public: 48 virtual ~VolumeBase(); 49 50 enum class Type { 51 kPublic = 0, 52 kPrivate, 53 kEmulated, 54 kAsec, 55 kObb, 56 }; 57 58 enum Flags { 59 /* Flag that volume is primary external storage */ 60 kPrimary = 1 << 0, 61 /* Flag that volume is visible to normal apps */ 62 kVisible = 1 << 1, 63 }; 64 65 enum class State { 66 /* Next states: mounting, formatting */ 67 kUnmounted = 0, 68 /* Next states: mounted, unmountable */ 69 kMounting, 70 /* Next states: unmounting */ 71 kMounted, 72 /* Next states: unmounted */ 73 kFormatting, 74 /* Next states: unmounted */ 75 kUnmounting, 76 /* Next states: mounting, formatting */ 77 kUnmountable, 78 }; 79 80 const std::string& getId() { return mId; } 81 Type getType() { return mType; } 82 int getFlags() { return mFlags; } 83 userid_t getUser() { return mUser; } 84 State getState() { return mState; } 85 const std::string& getPath() { return mPath; } 86 87 status_t setFlags(int flags); 88 status_t setUser(userid_t user); 89 status_t setSilent(bool silent); 90 91 void addVolume(const std::shared_ptr<VolumeBase>& volume); 92 void removeVolume(const std::shared_ptr<VolumeBase>& volume); 93 94 std::shared_ptr<VolumeBase> findVolume(const std::string& id); 95 96 status_t create(); 97 status_t destroy(); 98 status_t mount(); 99 status_t unmount(); 100 status_t format(); 101 102protected: 103 explicit VolumeBase(Type type); 104 105 virtual status_t doCreate(); 106 virtual status_t doDestroy(); 107 virtual status_t doMount() = 0; 108 virtual status_t doUnmount() = 0; 109 virtual status_t doFormat(); 110 111 status_t setId(const std::string& id); 112 status_t setPath(const std::string& path); 113 114 void notifyEvent(int msg); 115 void notifyEvent(int msg, const std::string& value); 116 117private: 118 /* ID that uniquely references volume while alive */ 119 std::string mId; 120 /* Volume type */ 121 Type mType; 122 /* Flags applicable to volume */ 123 int mFlags; 124 /* User that owns this volume, otherwise -1 */ 125 userid_t mUser; 126 /* Flag indicating object is created */ 127 bool mCreated; 128 /* Current state of volume */ 129 State mState; 130 /* Path to mounted volume */ 131 std::string mPath; 132 /* Flag indicating that volume should emit no events */ 133 bool mSilent; 134 135 /* Volumes stacked on top of this volume */ 136 std::list<std::shared_ptr<VolumeBase>> mVolumes; 137 138 void setState(State state); 139 140 DISALLOW_COPY_AND_ASSIGN(VolumeBase); 141}; 142 143} // namespace vold 144} // namespace android 145 146#endif 147