regions.h File Reference

Xen extended regions interface. More...

Go to the source code of this file.

Functions
bool	xen_region_is_addr_extreg (void *ptr)
	Checks if the provided address belongs to the Xen extended regions.
void *	xen_region_get_pages (size_t nr_pages)
	Allocate pages from the extended regions.
int	xen_region_put_pages (void *ptr, size_t nr_pages)
	Free pages on extended regions.
int	xen_region_map (void *ptr, size_t nr_pages)
	Map extended region memory.
int	xen_region_unmap (void *ptr, size_t nr_pages)
	Unmap extended region memory.

Detailed Description

Xen extended regions interface.

This file provides the interface for managing Xen extended regions, including allocation, freeing pages, and mapping/unmapping extended regions memory.

Function Documentation

xen_region_get_pages()

void * xen_region_get_pages

(

size_t

nr_pages

)

Allocate pages from the extended regions.

Parameters

nr_pages

number of pages to be allocated

Returns

pointer to the allocated pages

xen_region_is_addr_extreg()

bool xen_region_is_addr_extreg

(

void *

ptr

)

Checks if the provided address belongs to the Xen extended regions.

Parameters

ptr	the address/pointer to be checked

Returns

true if the address is located within an extended region

false if the address is outside all extended regions or if ptr is NULL

xen_region_map()

int xen_region_map	(	void *	ptr,
		size_t	nr_pages )

Map extended region memory.

Parameters

ptr	pointer to the pages, allocated by xen_region_get_pages call
nr_pages	number of pages that should be mapped

Returns

zero on success, non-zero on failure

xen_region_put_pages()

int xen_region_put_pages	(	void *	ptr,
		size_t	nr_pages )

Free pages on extended regions.

Parameters

ptr	pointer to the pages, allocated by xen_region_get_pages call
nr_pages	number of pages that were allocated

Returns

zero on success, non-zero on failure

xen_region_unmap()

int xen_region_unmap	(	void *	ptr,
		size_t	nr_pages )

Unmap extended region memory.

Parameters

ptr	pointer to the pages, allocated by xen_region_get_pages call
nr_pages	number of pages that should be unmapped

Returns

zero on success, non-zero on failure