class VmPageSpliceList

For use by PhysicalPageProvider. The user-pager path doesn't use this. This returns a

finalized list.

Pops the next page off of the splice list. It is invalid to pop a page from a non-finalized

splice list.

Inserts the |content| into the splice list at the specified |offset|.

The splice list takes ownership of `content` after this call.

It is invalid to append to a finalized splice list.

Convenience constructor that calls Initialize.

Initialize the list with the given range. Can only be done once, and must be done before

providing pages.

Takes the content out of |source| and places them in this splice list, which must have already

been initialized but still be empty. The range to be taken is determined by the provided

|offset| and the length of this splice list. May return ZX_ERR_OUT_OF_MEMORY, in which case an

unspecified number of pages will have been moved into this splice list.

Takes a function with the signature void(VmPageOrMarker *src, VmPageOrMarker *dst, uint64_t

offset), which is expected to move content from |src| to |dst|.

Iterates all pages in this splice list without taking ownership. Pages are not considered

processed and can not be removed using this iterator. The callback is expected to have the

signature: zx_status_t page_func(VmPageOrMarkerRef slot, uint64_t offset);

The iterator will start at `start_offset` and iterate until the end of the VmPageSpliceList.

start_offset must be paged aligned and less than length_.

Iterates all the pages and gaps in this splice list. The page_func is given ownership of each

page. It is invalid to process a non-finalized splice list. The two callbacks are expected to

have the signature:

zx_status_t page_func(VmPageOrMarker slot, uint64_t splice_offset);

zx_status_t gap_func(uint64_t gap_start, uint64_t gap_end);

Due to page_func always taking ownership of the content if it returns any kind of error, either

a graceful request to stop iteration via ZX_ERR_STOP or an explicit error, then that offset is

considered processed and will not be repeated in future calls. In contrast, if iteration is

stopped during gap_func, that gap will not be considered processed and can be returned in

future calls.

Returns true after the whole collection has been processed by Pop.

Returns true if the collection has been Initialized.

Returns true if this list is empty.

Marks the list as finalized.

See the comment at `VmPageSpliceList`'s declaration for more info on what this means and when

to call it. Note that it is invalid to call `Finalize` twice on the same list.

Returns true if the splice list is finalized.

See the comment at `VmPageSpliceList`'s declaration for more info on what this means.

Returns the current position in the list.