Home | History | Annotate | Download | only in common
      1 //
      2 // Copyright (C) 2012 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 #include "update_engine/common/test_utils.h"
     18 
     19 #include <dirent.h>
     20 #include <errno.h>
     21 #include <fcntl.h>
     22 #include <linux/loop.h>
     23 #include <linux/major.h>
     24 #include <stdio.h>
     25 #include <stdlib.h>
     26 #include <sys/ioctl.h>
     27 #include <sys/stat.h>
     28 #include <sys/types.h>
     29 #include <sys/xattr.h>
     30 #include <unistd.h>
     31 
     32 #include <set>
     33 #include <string>
     34 #include <vector>
     35 
     36 #include <base/files/file_util.h>
     37 #include <base/format_macros.h>
     38 #include <base/logging.h>
     39 #include <base/strings/string_util.h>
     40 #include <base/strings/stringprintf.h>
     41 
     42 #include "update_engine/common/error_code_utils.h"
     43 #include "update_engine/common/utils.h"
     44 #include "update_engine/payload_consumer/file_writer.h"
     45 
     46 using base::StringPrintf;
     47 using std::set;
     48 using std::string;
     49 using std::vector;
     50 
     51 namespace chromeos_update_engine {
     52 
     53 void PrintTo(const Extent& extent, ::std::ostream* os) {
     54   *os << "(" << extent.start_block() << ", " << extent.num_blocks() << ")";
     55 }
     56 
     57 void PrintTo(const ErrorCode& error_code, ::std::ostream* os) {
     58   *os << utils::ErrorCodeToString(error_code);
     59 }
     60 
     61 namespace test_utils {
     62 
     63 const uint8_t kRandomString[] = {
     64   0xf2, 0xb7, 0x55, 0x92, 0xea, 0xa6, 0xc9, 0x57,
     65   0xe0, 0xf8, 0xeb, 0x34, 0x93, 0xd9, 0xc4, 0x8f,
     66   0xcb, 0x20, 0xfa, 0x37, 0x4b, 0x40, 0xcf, 0xdc,
     67   0xa5, 0x08, 0x70, 0x89, 0x79, 0x35, 0xe2, 0x3d,
     68   0x56, 0xa4, 0x75, 0x73, 0xa3, 0x6d, 0xd1, 0xd5,
     69   0x26, 0xbb, 0x9c, 0x60, 0xbd, 0x2f, 0x5a, 0xfa,
     70   0xb7, 0xd4, 0x3a, 0x50, 0xa7, 0x6b, 0x3e, 0xfd,
     71   0x61, 0x2b, 0x3a, 0x31, 0x30, 0x13, 0x33, 0x53,
     72   0xdb, 0xd0, 0x32, 0x71, 0x5c, 0x39, 0xed, 0xda,
     73   0xb4, 0x84, 0xca, 0xbc, 0xbd, 0x78, 0x1c, 0x0c,
     74   0xd8, 0x0b, 0x41, 0xe8, 0xe1, 0xe0, 0x41, 0xad,
     75   0x03, 0x12, 0xd3, 0x3d, 0xb8, 0x75, 0x9b, 0xe6,
     76   0xd9, 0x01, 0xd0, 0x87, 0xf4, 0x36, 0xfa, 0xa7,
     77   0x0a, 0xfa, 0xc5, 0x87, 0x65, 0xab, 0x9a, 0x7b,
     78   0xeb, 0x58, 0x23, 0xf0, 0xa8, 0x0a, 0xf2, 0x33,
     79   0x3a, 0xe2, 0xe3, 0x35, 0x74, 0x95, 0xdd, 0x3c,
     80   0x59, 0x5a, 0xd9, 0x52, 0x3a, 0x3c, 0xac, 0xe5,
     81   0x15, 0x87, 0x6d, 0x82, 0xbc, 0xf8, 0x7d, 0xbe,
     82   0xca, 0xd3, 0x2c, 0xd6, 0xec, 0x38, 0xeb, 0xe4,
     83   0x53, 0xb0, 0x4c, 0x3f, 0x39, 0x29, 0xf7, 0xa4,
     84   0x73, 0xa8, 0xcb, 0x32, 0x50, 0x05, 0x8c, 0x1c,
     85   0x1c, 0xca, 0xc9, 0x76, 0x0b, 0x8f, 0x6b, 0x57,
     86   0x1f, 0x24, 0x2b, 0xba, 0x82, 0xba, 0xed, 0x58,
     87   0xd8, 0xbf, 0xec, 0x06, 0x64, 0x52, 0x6a, 0x3f,
     88   0xe4, 0xad, 0xce, 0x84, 0xb4, 0x27, 0x55, 0x14,
     89   0xe3, 0x75, 0x59, 0x73, 0x71, 0x51, 0xea, 0xe8,
     90   0xcc, 0xda, 0x4f, 0x09, 0xaf, 0xa4, 0xbc, 0x0e,
     91   0xa6, 0x1f, 0xe2, 0x3a, 0xf8, 0x96, 0x7d, 0x30,
     92   0x23, 0xc5, 0x12, 0xb5, 0xd8, 0x73, 0x6b, 0x71,
     93   0xab, 0xf1, 0xd7, 0x43, 0x58, 0xa7, 0xc9, 0xf0,
     94   0xe4, 0x85, 0x1c, 0xd6, 0x92, 0x50, 0x2c, 0x98,
     95   0x36, 0xfe, 0x87, 0xaf, 0x43, 0x8f, 0x8f, 0xf5,
     96   0x88, 0x48, 0x18, 0x42, 0xcf, 0x42, 0xc1, 0xa8,
     97   0xe8, 0x05, 0x08, 0xa1, 0x45, 0x70, 0x5b, 0x8c,
     98   0x39, 0x28, 0xab, 0xe9, 0x6b, 0x51, 0xd2, 0xcb,
     99   0x30, 0x04, 0xea, 0x7d, 0x2f, 0x6e, 0x6c, 0x3b,
    100   0x5f, 0x82, 0xd9, 0x5b, 0x89, 0x37, 0x65, 0x65,
    101   0xbe, 0x9f, 0xa3, 0x5d,
    102 };
    103 
    104 string Readlink(const string& path) {
    105   vector<char> buf(PATH_MAX + 1);
    106   ssize_t r = readlink(path.c_str(), buf.data(), buf.size());
    107   if (r < 0)
    108     return "";
    109   CHECK_LT(r, static_cast<ssize_t>(buf.size()));
    110   return string(buf.begin(), buf.begin() + r);
    111 }
    112 
    113 bool IsXAttrSupported(const base::FilePath& dir_path) {
    114   char *path = strdup(dir_path.Append("xattr_test_XXXXXX").value().c_str());
    115 
    116   int fd = mkstemp(path);
    117   if (fd == -1) {
    118     PLOG(ERROR) << "Error creating temporary file in " << dir_path.value();
    119     free(path);
    120     return false;
    121   }
    122 
    123   if (unlink(path) != 0) {
    124     PLOG(ERROR) << "Error unlinking temporary file " << path;
    125     close(fd);
    126     free(path);
    127     return false;
    128   }
    129 
    130   int xattr_res = fsetxattr(fd, "user.xattr-test", "value", strlen("value"), 0);
    131   if (xattr_res != 0) {
    132     if (errno == ENOTSUP) {
    133       // Leave it to call-sites to warn about non-support.
    134     } else {
    135       PLOG(ERROR) << "Error setting xattr on " << path;
    136     }
    137   }
    138   close(fd);
    139   free(path);
    140   return xattr_res == 0;
    141 }
    142 
    143 bool WriteFileVector(const string& path, const brillo::Blob& data) {
    144   return utils::WriteFile(path.c_str(), data.data(), data.size());
    145 }
    146 
    147 bool WriteFileString(const string& path, const string& data) {
    148   return utils::WriteFile(path.c_str(), data.data(), data.size());
    149 }
    150 
    151 bool BindToUnusedLoopDevice(const string& filename,
    152                             bool writable,
    153                             string* out_lo_dev_name) {
    154   CHECK(out_lo_dev_name);
    155   // Get the next available loop-device.
    156   int control_fd =
    157       HANDLE_EINTR(open("/dev/loop-control", O_RDWR | O_LARGEFILE));
    158   TEST_AND_RETURN_FALSE_ERRNO(control_fd >= 0);
    159   int loop_number = ioctl(control_fd, LOOP_CTL_GET_FREE);
    160   IGNORE_EINTR(close(control_fd));
    161   *out_lo_dev_name = StringPrintf("/dev/loop%d", loop_number);
    162 
    163   // Double check that the loop exists and is free.
    164   int loop_device_fd =
    165       HANDLE_EINTR(open(out_lo_dev_name->c_str(), O_RDWR | O_LARGEFILE));
    166   if (loop_device_fd == -1 && errno == ENOENT) {
    167     // Workaround the case when the loop device doesn't exist.
    168     TEST_AND_RETURN_FALSE_ERRNO(mknod(out_lo_dev_name->c_str(),
    169                                       S_IFBLK | 0660,
    170                                       makedev(LOOP_MAJOR, loop_number)) == 0);
    171     loop_device_fd =
    172         HANDLE_EINTR(open(out_lo_dev_name->c_str(), O_RDWR | O_LARGEFILE));
    173   }
    174   TEST_AND_RETURN_FALSE_ERRNO(loop_device_fd != -1);
    175   ScopedFdCloser loop_device_fd_closer(&loop_device_fd);
    176 
    177   struct loop_info64 device_info;
    178   if (ioctl(loop_device_fd, LOOP_GET_STATUS64, &device_info) != -1 ||
    179       errno != ENXIO) {
    180     PLOG(ERROR) << "Loop device " << out_lo_dev_name->c_str()
    181                 << " already in use";
    182     return false;
    183   }
    184 
    185   // Open our data file and assign it to the loop device.
    186   int data_fd = open(filename.c_str(),
    187                      (writable ? O_RDWR : O_RDONLY) | O_LARGEFILE | O_CLOEXEC);
    188   TEST_AND_RETURN_FALSE_ERRNO(data_fd >= 0);
    189   ScopedFdCloser data_fd_closer(&data_fd);
    190   TEST_AND_RETURN_FALSE_ERRNO(ioctl(loop_device_fd, LOOP_SET_FD, data_fd) == 0);
    191 
    192   memset(&device_info, 0, sizeof(device_info));
    193   device_info.lo_offset = 0;
    194   device_info.lo_sizelimit = 0;  // 0 means whole file.
    195   device_info.lo_flags = (writable ? 0 : LO_FLAGS_READ_ONLY);
    196   device_info.lo_number = loop_number;
    197   strncpy(reinterpret_cast<char*>(device_info.lo_file_name),
    198           base::FilePath(filename).BaseName().value().c_str(),
    199           LO_NAME_SIZE - 1);
    200   device_info.lo_file_name[LO_NAME_SIZE - 1] = '\0';
    201   TEST_AND_RETURN_FALSE_ERRNO(
    202       ioctl(loop_device_fd, LOOP_SET_STATUS64, &device_info) == 0);
    203   return true;
    204 }
    205 
    206 bool UnbindLoopDevice(const string& lo_dev_name) {
    207   int loop_device_fd =
    208       HANDLE_EINTR(open(lo_dev_name.c_str(), O_RDWR | O_LARGEFILE));
    209   if (loop_device_fd == -1 && errno == ENOENT)
    210     return true;
    211   TEST_AND_RETURN_FALSE_ERRNO(loop_device_fd != -1);
    212   ScopedFdCloser loop_device_fd_closer(&loop_device_fd);
    213 
    214   struct loop_info64 device_info;
    215   // Check if the device is bound before trying to unbind it.
    216   int get_stat_err = ioctl(loop_device_fd, LOOP_GET_STATUS64, &device_info);
    217   if (get_stat_err == -1 && errno == ENXIO)
    218     return true;
    219 
    220   TEST_AND_RETURN_FALSE_ERRNO(ioctl(loop_device_fd, LOOP_CLR_FD) == 0);
    221   return true;
    222 }
    223 
    224 bool ExpectVectorsEq(const brillo::Blob& expected,
    225                      const brillo::Blob& actual) {
    226   EXPECT_EQ(expected.size(), actual.size());
    227   if (expected.size() != actual.size())
    228     return false;
    229   bool is_all_eq = true;
    230   for (unsigned int i = 0; i < expected.size(); i++) {
    231     EXPECT_EQ(expected[i], actual[i]) << "offset: " << i;
    232     is_all_eq = is_all_eq && (expected[i] == actual[i]);
    233   }
    234   return is_all_eq;
    235 }
    236 
    237 void FillWithData(brillo::Blob* buffer) {
    238   size_t input_counter = 0;
    239   for (uint8_t& b : *buffer) {
    240     b = kRandomString[input_counter];
    241     input_counter++;
    242     input_counter %= sizeof(kRandomString);
    243   }
    244 }
    245 
    246 ScopedLoopMounter::ScopedLoopMounter(const string& file_path,
    247                                      string* mnt_path,
    248                                      unsigned long flags) {  // NOLINT - long
    249   EXPECT_TRUE(temp_dir_.CreateUniqueTempDir());
    250   *mnt_path = temp_dir_.path().value();
    251 
    252   string loop_dev;
    253   loop_binder_.reset(
    254       new ScopedLoopbackDeviceBinder(file_path, true, &loop_dev));
    255 
    256   EXPECT_TRUE(utils::MountFilesystem(loop_dev, *mnt_path, flags, "", ""));
    257   unmounter_.reset(new ScopedFilesystemUnmounter(*mnt_path));
    258 }
    259 
    260 base::FilePath GetBuildArtifactsPath() {
    261   base::FilePath exe_path;
    262   base::ReadSymbolicLink(base::FilePath("/proc/self/exe"), &exe_path);
    263   return exe_path.DirName();
    264 }
    265 
    266 string GetBuildArtifactsPath(const string& relative_path) {
    267   return GetBuildArtifactsPath().Append(relative_path).value();
    268 }
    269 
    270 }  // namespace test_utils
    271 }  // namespace chromeos_update_engine
    272