80 lines
2.2 KiB
C++
80 lines
2.2 KiB
C++
// Copyright 2019 Google LLC
|
|
//
|
|
// 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
|
|
//
|
|
// https://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_RPCCHANNEL_H_
|
|
#define SANDBOXED_API_RPCCHANNEL_H_
|
|
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
|
|
#include "absl/status/status.h"
|
|
#include "absl/status/statusor.h"
|
|
#include "absl/synchronization/mutex.h"
|
|
#include "sandboxed_api/call.h"
|
|
#include "sandboxed_api/sandbox2/comms.h"
|
|
#include "sandboxed_api/var_type.h"
|
|
|
|
namespace sapi {
|
|
|
|
// This class exposes functions which provide primitives operating over the
|
|
// Comms channel.
|
|
class RPCChannel {
|
|
public:
|
|
explicit RPCChannel(sandbox2::Comms* comms) : comms_(comms) {}
|
|
|
|
// Calls a function.
|
|
absl::Status Call(const FuncCall& call, uint32_t tag, FuncRet* ret,
|
|
v::Type exp_type);
|
|
|
|
// Allocates memory.
|
|
absl::Status Allocate(size_t size, void** addr);
|
|
|
|
// Reallocates memory.
|
|
absl::Status Reallocate(void* old_addr, size_t size, void** new_addr);
|
|
|
|
// Frees memory.
|
|
absl::Status Free(void* addr);
|
|
|
|
// Returns address of a symbol.
|
|
absl::Status Symbol(const char* symname, void** addr);
|
|
|
|
// Makes the remote part exit.
|
|
absl::Status Exit();
|
|
|
|
// Transfers fd to sandboxee.
|
|
absl::Status SendFD(int local_fd, int* remote_fd);
|
|
|
|
// Retrieves fd from sandboxee.
|
|
absl::Status RecvFD(int remote_fd, int* local_fd);
|
|
|
|
// Closes fd in sandboxee.
|
|
absl::Status Close(int remote_fd);
|
|
|
|
// Returns length of a null-terminated c-style string (invokes strlen).
|
|
absl::StatusOr<size_t> Strlen(void* str);
|
|
|
|
sandbox2::Comms* comms() const { return comms_; }
|
|
|
|
private:
|
|
// Receives the result after a call.
|
|
absl::StatusOr<FuncRet> Return(v::Type exp_type);
|
|
|
|
sandbox2::Comms* comms_; // Owned by sandbox2;
|
|
absl::Mutex mutex_;
|
|
};
|
|
|
|
} // namespace sapi
|
|
|
|
#endif // SANDBOXED_API_RPCCHANNEL_H_
|