sandboxed-api/sandboxed_api/sandbox2/mounts.h
Sandboxed API Team f29a5a81ed Print final FS mounts in sandboxee's chroot
After all requested filesystem mounts are fully mounted under a sandboxee's virtual chroot, print a list of the outside paths and a list of the inside chroot paths that the outside paths are mapped to. This provides a valuable insight while debugging sandboxed binaries.

PiperOrigin-RevId: 247130923
Change-Id: I42b4b3db68d826587c0fe8127aabbead38bc6f20
2019-05-07 18:30:13 -07:00

69 lines
2.5 KiB
C++

// Copyright 2019 Google LLC. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#ifndef SANDBOXED_API_SANDBOX2_MOUNTTREE_H_
#define SANDBOXED_API_SANDBOX2_MOUNTTREE_H_
#include <string>
#include <vector>
#include "absl/base/attributes.h"
#include "absl/strings/string_view.h"
#include "sandboxed_api/sandbox2/mounttree.pb.h"
#include "sandboxed_api/util/status.h"
namespace sandbox2 {
class Mounts {
public:
Mounts() = default;
explicit Mounts(MountTree mount_tree) : mount_tree_(std::move(mount_tree)) {}
::sapi::Status AddFile(absl::string_view path, bool is_ro = true);
::sapi::Status AddFileAt(absl::string_view outside, absl::string_view inside,
bool is_ro = true);
::sapi::Status AddDirectoryAt(absl::string_view outside,
absl::string_view inside, bool is_ro = true);
::sapi::Status AddMappingsForBinary(const std::string& path,
absl::string_view ld_library_path = {});
::sapi::Status AddTmpfs(absl::string_view inside, size_t sz);
void CreateMounts(const std::string& root_path) const;
MountTree GetMountTree() const { return mount_tree_; }
// Lists the outside and inside entries of the input tree in the output
// parameters, in an ls-like manner. Each entry is traversed in the
// depth-first order. However, the entries on the same level of hierarchy are
// traversed in their natural order in the tree. The elements in the output
// containers match each other pairwise: outside_entries[i] is mounted as
// inside_entries[i]. The elements of inside_entries are prefixed with either
// 'R' (read-only) or 'W' (writable).
void RecursivelyListMounts(std::vector<std::string>* outside_entries,
std::vector<std::string>* inside_entries);
private:
friend class MountTreeTest;
::sapi::Status Insert(absl::string_view path, const MountTree::Node& node);
MountTree mount_tree_;
};
} // namespace sandbox2
#endif // SANDBOXED_API_SANDBOX2_MOUNTTREE_H_