tests/sys/fs/fusefs/utils.cc

   1 /*-
   2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
   3  *
   4  * Copyright (c) 2019 The FreeBSD Foundation
   5  *
   6  * This software was developed by BFF Storage Systems, LLC under sponsorship
   7  * from the FreeBSD Foundation.
   8  *
   9  * Redistribution and use in source and binary forms, with or without
  10  * modification, are permitted provided that the following conditions
  11  * are met:
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  * 2. Redistributions in binary form must reproduce the above copyright
  15  *    notice, this list of conditions and the following disclaimer in the
  16  *    documentation and/or other materials provided with the distribution.
  17  *
  18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28  * SUCH DAMAGE.
  29  */
  30
  31 extern "C" {
  32 #include <sys/param.h>
  33 #include <sys/mman.h>
  34 #include <sys/module.h>
  35 #include <sys/sysctl.h>
  36 #include <sys/wait.h>
  37
  38 #include <pwd.h>
  39 #include <semaphore.h>
  40 #include <unistd.h>
  41 }
  42
  43 #include <gtest/gtest.h>
  44
  45 #include "mockfs.hh"
  46 #include "utils.hh"
  47
  48 using namespace testing;
  49
  50 /* Check that fusefs(4) is accessible and the current user can mount(2) */
  51 void check_environment()
  52 {
  53         const char *devnode = "/dev/fuse";
  54         const char *usermount_node = "vfs.usermount";
  55         int usermount_val = 0;
  56         size_t usermount_size = sizeof(usermount_val);
  57         if (eaccess(devnode, R_OK | W_OK)) {
  58                 if (errno == ENOENT) {
  59                         GTEST_SKIP() << devnode << " does not exist";
  60                 } else if (errno == EACCES) {
  61                         GTEST_SKIP() << devnode <<
  62                             " is not accessible by the current user";
  63                 } else {
  64                         GTEST_SKIP() << strerror(errno);
  65                 }
  66         }
  67         sysctlbyname(usermount_node, &usermount_val, &usermount_size,
  68                      NULL, 0);
  69         if (geteuid() != 0 && !usermount_val)
  70                 GTEST_SKIP() << "current user is not allowed to mount";
  71 }
  72
  73 class FuseEnv: public Environment {
  74         virtual void SetUp() {
  75         }
  76 };
  77
  78 void FuseTest::SetUp() {
  79         const char *node = "vfs.maxbcachebuf";
  80         int val = 0;
  81         size_t size = sizeof(val);
  82
  83         /*
  84          * XXX check_environment should be called from FuseEnv::SetUp, but
  85          * can't due to https://github.com/google/googletest/issues/2189
  86          */
  87         check_environment();
  88         if (IsSkipped())
  89                 return;
  90
  91         ASSERT_EQ(0, sysctlbyname(node, &val, &size, NULL, 0))
  92                 << strerror(errno);
  93         m_maxbcachebuf = val;
  94
  95         try {
  96                 m_mock = new MockFS(m_maxreadahead, m_allow_other,
  97                         m_default_permissions, m_push_symlinks_in, m_ro,
  98                         m_init_flags);
  99                 /*
 100                  * FUSE_ACCESS is called almost universally.  Expecting it in
 101                  * each test case would be super-annoying.  Instead, set a
 102                  * default expectation for FUSE_ACCESS and return ENOSYS.
 103                  *
 104                  * Individual test cases can override this expectation since
 105                  * googlemock evaluates expectations in LIFO order.
 106                  */
 107                 EXPECT_CALL(*m_mock, process(
 108                         ResultOf([=](auto in) {
 109                                 return (in->header.opcode == FUSE_ACCESS);
 110                         }, Eq(true)),
 111                         _)
 112                 ).Times(AnyNumber())
 113                 .WillRepeatedly(Invoke(ReturnErrno(ENOSYS)));
 114         } catch (std::system_error err) {
 115                 FAIL() << err.what();
 116         }
 117 }
 118
 119 void
 120 FuseTest::expect_access(uint64_t ino, mode_t access_mode, int error)
 121 {
 122         EXPECT_CALL(*m_mock, process(
 123                 ResultOf([=](auto in) {
 124                         return (in->header.opcode == FUSE_ACCESS &&
 125                                 in->header.nodeid == ino &&
 126                                 in->body.access.mask == access_mode);
 127                 }, Eq(true)),
 128                 _)
 129         ).WillOnce(Invoke(ReturnErrno(error)));
 130 }
 131
 132 void
 133 FuseTest::expect_flush(uint64_t ino, int times, ProcessMockerT r)
 134 {
 135         EXPECT_CALL(*m_mock, process(
 136                 ResultOf([=](auto in) {
 137                         return (in->header.opcode == FUSE_FLUSH &&
 138                                 in->header.nodeid == ino);
 139                 }, Eq(true)),
 140                 _)
 141         ).Times(times)
 142         .WillRepeatedly(Invoke(r));
 143 }
 144
 145 void FuseTest::expect_getattr(uint64_t ino, uint64_t size)
 146 {
 147         EXPECT_CALL(*m_mock, process(
 148                 ResultOf([=](auto in) {
 149                         return (in->header.opcode == FUSE_GETATTR &&
 150                                 in->header.nodeid == ino);
 151                 }, Eq(true)),
 152                 _)
 153         ).WillOnce(Invoke(ReturnImmediate([=](auto i __unused, auto out) {
 154                 SET_OUT_HEADER_LEN(out, attr);
 155                 out->body.attr.attr.ino = ino;  // Must match nodeid
 156                 out->body.attr.attr.mode = S_IFREG | 0644;
 157                 out->body.attr.attr.size = size;
 158                 out->body.attr.attr_valid = UINT64_MAX;
 159         })));
 160 }
 161
 162 void FuseTest::expect_lookup(const char *relpath, uint64_t ino, mode_t mode,
 163         uint64_t size, int times)
 164 {
 165         EXPECT_LOOKUP(1, relpath)
 166         .Times(times)
 167         .WillRepeatedly(Invoke(ReturnImmediate([=](auto in __unused, auto out) {
 168                 SET_OUT_HEADER_LEN(out, entry);
 169                 out->body.entry.attr.mode = mode;
 170                 out->body.entry.nodeid = ino;
 171                 out->body.entry.attr.nlink = 1;
 172                 out->body.entry.attr_valid = UINT64_MAX;
 173                 out->body.entry.attr.size = size;
 174         })));
 175 }
 176
 177 void FuseTest::expect_open(uint64_t ino, uint32_t flags, int times)
 178 {
 179         EXPECT_CALL(*m_mock, process(
 180                 ResultOf([=](auto in) {
 181                         return (in->header.opcode == FUSE_OPEN &&
 182                                 in->header.nodeid == ino);
 183                 }, Eq(true)),
 184                 _)
 185         ).Times(times)
 186         .WillRepeatedly(Invoke(ReturnImmediate([=](auto in __unused, auto out) {
 187                 out->header.len = sizeof(out->header);
 188                 SET_OUT_HEADER_LEN(out, open);
 189                 out->body.open.fh = FH;
 190                 out->body.open.open_flags = flags;
 191         })));
 192 }
 193
 194 void FuseTest::expect_opendir(uint64_t ino)
 195 {
 196         /* opendir(3) calls fstatfs */
 197         EXPECT_CALL(*m_mock, process(
 198                 ResultOf([](auto in) {
 199                         return (in->header.opcode == FUSE_STATFS);
 200                 }, Eq(true)),
 201                 _)
 202         ).WillRepeatedly(Invoke(ReturnImmediate([=](auto i __unused, auto out) {
 203                 SET_OUT_HEADER_LEN(out, statfs);
 204         })));
 205
 206         EXPECT_CALL(*m_mock, process(
 207                 ResultOf([=](auto in) {
 208                         return (in->header.opcode == FUSE_OPENDIR &&
 209                                 in->header.nodeid == ino);
 210                 }, Eq(true)),
 211                 _)
 212         ).WillOnce(Invoke(ReturnImmediate([=](auto in __unused, auto out) {
 213                 out->header.len = sizeof(out->header);
 214                 SET_OUT_HEADER_LEN(out, open);
 215                 out->body.open.fh = FH;
 216         })));
 217 }
 218
 219 void FuseTest::expect_read(uint64_t ino, uint64_t offset, uint64_t isize,
 220         uint64_t osize, const void *contents)
 221 {
 222         EXPECT_CALL(*m_mock, process(
 223                 ResultOf([=](auto in) {
 224                         return (in->header.opcode == FUSE_READ &&
 225                                 in->header.nodeid == ino &&
 226                                 in->body.read.fh == FH &&
 227                                 in->body.read.offset == offset &&
 228                                 in->body.read.size == isize);
 229                 }, Eq(true)),
 230                 _)
 231         ).WillOnce(Invoke(ReturnImmediate([=](auto in __unused, auto out) {
 232                 out->header.len = sizeof(struct fuse_out_header) + osize;
 233                 memmove(out->body.bytes, contents, osize);
 234         }))).RetiresOnSaturation();
 235 }
 236
 237 void FuseTest::expect_release(uint64_t ino, uint64_t fh)
 238 {
 239         EXPECT_CALL(*m_mock, process(
 240                 ResultOf([=](auto in) {
 241                         return (in->header.opcode == FUSE_RELEASE &&
 242                                 in->header.nodeid == ino &&
 243                                 in->body.release.fh == fh);
 244                 }, Eq(true)),
 245                 _)
 246         ).WillOnce(Invoke(ReturnErrno(0)));
 247 }
 248
 249 void FuseTest::expect_releasedir(uint64_t ino, ProcessMockerT r)
 250 {
 251         EXPECT_CALL(*m_mock, process(
 252                 ResultOf([=](auto in) {
 253                         return (in->header.opcode == FUSE_RELEASEDIR &&
 254                                 in->header.nodeid == ino &&
 255                                 in->body.release.fh == FH);
 256                 }, Eq(true)),
 257                 _)
 258         ).WillOnce(Invoke(r));
 259 }
 260
 261 void FuseTest::expect_write(uint64_t ino, uint64_t offset, uint64_t isize,
 262         uint64_t osize, uint32_t flags, const void *contents)
 263 {
 264         EXPECT_CALL(*m_mock, process(
 265                 ResultOf([=](auto in) {
 266                         const char *buf = (const char*)in->body.bytes +
 267                                 sizeof(struct fuse_write_in);
 268                         bool pid_ok;
 269
 270                         if (in->body.write.write_flags & FUSE_WRITE_CACHE)
 271                                 pid_ok = true;
 272                         else
 273                                 pid_ok = (pid_t)in->header.pid == getpid();
 274
 275                         return (in->header.opcode == FUSE_WRITE &&
 276                                 in->header.nodeid == ino &&
 277                                 in->body.write.fh == FH &&
 278                                 in->body.write.offset == offset  &&
 279                                 in->body.write.size == isize &&
 280                                 pid_ok &&
 281                                 in->body.write.write_flags == flags &&
 282                                 0 == bcmp(buf, contents, isize));
 283                 }, Eq(true)),
 284                 _)
 285         ).WillOnce(Invoke(ReturnImmediate([=](auto in __unused, auto out) {
 286                 SET_OUT_HEADER_LEN(out, write);
 287                 out->body.write.size = osize;
 288         })));
 289 }
 290
 291 static void
 292 get_unprivileged_uid(uid_t *uid)
 293 {
 294         struct passwd *pw;
 295
 296         /*
 297          * First try "tests", Kyua's default unprivileged user.  XXX after
 298          * GoogleTest gains a proper Kyua wrapper, get this with the Kyua API
 299          */
 300         pw = getpwnam("tests");
 301         if (pw == NULL) {
 302                 /* Fall back to "nobody" */
 303                 pw = getpwnam("nobody");
 304         }
 305         if (pw == NULL)
 306                 GTEST_SKIP() << "Test requires an unprivileged user";
 307         *uid = pw->pw_uid;
 308 }
 309
 310 void
 311 FuseTest::fork(bool drop_privs, std::function<void()> parent_func,
 312         std::function<int()> child_func)
 313 {
 314         sem_t *sem;
 315         int mprot = PROT_READ | PROT_WRITE;
 316         int mflags = MAP_ANON | MAP_SHARED;
 317         pid_t child;
 318         uid_t uid;
 319
 320         if (drop_privs) {
 321                 get_unprivileged_uid(&uid);
 322                 if (IsSkipped())
 323                         return;
 324         }
 325
 326         sem = (sem_t*)mmap(NULL, sizeof(*sem), mprot, mflags, -1, 0);
 327         ASSERT_NE(MAP_FAILED, sem) << strerror(errno);
 328         ASSERT_EQ(0, sem_init(sem, 1, 0)) << strerror(errno);
 329
 330         if ((child = ::fork()) == 0) {
 331                 /* In child */
 332                 int err = 0;
 333
 334                 if (sem_wait(sem)) {
 335                         perror("sem_wait");
 336                         err = 1;
 337                         goto out;
 338                 }
 339
 340                 if (drop_privs && 0 != setreuid(-1, uid)) {
 341                         perror("setreuid");
 342                         err = 1;
 343                         goto out;
 344                 }
 345                 err = child_func();
 346
 347 out:
 348                 sem_destroy(sem);
 349                 _exit(err);
 350         } else if (child > 0) {
 351                 int child_status;
 352
 353                 /*
 354                  * In parent.  Cleanup must happen here, because it's still
 355                  * privileged.
 356                  */
 357                 m_mock->m_child_pid = child;
 358                 ASSERT_NO_FATAL_FAILURE(parent_func());
 359
 360                 /* Signal the child process to go */
 361                 ASSERT_EQ(0, sem_post(sem)) << strerror(errno);
 362
 363                 ASSERT_LE(0, wait(&child_status)) << strerror(errno);
 364                 ASSERT_EQ(0, WEXITSTATUS(child_status));
 365         } else {
 366                 FAIL() << strerror(errno);
 367         }
 368         munmap(sem, sizeof(*sem));
 369 }
 370
 371 static void usage(char* progname) {
 372         fprintf(stderr, "Usage: %s [-v]\n\t-v increase verbosity\n", progname);
 373         exit(2);
 374 }
 375
 376 int main(int argc, char **argv) {
 377         int ch;
 378         FuseEnv *fuse_env = new FuseEnv;
 379
 380         InitGoogleTest(&argc, argv);
 381         AddGlobalTestEnvironment(fuse_env);
 382
 383         while ((ch = getopt(argc, argv, "v")) != -1) {
 384                 switch (ch) {
 385                         case 'v':
 386                                 verbosity++;
 387                                 break;
 388                         default:
 389                                 usage(argv[0]);
 390                                 break;
 391                 }
 392         }
 393
 394         return (RUN_ALL_TESTS());
 395 }