/******************************************************************************

[0] Fix | Delete

* gntalloc.h

[1] Fix | Delete

*

[2] Fix | Delete

* Interface to /dev/xen/gntalloc.

[3] Fix | Delete

*

[4] Fix | Delete

* Author: Daniel De Graaf <dgdegra@tycho.nsa.gov>

[5] Fix | Delete

*

[6] Fix | Delete

* This file is in the public domain.

[7] Fix | Delete

*/

[8] Fix | Delete

[9] Fix | Delete

#ifndef __LINUX_PUBLIC_GNTALLOC_H__

[10] Fix | Delete

#define __LINUX_PUBLIC_GNTALLOC_H__

[11] Fix | Delete

[12] Fix | Delete

#include <linux/types.h>

[13] Fix | Delete

[14] Fix | Delete

/*

[15] Fix | Delete

* Allocates a new page and creates a new grant reference.

[16] Fix | Delete

*/

[17] Fix | Delete

#define IOCTL_GNTALLOC_ALLOC_GREF \

[18] Fix | Delete

_IOC(_IOC_NONE, 'G', 5, sizeof(struct ioctl_gntalloc_alloc_gref))

[19] Fix | Delete

struct ioctl_gntalloc_alloc_gref {

[20] Fix | Delete

/* IN parameters */

[21] Fix | Delete

/* The ID of the domain to be given access to the grants. */

[22] Fix | Delete

__u16 domid;

[23] Fix | Delete

/* Flags for this mapping */

[24] Fix | Delete

__u16 flags;

[25] Fix | Delete

/* Number of pages to map */

[26] Fix | Delete

__u32 count;

[27] Fix | Delete

/* OUT parameters */

[28] Fix | Delete

/* The offset to be used on a subsequent call to mmap(). */

[29] Fix | Delete

__u64 index;

[30] Fix | Delete

/* The grant references of the newly created grant, one per page */

[31] Fix | Delete

/* Variable size, depending on count */

[32] Fix | Delete

__u32 gref_ids[1];

[33] Fix | Delete

};

[34] Fix | Delete

[35] Fix | Delete

#define GNTALLOC_FLAG_WRITABLE 1

[36] Fix | Delete

[37] Fix | Delete

/*

[38] Fix | Delete

* Deallocates the grant reference, allowing the associated page to be freed if

[39] Fix | Delete

* no other domains are using it.

[40] Fix | Delete

*/

[41] Fix | Delete

#define IOCTL_GNTALLOC_DEALLOC_GREF \

[42] Fix | Delete

_IOC(_IOC_NONE, 'G', 6, sizeof(struct ioctl_gntalloc_dealloc_gref))

[43] Fix | Delete

struct ioctl_gntalloc_dealloc_gref {

[44] Fix | Delete

/* IN parameters */

[45] Fix | Delete

/* The offset returned in the map operation */

[46] Fix | Delete

__u64 index;

[47] Fix | Delete

/* Number of references to unmap */

[48] Fix | Delete

__u32 count;

[49] Fix | Delete

};

[50] Fix | Delete

[51] Fix | Delete

/*

[52] Fix | Delete

* Sets up an unmap notification within the page, so that the other side can do

[53] Fix | Delete

* cleanup if this side crashes. Required to implement cross-domain robust

[54] Fix | Delete

* mutexes or close notification on communication channels.

[55] Fix | Delete

*

[56] Fix | Delete

* Each mapped page only supports one notification; multiple calls referring to

[57] Fix | Delete

* the same page overwrite the previous notification. You must clear the

[58] Fix | Delete

* notification prior to the IOCTL_GNTALLOC_DEALLOC_GREF if you do not want it

[59] Fix | Delete

* to occur.

[60] Fix | Delete

*/

[61] Fix | Delete

#define IOCTL_GNTALLOC_SET_UNMAP_NOTIFY \

[62] Fix | Delete

_IOC(_IOC_NONE, 'G', 7, sizeof(struct ioctl_gntalloc_unmap_notify))

[63] Fix | Delete

struct ioctl_gntalloc_unmap_notify {

[64] Fix | Delete

/* IN parameters */

[65] Fix | Delete

/* Offset in the file descriptor for a byte within the page (same as

[66] Fix | Delete

* used in mmap). If using UNMAP_NOTIFY_CLEAR_BYTE, this is the byte to

[67] Fix | Delete

* be cleared. Otherwise, it can be any byte in the page whose

[68] Fix | Delete

* notification we are adjusting.

[69] Fix | Delete

*/

[70] Fix | Delete

__u64 index;

[71] Fix | Delete

/* Action(s) to take on unmap */

[72] Fix | Delete

__u32 action;

[73] Fix | Delete

/* Event channel to notify */

[74] Fix | Delete

__u32 event_channel_port;

[75] Fix | Delete

};

[76] Fix | Delete

[77] Fix | Delete

/* Clear (set to zero) the byte specified by index */

[78] Fix | Delete

#define UNMAP_NOTIFY_CLEAR_BYTE 0x1

[79] Fix | Delete

/* Send an interrupt on the indicated event channel */

[80] Fix | Delete

#define UNMAP_NOTIFY_SEND_EVENT 0x2

[81] Fix | Delete

[82] Fix | Delete

#endif /* __LINUX_PUBLIC_GNTALLOC_H__ */

[83] Fix | Delete

[84] Fix | Delete