sandboxed-api/sandboxed_api/rpcchannel.h
Christian Blichmann d451478e26 Change license link to HTTPS URL
PiperOrigin-RevId: 424811734
Change-Id: If5ea692edc56ddc9c99fd478673df41c0246e9cc
2022-01-28 01:39:09 -08:00

79 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 "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_