blob: 4bfd8e96c54b6142e45b9e1ff42298bf1a3b2ec2 [file] [log] [blame]
Jeff Sharkeydeb24052015-03-02 21:01:40 -08001/*
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_UTILS_H
18#define ANDROID_VOLD_UTILS_H
19
20#include <utils/Errors.h>
Jeff Sharkeyd2c96e72015-11-08 17:56:23 -080021#include <cutils/multiuser.h>
Jeff Sharkey95c87cc2015-04-01 11:54:32 -070022#include <selinux/selinux.h>
Jeff Sharkeydeb24052015-03-02 21:01:40 -080023
Jeff Sharkey9c484982015-03-31 10:35:33 -070024#include <vector>
Jeff Sharkeydeb24052015-03-02 21:01:40 -080025#include <string>
26
27// DISALLOW_COPY_AND_ASSIGN disallows the copy and operator= functions. It goes in the private:
28// declarations in a class.
29#if !defined(DISALLOW_COPY_AND_ASSIGN)
30#define DISALLOW_COPY_AND_ASSIGN(TypeName) \
31 TypeName(const TypeName&) = delete; \
32 void operator=(const TypeName&) = delete
33#endif
34
Daichi Hirono10d34882016-01-29 14:33:51 +090035struct DIR;
36
Jeff Sharkeydeb24052015-03-02 21:01:40 -080037namespace android {
38namespace vold {
39
Jeff Sharkey95c87cc2015-04-01 11:54:32 -070040/* SELinux contexts used depending on the block device type */
41extern security_context_t sBlkidContext;
42extern security_context_t sBlkidUntrustedContext;
43extern security_context_t sFsckContext;
44extern security_context_t sFsckUntrustedContext;
45
Jeff Sharkeydeb24052015-03-02 21:01:40 -080046status_t CreateDeviceNode(const std::string& path, dev_t dev);
47status_t DestroyDeviceNode(const std::string& path);
48
Jeff Sharkeyf0121c52015-04-06 14:08:45 -070049/* fs_prepare_dir wrapper that creates with SELinux context */
50status_t PrepareDir(const std::string& path, mode_t mode, uid_t uid, gid_t gid);
51
Jeff Sharkeydeb24052015-03-02 21:01:40 -080052/* Really unmounts the path, killing active processes along the way */
53status_t ForceUnmount(const std::string& path);
54
Jeff Sharkey89f74fb2015-10-21 12:16:12 -070055/* Kills any processes using given path */
56status_t KillProcessesUsingPath(const std::string& path);
57
Jeff Sharkey36801cc2015-03-13 16:09:20 -070058/* Creates bind mount from source to target */
59status_t BindMount(const std::string& source, const std::string& target);
60
Jeff Sharkey9c484982015-03-31 10:35:33 -070061/* Reads filesystem metadata from device at path */
62status_t ReadMetadata(const std::string& path, std::string& fsType,
63 std::string& fsUuid, std::string& fsLabel);
64
Jeff Sharkey95c87cc2015-04-01 11:54:32 -070065/* Reads filesystem metadata from untrusted device at path */
66status_t ReadMetadataUntrusted(const std::string& path, std::string& fsType,
67 std::string& fsUuid, std::string& fsLabel);
68
Jeff Sharkeyce6a9132015-04-08 21:07:21 -070069/* Returns either WEXITSTATUS() status, or a negative errno */
70status_t ForkExecvp(const std::vector<std::string>& args);
71status_t ForkExecvp(const std::vector<std::string>& args, security_context_t context);
72
73status_t ForkExecvp(const std::vector<std::string>& args,
74 std::vector<std::string>& output);
75status_t ForkExecvp(const std::vector<std::string>& args,
76 std::vector<std::string>& output, security_context_t context);
Jeff Sharkey9c484982015-03-31 10:35:33 -070077
Jeff Sharkey1d6fbcc2015-04-24 16:00:03 -070078pid_t ForkExecvpAsync(const std::vector<std::string>& args);
79
Jeff Sharkey9c484982015-03-31 10:35:33 -070080status_t ReadRandomBytes(size_t bytes, std::string& out);
81
Jeff Sharkey95c87cc2015-04-01 11:54:32 -070082/* Converts hex string to raw bytes, ignoring [ :-] */
Jeff Sharkey9c484982015-03-31 10:35:33 -070083status_t HexToStr(const std::string& hex, std::string& str);
Jeff Sharkey95c87cc2015-04-01 11:54:32 -070084/* Converts raw bytes to hex string */
Jeff Sharkey9c484982015-03-31 10:35:33 -070085status_t StrToHex(const std::string& str, std::string& hex);
Jeff Sharkeybc40cc82015-06-18 14:25:08 -070086/* Normalize given hex string into consistent format */
87status_t NormalizeHex(const std::string& in, std::string& out);
Jeff Sharkey9c484982015-03-31 10:35:33 -070088
Jeff Sharkey1d6fbcc2015-04-24 16:00:03 -070089uint64_t GetFreeBytes(const std::string& path);
90uint64_t GetTreeBytes(const std::string& path);
91
Jeff Sharkeyd0640f62015-05-21 22:35:42 -070092bool IsFilesystemSupported(const std::string& fsType);
93
94/* Wipes contents of block device at given path */
95status_t WipeBlockDevice(const std::string& path);
96
Jeff Sharkeybc40cc82015-06-18 14:25:08 -070097std::string BuildKeyPath(const std::string& partGuid);
98
Jeff Sharkeybe70c9a2016-04-14 20:45:16 -060099std::string BuildDataSystemLegacyPath(userid_t userid);
Jeff Sharkeyd2c96e72015-11-08 17:56:23 -0800100std::string BuildDataSystemCePath(userid_t userid);
Jeff Sharkey47695b22016-02-01 17:02:29 -0700101std::string BuildDataSystemDePath(userid_t userid);
Jeff Sharkeybe70c9a2016-04-14 20:45:16 -0600102std::string BuildDataMiscLegacyPath(userid_t userid);
Jeff Sharkey47695b22016-02-01 17:02:29 -0700103std::string BuildDataMiscCePath(userid_t userid);
104std::string BuildDataMiscDePath(userid_t userid);
Calin Juravle79f55a42016-02-17 20:14:46 +0000105std::string BuildDataProfilesDePath(userid_t userid);
Calin Juravle493f5aa2016-02-24 16:27:19 +0000106std::string BuildDataProfilesForeignDexDePath(userid_t userid);
Jeff Sharkeyd2c96e72015-11-08 17:56:23 -0800107
108std::string BuildDataPath(const char* volumeUuid);
Jeff Sharkeybe70c9a2016-04-14 20:45:16 -0600109std::string BuildDataMediaCePath(const char* volumeUuid, userid_t userid);
110std::string BuildDataUserCePath(const char* volumeUuid, userid_t userid);
Jeff Sharkeyd2c96e72015-11-08 17:56:23 -0800111std::string BuildDataUserDePath(const char* volumeUuid, userid_t userid);
112
Jeff Sharkey66270a22015-06-24 11:49:24 -0700113dev_t GetDevice(const std::string& path);
114
Jeff Sharkeyc86ab6f2015-06-26 14:02:09 -0700115std::string DefaultFstabPath();
116
Jeff Sharkeyd24aeda2016-07-15 16:20:22 -0600117status_t RestoreconRecursive(const std::string& path);
118
Daichi Hirono10d34882016-01-29 14:33:51 +0900119status_t SaneReadLinkAt(int dirfd, const char* path, char* buf, size_t bufsiz);
120
121class ScopedFd {
122 const int fd_;
123public:
124 ScopedFd(int fd);
125 ~ScopedFd();
126 int get() const { return fd_; }
127
128 DISALLOW_COPY_AND_ASSIGN(ScopedFd);
129};
130
131class ScopedDir {
132 DIR* const dir_;
133public:
134 ScopedDir(DIR* dir);
135 ~ScopedDir();
136 DIR* get() const { return dir_; }
137
138 DISALLOW_COPY_AND_ASSIGN(ScopedDir);
139};
140
Yu Ning942d4e82016-01-08 17:36:47 +0800141/* Checks if Android is running in QEMU */
142bool IsRunningInEmulator();
143
Jeff Sharkeydeb24052015-03-02 21:01:40 -0800144} // namespace vold
145} // namespace android
146
147#endif