• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 #define TRACE_TAG ADB
18 
19 #include "adb_utils.h"
20 
21 #include <libgen.h>
22 #include <stdlib.h>
23 #include <sys/stat.h>
24 #include <sys/types.h>
25 #include <unistd.h>
26 
27 #include <algorithm>
28 
29 #include <android-base/logging.h>
30 #include <android-base/stringprintf.h>
31 #include <android-base/strings.h>
32 
33 #include "adb.h"
34 #include "adb_trace.h"
35 #include "sysdeps.h"
36 
37 #ifdef _WIN32
38 #  ifndef WIN32_LEAN_AND_MEAN
39 #    define WIN32_LEAN_AND_MEAN
40 #  endif
41 #  include "windows.h"
42 #  include "shlobj.h"
43 #endif
44 
45 ADB_MUTEX_DEFINE(basename_lock);
46 ADB_MUTEX_DEFINE(dirname_lock);
47 
48 #if defined(_WIN32)
49 constexpr char kNullFileName[] = "NUL";
50 #else
51 constexpr char kNullFileName[] = "/dev/null";
52 #endif
53 
close_stdin()54 void close_stdin() {
55     int fd = unix_open(kNullFileName, O_RDONLY);
56     if (fd == -1) {
57         fatal_errno("failed to open %s", kNullFileName);
58     }
59 
60     if (TEMP_FAILURE_RETRY(dup2(fd, STDIN_FILENO)) == -1) {
61         fatal_errno("failed to redirect stdin to %s", kNullFileName);
62     }
63     unix_close(fd);
64 }
65 
getcwd(std::string * s)66 bool getcwd(std::string* s) {
67   char* cwd = getcwd(nullptr, 0);
68   if (cwd != nullptr) *s = cwd;
69   free(cwd);
70   return (cwd != nullptr);
71 }
72 
directory_exists(const std::string & path)73 bool directory_exists(const std::string& path) {
74   struct stat sb;
75   return lstat(path.c_str(), &sb) != -1 && S_ISDIR(sb.st_mode);
76 }
77 
escape_arg(const std::string & s)78 std::string escape_arg(const std::string& s) {
79   std::string result = s;
80 
81   // Escape any ' in the string (before we single-quote the whole thing).
82   // The correct way to do this for the shell is to replace ' with '\'' --- that is,
83   // close the existing single-quoted string, escape a single single-quote, and start
84   // a new single-quoted string. Like the C preprocessor, the shell will concatenate
85   // these pieces into one string.
86   for (size_t i = 0; i < s.size(); ++i) {
87     if (s[i] == '\'') {
88       result.insert(i, "'\\'");
89       i += 2;
90     }
91   }
92 
93   // Prefix and suffix the whole string with '.
94   result.insert(result.begin(), '\'');
95   result.push_back('\'');
96   return result;
97 }
98 
adb_basename(const std::string & path)99 std::string adb_basename(const std::string& path) {
100   // Copy path because basename may modify the string passed in.
101   std::string result(path);
102 
103   // Use lock because basename() may write to a process global and return a
104   // pointer to that. Note that this locking strategy only works if all other
105   // callers to dirname in the process also grab this same lock.
106   adb_mutex_lock(&basename_lock);
107 
108   // Note that if std::string uses copy-on-write strings, &str[0] will cause
109   // the copy to be made, so there is no chance of us accidentally writing to
110   // the storage for 'path'.
111   char* name = basename(&result[0]);
112 
113   // In case dirname returned a pointer to a process global, copy that string
114   // before leaving the lock.
115   result.assign(name);
116 
117   adb_mutex_unlock(&basename_lock);
118 
119   return result;
120 }
121 
adb_dirname(const std::string & path)122 std::string adb_dirname(const std::string& path) {
123   // Copy path because dirname may modify the string passed in.
124   std::string result(path);
125 
126   // Use lock because dirname() may write to a process global and return a
127   // pointer to that. Note that this locking strategy only works if all other
128   // callers to dirname in the process also grab this same lock.
129   adb_mutex_lock(&dirname_lock);
130 
131   // Note that if std::string uses copy-on-write strings, &str[0] will cause
132   // the copy to be made, so there is no chance of us accidentally writing to
133   // the storage for 'path'.
134   char* parent = dirname(&result[0]);
135 
136   // In case dirname returned a pointer to a process global, copy that string
137   // before leaving the lock.
138   result.assign(parent);
139 
140   adb_mutex_unlock(&dirname_lock);
141 
142   return result;
143 }
144 
145 // Given a relative or absolute filepath, create the directory hierarchy
146 // as needed. Returns true if the hierarchy is/was setup.
mkdirs(const std::string & path)147 bool mkdirs(const std::string& path) {
148   // TODO: all the callers do unlink && mkdirs && adb_creat ---
149   // that's probably the operation we should expose.
150 
151   // Implementation Notes:
152   //
153   // Pros:
154   // - Uses dirname, so does not need to deal with OS_PATH_SEPARATOR.
155   // - On Windows, uses mingw dirname which accepts '/' and '\\', drive letters
156   //   (C:\foo), UNC paths (\\server\share\dir\dir\file), and Unicode (when
157   //   combined with our adb_mkdir() which takes UTF-8).
158   // - Is optimistic wrt thinking that a deep directory hierarchy will exist.
159   //   So it does as few stat()s as possible before doing mkdir()s.
160   // Cons:
161   // - Recursive, so it uses stack space relative to number of directory
162   //   components.
163 
164   // If path points to a symlink to a directory, that's fine.
165   struct stat sb;
166   if (stat(path.c_str(), &sb) != -1 && S_ISDIR(sb.st_mode)) {
167     return true;
168   }
169 
170   const std::string parent(adb_dirname(path));
171 
172   // If dirname returned the same path as what we passed in, don't go recursive.
173   // This can happen on Windows when walking up the directory hierarchy and not
174   // finding anything that already exists (unlike POSIX that will eventually
175   // find . or /).
176   if (parent == path) {
177     errno = ENOENT;
178     return false;
179   }
180 
181   // Recursively make parent directories of 'path'.
182   if (!mkdirs(parent)) {
183     return false;
184   }
185 
186   // Now that the parent directory hierarchy of 'path' has been ensured,
187   // create path itself.
188   if (adb_mkdir(path, 0775) == -1) {
189     const int saved_errno = errno;
190     // If someone else created the directory, that is ok.
191     if (directory_exists(path)) {
192       return true;
193     }
194     // There might be a pre-existing file at 'path', or there might have been some other error.
195     errno = saved_errno;
196     return false;
197   }
198 
199   return true;
200 }
201 
dump_hex(const void * data,size_t byte_count)202 std::string dump_hex(const void* data, size_t byte_count) {
203     byte_count = std::min(byte_count, size_t(16));
204 
205     const uint8_t* p = reinterpret_cast<const uint8_t*>(data);
206 
207     std::string line;
208     for (size_t i = 0; i < byte_count; ++i) {
209         android::base::StringAppendF(&line, "%02x", p[i]);
210     }
211     line.push_back(' ');
212 
213     for (size_t i = 0; i < byte_count; ++i) {
214         int ch = p[i];
215         line.push_back(isprint(ch) ? ch : '.');
216     }
217 
218     return line;
219 }
220 
perror_str(const char * msg)221 std::string perror_str(const char* msg) {
222     return android::base::StringPrintf("%s: %s", msg, strerror(errno));
223 }
224 
225 #if !defined(_WIN32)
226 // Windows version provided in sysdeps_win32.cpp
set_file_block_mode(int fd,bool block)227 bool set_file_block_mode(int fd, bool block) {
228     int flags = fcntl(fd, F_GETFL, 0);
229     if (flags == -1) {
230         PLOG(ERROR) << "failed to fcntl(F_GETFL) for fd " << fd;
231         return false;
232     }
233     flags = block ? (flags & ~O_NONBLOCK) : (flags | O_NONBLOCK);
234     if (fcntl(fd, F_SETFL, flags) != 0) {
235         PLOG(ERROR) << "failed to fcntl(F_SETFL) for fd " << fd << ", flags " << flags;
236         return false;
237     }
238     return true;
239 }
240 #endif
241 
adb_get_homedir_path(bool check_env_first)242 std::string adb_get_homedir_path(bool check_env_first) {
243 #ifdef _WIN32
244     if (check_env_first) {
245         if (const char* const home = getenv("ANDROID_SDK_HOME")) {
246             return home;
247         }
248     }
249 
250     WCHAR path[MAX_PATH];
251     const HRESULT hr = SHGetFolderPathW(NULL, CSIDL_PROFILE, NULL, 0, path);
252     if (FAILED(hr)) {
253         D("SHGetFolderPathW failed: %s", android::base::SystemErrorCodeToString(hr).c_str());
254         return {};
255     }
256     std::string home_str;
257     if (!android::base::WideToUTF8(path, &home_str)) {
258         return {};
259     }
260     return home_str;
261 #else
262     if (const char* const home = getenv("HOME")) {
263         return home;
264     }
265     return {};
266 #endif
267 }
268 
269