class RemoteAbiHeap

Create the RemoteAbiHeap by modifying the RemoteLoadModule for the stub

dynamic linker, using the same original data segment size passed to the

RemoteAbiHeapLayout constructor from RemoteAbiStub::data_size(). This

both modifies the RemoteLoadModule's final segment and references that

segment's VMO, so that RemoteLoadModule must remain live for the lifetime

of the RemoteAbiHeap object.

The heap size is fixed when the Buffer is created. It can be used to

size a mapping location whose vaddr will be passed into Remote calls.

After the stub module's load_bias() has been fixed, this yields the

runtime vaddr of the stub module's heap segment: the vaddr argument for

the Remote() methods below.

This should only be called on a stub_module that was previously modified

by a successful Create() call, and has since had its load_bias() set.

Return a local mutable reference to a global of type T at a known offset

in the stub data segment.

The string table is already written, so each RemoteAbiString yields a

constant span of the image where that NUL-terminated string already lies

in the table.

The local span

<T

> contents in the RemoteAbiHeap can now be filled in.

The return span remains valid until Commit() is called (see below).

Given the remote virtual address where the segment will be mapped,

RemoteAbiString and RemoteAbiSpan placeholders can be turned into remote

AbiSpan objects ready to be copied into place.

Remove the original mutable segment and turn it into the larger

read-only segment. It can be either a DataWithZeroFillSegment that

might have an existing VMO, or a ZeroFillSegment that never does.

Private subroutine of Create; public only for unit testing.

When a RemoteAbiHeap has been filled and is ready to be mapped into a

process, Commit() yields the VMO. It should then be mapped at the same

vaddr that was used in Remote calls when filling pointers in the data.

This must be the last method called and must be called using std::move.

This invalidates all previous return values from Local.