summaryrefslogtreecommitdiff
path: root/drivers/staging/memrar/memrar-abi
blob: c23fc996a4356b257c18c67a6ad59ae530e366a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
What:		/dev/memrar
Date:		March 2010
KernelVersion:	2.6.34
Contact:	Eugene Epshteyn <eugene.epshteyn@intel.com>
Description:	The Intel Moorestown Restricted Access Region (RAR)
		Handler driver exposes an ioctl() based interface that
		allows a user to reserve and release blocks of RAR
		memory.

		Note:  A sysfs based one was not appropriate for the
		RAR handler's usage model.

		=========================================================
				ioctl() Requests
		=========================================================
		RAR_HANDLER_RESERVE
		-------------------
		Description:	Reserve RAR block.
		Type:		struct RAR_block_info
		Direction:	in/out
		Errors:		EINVAL (invalid RAR type or size)
				ENOMEM (not enough RAR memory)

		RAR_HANDLER_STAT
		----------------
		Description:	Get RAR statistics.
		Type:		struct RAR_stat
		Direction:	in/out
		Errors:		EINVAL (invalid RAR type)

		RAR_HANDLER_RELEASE
		-------------------
		Description:	Release previously reserved RAR block.
		Type:		32 bit unsigned integer
				(e.g. uint32_t), i.e the RAR "handle".
		Direction:	in
		Errors:		EINVAL (invalid RAR handle)


		=========================================================
			ioctl() Request Parameter Types
		=========================================================
		The structures referred to above are defined as
		follows:

		/**
		 * struct RAR_block_info - user space struct that
		 *			   describes RAR buffer
		 * @type:	Type of RAR memory (e.g.,
		 *		RAR_TYPE_VIDEO or RAR_TYPE_AUDIO) [in]
		 * @size:	Requested size of a block in bytes to
		 *		be reserved in RAR. [in]
		 * @handle:	Handle that can be used to refer to
		 *		reserved block. [out]
		 *
		 * This is the basic structure exposed to the user
		 * space that describes a given RAR buffer.  It used
		 * as the parameter for the RAR_HANDLER_RESERVE ioctl.
		 * The buffer's underlying bus address is not exposed
		 * to the user.  User space code refers to the buffer
		 * entirely by "handle".
		 */
		struct RAR_block_info {
			__u32 type;
			__u32 size;
			__u32 handle;
		};

		/**
		 * struct RAR_stat - RAR statistics structure
		 * @type:		Type of RAR memory (e.g.,
		 *			RAR_TYPE_VIDEO or
		 *			RAR_TYPE_AUDIO) [in]
		 * @capacity:		Total size of RAR memory
		 *			region. [out]
		 * @largest_block_size:	Size of the largest reservable
		 *			block. [out]
		 *
		 * This structure is used for RAR_HANDLER_STAT ioctl.
		 */
		struct RAR_stat {
			__u32 type;
			__u32 capacity;
			__u32 largest_block_size;
		};

		Lastly, the RAR_HANDLER_RELEASE ioctl expects a
		"handle" to the RAR block of memory.  It is a 32 bit
		unsigned integer.