mach/upl.h Kernel.framework

Aborts every page of the UPL, equivalent to upl_abort_range over the UPL's full extent. abort_cond carries UPL_ABORT_* flags describing the failure disposition (UPL_ABORT_ERROR, UPL_ABORT_DUMP_PAGES, UPL_ABORT_RESTART, ...). Returns KERN_INVALID_ARGUMENT if the UPL is null.

Aborts the given byte range of the UPL after a failed or abandoned I/O: the covered pages are unbusied and disposed of according to the UPL_ABORT_* flags in abort_cond (UPL_ABORT_DUMP_PAGES frees them, UPL_ABORT_ERROR marks the object in error, UPL_ABORT_RESTART/UPL_ABORT_UNAVAILABLE control page state). For I/O-wired UPLs without UPL_ABORT_DUMP_PAGES the call is converted to upl_commit_range with UPL_COMMIT_FREE_ABSENT. *empty is set TRUE when the entire UPL has been processed; with UPL_ABORT_FREE_ON_EMPTY the UPL is also deallocated, saving a call to upl_deallocate. Returns KERN_INVALID_ARGUMENT for a null UPL, KERN_FAILURE for a range beyond the UPL's extent.

Commits every page of the UPL, equivalent to upl_commit_range over the UPL's full extent with no flags; page_list (with page_listCnt entries) optionally supplies per-page state gathered when the UPL was created. Returns KERN_INVALID_ARGUMENT if the UPL is null.

Commits the given byte range of the UPL after successful completion of the I/O or other operation it was created for: covered pages are unbusied, wired counts dropped for I/O-wired UPLs, and dirty/precious state updated per the UPL_COMMIT_* flags (UPL_COMMIT_CLEAR_DIRTY, UPL_COMMIT_SET_DIRTY, UPL_COMMIT_FREE_ABSENT, UPL_COMMIT_INACTIVATE, ...) and the optional page_list information. *empty is set TRUE when the whole UPL has been committed; with UPL_COMMIT_FREE_ON_EMPTY it is then deallocated automatically. Returns KERN_INVALID_ARGUMENT for a null UPL, KERN_FAILURE for a range beyond the UPL's extent.