Disk.h

   1 /*
   2  * Copyright (C) 2015 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_DISK_H
  18 #define ANDROID_VOLD_DISK_H
  19
  20 #include "Utils.h"
  21 #include "VolumeBase.h"
  22
  23 #include <utils/Errors.h>
  24
  25 #include <vector>
  26
  27 namespace android {
  28 namespace vold {
  29
  30 class VolumeBase;
  31
  32 /*
  33  * Representation of detected physical media.
  34  *
  35  * Knows how to create volumes based on the partition tables found, and also
  36  * how to repartition itself.
  37  */
  38 class Disk {
  39 public:
  40     Disk(const std::string& eventPath, dev_t device, const std::string& nickname, int flags);
  41     virtual ~Disk();
  42
  43     enum Flags {
  44         /* Flag that disk is adoptable */
  45         kAdoptable = 1 << 0,
  46         /* Flag that disk is considered primary when the user hasn't
  47          * explicitly picked a primary storage location */
  48         kDefaultPrimary = 1 << 1,
  49         /* Flag that disk is SD card */
  50         kSd = 1 << 2,
  51         /* Flag that disk is USB disk */
  52         kUsb = 1 << 3,
  53         /* Flag that disk is EMMC internal */
  54         kEmmc = 1 << 4,
  55         /* Flag that disk is non-removable */
  56         kNonRemovable = 1 << 5,
  57     };
  58
  59     const std::string& getId() { return mId; }
  60     const std::string& getEventPath() { return mEventPath; }
  61     const std::string& getSysPath() { return mSysPath; }
  62     const std::string& getDevPath() { return mDevPath; }
  63     dev_t getDevice() { return mDevice; }
  64     uint64_t getSize() { return mSize; }
  65     const std::string& getLabel() { return mLabel; }
  66     int getFlags() { return mFlags; }
  67
  68     std::shared_ptr<VolumeBase> findVolume(const std::string& id);
  69
  70     void listVolumes(VolumeBase::Type type, std::list<std::string>& list);
  71
  72     virtual status_t create();
  73     virtual status_t destroy();
  74
  75     virtual status_t readMetadata();
  76     virtual status_t readPartitions();
  77
  78     status_t unmountAll();
  79
  80     virtual status_t partitionPublic();
  81     virtual status_t partitionPrivate();
  82     virtual status_t partitionMixed(int8_t ratio);
  83
  84     void notifyEvent(int msg);
  85     void notifyEvent(int msg, const std::string& value);
  86
  87 protected:
  88     /* ID that uniquely references this disk */
  89     std::string mId;
  90     /* Original event path */
  91     std::string mEventPath;
  92     /* Device path under sysfs */
  93     std::string mSysPath;
  94     /* Device path under dev */
  95     std::string mDevPath;
  96     /* Kernel device representing disk */
  97     dev_t mDevice;
  98     /* Size of disk, in bytes */
  99     uint64_t mSize;
 100     /* User-visible label, such as manufacturer */
 101     std::string mLabel;
 102     /* Current partitions on disk */
 103     std::vector<std::shared_ptr<VolumeBase>> mVolumes;
 104     /* Nickname for this disk */
 105     std::string mNickname;
 106     /* Flags applicable to this disk */
 107     int mFlags;
 108     /* Flag indicating object is created */
 109     bool mCreated;
 110     /* Flag that we just partitioned and should format all volumes */
 111     bool mJustPartitioned;
 112     /* Flag that we need to skip first disk change events after partitioning*/
 113     bool mSkipChange;
 114
 115     void createPublicVolume(dev_t device,
 116                     const std::string& fstype = "",
 117                     const std::string& mntopts = "");
 118     void createPrivateVolume(dev_t device, const std::string& partGuid);
 119
 120     void destroyAllVolumes();
 121
 122     int getMaxMinors();
 123
 124     DISALLOW_COPY_AND_ASSIGN(Disk);
 125 };
 126
 127 }  // namespace vold
 128 }  // namespace android
 129
 130 #endif