[deliverable/linux.git] / arch / x86 / include / asm / lguest_hcall.h

/* Architecture specific portion of the lguest hypercalls */
#ifndef _ASM_X86_LGUEST_HCALL_H
#define _ASM_X86_LGUEST_HCALL_H

#define LHCALL_FLUSH_ASYNC	0
#define LHCALL_LGUEST_INIT	1
#define LHCALL_SHUTDOWN		2
#define LHCALL_NEW_PGTABLE	4
#define LHCALL_FLUSH_TLB	5
#define LHCALL_LOAD_IDT_ENTRY	6
#define LHCALL_SET_STACK	7
#define LHCALL_TS		8
#define LHCALL_SET_CLOCKEVENT	9
#define LHCALL_HALT		10
#define LHCALL_SET_PMD		13
#define LHCALL_SET_PTE		14
#define LHCALL_SET_PGD		15
#define LHCALL_LOAD_TLS		16
#define LHCALL_LOAD_GDT_ENTRY	18
#define LHCALL_SEND_INTERRUPTS	19

#define LGUEST_TRAP_ENTRY 0x1F

/* Argument number 3 to LHCALL_LGUEST_SHUTDOWN */
#define LGUEST_SHUTDOWN_POWEROFF	1
#define LGUEST_SHUTDOWN_RESTART		2

#ifndef __ASSEMBLY__
#include <asm/hw_irq.h>

/*G:030
 * But first, how does our Guest contact the Host to ask for privileged
 * operations?  There are two ways: the direct way is to make a "hypercall",
 * to make requests of the Host Itself.
 *
 * Our hypercall mechanism uses the highest unused trap code (traps 32 and
 * above are used by real hardware interrupts).  Seventeen hypercalls are
 * available: the hypercall number is put in the %eax register, and the
 * arguments (when required) are placed in %ebx, %ecx, %edx and %esi.
 * If a return value makes sense, it's returned in %eax.
 *
 * Grossly invalid calls result in Sudden Death at the hands of the vengeful
 * Host, rather than returning failure.  This reflects Winston Churchill's
 * definition of a gentleman: "someone who is only rude intentionally".
 */
static inline unsigned long
hcall(unsigned long call,
      unsigned long arg1, unsigned long arg2, unsigned long arg3,
      unsigned long arg4)
{
	/* "int" is the Intel instruction to trigger a trap. */
	asm volatile("int $" __stringify(LGUEST_TRAP_ENTRY)
		     /* The call in %eax (aka "a") might be overwritten */
		     : "=a"(call)
		       /* The arguments are in %eax, %ebx, %ecx, %edx & %esi */
		     : "a"(call), "b"(arg1), "c"(arg2), "d"(arg3), "S"(arg4)
		       /* "memory" means this might write somewhere in memory.
			* This isn't true for all calls, but it's safe to tell
			* gcc that it might happen so it doesn't get clever. */
		     : "memory");
	return call;
}
/*:*/

/* Can't use our min() macro here: needs to be a constant */
#define LGUEST_IRQS (NR_IRQS < 32 ? NR_IRQS: 32)

#define LHCALL_RING_SIZE 64
struct hcall_args {
	/* These map directly onto eax/ebx/ecx/edx/esi in struct lguest_regs */
	unsigned long arg0, arg1, arg2, arg3, arg4;
};

#endif /* !__ASSEMBLY__ */
#endif /* _ASM_X86_LGUEST_HCALL_H */
Commit	Line	Data
c37ae93d	1	/* Architecture specific portion of the lguest hypercalls */
1965aae3 PA	2	#ifndef _ASM_X86_LGUEST_HCALL_H
1965aae3 PA	3	#define _ASM_X86_LGUEST_HCALL_H
c37ae93d JS	4
	5	#define LHCALL_FLUSH_ASYNC 0
	6	#define LHCALL_LGUEST_INIT 1
ec04b13f	7	#define LHCALL_SHUTDOWN 2
c37ae93d JS	8	#define LHCALL_NEW_PGTABLE 4
	9	#define LHCALL_FLUSH_TLB 5
	10	#define LHCALL_LOAD_IDT_ENTRY 6
	11	#define LHCALL_SET_STACK 7
	12	#define LHCALL_TS 8
	13	#define LHCALL_SET_CLOCKEVENT 9
	14	#define LHCALL_HALT 10
acdd0b62	15	#define LHCALL_SET_PMD 13
c37ae93d	16	#define LHCALL_SET_PTE 14
ebe0ba84	17	#define LHCALL_SET_PGD 15
c37ae93d	18	#define LHCALL_LOAD_TLS 16
a489f0b5	19	#define LHCALL_LOAD_GDT_ENTRY 18
a32a8813	20	#define LHCALL_SEND_INTERRUPTS 19
c37ae93d	21
e1e72965 RR	22	#define LGUEST_TRAP_ENTRY 0x1F
e1e72965 RR	23
ec04b13f BR	24	/* Argument number 3 to LHCALL_LGUEST_SHUTDOWN */
	25	#define LGUEST_SHUTDOWN_POWEROFF 1
	26	#define LGUEST_SHUTDOWN_RESTART 2
	27
e1e72965 RR	28	#ifndef __ASSEMBLY__
	29	#include <asm/hw_irq.h>
	30
2e04ef76 RR	31	/*G:030
2e04ef76 RR	32	* But first, how does our Guest contact the Host to ask for privileged
c37ae93d JS	33	* operations? There are two ways: the direct way is to make a "hypercall",
	34	* to make requests of the Host Itself.
	35	*
091ebf07 RR	36	* Our hypercall mechanism uses the highest unused trap code (traps 32 and
	37	* above are used by real hardware interrupts). Seventeen hypercalls are
	38	* available: the hypercall number is put in the %eax register, and the
	39	* arguments (when required) are placed in %ebx, %ecx, %edx and %esi.
	40	* If a return value makes sense, it's returned in %eax.
c37ae93d JS	41	*
	42	* Grossly invalid calls result in Sudden Death at the hands of the vengeful
	43	* Host, rather than returning failure. This reflects Winston Churchill's
2e04ef76	44	* definition of a gentleman: "someone who is only rude intentionally".
091ebf07 RR	45	*/
	46	static inline unsigned long
	47	hcall(unsigned long call,
	48	unsigned long arg1, unsigned long arg2, unsigned long arg3,
	49	unsigned long arg4)
	50	{
	51	/* "int" is the Intel instruction to trigger a trap. */
	52	asm volatile("int $" __stringify(LGUEST_TRAP_ENTRY)
	53	/* The call in %eax (aka "a") might be overwritten */
	54	: "=a"(call)
	55	/* The arguments are in %eax, %ebx, %ecx, %edx & %esi */
	56	: "a"(call), "b"(arg1), "c"(arg2), "d"(arg3), "S"(arg4)
	57	/* "memory" means this might write somewhere in memory.
	58	* This isn't true for all calls, but it's safe to tell
	59	* gcc that it might happen so it doesn't get clever. */
	60	: "memory");
	61	return call;
	62	}
9f54288d	63	/:/
c37ae93d	64
c37ae93d JS	65	/* Can't use our min() macro here: needs to be a constant */
	66	#define LGUEST_IRQS (NR_IRQS < 32 ? NR_IRQS: 32)
	67
	68	#define LHCALL_RING_SIZE 64
fd1ea0c2	69	struct hcall_args {
2e04ef76	70	/* These map directly onto eax/ebx/ecx/edx/esi in struct lguest_regs */
cefcad17	71	unsigned long arg0, arg1, arg2, arg3, arg4;
c37ae93d	72	};
47436aa4 RR	73
47436aa4 RR	74	#endif /* !__ASSEMBLY__ */
1965aae3	75	#endif /* _ASM_X86_LGUEST_HCALL_H */