sandboxed-api/sandboxed_api/var_ptr.h
Oliver Kunz f2840b37a3 NullPtr: Change SAPI to accept regular nullptr for sandboxed API calls.
This change allows to use a `nullptr` instead to having to instantiate a `sapi:✌️:NullPtr` object.

```
sapi:✌️:NullPtr null;
SAPI_RETURN_IF_ERROR(api.testNullPtr(&null);
```

Becomes:

```
SAPI_RETURN_IF_ERROR(api.testNullPtr(nullptr);
```

PiperOrigin-RevId: 602333882
Change-Id: Ie2517dbedab8c514d7a102c4ef4bad90b34a219d
2024-01-29 03:23:45 -08:00

108 lines
3.0 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_VAR_PTR_H_
#define SANDBOXED_API_VAR_PTR_H_
#include <algorithm>
#include <cstring>
#include <memory>
#include <string>
#include "absl/base/attributes.h"
#include "absl/base/macros.h"
#include "absl/strings/str_format.h"
#include "sandboxed_api/var_abstract.h"
#include "sandboxed_api/var_reg.h"
namespace sapi::v {
// Class representing a pointer. Takes both Var* and regular pointers in the
// initializers.
class Ptr : public Reg<Var*> {
public:
Ptr() = delete;
explicit Ptr(Var* value, SyncType sync_type) : sync_type_(sync_type) {
Reg<Var*>::SetValue(value);
}
Var* GetPointedVar() const { return Reg<Var*>::GetValue(); }
void SetValue(Var* ptr) final { value_->SetRemote(ptr); }
Var* GetValue() const final {
return reinterpret_cast<Var*>(value_->GetRemote());
}
const void* GetDataPtr() final {
remote_ptr_cache_ = GetValue();
return &remote_ptr_cache_;
}
void SetDataFromPtr(const void* ptr, size_t max_sz) final {
void* tmp;
memcpy(&tmp, ptr, std::min(sizeof(tmp), max_sz));
SetValue(reinterpret_cast<Var*>(tmp));
}
// Getter/Setter for the sync_type_ field.
SyncType GetSyncType() { return sync_type_; }
void SetSyncType(SyncType sync_type) { sync_type_ = sync_type; }
std::string ToString() const final {
Var* var = GetPointedVar();
return absl::StrFormat(
"Ptr to obj:%p (type:'%s' val:'%s'), local:%p, remote:%p, size:%tx",
var, var->GetTypeString(), var->ToString(), var->GetLocal(),
var->GetRemote(), var->GetSize());
}
private:
// GetDataPtr() interface requires of us to return a pointer to the data
// (variable) that can be copied. We cannot get pointer to pointer with
// Var::GetRemote(), hence we cache it, and return pointer to it.
void* remote_ptr_cache_;
// Shall we synchronize the underlying object before/after call.
SyncType sync_type_;
};
// Good, old nullptr
class ABSL_DEPRECATED(
"Use regular `nullptr` or `NULL` instead. This class will eventually get "
"removed") NullPtr : public Ptr {
public:
NullPtr() : Ptr(&void_obj_, SyncType::kSyncNone) {}
private:
Reg<void*> void_obj_;
};
// Pointer, which can only point to remote memory, and is never synchronized.
class RemotePtr : public Ptr {
public:
explicit RemotePtr(void* remote_addr)
: Ptr(&pointed_obj_, SyncType::kSyncNone) {
pointed_obj_.SetRemote(remote_addr);
}
private:
Reg<void*> pointed_obj_;
};
} // namespace sapi::v
#endif // SANDBOXED_API_VAR_PTR_H_