IEMInternal.h@ 58944

Last change on this file since 58944 was 58127, checked in by vboxsync, 9 years ago
VMM: No more doxygen warnings here.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 65.0 KB

Line
1	/* $Id: IEMInternal.h 58127 2015-10-08 22:09:23Z vboxsync $ */
2	/** @file
3	* IEM - Internal header file.
4	*/
5
6	/*
7	* Copyright (C) 2011-2015 Oracle Corporation
8	*
9	* This file is part of VirtualBox Open Source Edition (OSE), as
10	* available from http://www.virtualbox.org. This file is free software;
11	* you can redistribute it and/or modify it under the terms of the GNU
12	* General Public License (GPL) as published by the Free Software
13	* Foundation, in version 2 as it comes in the "COPYING" file of the
14	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16	*/
17
18	#ifndef ___IEMInternal_h
19	#define ___IEMInternal_h
20
21	#include <VBox/vmm/cpum.h>
22	#include <VBox/vmm/iem.h>
23	#include <VBox/vmm/stam.h>
24	#include <VBox/param.h>
25
26
27	RT_C_DECLS_BEGIN
28
29
30	/** @defgroup grp_iem_int Internals
31	* @ingroup grp_iem
32	* @internal
33	* @{
34	*/
35
36	/** For expanding symbol in slickedit and other products tagging and
37	* crossreferencing IEM symbols. */
38	#ifndef IEM_STATIC
39	# define IEM_STATIC static
40	#endif
41
42	/** @def IEM_VERIFICATION_MODE_FULL
43	* Shorthand for:
44	* defined(IEM_VERIFICATION_MODE) && !defined(IEM_VERIFICATION_MODE_MINIMAL)
45	*/
46	#if (defined(IEM_VERIFICATION_MODE) && !defined(IEM_VERIFICATION_MODE_MINIMAL) && !defined(IEM_VERIFICATION_MODE_FULL)) \
47	\|\| defined(DOXYGEN_RUNNING)
48	# define IEM_VERIFICATION_MODE_FULL
49	#endif
50
51
52	/** Finish and move to types.h */
53	typedef union
54	{
55	uint32_t u32;
56	} RTFLOAT32U;
57	typedef RTFLOAT32U *PRTFLOAT32U;
58	typedef RTFLOAT32U const *PCRTFLOAT32U;
59
60
61	/**
62	* Extended operand mode that includes a representation of 8-bit.
63	*
64	* This is used for packing down modes when invoking some C instruction
65	* implementations.
66	*/
67	typedef enum IEMMODEX
68	{
69	IEMMODEX_16BIT = IEMMODE_16BIT,
70	IEMMODEX_32BIT = IEMMODE_32BIT,
71	IEMMODEX_64BIT = IEMMODE_64BIT,
72	IEMMODEX_8BIT
73	} IEMMODEX;
74	AssertCompileSize(IEMMODEX, 4);
75
76
77	/**
78	* Branch types.
79	*/
80	typedef enum IEMBRANCH
81	{
82	IEMBRANCH_JUMP = 1,
83	IEMBRANCH_CALL,
84	IEMBRANCH_TRAP,
85	IEMBRANCH_SOFTWARE_INT,
86	IEMBRANCH_HARDWARE_INT
87	} IEMBRANCH;
88	AssertCompileSize(IEMBRANCH, 4);
89
90
91	/**
92	* A FPU result.
93	*/
94	typedef struct IEMFPURESULT
95	{
96	/** The output value. */
97	RTFLOAT80U r80Result;
98	/** The output status. */
99	uint16_t FSW;
100	} IEMFPURESULT;
101	AssertCompileMemberOffset(IEMFPURESULT, FSW, 10);
102	/** Pointer to a FPU result. */
103	typedef IEMFPURESULT *PIEMFPURESULT;
104	/** Pointer to a const FPU result. */
105	typedef IEMFPURESULT const *PCIEMFPURESULT;
106
107
108	/**
109	* A FPU result consisting of two output values and FSW.
110	*/
111	typedef struct IEMFPURESULTTWO
112	{
113	/** The first output value. */
114	RTFLOAT80U r80Result1;
115	/** The output status. */
116	uint16_t FSW;
117	/** The second output value. */
118	RTFLOAT80U r80Result2;
119	} IEMFPURESULTTWO;
120	AssertCompileMemberOffset(IEMFPURESULTTWO, FSW, 10);
121	AssertCompileMemberOffset(IEMFPURESULTTWO, r80Result2, 12);
122	/** Pointer to a FPU result consisting of two output values and FSW. */
123	typedef IEMFPURESULTTWO *PIEMFPURESULTTWO;
124	/** Pointer to a const FPU result consisting of two output values and FSW. */
125	typedef IEMFPURESULTTWO const *PCIEMFPURESULTTWO;
126
127
128	/**
129	* IEM pending commit function index.
130	*/
131	typedef enum IEMCOMMIT
132	{
133	/** Invalid / nothing pending. */
134	IEMCOMMIT_INVALID = 0,
135	/** @name INS
136	* @{ */
137	IEMCOMMIT_INS_OP8_ADDR16,
138	IEMCOMMIT_INS_OP8_ADDR32,
139	IEMCOMMIT_INS_OP8_ADDR64,
140	IEMCOMMIT_INS_OP16_ADDR16,
141	IEMCOMMIT_INS_OP16_ADDR32,
142	IEMCOMMIT_INS_OP16_ADDR64,
143	IEMCOMMIT_INS_OP32_ADDR16,
144	IEMCOMMIT_INS_OP32_ADDR32,
145	IEMCOMMIT_INS_OP32_ADDR64,
146	/** @} */
147	/** @name REP INS
148	* @{ */
149	IEMCOMMIT_REP_INS_OP8_ADDR16,
150	IEMCOMMIT_REP_INS_OP8_ADDR32,
151	IEMCOMMIT_REP_INS_OP8_ADDR64,
152	IEMCOMMIT_REP_INS_OP16_ADDR16,
153	IEMCOMMIT_REP_INS_OP16_ADDR32,
154	IEMCOMMIT_REP_INS_OP16_ADDR64,
155	IEMCOMMIT_REP_INS_OP32_ADDR16,
156	IEMCOMMIT_REP_INS_OP32_ADDR32,
157	IEMCOMMIT_REP_INS_OP32_ADDR64,
158	/** @} */
159	/** End of valid functions. */
160	IEMCOMMIT_END,
161	/** Make sure the type is int in call contexts. */
162	IEMCOMMIT_32BIT_HACK = 0x7fffffff
163	} IEMCOMMIT;
164	AssertCompile(sizeof(IEMCOMMIT) == 4);
165
166
167	#ifdef IEM_VERIFICATION_MODE_FULL
168
169	/**
170	* Verification event type.
171	*/
172	typedef enum IEMVERIFYEVENT
173	{
174	IEMVERIFYEVENT_INVALID = 0,
175	IEMVERIFYEVENT_IOPORT_READ,
176	IEMVERIFYEVENT_IOPORT_WRITE,
177	IEMVERIFYEVENT_RAM_WRITE,
178	IEMVERIFYEVENT_RAM_READ
179	} IEMVERIFYEVENT;
180
181	/** Checks if the event type is a RAM read or write. */
182	# define IEMVERIFYEVENT_IS_RAM(a_enmType) ((a_enmType) == IEMVERIFYEVENT_RAM_WRITE \|\| (a_enmType) == IEMVERIFYEVENT_RAM_READ)
183
184	/**
185	* Verification event record.
186	*/
187	typedef struct IEMVERIFYEVTREC
188	{
189	/** Pointer to the next record in the list. */
190	struct IEMVERIFYEVTREC *pNext;
191	/** The event type. */
192	IEMVERIFYEVENT enmEvent;
193	/** The event data. */
194	union
195	{
196	/** IEMVERIFYEVENT_IOPORT_READ */
197	struct
198	{
199	RTIOPORT Port;
200	uint32_t cbValue;
201	} IOPortRead;
202
203	/** IEMVERIFYEVENT_IOPORT_WRITE */
204	struct
205	{
206	RTIOPORT Port;
207	uint32_t cbValue;
208	uint32_t u32Value;
209	} IOPortWrite;
210
211	/** IEMVERIFYEVENT_RAM_READ */
212	struct
213	{
214	RTGCPHYS GCPhys;
215	uint32_t cb;
216	} RamRead;
217
218	/** IEMVERIFYEVENT_RAM_WRITE */
219	struct
220	{
221	RTGCPHYS GCPhys;
222	uint32_t cb;
223	uint8_t ab[512];
224	} RamWrite;
225	} u;
226	} IEMVERIFYEVTREC;
227	/** Pointer to an IEM event verification records. */
228	typedef IEMVERIFYEVTREC *PIEMVERIFYEVTREC;
229
230	#endif /* IEM_VERIFICATION_MODE_FULL */
231
232
233	/**
234	* The per-CPU IEM state.
235	*/
236	typedef struct IEMCPU
237	{
238	/** Pointer to the CPU context - ring-3 context. */
239	R3PTRTYPE(PCPUMCTX) pCtxR3;
240	/** Pointer to the CPU context - ring-0 context. */
241	R0PTRTYPE(PCPUMCTX) pCtxR0;
242	/** Pointer to the CPU context - raw-mode context. */
243	RCPTRTYPE(PCPUMCTX) pCtxRC;
244
245	/** Offset of the VMCPU structure relative to this structure (negative). */
246	int32_t offVMCpu;
247	/** Offset of the VM structure relative to this structure (negative). */
248	int32_t offVM;
249
250	/** Whether to bypass access handlers or not. */
251	bool fBypassHandlers;
252	/** Indicates that we're interpreting patch code - RC only! */
253	bool fInPatchCode;
254	/** Explicit alignment padding. */
255	bool afAlignment0[2];
256
257	/** The flags of the current exception / interrupt. */
258	uint32_t fCurXcpt;
259	/** The current exception / interrupt. */
260	uint8_t uCurXcpt;
261	/** Exception / interrupt recursion depth. */
262	int8_t cXcptRecursions;
263	/** Explicit alignment padding. */
264	bool afAlignment1[1];
265	/** The CPL. */
266	uint8_t uCpl;
267	/** The current CPU execution mode (CS). */
268	IEMMODE enmCpuMode;
269	/** Info status code that needs to be propagated to the IEM caller.
270	* This cannot be passed internally, as it would complicate all success
271	* checks within the interpreter making the code larger and almost impossible
272	* to get right. Instead, we'll store status codes to pass on here. Each
273	* source of these codes will perform appropriate sanity checks. */
274	int32_t rcPassUp;
275
276	/** @name Statistics
277	* @{ */
278	/** The number of instructions we've executed. */
279	uint32_t cInstructions;
280	/** The number of potential exits. */
281	uint32_t cPotentialExits;
282	/** The number of bytes data or stack written (mostly for IEMExecOneEx).
283	* This may contain uncommitted writes. */
284	uint32_t cbWritten;
285	/** Counts the VERR_IEM_INSTR_NOT_IMPLEMENTED returns. */
286	uint32_t cRetInstrNotImplemented;
287	/** Counts the VERR_IEM_ASPECT_NOT_IMPLEMENTED returns. */
288	uint32_t cRetAspectNotImplemented;
289	/** Counts informational statuses returned (other than VINF_SUCCESS). */
290	uint32_t cRetInfStatuses;
291	/** Counts other error statuses returned. */
292	uint32_t cRetErrStatuses;
293	/** Number of times rcPassUp has been used. */
294	uint32_t cRetPassUpStatus;
295	/** Number of times RZ left with instruction commit pending for ring-3. */
296	uint32_t cPendingCommit;
297	#ifdef IEM_VERIFICATION_MODE_FULL
298	/** The Number of I/O port reads that has been performed. */
299	uint32_t cIOReads;
300	/** The Number of I/O port writes that has been performed. */
301	uint32_t cIOWrites;
302	/** Set if no comparison to REM is currently performed.
303	* This is used to skip past really slow bits. */
304	bool fNoRem;
305	/** Indicates that RAX and RDX differences should be ignored since RDTSC
306	* and RDTSCP are timing sensitive. */
307	bool fIgnoreRaxRdx;
308	/** Indicates that a MOVS instruction with overlapping source and destination
309	* was executed, causing the memory write records to be incorrrect. */
310	bool fOverlappingMovs;
311	/** Set if there are problematic memory accesses (MMIO, write monitored, ++). */
312	bool fProblematicMemory;
313	/** This is used to communicate a CPL changed caused by IEMInjectTrap that
314	* CPUM doesn't yet reflect. */
315	uint8_t uInjectCpl;
316	bool afAlignment2[3];
317	/** Mask of undefined eflags.
318	* The verifier will any difference in these flags. */
319	uint32_t fUndefinedEFlags;
320	/** The CS of the instruction being interpreted. */
321	RTSEL uOldCs;
322	/** The RIP of the instruction being interpreted. */
323	uint64_t uOldRip;
324	/** The physical address corresponding to abOpcodes[0]. */
325	RTGCPHYS GCPhysOpcodes;
326	#endif
327	/** @} */
328
329	/** @name Decoder state.
330	* @{ */
331
332	/** The default addressing mode . */
333	IEMMODE enmDefAddrMode;
334	/** The effective addressing mode . */
335	IEMMODE enmEffAddrMode;
336	/** The default operand mode . */
337	IEMMODE enmDefOpSize;
338	/** The effective operand mode . */
339	IEMMODE enmEffOpSize;
340
341	/** The prefix mask (IEM_OP_PRF_XXX). */
342	uint32_t fPrefixes;
343	/** The extra REX ModR/M register field bit (REX.R << 3). */
344	uint8_t uRexReg;
345	/** The extra REX ModR/M r/m field, SIB base and opcode reg bit
346	* (REX.B << 3). */
347	uint8_t uRexB;
348	/** The extra REX SIB index field bit (REX.X << 3). */
349	uint8_t uRexIndex;
350	/** The effective segment register (X86_SREG_XXX). */
351	uint8_t iEffSeg;
352
353	/** The current offset into abOpcodes. */
354	uint8_t offOpcode;
355	/** The size of what has currently been fetched into abOpcodes. */
356	uint8_t cbOpcode;
357	/** The opcode bytes. */
358	uint8_t abOpcode[15];
359	/** Offset into abOpcodes where the FPU instruction starts.
360	* Only set by the FPU escape opcodes (0xd8-0xdf) and used later on when the
361	* instruction result is committed. */
362	uint8_t offFpuOpcode;
363
364	/** @}*/
365
366	/** The number of active guest memory mappings. */
367	uint8_t cActiveMappings;
368	/** The next unused mapping index. */
369	uint8_t iNextMapping;
370	/** Records for tracking guest memory mappings. */
371	struct
372	{
373	/** The address of the mapped bytes. */
374	void *pv;
375	#if defined(IN_RC) && HC_ARCH_BITS == 64
376	uint32_t u32Alignment3; /*< Alignment padding. /
377	#endif
378	/** The access flags (IEM_ACCESS_XXX).
379	* IEM_ACCESS_INVALID if the entry is unused. */
380	uint32_t fAccess;
381	#if HC_ARCH_BITS == 64
382	uint32_t u32Alignment4; /*< Alignment padding. /
383	#endif
384	} aMemMappings[3];
385
386	/** Locking records for the mapped memory. */
387	union
388	{
389	PGMPAGEMAPLOCK Lock;
390	uint64_t au64Padding[2];
391	} aMemMappingLocks[3];
392
393	/** Bounce buffer info.
394	* This runs in parallel to aMemMappings. */
395	struct
396	{
397	/** The physical address of the first byte. */
398	RTGCPHYS GCPhysFirst;
399	/** The physical address of the second page. */
400	RTGCPHYS GCPhysSecond;
401	/** The number of bytes in the first page. */
402	uint16_t cbFirst;
403	/** The number of bytes in the second page. */
404	uint16_t cbSecond;
405	/** Whether it's unassigned memory. */
406	bool fUnassigned;
407	/** Explicit alignment padding. */
408	bool afAlignment5[3];
409	} aMemBbMappings[3];
410
411	/** Bounce buffer storage.
412	* This runs in parallel to aMemMappings and aMemBbMappings. */
413	struct
414	{
415	uint8_t ab[512];
416	} aBounceBuffers[3];
417
418	/** @name Pending Instruction Commit (R0/RC postponed it to Ring-3).
419	* @{ */
420	struct
421	{
422	/** The commit function to call. */
423	IEMCOMMIT enmFn;
424	/** The instruction size. */
425	uint8_t cbInstr;
426	/** Generic value to commit. */
427	uint64_t uValue;
428	} PendingCommit;
429	/** @} */
430
431	/** @name Target CPU information.
432	* @{ */
433	/** The CPU vendor. */
434	CPUMCPUVENDOR enmCpuVendor;
435	/** @} */
436
437	/** @name Host CPU information.
438	* @{ */
439	/** The CPU vendor. */
440	CPUMCPUVENDOR enmHostCpuVendor;
441	/** @} */
442
443	#ifdef IEM_VERIFICATION_MODE_FULL
444	/** The event verification records for what IEM did (LIFO). */
445	R3PTRTYPE(PIEMVERIFYEVTREC) pIemEvtRecHead;
446	/** Insertion point for pIemEvtRecHead. */
447	R3PTRTYPE(PIEMVERIFYEVTREC *) ppIemEvtRecNext;
448	/** The event verification records for what the other party did (FIFO). */
449	R3PTRTYPE(PIEMVERIFYEVTREC) pOtherEvtRecHead;
450	/** Insertion point for pOtherEvtRecHead. */
451	R3PTRTYPE(PIEMVERIFYEVTREC *) ppOtherEvtRecNext;
452	/** List of free event records. */
453	R3PTRTYPE(PIEMVERIFYEVTREC) pFreeEvtRec;
454	#endif
455	} IEMCPU;
456	/** Pointer to the per-CPU IEM state. */
457	typedef IEMCPU *PIEMCPU;
458	/** Pointer to the const per-CPU IEM state. */
459	typedef IEMCPU const *PCIEMCPU;
460
461	/** Converts a IEMCPU pointer to a VMCPU pointer.
462	* @returns VMCPU pointer.
463	* @param a_pIemCpu The IEM per CPU instance data.
464	*/
465	#define IEMCPU_TO_VMCPU(a_pIemCpu) ((PVMCPU)( (uintptr_t)(a_pIemCpu) + a_pIemCpu->offVMCpu ))
466
467	/** Converts a IEMCPU pointer to a VM pointer.
468	* @returns VM pointer.
469	* @param a_pIemCpu The IEM per CPU instance data.
470	*/
471	#define IEMCPU_TO_VM(a_pIemCpu) ((PVM)( (uintptr_t)(a_pIemCpu) + a_pIemCpu->offVM ))
472
473	/** @name IEM_ACCESS_XXX - Access details.
474	* @{ */
475	#define IEM_ACCESS_INVALID UINT32_C(0x000000ff)
476	#define IEM_ACCESS_TYPE_READ UINT32_C(0x00000001)
477	#define IEM_ACCESS_TYPE_WRITE UINT32_C(0x00000002)
478	#define IEM_ACCESS_TYPE_EXEC UINT32_C(0x00000004)
479	#define IEM_ACCESS_TYPE_MASK UINT32_C(0x00000007)
480	#define IEM_ACCESS_WHAT_CODE UINT32_C(0x00000010)
481	#define IEM_ACCESS_WHAT_DATA UINT32_C(0x00000020)
482	#define IEM_ACCESS_WHAT_STACK UINT32_C(0x00000030)
483	#define IEM_ACCESS_WHAT_SYS UINT32_C(0x00000040)
484	#define IEM_ACCESS_WHAT_MASK UINT32_C(0x00000070)
485	/** The writes are partial, so if initialize the bounce buffer with the
486	* orignal RAM content. */
487	#define IEM_ACCESS_PARTIAL_WRITE UINT32_C(0x00000100)
488	/** Used in aMemMappings to indicate that the entry is bounce buffered. */
489	#define IEM_ACCESS_BOUNCE_BUFFERED UINT32_C(0x00000200)
490	/** Read+write data alias. */
491	#define IEM_ACCESS_DATA_RW (IEM_ACCESS_TYPE_READ \| IEM_ACCESS_TYPE_WRITE \| IEM_ACCESS_WHAT_DATA)
492	/** Write data alias. */
493	#define IEM_ACCESS_DATA_W (IEM_ACCESS_TYPE_WRITE \| IEM_ACCESS_WHAT_DATA)
494	/** Read data alias. */
495	#define IEM_ACCESS_DATA_R (IEM_ACCESS_TYPE_READ \| IEM_ACCESS_WHAT_DATA)
496	/** Instruction fetch alias. */
497	#define IEM_ACCESS_INSTRUCTION (IEM_ACCESS_TYPE_EXEC \| IEM_ACCESS_WHAT_CODE)
498	/** Stack write alias. */
499	#define IEM_ACCESS_STACK_W (IEM_ACCESS_TYPE_WRITE \| IEM_ACCESS_WHAT_STACK)
500	/** Stack read alias. */
501	#define IEM_ACCESS_STACK_R (IEM_ACCESS_TYPE_READ \| IEM_ACCESS_WHAT_STACK)
502	/** Stack read+write alias. */
503	#define IEM_ACCESS_STACK_RW (IEM_ACCESS_TYPE_READ \| IEM_ACCESS_TYPE_WRITE \| IEM_ACCESS_WHAT_STACK)
504	/** Read system table alias. */
505	#define IEM_ACCESS_SYS_R (IEM_ACCESS_TYPE_READ \| IEM_ACCESS_WHAT_SYS)
506	/** Read+write system table alias. */
507	#define IEM_ACCESS_SYS_RW (IEM_ACCESS_TYPE_READ \| IEM_ACCESS_TYPE_WRITE \| IEM_ACCESS_WHAT_SYS)
508	/** @} */
509
510	/** @name Prefix constants (IEMCPU::fPrefixes)
511	* @{ */
512	#define IEM_OP_PRF_SEG_CS RT_BIT_32(0) /*< CS segment prefix (0x2e). /
513	#define IEM_OP_PRF_SEG_SS RT_BIT_32(1) /*< SS segment prefix (0x36). /
514	#define IEM_OP_PRF_SEG_DS RT_BIT_32(2) /*< DS segment prefix (0x3e). /
515	#define IEM_OP_PRF_SEG_ES RT_BIT_32(3) /*< ES segment prefix (0x26). /
516	#define IEM_OP_PRF_SEG_FS RT_BIT_32(4) /*< FS segment prefix (0x64). /
517	#define IEM_OP_PRF_SEG_GS RT_BIT_32(5) /*< GS segment prefix (0x65). /
518	#define IEM_OP_PRF_SEG_MASK UINT32_C(0x3f)
519
520	#define IEM_OP_PRF_SIZE_OP RT_BIT_32(8) /*< Operand size prefix (0x66). /
521	#define IEM_OP_PRF_SIZE_REX_W RT_BIT_32(9) /*< REX.W prefix (0x48-0x4f). /
522	#define IEM_OP_PRF_SIZE_ADDR RT_BIT_32(10) /*< Address size prefix (0x67). /
523
524	#define IEM_OP_PRF_LOCK RT_BIT_32(16) /*< Lock prefix (0xf0). /
525	#define IEM_OP_PRF_REPNZ RT_BIT_32(17) /*< Repeat-not-zero prefix (0xf2). /
526	#define IEM_OP_PRF_REPZ RT_BIT_32(18) /*< Repeat-if-zero prefix (0xf3). /
527
528	#define IEM_OP_PRF_REX RT_BIT_32(24) /*< Any REX prefix (0x40-0x4f). /
529	#define IEM_OP_PRF_REX_R RT_BIT_32(25) /*< REX.R prefix (0x44,0x45,0x46,0x47,0x4c,0x4d,0x4e,0x4f). /
530	#define IEM_OP_PRF_REX_B RT_BIT_32(26) /*< REX.B prefix (0x41,0x43,0x45,0x47,0x49,0x4b,0x4d,0x4f). /
531	#define IEM_OP_PRF_REX_X RT_BIT_32(27) /*< REX.X prefix (0x42,0x43,0x46,0x47,0x4a,0x4b,0x4e,0x4f). /
532	/** Mask with all the REX prefix flags.
533	* This is generally for use when needing to undo the REX prefixes when they
534	* are followed legacy prefixes and therefore does not immediately preceed
535	* the first opcode byte.
536	* For testing whether any REX prefix is present, use IEM_OP_PRF_REX instead. */
537	#define IEM_OP_PRF_REX_MASK (IEM_OP_PRF_REX \| IEM_OP_PRF_REX_R \| IEM_OP_PRF_REX_B \| IEM_OP_PRF_REX_X \| IEM_OP_PRF_SIZE_REX_W )
538	/** @} */
539
540	/** @name Opcode forms
541	* @{ */
542	/** ModR/M: reg, r/m */
543	#define IEMOPFORM_RM 0
544	/** ModR/M: reg, r/m (register) */
545	#define IEMOPFORM_RM_REG (IEMOPFORM_RM \| IEMOPFORM_MOD3)
546	/** ModR/M: reg, r/m (memory) */
547	#define IEMOPFORM_RM_MEM (IEMOPFORM_RM \| IEMOPFORM_NOT_MOD3)
548	/** ModR/M: r/m, reg */
549	#define IEMOPFORM_MR 1
550	/** ModR/M: r/m (register), reg */
551	#define IEMOPFORM_MR_REG (IEMOPFORM_MR \| IEMOPFORM_MOD3)
552	/** ModR/M: r/m (memory), reg */
553	#define IEMOPFORM_MR_MEM (IEMOPFORM_MR \| IEMOPFORM_NOT_MOD3)
554	/** ModR/M: r/m only */
555	#define IEMOPFORM_M 2
556	/** ModR/M: r/m only (register). */
557	#define IEMOPFORM_M_REG (IEMOPFORM_M \| IEMOPFORM_MOD3)
558	/** ModR/M: r/m only (memory). */
559	#define IEMOPFORM_M_MEM (IEMOPFORM_M \| IEMOPFORM_NOT_MOD3)
560	/** ModR/M: reg only */
561	#define IEMOPFORM_R 3
562
563	/** Fixed register instruction, no R/M. */
564	#define IEMOPFORM_FIXED 4
565
566	/** The r/m is a register. */
567	#define IEMOPFORM_MOD3 RT_BIT_32(8)
568	/** The r/m is a memory access. */
569	#define IEMOPFORM_NOT_MOD3 RT_BIT_32(9)
570	/** @} */
571
572	/**
573	* Possible hardware task switch sources.
574	*/
575	typedef enum IEMTASKSWITCH
576	{
577	/** Task switch caused by an interrupt/exception. */
578	IEMTASKSWITCH_INT_XCPT = 1,
579	/** Task switch caused by a far CALL. */
580	IEMTASKSWITCH_CALL,
581	/** Task switch caused by a far JMP. */
582	IEMTASKSWITCH_JUMP,
583	/** Task switch caused by an IRET. */
584	IEMTASKSWITCH_IRET
585	} IEMTASKSWITCH;
586	AssertCompileSize(IEMTASKSWITCH, 4);
587
588
589	/**
590	* Tests if verification mode is enabled.
591	*
592	* This expands to @c false when IEM_VERIFICATION_MODE is not defined and
593	* should therefore cause the compiler to eliminate the verification branch
594	* of an if statement. */
595	#ifdef IEM_VERIFICATION_MODE_FULL
596	# define IEM_VERIFICATION_ENABLED(a_pIemCpu) (!(a_pIemCpu)->fNoRem)
597	#elif defined(IEM_VERIFICATION_MODE_MINIMAL)
598	# define IEM_VERIFICATION_ENABLED(a_pIemCpu) (true)
599	#else
600	# define IEM_VERIFICATION_ENABLED(a_pIemCpu) (false)
601	#endif
602
603	/**
604	* Tests if full verification mode is enabled.
605	*
606	* This expands to @c false when IEM_VERIFICATION_MODE_FULL is not defined and
607	* should therefore cause the compiler to eliminate the verification branch
608	* of an if statement. */
609	#ifdef IEM_VERIFICATION_MODE_FULL
610	# define IEM_FULL_VERIFICATION_ENABLED(a_pIemCpu) (!(a_pIemCpu)->fNoRem)
611	#else
612	# define IEM_FULL_VERIFICATION_ENABLED(a_pIemCpu) (false)
613	#endif
614
615	/**
616	* Tests if full verification mode is enabled again REM.
617	*
618	* This expands to @c false when IEM_VERIFICATION_MODE_FULL is not defined and
619	* should therefore cause the compiler to eliminate the verification branch
620	* of an if statement. */
621	#ifdef IEM_VERIFICATION_MODE_FULL
622	# ifdef IEM_VERIFICATION_MODE_FULL_HM
623	# define IEM_FULL_VERIFICATION_REM_ENABLED(a_pIemCpu) (!(a_pIemCpu)->fNoRem && !HMIsEnabled(IEMCPU_TO_VM(a_pIemCpu)))
624	# else
625	# define IEM_FULL_VERIFICATION_REM_ENABLED(a_pIemCpu) (!(a_pIemCpu)->fNoRem)
626	# endif
627	#else
628	# define IEM_FULL_VERIFICATION_REM_ENABLED(a_pIemCpu) (false)
629	#endif
630
631	/** @def IEM_VERIFICATION_MODE
632	* Indicates that one of the verfication modes are enabled.
633	*/
634	#if (defined(IEM_VERIFICATION_MODE_FULL) \|\| defined(IEM_VERIFICATION_MODE_MINIMAL)) && !defined(IEM_VERIFICATION_MODE) \
635	\|\| defined(DOXYGEN_RUNNING)
636	# define IEM_VERIFICATION_MODE
637	#endif
638
639	/**
640	* Indicates to the verifier that the given flag set is undefined.
641	*
642	* Can be invoked again to add more flags.
643	*
644	* This is a NOOP if the verifier isn't compiled in.
645	*/
646	#ifdef IEM_VERIFICATION_MODE_FULL
647	# define IEMOP_VERIFICATION_UNDEFINED_EFLAGS(a_fEfl) do { pIemCpu->fUndefinedEFlags \|= (a_fEfl); } while (0)
648	#else
649	# define IEMOP_VERIFICATION_UNDEFINED_EFLAGS(a_fEfl) do { } while (0)
650	#endif
651
652
653	/** @def IEM_DECL_IMPL_TYPE
654	* For typedef'ing an instruction implementation function.
655	*
656	* @param a_RetType The return type.
657	* @param a_Name The name of the type.
658	* @param a_ArgList The argument list enclosed in parentheses.
659	*/
660
661	/** @def IEM_DECL_IMPL_DEF
662	* For defining an instruction implementation function.
663	*
664	* @param a_RetType The return type.
665	* @param a_Name The name of the type.
666	* @param a_ArgList The argument list enclosed in parentheses.
667	*/
668
669	#if defined(__GNUC__) && defined(RT_ARCH_X86)
670	# define IEM_DECL_IMPL_TYPE(a_RetType, a_Name, a_ArgList) \
671	__attribute__((__fastcall__)) a_RetType (a_Name) a_ArgList
672	# define IEM_DECL_IMPL_DEF(a_RetType, a_Name, a_ArgList) \
673	__attribute__((__fastcall__, __nothrow__)) a_RetType a_Name a_ArgList
674
675	#elif defined(_MSC_VER) && defined(RT_ARCH_X86)
676	# define IEM_DECL_IMPL_TYPE(a_RetType, a_Name, a_ArgList) \
677	a_RetType (__fastcall a_Name) a_ArgList
678	# define IEM_DECL_IMPL_DEF(a_RetType, a_Name, a_ArgList) \
679	a_RetType __fastcall a_Name a_ArgList
680
681	#else
682	# define IEM_DECL_IMPL_TYPE(a_RetType, a_Name, a_ArgList) \
683	a_RetType (VBOXCALL a_Name) a_ArgList
684	# define IEM_DECL_IMPL_DEF(a_RetType, a_Name, a_ArgList) \
685	a_RetType VBOXCALL a_Name a_ArgList
686
687	#endif
688
689	/** @name Arithmetic assignment operations on bytes (binary).
690	* @{ */
691	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLBINU8, (uint8_t pu8Dst, uint8_t u8Src, uint32_t pEFlags));
692	typedef FNIEMAIMPLBINU8 *PFNIEMAIMPLBINU8;
693	FNIEMAIMPLBINU8 iemAImpl_add_u8, iemAImpl_add_u8_locked;
694	FNIEMAIMPLBINU8 iemAImpl_adc_u8, iemAImpl_adc_u8_locked;
695	FNIEMAIMPLBINU8 iemAImpl_sub_u8, iemAImpl_sub_u8_locked;
696	FNIEMAIMPLBINU8 iemAImpl_sbb_u8, iemAImpl_sbb_u8_locked;
697	FNIEMAIMPLBINU8 iemAImpl_or_u8, iemAImpl_or_u8_locked;
698	FNIEMAIMPLBINU8 iemAImpl_xor_u8, iemAImpl_xor_u8_locked;
699	FNIEMAIMPLBINU8 iemAImpl_and_u8, iemAImpl_and_u8_locked;
700	/** @} */
701
702	/** @name Arithmetic assignment operations on words (binary).
703	* @{ */
704	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLBINU16, (uint16_t pu16Dst, uint16_t u16Src, uint32_t pEFlags));
705	typedef FNIEMAIMPLBINU16 *PFNIEMAIMPLBINU16;
706	FNIEMAIMPLBINU16 iemAImpl_add_u16, iemAImpl_add_u16_locked;
707	FNIEMAIMPLBINU16 iemAImpl_adc_u16, iemAImpl_adc_u16_locked;
708	FNIEMAIMPLBINU16 iemAImpl_sub_u16, iemAImpl_sub_u16_locked;
709	FNIEMAIMPLBINU16 iemAImpl_sbb_u16, iemAImpl_sbb_u16_locked;
710	FNIEMAIMPLBINU16 iemAImpl_or_u16, iemAImpl_or_u16_locked;
711	FNIEMAIMPLBINU16 iemAImpl_xor_u16, iemAImpl_xor_u16_locked;
712	FNIEMAIMPLBINU16 iemAImpl_and_u16, iemAImpl_and_u16_locked;
713	/** @} */
714
715	/** @name Arithmetic assignment operations on double words (binary).
716	* @{ */
717	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLBINU32, (uint32_t pu32Dst, uint32_t u32Src, uint32_t pEFlags));
718	typedef FNIEMAIMPLBINU32 *PFNIEMAIMPLBINU32;
719	FNIEMAIMPLBINU32 iemAImpl_add_u32, iemAImpl_add_u32_locked;
720	FNIEMAIMPLBINU32 iemAImpl_adc_u32, iemAImpl_adc_u32_locked;
721	FNIEMAIMPLBINU32 iemAImpl_sub_u32, iemAImpl_sub_u32_locked;
722	FNIEMAIMPLBINU32 iemAImpl_sbb_u32, iemAImpl_sbb_u32_locked;
723	FNIEMAIMPLBINU32 iemAImpl_or_u32, iemAImpl_or_u32_locked;
724	FNIEMAIMPLBINU32 iemAImpl_xor_u32, iemAImpl_xor_u32_locked;
725	FNIEMAIMPLBINU32 iemAImpl_and_u32, iemAImpl_and_u32_locked;
726	/** @} */
727
728	/** @name Arithmetic assignment operations on quad words (binary).
729	* @{ */
730	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLBINU64, (uint64_t pu64Dst, uint64_t u64Src, uint32_t pEFlags));
731	typedef FNIEMAIMPLBINU64 *PFNIEMAIMPLBINU64;
732	FNIEMAIMPLBINU64 iemAImpl_add_u64, iemAImpl_add_u64_locked;
733	FNIEMAIMPLBINU64 iemAImpl_adc_u64, iemAImpl_adc_u64_locked;
734	FNIEMAIMPLBINU64 iemAImpl_sub_u64, iemAImpl_sub_u64_locked;
735	FNIEMAIMPLBINU64 iemAImpl_sbb_u64, iemAImpl_sbb_u64_locked;
736	FNIEMAIMPLBINU64 iemAImpl_or_u64, iemAImpl_or_u64_locked;
737	FNIEMAIMPLBINU64 iemAImpl_xor_u64, iemAImpl_xor_u64_locked;
738	FNIEMAIMPLBINU64 iemAImpl_and_u64, iemAImpl_and_u64_locked;
739	/** @} */
740
741	/** @name Compare operations (thrown in with the binary ops).
742	* @{ */
743	FNIEMAIMPLBINU8 iemAImpl_cmp_u8;
744	FNIEMAIMPLBINU16 iemAImpl_cmp_u16;
745	FNIEMAIMPLBINU32 iemAImpl_cmp_u32;
746	FNIEMAIMPLBINU64 iemAImpl_cmp_u64;
747	/** @} */
748
749	/** @name Test operations (thrown in with the binary ops).
750	* @{ */
751	FNIEMAIMPLBINU8 iemAImpl_test_u8;
752	FNIEMAIMPLBINU16 iemAImpl_test_u16;
753	FNIEMAIMPLBINU32 iemAImpl_test_u32;
754	FNIEMAIMPLBINU64 iemAImpl_test_u64;
755	/** @} */
756
757	/** @name Bit operations operations (thrown in with the binary ops).
758	* @{ */
759	FNIEMAIMPLBINU16 iemAImpl_bt_u16, iemAImpl_bt_u16_locked;
760	FNIEMAIMPLBINU32 iemAImpl_bt_u32, iemAImpl_bt_u32_locked;
761	FNIEMAIMPLBINU64 iemAImpl_bt_u64, iemAImpl_bt_u64_locked;
762	FNIEMAIMPLBINU16 iemAImpl_btc_u16, iemAImpl_btc_u16_locked;
763	FNIEMAIMPLBINU32 iemAImpl_btc_u32, iemAImpl_btc_u32_locked;
764	FNIEMAIMPLBINU64 iemAImpl_btc_u64, iemAImpl_btc_u64_locked;
765	FNIEMAIMPLBINU16 iemAImpl_btr_u16, iemAImpl_btr_u16_locked;
766	FNIEMAIMPLBINU32 iemAImpl_btr_u32, iemAImpl_btr_u32_locked;
767	FNIEMAIMPLBINU64 iemAImpl_btr_u64, iemAImpl_btr_u64_locked;
768	FNIEMAIMPLBINU16 iemAImpl_bts_u16, iemAImpl_bts_u16_locked;
769	FNIEMAIMPLBINU32 iemAImpl_bts_u32, iemAImpl_bts_u32_locked;
770	FNIEMAIMPLBINU64 iemAImpl_bts_u64, iemAImpl_bts_u64_locked;
771	/** @} */
772
773	/** @name Exchange memory with register operations.
774	* @{ */
775	IEM_DECL_IMPL_DEF(void, iemAImpl_xchg_u8, (uint8_t pu8Mem, uint8_t pu8Reg));
776	IEM_DECL_IMPL_DEF(void, iemAImpl_xchg_u16,(uint16_t pu16Mem, uint16_t pu16Reg));
777	IEM_DECL_IMPL_DEF(void, iemAImpl_xchg_u32,(uint32_t pu32Mem, uint32_t pu32Reg));
778	IEM_DECL_IMPL_DEF(void, iemAImpl_xchg_u64,(uint64_t pu64Mem, uint64_t pu64Reg));
779	/** @} */
780
781	/** @name Exchange and add operations.
782	* @{ */
783	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u8, (uint8_t pu8Dst, uint8_t pu8Reg, uint32_t *pEFlags));
784	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u16,(uint16_t pu16Dst, uint16_t pu16Reg, uint32_t *pEFlags));
785	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u32,(uint32_t pu32Dst, uint32_t pu32Reg, uint32_t *pEFlags));
786	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u64,(uint64_t pu64Dst, uint64_t pu64Reg, uint32_t *pEFlags));
787	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u8_locked, (uint8_t pu8Dst, uint8_t pu8Reg, uint32_t *pEFlags));
788	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u16_locked,(uint16_t pu16Dst, uint16_t pu16Reg, uint32_t *pEFlags));
789	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u32_locked,(uint32_t pu32Dst, uint32_t pu32Reg, uint32_t *pEFlags));
790	IEM_DECL_IMPL_DEF(void, iemAImpl_xadd_u64_locked,(uint64_t pu64Dst, uint64_t pu64Reg, uint32_t *pEFlags));
791	/** @} */
792
793	/** @name Compare and exchange.
794	* @{ */
795	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u8, (uint8_t pu8Dst, uint8_t puAl, uint8_t uSrcReg, uint32_t *pEFlags));
796	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u8_locked, (uint8_t pu8Dst, uint8_t puAl, uint8_t uSrcReg, uint32_t *pEFlags));
797	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u16, (uint16_t pu16Dst, uint16_t puAx, uint16_t uSrcReg, uint32_t *pEFlags));
798	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u16_locked,(uint16_t pu16Dst, uint16_t puAx, uint16_t uSrcReg, uint32_t *pEFlags));
799	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u32, (uint32_t pu32Dst, uint32_t puEax, uint32_t uSrcReg, uint32_t *pEFlags));
800	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u32_locked,(uint32_t pu32Dst, uint32_t puEax, uint32_t uSrcReg, uint32_t *pEFlags));
801	#ifdef RT_ARCH_X86
802	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u64, (uint64_t pu64Dst, uint64_t puRax, uint64_t puSrcReg, uint32_t pEFlags));
803	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u64_locked,(uint64_t pu64Dst, uint64_t puRax, uint64_t puSrcReg, uint32_t pEFlags));
804	#else
805	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u64, (uint64_t pu64Dst, uint64_t puRax, uint64_t uSrcReg, uint32_t *pEFlags));
806	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg_u64_locked,(uint64_t pu64Dst, uint64_t puRax, uint64_t uSrcReg, uint32_t *pEFlags));
807	#endif
808	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg8b,(uint64_t *pu64Dst, PRTUINT64U pu64EaxEdx, PRTUINT64U pu64EbxEcx,
809	uint32_t *pEFlags));
810	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg8b_locked,(uint64_t *pu64Dst, PRTUINT64U pu64EaxEdx, PRTUINT64U pu64EbxEcx,
811	uint32_t *pEFlags));
812	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg16b,(PRTUINT128U *pu128Dst, PRTUINT128U pu64RaxRdx, PRTUINT128U pu64RbxRcx,
813	uint32_t *pEFlags));
814	IEM_DECL_IMPL_DEF(void, iemAImpl_cmpxchg16b_locked,(PRTUINT128U *pu128Dst, PRTUINT128U pu64RaxRdx, PRTUINT128U pu64RbxRcx,
815	uint32_t *pEFlags));
816	/** @} */
817
818	/** @name Memory ordering
819	* @{ */
820	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEMFENCE,(void));
821	typedef FNIEMAIMPLMEMFENCE *PFNIEMAIMPLMEMFENCE;
822	IEM_DECL_IMPL_DEF(void, iemAImpl_mfence,(void));
823	IEM_DECL_IMPL_DEF(void, iemAImpl_sfence,(void));
824	IEM_DECL_IMPL_DEF(void, iemAImpl_lfence,(void));
825	IEM_DECL_IMPL_DEF(void, iemAImpl_alt_mem_fence,(void));
826	/** @} */
827
828	/** @name Double precision shifts
829	* @{ */
830	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLSHIFTDBLU16,(uint16_t pu16Dst, uint16_t u16Src, uint8_t cShift, uint32_t pEFlags));
831	typedef FNIEMAIMPLSHIFTDBLU16 *PFNIEMAIMPLSHIFTDBLU16;
832	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLSHIFTDBLU32,(uint32_t pu32Dst, uint32_t u32Src, uint8_t cShift, uint32_t pEFlags));
833	typedef FNIEMAIMPLSHIFTDBLU32 *PFNIEMAIMPLSHIFTDBLU32;
834	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLSHIFTDBLU64,(uint64_t pu64Dst, uint64_t u64Src, uint8_t cShift, uint32_t pEFlags));
835	typedef FNIEMAIMPLSHIFTDBLU64 *PFNIEMAIMPLSHIFTDBLU64;
836	FNIEMAIMPLSHIFTDBLU16 iemAImpl_shld_u16;
837	FNIEMAIMPLSHIFTDBLU32 iemAImpl_shld_u32;
838	FNIEMAIMPLSHIFTDBLU64 iemAImpl_shld_u64;
839	FNIEMAIMPLSHIFTDBLU16 iemAImpl_shrd_u16;
840	FNIEMAIMPLSHIFTDBLU32 iemAImpl_shrd_u32;
841	FNIEMAIMPLSHIFTDBLU64 iemAImpl_shrd_u64;
842	/** @} */
843
844
845	/** @name Bit search operations (thrown in with the binary ops).
846	* @{ */
847	FNIEMAIMPLBINU16 iemAImpl_bsf_u16;
848	FNIEMAIMPLBINU32 iemAImpl_bsf_u32;
849	FNIEMAIMPLBINU64 iemAImpl_bsf_u64;
850	FNIEMAIMPLBINU16 iemAImpl_bsr_u16;
851	FNIEMAIMPLBINU32 iemAImpl_bsr_u32;
852	FNIEMAIMPLBINU64 iemAImpl_bsr_u64;
853	/** @} */
854
855	/** @name Signed multiplication operations (thrown in with the binary ops).
856	* @{ */
857	FNIEMAIMPLBINU16 iemAImpl_imul_two_u16;
858	FNIEMAIMPLBINU32 iemAImpl_imul_two_u32;
859	FNIEMAIMPLBINU64 iemAImpl_imul_two_u64;
860	/** @} */
861
862	/** @name Arithmetic assignment operations on bytes (unary).
863	* @{ */
864	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLUNARYU8, (uint8_t pu8Dst, uint32_t pEFlags));
865	typedef FNIEMAIMPLUNARYU8 *PFNIEMAIMPLUNARYU8;
866	FNIEMAIMPLUNARYU8 iemAImpl_inc_u8, iemAImpl_inc_u8_locked;
867	FNIEMAIMPLUNARYU8 iemAImpl_dec_u8, iemAImpl_dec_u8_locked;
868	FNIEMAIMPLUNARYU8 iemAImpl_not_u8, iemAImpl_not_u8_locked;
869	FNIEMAIMPLUNARYU8 iemAImpl_neg_u8, iemAImpl_neg_u8_locked;
870	/** @} */
871
872	/** @name Arithmetic assignment operations on words (unary).
873	* @{ */
874	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLUNARYU16, (uint16_t pu16Dst, uint32_t pEFlags));
875	typedef FNIEMAIMPLUNARYU16 *PFNIEMAIMPLUNARYU16;
876	FNIEMAIMPLUNARYU16 iemAImpl_inc_u16, iemAImpl_inc_u16_locked;
877	FNIEMAIMPLUNARYU16 iemAImpl_dec_u16, iemAImpl_dec_u16_locked;
878	FNIEMAIMPLUNARYU16 iemAImpl_not_u16, iemAImpl_not_u16_locked;
879	FNIEMAIMPLUNARYU16 iemAImpl_neg_u16, iemAImpl_neg_u16_locked;
880	/** @} */
881
882	/** @name Arithmetic assignment operations on double words (unary).
883	* @{ */
884	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLUNARYU32, (uint32_t pu32Dst, uint32_t pEFlags));
885	typedef FNIEMAIMPLUNARYU32 *PFNIEMAIMPLUNARYU32;
886	FNIEMAIMPLUNARYU32 iemAImpl_inc_u32, iemAImpl_inc_u32_locked;
887	FNIEMAIMPLUNARYU32 iemAImpl_dec_u32, iemAImpl_dec_u32_locked;
888	FNIEMAIMPLUNARYU32 iemAImpl_not_u32, iemAImpl_not_u32_locked;
889	FNIEMAIMPLUNARYU32 iemAImpl_neg_u32, iemAImpl_neg_u32_locked;
890	/** @} */
891
892	/** @name Arithmetic assignment operations on quad words (unary).
893	* @{ */
894	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLUNARYU64, (uint64_t pu64Dst, uint32_t pEFlags));
895	typedef FNIEMAIMPLUNARYU64 *PFNIEMAIMPLUNARYU64;
896	FNIEMAIMPLUNARYU64 iemAImpl_inc_u64, iemAImpl_inc_u64_locked;
897	FNIEMAIMPLUNARYU64 iemAImpl_dec_u64, iemAImpl_dec_u64_locked;
898	FNIEMAIMPLUNARYU64 iemAImpl_not_u64, iemAImpl_not_u64_locked;
899	FNIEMAIMPLUNARYU64 iemAImpl_neg_u64, iemAImpl_neg_u64_locked;
900	/** @} */
901
902
903	/** @name Shift operations on bytes (Group 2).
904	* @{ */
905	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLSHIFTU8,(uint8_t pu8Dst, uint8_t cShift, uint32_t pEFlags));
906	typedef FNIEMAIMPLSHIFTU8 *PFNIEMAIMPLSHIFTU8;
907	FNIEMAIMPLSHIFTU8 iemAImpl_rol_u8;
908	FNIEMAIMPLSHIFTU8 iemAImpl_ror_u8;
909	FNIEMAIMPLSHIFTU8 iemAImpl_rcl_u8;
910	FNIEMAIMPLSHIFTU8 iemAImpl_rcr_u8;
911	FNIEMAIMPLSHIFTU8 iemAImpl_shl_u8;
912	FNIEMAIMPLSHIFTU8 iemAImpl_shr_u8;
913	FNIEMAIMPLSHIFTU8 iemAImpl_sar_u8;
914	/** @} */
915
916	/** @name Shift operations on words (Group 2).
917	* @{ */
918	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLSHIFTU16,(uint16_t pu16Dst, uint8_t cShift, uint32_t pEFlags));
919	typedef FNIEMAIMPLSHIFTU16 *PFNIEMAIMPLSHIFTU16;
920	FNIEMAIMPLSHIFTU16 iemAImpl_rol_u16;
921	FNIEMAIMPLSHIFTU16 iemAImpl_ror_u16;
922	FNIEMAIMPLSHIFTU16 iemAImpl_rcl_u16;
923	FNIEMAIMPLSHIFTU16 iemAImpl_rcr_u16;
924	FNIEMAIMPLSHIFTU16 iemAImpl_shl_u16;
925	FNIEMAIMPLSHIFTU16 iemAImpl_shr_u16;
926	FNIEMAIMPLSHIFTU16 iemAImpl_sar_u16;
927	/** @} */
928
929	/** @name Shift operations on double words (Group 2).
930	* @{ */
931	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLSHIFTU32,(uint32_t pu32Dst, uint8_t cShift, uint32_t pEFlags));
932	typedef FNIEMAIMPLSHIFTU32 *PFNIEMAIMPLSHIFTU32;
933	FNIEMAIMPLSHIFTU32 iemAImpl_rol_u32;
934	FNIEMAIMPLSHIFTU32 iemAImpl_ror_u32;
935	FNIEMAIMPLSHIFTU32 iemAImpl_rcl_u32;
936	FNIEMAIMPLSHIFTU32 iemAImpl_rcr_u32;
937	FNIEMAIMPLSHIFTU32 iemAImpl_shl_u32;
938	FNIEMAIMPLSHIFTU32 iemAImpl_shr_u32;
939	FNIEMAIMPLSHIFTU32 iemAImpl_sar_u32;
940	/** @} */
941
942	/** @name Shift operations on words (Group 2).
943	* @{ */
944	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLSHIFTU64,(uint64_t pu64Dst, uint8_t cShift, uint32_t pEFlags));
945	typedef FNIEMAIMPLSHIFTU64 *PFNIEMAIMPLSHIFTU64;
946	FNIEMAIMPLSHIFTU64 iemAImpl_rol_u64;
947	FNIEMAIMPLSHIFTU64 iemAImpl_ror_u64;
948	FNIEMAIMPLSHIFTU64 iemAImpl_rcl_u64;
949	FNIEMAIMPLSHIFTU64 iemAImpl_rcr_u64;
950	FNIEMAIMPLSHIFTU64 iemAImpl_shl_u64;
951	FNIEMAIMPLSHIFTU64 iemAImpl_shr_u64;
952	FNIEMAIMPLSHIFTU64 iemAImpl_sar_u64;
953	/** @} */
954
955	/** @name Multiplication and division operations.
956	* @{ */
957	typedef IEM_DECL_IMPL_TYPE(int, FNIEMAIMPLMULDIVU8,(uint16_t pu16AX, uint8_t u8FactorDivisor, uint32_t pEFlags));
958	typedef FNIEMAIMPLMULDIVU8 *PFNIEMAIMPLMULDIVU8;
959	FNIEMAIMPLMULDIVU8 iemAImpl_mul_u8, iemAImpl_imul_u8;
960	FNIEMAIMPLMULDIVU8 iemAImpl_div_u8, iemAImpl_idiv_u8;
961
962	typedef IEM_DECL_IMPL_TYPE(int, FNIEMAIMPLMULDIVU16,(uint16_t pu16AX, uint16_t pu16DX, uint16_t u16FactorDivisor, uint32_t *pEFlags));
963	typedef FNIEMAIMPLMULDIVU16 *PFNIEMAIMPLMULDIVU16;
964	FNIEMAIMPLMULDIVU16 iemAImpl_mul_u16, iemAImpl_imul_u16;
965	FNIEMAIMPLMULDIVU16 iemAImpl_div_u16, iemAImpl_idiv_u16;
966
967	typedef IEM_DECL_IMPL_TYPE(int, FNIEMAIMPLMULDIVU32,(uint32_t pu32EAX, uint32_t pu32EDX, uint32_t u32FactorDivisor, uint32_t *pEFlags));
968	typedef FNIEMAIMPLMULDIVU32 *PFNIEMAIMPLMULDIVU32;
969	FNIEMAIMPLMULDIVU32 iemAImpl_mul_u32, iemAImpl_imul_u32;
970	FNIEMAIMPLMULDIVU32 iemAImpl_div_u32, iemAImpl_idiv_u32;
971
972	typedef IEM_DECL_IMPL_TYPE(int, FNIEMAIMPLMULDIVU64,(uint64_t pu64RAX, uint64_t pu64RDX, uint64_t u64FactorDivisor, uint32_t *pEFlags));
973	typedef FNIEMAIMPLMULDIVU64 *PFNIEMAIMPLMULDIVU64;
974	FNIEMAIMPLMULDIVU64 iemAImpl_mul_u64, iemAImpl_imul_u64;
975	FNIEMAIMPLMULDIVU64 iemAImpl_div_u64, iemAImpl_idiv_u64;
976	/** @} */
977
978	/** @name Byte Swap.
979	* @{ */
980	IEM_DECL_IMPL_TYPE(void, iemAImpl_bswap_u16,(uint32_t pu32Dst)); / Yes, 32-bit register access. */
981	IEM_DECL_IMPL_TYPE(void, iemAImpl_bswap_u32,(uint32_t *pu32Dst));
982	IEM_DECL_IMPL_TYPE(void, iemAImpl_bswap_u64,(uint64_t *pu64Dst));
983	/** @} */
984
985	/** @name Misc.
986	* @{ */
987	FNIEMAIMPLBINU16 iemAImpl_arpl;
988	/** @} */
989
990
991	/** @name FPU operations taking a 32-bit float argument
992	* @{ */
993	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR32FSW,(PCX86FXSTATE pFpuState, uint16_t *pFSW,
994	PCRTFLOAT80U pr80Val1, PCRTFLOAT32U pr32Val2));
995	typedef FNIEMAIMPLFPUR32FSW *PFNIEMAIMPLFPUR32FSW;
996
997	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR32,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes,
998	PCRTFLOAT80U pr80Val1, PCRTFLOAT32U pr32Val2));
999	typedef FNIEMAIMPLFPUR32 *PFNIEMAIMPLFPUR32;
1000
1001	FNIEMAIMPLFPUR32FSW iemAImpl_fcom_r80_by_r32;
1002	FNIEMAIMPLFPUR32 iemAImpl_fadd_r80_by_r32;
1003	FNIEMAIMPLFPUR32 iemAImpl_fmul_r80_by_r32;
1004	FNIEMAIMPLFPUR32 iemAImpl_fsub_r80_by_r32;
1005	FNIEMAIMPLFPUR32 iemAImpl_fsubr_r80_by_r32;
1006	FNIEMAIMPLFPUR32 iemAImpl_fdiv_r80_by_r32;
1007	FNIEMAIMPLFPUR32 iemAImpl_fdivr_r80_by_r32;
1008
1009	IEM_DECL_IMPL_DEF(void, iemAImpl_fld_r32_to_r80,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes, PCRTFLOAT32U pr32Val));
1010	IEM_DECL_IMPL_DEF(void, iemAImpl_fst_r80_to_r32,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1011	PRTFLOAT32U pr32Val, PCRTFLOAT80U pr80Val));
1012	/** @} */
1013
1014	/** @name FPU operations taking a 64-bit float argument
1015	* @{ */
1016	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR64,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes,
1017	PCRTFLOAT80U pr80Val1, PCRTFLOAT64U pr64Val2));
1018	typedef FNIEMAIMPLFPUR64 *PFNIEMAIMPLFPUR64;
1019
1020	FNIEMAIMPLFPUR64 iemAImpl_fadd_r80_by_r64;
1021	FNIEMAIMPLFPUR64 iemAImpl_fmul_r80_by_r64;
1022	FNIEMAIMPLFPUR64 iemAImpl_fsub_r80_by_r64;
1023	FNIEMAIMPLFPUR64 iemAImpl_fsubr_r80_by_r64;
1024	FNIEMAIMPLFPUR64 iemAImpl_fdiv_r80_by_r64;
1025	FNIEMAIMPLFPUR64 iemAImpl_fdivr_r80_by_r64;
1026
1027	IEM_DECL_IMPL_DEF(void, iemAImpl_fcom_r80_by_r64,(PCX86FXSTATE pFpuState, uint16_t *pFSW,
1028	PCRTFLOAT80U pr80Val1, PCRTFLOAT64U pr64Val2));
1029	IEM_DECL_IMPL_DEF(void, iemAImpl_fld_r64_to_r80,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes, PCRTFLOAT64U pr64Val));
1030	IEM_DECL_IMPL_DEF(void, iemAImpl_fst_r80_to_r64,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1031	PRTFLOAT64U pr32Val, PCRTFLOAT80U pr80Val));
1032	/** @} */
1033
1034	/** @name FPU operations taking a 80-bit float argument
1035	* @{ */
1036	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR80,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes,
1037	PCRTFLOAT80U pr80Val1, PCRTFLOAT80U pr80Val2));
1038	typedef FNIEMAIMPLFPUR80 *PFNIEMAIMPLFPUR80;
1039	FNIEMAIMPLFPUR80 iemAImpl_fadd_r80_by_r80;
1040	FNIEMAIMPLFPUR80 iemAImpl_fmul_r80_by_r80;
1041	FNIEMAIMPLFPUR80 iemAImpl_fsub_r80_by_r80;
1042	FNIEMAIMPLFPUR80 iemAImpl_fsubr_r80_by_r80;
1043	FNIEMAIMPLFPUR80 iemAImpl_fdiv_r80_by_r80;
1044	FNIEMAIMPLFPUR80 iemAImpl_fdivr_r80_by_r80;
1045	FNIEMAIMPLFPUR80 iemAImpl_fprem_r80_by_r80;
1046	FNIEMAIMPLFPUR80 iemAImpl_fprem1_r80_by_r80;
1047	FNIEMAIMPLFPUR80 iemAImpl_fscale_r80_by_r80;
1048
1049	FNIEMAIMPLFPUR80 iemAImpl_fpatan_r80_by_r80;
1050	FNIEMAIMPLFPUR80 iemAImpl_fyl2xp1_r80_by_r80;
1051
1052	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR80FSW,(PCX86FXSTATE pFpuState, uint16_t *pFSW,
1053	PCRTFLOAT80U pr80Val1, PCRTFLOAT80U pr80Val2));
1054	typedef FNIEMAIMPLFPUR80FSW *PFNIEMAIMPLFPUR80FSW;
1055	FNIEMAIMPLFPUR80FSW iemAImpl_fcom_r80_by_r80;
1056	FNIEMAIMPLFPUR80FSW iemAImpl_fucom_r80_by_r80;
1057
1058	typedef IEM_DECL_IMPL_TYPE(uint32_t, FNIEMAIMPLFPUR80EFL,(PCX86FXSTATE pFpuState, uint16_t *pu16Fsw,
1059	PCRTFLOAT80U pr80Val1, PCRTFLOAT80U pr80Val2));
1060	typedef FNIEMAIMPLFPUR80EFL *PFNIEMAIMPLFPUR80EFL;
1061	FNIEMAIMPLFPUR80EFL iemAImpl_fcomi_r80_by_r80;
1062	FNIEMAIMPLFPUR80EFL iemAImpl_fucomi_r80_by_r80;
1063
1064	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR80UNARY,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes, PCRTFLOAT80U pr80Val));
1065	typedef FNIEMAIMPLFPUR80UNARY *PFNIEMAIMPLFPUR80UNARY;
1066	FNIEMAIMPLFPUR80UNARY iemAImpl_fabs_r80;
1067	FNIEMAIMPLFPUR80UNARY iemAImpl_fchs_r80;
1068	FNIEMAIMPLFPUR80UNARY iemAImpl_f2xm1_r80;
1069	FNIEMAIMPLFPUR80UNARY iemAImpl_fyl2x_r80;
1070	FNIEMAIMPLFPUR80UNARY iemAImpl_fsqrt_r80;
1071	FNIEMAIMPLFPUR80UNARY iemAImpl_frndint_r80;
1072	FNIEMAIMPLFPUR80UNARY iemAImpl_fsin_r80;
1073	FNIEMAIMPLFPUR80UNARY iemAImpl_fcos_r80;
1074
1075	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR80UNARYFSW,(PCX86FXSTATE pFpuState, uint16_t *pu16Fsw, PCRTFLOAT80U pr80Val));
1076	typedef FNIEMAIMPLFPUR80UNARYFSW *PFNIEMAIMPLFPUR80UNARYFSW;
1077	FNIEMAIMPLFPUR80UNARYFSW iemAImpl_ftst_r80;
1078	FNIEMAIMPLFPUR80UNARYFSW iemAImpl_fxam_r80;
1079
1080	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR80LDCONST,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes));
1081	typedef FNIEMAIMPLFPUR80LDCONST *PFNIEMAIMPLFPUR80LDCONST;
1082	FNIEMAIMPLFPUR80LDCONST iemAImpl_fld1;
1083	FNIEMAIMPLFPUR80LDCONST iemAImpl_fldl2t;
1084	FNIEMAIMPLFPUR80LDCONST iemAImpl_fldl2e;
1085	FNIEMAIMPLFPUR80LDCONST iemAImpl_fldpi;
1086	FNIEMAIMPLFPUR80LDCONST iemAImpl_fldlg2;
1087	FNIEMAIMPLFPUR80LDCONST iemAImpl_fldln2;
1088	FNIEMAIMPLFPUR80LDCONST iemAImpl_fldz;
1089
1090	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUR80UNARYTWO,(PCX86FXSTATE pFpuState, PIEMFPURESULTTWO pFpuResTwo,
1091	PCRTFLOAT80U pr80Val));
1092	typedef FNIEMAIMPLFPUR80UNARYTWO *PFNIEMAIMPLFPUR80UNARYTWO;
1093	FNIEMAIMPLFPUR80UNARYTWO iemAImpl_fptan_r80_r80;
1094	FNIEMAIMPLFPUR80UNARYTWO iemAImpl_fxtract_r80_r80;
1095	FNIEMAIMPLFPUR80UNARYTWO iemAImpl_fsincos_r80_r80;
1096
1097	IEM_DECL_IMPL_DEF(void, iemAImpl_fld_r80_from_r80,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes, PCRTFLOAT80U pr80Val));
1098	IEM_DECL_IMPL_DEF(void, iemAImpl_fst_r80_to_r80,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1099	PRTFLOAT80U pr80Dst, PCRTFLOAT80U pr80Src));
1100
1101	/** @} */
1102
1103	/** @name FPU operations taking a 16-bit signed integer argument
1104	* @{ */
1105	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUI16,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes,
1106	PCRTFLOAT80U pr80Val1, int16_t const *pi16Val2));
1107	typedef FNIEMAIMPLFPUI16 *PFNIEMAIMPLFPUI16;
1108
1109	FNIEMAIMPLFPUI16 iemAImpl_fiadd_r80_by_i16;
1110	FNIEMAIMPLFPUI16 iemAImpl_fimul_r80_by_i16;
1111	FNIEMAIMPLFPUI16 iemAImpl_fisub_r80_by_i16;
1112	FNIEMAIMPLFPUI16 iemAImpl_fisubr_r80_by_i16;
1113	FNIEMAIMPLFPUI16 iemAImpl_fidiv_r80_by_i16;
1114	FNIEMAIMPLFPUI16 iemAImpl_fidivr_r80_by_i16;
1115
1116	IEM_DECL_IMPL_DEF(void, iemAImpl_ficom_r80_by_i16,(PCX86FXSTATE pFpuState, uint16_t *pu16Fsw,
1117	PCRTFLOAT80U pr80Val1, int16_t const *pi16Val2));
1118
1119	IEM_DECL_IMPL_DEF(void, iemAImpl_fild_i16_to_r80,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes, int16_t const *pi16Val));
1120	IEM_DECL_IMPL_DEF(void, iemAImpl_fist_r80_to_i16,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1121	int16_t *pi16Val, PCRTFLOAT80U pr80Val));
1122	IEM_DECL_IMPL_DEF(void, iemAImpl_fistt_r80_to_i16,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1123	int16_t *pi16Val, PCRTFLOAT80U pr80Val));
1124	/** @} */
1125
1126	/** @name FPU operations taking a 32-bit signed integer argument
1127	* @{ */
1128	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUI32,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes,
1129	PCRTFLOAT80U pr80Val1, int32_t const *pi32Val2));
1130	typedef FNIEMAIMPLFPUI32 *PFNIEMAIMPLFPUI32;
1131
1132	FNIEMAIMPLFPUI32 iemAImpl_fiadd_r80_by_i32;
1133	FNIEMAIMPLFPUI32 iemAImpl_fimul_r80_by_i32;
1134	FNIEMAIMPLFPUI32 iemAImpl_fisub_r80_by_i32;
1135	FNIEMAIMPLFPUI32 iemAImpl_fisubr_r80_by_i32;
1136	FNIEMAIMPLFPUI32 iemAImpl_fidiv_r80_by_i32;
1137	FNIEMAIMPLFPUI32 iemAImpl_fidivr_r80_by_i32;
1138
1139	IEM_DECL_IMPL_DEF(void, iemAImpl_ficom_r80_by_i32,(PCX86FXSTATE pFpuState, uint16_t *pu16Fsw,
1140	PCRTFLOAT80U pr80Val1, int32_t const *pi32Val2));
1141
1142	IEM_DECL_IMPL_DEF(void, iemAImpl_fild_i32_to_r80,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes, int32_t const *pi32Val));
1143	IEM_DECL_IMPL_DEF(void, iemAImpl_fist_r80_to_i32,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1144	int32_t *pi32Val, PCRTFLOAT80U pr80Val));
1145	IEM_DECL_IMPL_DEF(void, iemAImpl_fistt_r80_to_i32,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1146	int32_t *pi32Val, PCRTFLOAT80U pr80Val));
1147	/** @} */
1148
1149	/** @name FPU operations taking a 64-bit signed integer argument
1150	* @{ */
1151	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLFPUI64,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes,
1152	PCRTFLOAT80U pr80Val1, int64_t const *pi64Val2));
1153	typedef FNIEMAIMPLFPUI64 *PFNIEMAIMPLFPUI64;
1154
1155	FNIEMAIMPLFPUI64 iemAImpl_fiadd_r80_by_i64;
1156	FNIEMAIMPLFPUI64 iemAImpl_fimul_r80_by_i64;
1157	FNIEMAIMPLFPUI64 iemAImpl_fisub_r80_by_i64;
1158	FNIEMAIMPLFPUI64 iemAImpl_fisubr_r80_by_i64;
1159	FNIEMAIMPLFPUI64 iemAImpl_fidiv_r80_by_i64;
1160	FNIEMAIMPLFPUI64 iemAImpl_fidivr_r80_by_i64;
1161
1162	IEM_DECL_IMPL_DEF(void, iemAImpl_ficom_r80_by_i64,(PCX86FXSTATE pFpuState, uint16_t *pu16Fsw,
1163	PCRTFLOAT80U pr80Val1, int64_t const *pi64Val2));
1164
1165	IEM_DECL_IMPL_DEF(void, iemAImpl_fild_i64_to_r80,(PCX86FXSTATE pFpuState, PIEMFPURESULT pFpuRes, int64_t const *pi64Val));
1166	IEM_DECL_IMPL_DEF(void, iemAImpl_fist_r80_to_i64,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1167	int64_t *pi64Val, PCRTFLOAT80U pr80Val));
1168	IEM_DECL_IMPL_DEF(void, iemAImpl_fistt_r80_to_i64,(PCX86FXSTATE pFpuState, uint16_t *pu16FSW,
1169	int64_t *pi32Val, PCRTFLOAT80U pr80Val));
1170	/** @} */
1171
1172
1173	/** Temporary type representing a 256-bit vector register. */
1174	typedef struct {uint64_t au64[4]; } IEMVMM256;
1175	/** Temporary type pointing to a 256-bit vector register. */
1176	typedef IEMVMM256 *PIEMVMM256;
1177	/** Temporary type pointing to a const 256-bit vector register. */
1178	typedef IEMVMM256 *PCIEMVMM256;
1179
1180
1181	/** @name Media (SSE/MMX/AVX) operations: full1 + full2 -> full1.
1182	* @{ */
1183	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEDIAF2U64,(PCX86FXSTATE pFpuState, uint64_t pu64Dst, uint64_t const pu64Src));
1184	typedef FNIEMAIMPLMEDIAF2U64 *PFNIEMAIMPLMEDIAF2U64;
1185	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEDIAF2U128,(PCX86FXSTATE pFpuState, uint128_t pu128Dst, uint128_t const pu128Src));
1186	typedef FNIEMAIMPLMEDIAF2U128 *PFNIEMAIMPLMEDIAF2U128;
1187	FNIEMAIMPLMEDIAF2U64 iemAImpl_pxor_u64, iemAImpl_pcmpeqb_u64, iemAImpl_pcmpeqw_u64, iemAImpl_pcmpeqd_u64;
1188	FNIEMAIMPLMEDIAF2U128 iemAImpl_pxor_u128, iemAImpl_pcmpeqb_u128, iemAImpl_pcmpeqw_u128, iemAImpl_pcmpeqd_u128;
1189	/** @} */
1190
1191	/** @name Media (SSE/MMX/AVX) operations: lowhalf1 + lowhalf1 -> full1.
1192	* @{ */
1193	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEDIAF1L1U64,(PCX86FXSTATE pFpuState, uint64_t pu64Dst, uint32_t const pu32Src));
1194	typedef FNIEMAIMPLMEDIAF1L1U64 *PFNIEMAIMPLMEDIAF1L1U64;
1195	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEDIAF1L1U128,(PCX86FXSTATE pFpuState, uint128_t pu128Dst, uint64_t const pu64Src));
1196	typedef FNIEMAIMPLMEDIAF1L1U128 *PFNIEMAIMPLMEDIAF1L1U128;
1197	FNIEMAIMPLMEDIAF1L1U64 iemAImpl_punpcklbw_u64, iemAImpl_punpcklwd_u64, iemAImpl_punpckldq_u64;
1198	FNIEMAIMPLMEDIAF1L1U128 iemAImpl_punpcklbw_u128, iemAImpl_punpcklwd_u128, iemAImpl_punpckldq_u128, iemAImpl_punpcklqdq_u128;
1199	/** @} */
1200
1201	/** @name Media (SSE/MMX/AVX) operations: hihalf1 + hihalf2 -> full1.
1202	* @{ */
1203	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEDIAF1H1U64,(PCX86FXSTATE pFpuState, uint64_t pu64Dst, uint64_t const pu64Src));
1204	typedef FNIEMAIMPLMEDIAF2U64 *PFNIEMAIMPLMEDIAF1H1U64;
1205	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEDIAF1H1U128,(PCX86FXSTATE pFpuState, uint128_t pu128Dst, uint128_t const pu128Src));
1206	typedef FNIEMAIMPLMEDIAF2U128 *PFNIEMAIMPLMEDIAF1H1U128;
1207	FNIEMAIMPLMEDIAF1H1U64 iemAImpl_punpckhbw_u64, iemAImpl_punpckhwd_u64, iemAImpl_punpckhdq_u64;
1208	FNIEMAIMPLMEDIAF1H1U128 iemAImpl_punpckhbw_u128, iemAImpl_punpckhwd_u128, iemAImpl_punpckhdq_u128, iemAImpl_punpckhqdq_u128;
1209	/** @} */
1210
1211	/** @name Media (SSE/MMX/AVX) operation: Packed Shuffle Stuff (evil)
1212	* @{ */
1213	typedef IEM_DECL_IMPL_TYPE(void, FNIEMAIMPLMEDIAPSHUF,(PCX86FXSTATE pFpuState, uint128_t *pu128Dst,
1214	uint128_t const *pu128Src, uint8_t bEvil));
1215	typedef FNIEMAIMPLMEDIAPSHUF *PFNIEMAIMPLMEDIAPSHUF;
1216	FNIEMAIMPLMEDIAPSHUF iemAImpl_pshufhw, iemAImpl_pshuflw, iemAImpl_pshufd;
1217	IEM_DECL_IMPL_DEF(void, iemAImpl_pshufw,(PCX86FXSTATE pFpuState, uint64_t pu64Dst, uint64_t const pu64Src, uint8_t bEvil));
1218	/** @} */
1219
1220	/** @name Media (SSE/MMX/AVX) operation: Move Byte Mask
1221	* @{ */
1222	IEM_DECL_IMPL_DEF(void, iemAImpl_pmovmskb_u64,(PCX86FXSTATE pFpuState, uint64_t pu64Dst, uint64_t const pu64Src));
1223	IEM_DECL_IMPL_DEF(void, iemAImpl_pmovmskb_u128,(PCX86FXSTATE pFpuState, uint64_t pu64Dst, uint128_t const pu128Src));
1224	/** @} */
1225
1226
1227
1228	/** @name Function tables.
1229	* @{
1230	*/
1231
1232	/**
1233	* Function table for a binary operator providing implementation based on
1234	* operand size.
1235	*/
1236	typedef struct IEMOPBINSIZES
1237	{
1238	PFNIEMAIMPLBINU8 pfnNormalU8, pfnLockedU8;
1239	PFNIEMAIMPLBINU16 pfnNormalU16, pfnLockedU16;
1240	PFNIEMAIMPLBINU32 pfnNormalU32, pfnLockedU32;
1241	PFNIEMAIMPLBINU64 pfnNormalU64, pfnLockedU64;
1242	} IEMOPBINSIZES;
1243	/** Pointer to a binary operator function table. */
1244	typedef IEMOPBINSIZES const *PCIEMOPBINSIZES;
1245
1246
1247	/**
1248	* Function table for a unary operator providing implementation based on
1249	* operand size.
1250	*/
1251	typedef struct IEMOPUNARYSIZES
1252	{
1253	PFNIEMAIMPLUNARYU8 pfnNormalU8, pfnLockedU8;
1254	PFNIEMAIMPLUNARYU16 pfnNormalU16, pfnLockedU16;
1255	PFNIEMAIMPLUNARYU32 pfnNormalU32, pfnLockedU32;
1256	PFNIEMAIMPLUNARYU64 pfnNormalU64, pfnLockedU64;
1257	} IEMOPUNARYSIZES;
1258	/** Pointer to a unary operator function table. */
1259	typedef IEMOPUNARYSIZES const *PCIEMOPUNARYSIZES;
1260
1261
1262	/**
1263	* Function table for a shift operator providing implementation based on
1264	* operand size.
1265	*/
1266	typedef struct IEMOPSHIFTSIZES
1267	{
1268	PFNIEMAIMPLSHIFTU8 pfnNormalU8;
1269	PFNIEMAIMPLSHIFTU16 pfnNormalU16;
1270	PFNIEMAIMPLSHIFTU32 pfnNormalU32;
1271	PFNIEMAIMPLSHIFTU64 pfnNormalU64;
1272	} IEMOPSHIFTSIZES;
1273	/** Pointer to a shift operator function table. */
1274	typedef IEMOPSHIFTSIZES const *PCIEMOPSHIFTSIZES;
1275
1276
1277	/**
1278	* Function table for a multiplication or division operation.
1279	*/
1280	typedef struct IEMOPMULDIVSIZES
1281	{
1282	PFNIEMAIMPLMULDIVU8 pfnU8;
1283	PFNIEMAIMPLMULDIVU16 pfnU16;
1284	PFNIEMAIMPLMULDIVU32 pfnU32;
1285	PFNIEMAIMPLMULDIVU64 pfnU64;
1286	} IEMOPMULDIVSIZES;
1287	/** Pointer to a multiplication or division operation function table. */
1288	typedef IEMOPMULDIVSIZES const *PCIEMOPMULDIVSIZES;
1289
1290
1291	/**
1292	* Function table for a double precision shift operator providing implementation
1293	* based on operand size.
1294	*/
1295	typedef struct IEMOPSHIFTDBLSIZES
1296	{
1297	PFNIEMAIMPLSHIFTDBLU16 pfnNormalU16;
1298	PFNIEMAIMPLSHIFTDBLU32 pfnNormalU32;
1299	PFNIEMAIMPLSHIFTDBLU64 pfnNormalU64;
1300	} IEMOPSHIFTDBLSIZES;
1301	/** Pointer to a double precision shift function table. */
1302	typedef IEMOPSHIFTDBLSIZES const *PCIEMOPSHIFTDBLSIZES;
1303
1304
1305	/**
1306	* Function table for media instruction taking two full sized media registers,
1307	* optionally the 2nd being a memory reference (only modifying the first op.)
1308	*/
1309	typedef struct IEMOPMEDIAF2
1310	{
1311	PFNIEMAIMPLMEDIAF2U64 pfnU64;
1312	PFNIEMAIMPLMEDIAF2U128 pfnU128;
1313	} IEMOPMEDIAF2;
1314	/** Pointer to a media operation function table for full sized ops. */
1315	typedef IEMOPMEDIAF2 const *PCIEMOPMEDIAF2;
1316
1317	/**
1318	* Function table for media instruction taking taking one full and one lower
1319	* half media register.
1320	*/
1321	typedef struct IEMOPMEDIAF1L1
1322	{
1323	PFNIEMAIMPLMEDIAF1L1U64 pfnU64;
1324	PFNIEMAIMPLMEDIAF1L1U128 pfnU128;
1325	} IEMOPMEDIAF1L1;
1326	/** Pointer to a media operation function table for lowhalf+lowhalf -> full. */
1327	typedef IEMOPMEDIAF1L1 const *PCIEMOPMEDIAF1L1;
1328
1329	/**
1330	* Function table for media instruction taking taking one full and one high half
1331	* media register.
1332	*/
1333	typedef struct IEMOPMEDIAF1H1
1334	{
1335	PFNIEMAIMPLMEDIAF1H1U64 pfnU64;
1336	PFNIEMAIMPLMEDIAF1H1U128 pfnU128;
1337	} IEMOPMEDIAF1H1;
1338	/** Pointer to a media operation function table for hihalf+hihalf -> full. */
1339	typedef IEMOPMEDIAF1H1 const *PCIEMOPMEDIAF1H1;
1340
1341
1342	/** @} */
1343
1344
1345	/** @name C instruction implementations for anything slightly complicated.
1346	* @{ */
1347
1348	/**
1349	* For typedef'ing or declaring a C instruction implementation function taking
1350	* no extra arguments.
1351	*
1352	* @param a_Name The name of the type.
1353	*/
1354	# define IEM_CIMPL_DECL_TYPE_0(a_Name) \
1355	IEM_DECL_IMPL_TYPE(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr))
1356	/**
1357	* For defining a C instruction implementation function taking no extra
1358	* arguments.
1359	*
1360	* @param a_Name The name of the function
1361	*/
1362	# define IEM_CIMPL_DEF_0(a_Name) \
1363	IEM_DECL_IMPL_DEF(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr))
1364	/**
1365	* For calling a C instruction implementation function taking no extra
1366	* arguments.
1367	*
1368	* This special call macro adds default arguments to the call and allow us to
1369	* change these later.
1370	*
1371	* @param a_fn The name of the function.
1372	*/
1373	# define IEM_CIMPL_CALL_0(a_fn) a_fn(pIemCpu, cbInstr)
1374
1375	/**
1376	* For typedef'ing or declaring a C instruction implementation function taking
1377	* one extra argument.
1378	*
1379	* @param a_Name The name of the type.
1380	* @param a_Type0 The argument type.
1381	* @param a_Arg0 The argument name.
1382	*/
1383	# define IEM_CIMPL_DECL_TYPE_1(a_Name, a_Type0, a_Arg0) \
1384	IEM_DECL_IMPL_TYPE(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0))
1385	/**
1386	* For defining a C instruction implementation function taking one extra
1387	* argument.
1388	*
1389	* @param a_Name The name of the function
1390	* @param a_Type0 The argument type.
1391	* @param a_Arg0 The argument name.
1392	*/
1393	# define IEM_CIMPL_DEF_1(a_Name, a_Type0, a_Arg0) \
1394	IEM_DECL_IMPL_DEF(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0))
1395	/**
1396	* For calling a C instruction implementation function taking one extra
1397	* argument.
1398	*
1399	* This special call macro adds default arguments to the call and allow us to
1400	* change these later.
1401	*
1402	* @param a_fn The name of the function.
1403	* @param a0 The name of the 1st argument.
1404	*/
1405	# define IEM_CIMPL_CALL_1(a_fn, a0) a_fn(pIemCpu, cbInstr, (a0))
1406
1407	/**
1408	* For typedef'ing or declaring a C instruction implementation function taking
1409	* two extra arguments.
1410	*
1411	* @param a_Name The name of the type.
1412	* @param a_Type0 The type of the 1st argument
1413	* @param a_Arg0 The name of the 1st argument.
1414	* @param a_Type1 The type of the 2nd argument.
1415	* @param a_Arg1 The name of the 2nd argument.
1416	*/
1417	# define IEM_CIMPL_DECL_TYPE_2(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1) \
1418	IEM_DECL_IMPL_TYPE(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0, a_Type1 a_Arg1))
1419	/**
1420	* For defining a C instruction implementation function taking two extra
1421	* arguments.
1422	*
1423	* @param a_Name The name of the function.
1424	* @param a_Type0 The type of the 1st argument
1425	* @param a_Arg0 The name of the 1st argument.
1426	* @param a_Type1 The type of the 2nd argument.
1427	* @param a_Arg1 The name of the 2nd argument.
1428	*/
1429	# define IEM_CIMPL_DEF_2(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1) \
1430	IEM_DECL_IMPL_DEF(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0, a_Type1 a_Arg1))
1431	/**
1432	* For calling a C instruction implementation function taking two extra
1433	* arguments.
1434	*
1435	* This special call macro adds default arguments to the call and allow us to
1436	* change these later.
1437	*
1438	* @param a_fn The name of the function.
1439	* @param a0 The name of the 1st argument.
1440	* @param a1 The name of the 2nd argument.
1441	*/
1442	# define IEM_CIMPL_CALL_2(a_fn, a0, a1) a_fn(pIemCpu, cbInstr, (a0), (a1))
1443
1444	/**
1445	* For typedef'ing or declaring a C instruction implementation function taking
1446	* three extra arguments.
1447	*
1448	* @param a_Name The name of the type.
1449	* @param a_Type0 The type of the 1st argument
1450	* @param a_Arg0 The name of the 1st argument.
1451	* @param a_Type1 The type of the 2nd argument.
1452	* @param a_Arg1 The name of the 2nd argument.
1453	* @param a_Type2 The type of the 3rd argument.
1454	* @param a_Arg2 The name of the 3rd argument.
1455	*/
1456	# define IEM_CIMPL_DECL_TYPE_3(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1, a_Type2, a_Arg2) \
1457	IEM_DECL_IMPL_TYPE(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0, a_Type1 a_Arg1, a_Type2 a_Arg2))
1458	/**
1459	* For defining a C instruction implementation function taking three extra
1460	* arguments.
1461	*
1462	* @param a_Name The name of the function.
1463	* @param a_Type0 The type of the 1st argument
1464	* @param a_Arg0 The name of the 1st argument.
1465	* @param a_Type1 The type of the 2nd argument.
1466	* @param a_Arg1 The name of the 2nd argument.
1467	* @param a_Type2 The type of the 3rd argument.
1468	* @param a_Arg2 The name of the 3rd argument.
1469	*/
1470	# define IEM_CIMPL_DEF_3(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1, a_Type2, a_Arg2) \
1471	IEM_DECL_IMPL_DEF(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0, a_Type1 a_Arg1, a_Type2 a_Arg2))
1472	/**
1473	* For calling a C instruction implementation function taking three extra
1474	* arguments.
1475	*
1476	* This special call macro adds default arguments to the call and allow us to
1477	* change these later.
1478	*
1479	* @param a_fn The name of the function.
1480	* @param a0 The name of the 1st argument.
1481	* @param a1 The name of the 2nd argument.
1482	* @param a2 The name of the 3rd argument.
1483	*/
1484	# define IEM_CIMPL_CALL_3(a_fn, a0, a1, a2) a_fn(pIemCpu, cbInstr, (a0), (a1), (a2))
1485
1486
1487	/**
1488	* For typedef'ing or declaring a C instruction implementation function taking
1489	* four extra arguments.
1490	*
1491	* @param a_Name The name of the type.
1492	* @param a_Type0 The type of the 1st argument
1493	* @param a_Arg0 The name of the 1st argument.
1494	* @param a_Type1 The type of the 2nd argument.
1495	* @param a_Arg1 The name of the 2nd argument.
1496	* @param a_Type2 The type of the 3rd argument.
1497	* @param a_Arg2 The name of the 3rd argument.
1498	* @param a_Type3 The type of the 4th argument.
1499	* @param a_Arg3 The name of the 4th argument.
1500	*/
1501	# define IEM_CIMPL_DECL_TYPE_4(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1, a_Type2, a_Arg2, a_Type3, a_Arg3) \
1502	IEM_DECL_IMPL_TYPE(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0, a_Type1 a_Arg1, a_Type2 a_Arg2, a_Type3 a_Arg3))
1503	/**
1504	* For defining a C instruction implementation function taking four extra
1505	* arguments.
1506	*
1507	* @param a_Name The name of the function.
1508	* @param a_Type0 The type of the 1st argument
1509	* @param a_Arg0 The name of the 1st argument.
1510	* @param a_Type1 The type of the 2nd argument.
1511	* @param a_Arg1 The name of the 2nd argument.
1512	* @param a_Type2 The type of the 3rd argument.
1513	* @param a_Arg2 The name of the 3rd argument.
1514	* @param a_Type3 The type of the 4th argument.
1515	* @param a_Arg3 The name of the 4th argument.
1516	*/
1517	# define IEM_CIMPL_DEF_4(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1, a_Type2, a_Arg2, a_Type3, a_Arg3) \
1518	IEM_DECL_IMPL_DEF(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, a_Type0 a_Arg0, a_Type1 a_Arg1, \
1519	a_Type2 a_Arg2, a_Type3 a_Arg3))
1520	/**
1521	* For calling a C instruction implementation function taking four extra
1522	* arguments.
1523	*
1524	* This special call macro adds default arguments to the call and allow us to
1525	* change these later.
1526	*
1527	* @param a_fn The name of the function.
1528	* @param a0 The name of the 1st argument.
1529	* @param a1 The name of the 2nd argument.
1530	* @param a2 The name of the 3rd argument.
1531	* @param a3 The name of the 4th argument.
1532	*/
1533	# define IEM_CIMPL_CALL_4(a_fn, a0, a1, a2, a3) a_fn(pIemCpu, cbInstr, (a0), (a1), (a2), (a3))
1534
1535
1536	/**
1537	* For typedef'ing or declaring a C instruction implementation function taking
1538	* five extra arguments.
1539	*
1540	* @param a_Name The name of the type.
1541	* @param a_Type0 The type of the 1st argument
1542	* @param a_Arg0 The name of the 1st argument.
1543	* @param a_Type1 The type of the 2nd argument.
1544	* @param a_Arg1 The name of the 2nd argument.
1545	* @param a_Type2 The type of the 3rd argument.
1546	* @param a_Arg2 The name of the 3rd argument.
1547	* @param a_Type3 The type of the 4th argument.
1548	* @param a_Arg3 The name of the 4th argument.
1549	* @param a_Type4 The type of the 5th argument.
1550	* @param a_Arg4 The name of the 5th argument.
1551	*/
1552	# define IEM_CIMPL_DECL_TYPE_5(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1, a_Type2, a_Arg2, a_Type3, a_Arg3, a_Type4, a_Arg4) \
1553	IEM_DECL_IMPL_TYPE(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, \
1554	a_Type0 a_Arg0, a_Type1 a_Arg1, a_Type2 a_Arg2, \
1555	a_Type3 a_Arg3, a_Type4 a_Arg4))
1556	/**
1557	* For defining a C instruction implementation function taking five extra
1558	* arguments.
1559	*
1560	* @param a_Name The name of the function.
1561	* @param a_Type0 The type of the 1st argument
1562	* @param a_Arg0 The name of the 1st argument.
1563	* @param a_Type1 The type of the 2nd argument.
1564	* @param a_Arg1 The name of the 2nd argument.
1565	* @param a_Type2 The type of the 3rd argument.
1566	* @param a_Arg2 The name of the 3rd argument.
1567	* @param a_Type3 The type of the 4th argument.
1568	* @param a_Arg3 The name of the 4th argument.
1569	* @param a_Type4 The type of the 5th argument.
1570	* @param a_Arg4 The name of the 5th argument.
1571	*/
1572	# define IEM_CIMPL_DEF_5(a_Name, a_Type0, a_Arg0, a_Type1, a_Arg1, a_Type2, a_Arg2, a_Type3, a_Arg3, a_Type4, a_Arg4) \
1573	IEM_DECL_IMPL_DEF(VBOXSTRICTRC, a_Name, (PIEMCPU pIemCpu, uint8_t cbInstr, \
1574	a_Type0 a_Arg0, a_Type1 a_Arg1, a_Type2 a_Arg2, \
1575	a_Type3 a_Arg3, a_Type4 a_Arg4))
1576	/**
1577	* For calling a C instruction implementation function taking five extra
1578	* arguments.
1579	*
1580	* This special call macro adds default arguments to the call and allow us to
1581	* change these later.
1582	*
1583	* @param a_fn The name of the function.
1584	* @param a0 The name of the 1st argument.
1585	* @param a1 The name of the 2nd argument.
1586	* @param a2 The name of the 3rd argument.
1587	* @param a3 The name of the 4th argument.
1588	* @param a4 The name of the 5th argument.
1589	*/
1590	# define IEM_CIMPL_CALL_5(a_fn, a0, a1, a2, a3, a4) a_fn(pIemCpu, cbInstr, (a0), (a1), (a2), (a3), (a4))
1591
1592	/** @} */
1593
1594
1595	/** @} */
1596
1597	RT_C_DECLS_END
1598
1599	#endif
1600

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/VMM/include/IEMInternal.h@ 58944

Download in other formats: