src/include/thunks.h

/*
 *  thunks.h - Thunks to share data and code with MacOS
 *
 *  SheepShaver (C) 1997-2008 Christian Bauer and Marc Hellwig
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#ifndef THUNKS_H
#define THUNKS_H

#include "cpu_emulation.h"

/*
 *  Native function invocation
 */

enum {
  NATIVE_PATCH_NAME_REGISTRY,
  NATIVE_VIDEO_INSTALL_ACCEL,
  NATIVE_VIDEO_VBL,
  NATIVE_VIDEO_DO_DRIVER_IO,
  NATIVE_ETHER_AO_GET_HWADDR,
  NATIVE_ETHER_AO_ADD_MULTI,
  NATIVE_ETHER_AO_DEL_MULTI,
  NATIVE_ETHER_AO_SEND_PACKET,
  NATIVE_ETHER_IRQ,
  NATIVE_ETHER_INIT,
  NATIVE_ETHER_TERM,
  NATIVE_ETHER_OPEN,
  NATIVE_ETHER_CLOSE,
  NATIVE_ETHER_WPUT,
  NATIVE_ETHER_RSRV,
  NATIVE_SERIAL_NOTHING,
  NATIVE_SERIAL_OPEN,
  NATIVE_SERIAL_PRIME_IN,
  NATIVE_SERIAL_PRIME_OUT,
  NATIVE_SERIAL_CONTROL,
  NATIVE_SERIAL_STATUS,
  NATIVE_SERIAL_CLOSE,
  NATIVE_GET_RESOURCE,
  NATIVE_GET_1_RESOURCE,
  NATIVE_GET_IND_RESOURCE,
  NATIVE_GET_1_IND_RESOURCE,
  NATIVE_R_GET_RESOURCE,
  NATIVE_MAKE_EXECUTABLE,
  NATIVE_CHECK_LOAD_INVOC,
  NATIVE_NQD_SYNC_HOOK,
  NATIVE_NQD_BITBLT_HOOK,
  NATIVE_NQD_FILLRECT_HOOK,
  NATIVE_NQD_UNKNOWN_HOOK,
  NATIVE_NQD_BITBLT,
  NATIVE_NQD_INVRECT,
  NATIVE_NQD_FILLRECT,
  NATIVE_NAMED_CHECK_LOAD_INVOC,
  NATIVE_GET_NAMED_RESOURCE,
  NATIVE_GET_1_NAMED_RESOURCE,
  NATIVE_OP_MAX
};

// Initialize the thunks system
extern bool ThunksInit(void);

// Exit the thunks system
extern void ThunksExit(void);

// Return the fake PowerPC opcode to handle specified native code
#if EMULATED_PPC
extern uint32 NativeOpcode(int selector);
#endif

// Return the native function descriptor (TVECT)
extern uint32 NativeTVECT(int selector);

// Return the native function address
extern uint32 NativeFunction(int selector);

// Return the routine descriptor address of the native function
extern uint32 NativeRoutineDescriptor(int selector);


/*
 *  Helpers to share 32-bit addressable data with MacOS
 *
 *  There are two distinct allocatable regions:
 *
 *  - The Data region is used to share data between MacOS and
 *    SheepShaver. This is stack-like allocation since it is
 *    meant to only hold temporary data which dies at the end
 *    of the current function scope.
 *
 *  - The Procedure region is used to hold permanent M68K or
 *    PowerPC code to assist native routine implementations.
 *
 *  - The Procedure region grows up whereas the Data region
 *    grows down. They may intersect into the ZeroPage, which
 *    is a read-only page with all bits set to zero. In practise,
 *    the intersection is unlikely since the Procedure region is
 *    static and the Data region is meant to be small (< 256 KB).
 */

class SheepMem {
        static uint32 align(uint32 size);
protected:
        static uint32  page_size;
        static uintptr zero_page;
        static uintptr base;
        static uintptr data;
        static uintptr proc;
        static const uint32 size = 0x80000; // 512 KB
public:
        static bool Init(void);
        static void Exit(void);
        static uint32 PageSize();
        static uint32 ZeroPage();
        static uint32 Reserve(uint32 size);
        static void Release(uint32 size);
        static uint32 ReserveProc(uint32 size);
        friend class SheepVar;
};

inline uint32 SheepMem::align(uint32 size)
{
        // Align on 4 bytes boundaries
        return (size + 3) & -4;
}

inline uint32 SheepMem::PageSize()
{
  return page_size;
}

inline uint32 SheepMem::ZeroPage()
{
  return zero_page;
}

inline uint32 SheepMem::Reserve(uint32 size)
{
        data -= align(size);
        assert(data >= proc);
        return data;
}

inline void SheepMem::Release(uint32 size)
{
        data += align(size);
}

inline uint32 SheepMem::ReserveProc(uint32 size)
{
        uint32 mproc = proc;
        proc += align(size);
        assert(proc < data);
        return mproc;
}

static inline uint32 SheepProc(const uint8 *proc, uint32 proc_size)
{
        uint32 mac_proc = SheepMem::ReserveProc(proc_size);
        Host2Mac_memcpy(mac_proc, proc, proc_size);
        return mac_proc;
}

#define BUILD_SHEEPSHAVER_PROCEDURE(PROC)                                                       \
        static uint32 PROC = 0;                                                                                 \
        if (PROC == 0)                                                                                                  \
                PROC = SheepProc(PROC##_template, sizeof(PROC##_template))

class SheepVar
{
        uint32 m_base;
        uint32 m_size;
public:
        SheepVar(uint32 requested_size);
        ~SheepVar() { SheepMem::Release(m_size); }
        uint32 addr() const { return m_base; }
};

inline SheepVar::SheepVar(uint32 requested_size)
{
        m_size = SheepMem::align(requested_size);
        m_base = SheepMem::Reserve(m_size);
}

// TODO: optimize for 32-bit platforms

template< int requested_size >
struct SheepArray : public SheepVar
{
        SheepArray() : SheepVar(requested_size) { }
};

struct SheepVar32 : public SheepVar
{
        SheepVar32() : SheepVar(4) { }
        SheepVar32(uint32 value) : SheepVar(4) { set_value(value); }
        uint32 value() const { return ReadMacInt32(addr()); }
        void set_value(uint32 v) { WriteMacInt32(addr(), v); }
};

struct SheepString : public SheepVar
{
        SheepString(const char *str) : SheepVar(strlen(str) + 1)
                { if (str) strcpy(value(), str); else WriteMacInt8(addr(), 0); }
        char *value() const
                { return (char *)Mac2HostAddr(addr()); }
};

#endif
Revision:	1.16
Committed:	2008-01-01T09:47:39Z (16 years, 11 months ago) by gbeauche
Content type:	text/plain
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.15:	+1 -1 lines
Log Message:	Happy New Year!
#	User	Rev	Content
1	gbeauche	1.1	/*
2			* thunks.h - Thunks to share data and code with MacOS
3			*
4	gbeauche	1.16	* SheepShaver (C) 1997-2008 Christian Bauer and Marc Hellwig
5	gbeauche	1.1	*
6			* This program is free software; you can redistribute it and/or modify
7			* it under the terms of the GNU General Public License as published by
8			* the Free Software Foundation; either version 2 of the License, or
9			* (at your option) any later version.
10			*
11			* This program is distributed in the hope that it will be useful,
12			* but WITHOUT ANY WARRANTY; without even the implied warranty of
13			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14			* GNU General Public License for more details.
15			*
16			* You should have received a copy of the GNU General Public License
17			* along with this program; if not, write to the Free Software
18			* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19			*/
20
21			#ifndef THUNKS_H
22			#define THUNKS_H
23
24			#include "cpu_emulation.h"
25
26			/*
27			* Native function invocation
28			*/
29
30			enum {
31			NATIVE_PATCH_NAME_REGISTRY,
32			NATIVE_VIDEO_INSTALL_ACCEL,
33			NATIVE_VIDEO_VBL,
34			NATIVE_VIDEO_DO_DRIVER_IO,
35	gbeauche	1.13	NATIVE_ETHER_AO_GET_HWADDR,
36			NATIVE_ETHER_AO_ADD_MULTI,
37			NATIVE_ETHER_AO_DEL_MULTI,
38			NATIVE_ETHER_AO_SEND_PACKET,
39	gbeauche	1.1	NATIVE_ETHER_IRQ,
40			NATIVE_ETHER_INIT,
41			NATIVE_ETHER_TERM,
42			NATIVE_ETHER_OPEN,
43			NATIVE_ETHER_CLOSE,
44			NATIVE_ETHER_WPUT,
45			NATIVE_ETHER_RSRV,
46			NATIVE_SERIAL_NOTHING,
47			NATIVE_SERIAL_OPEN,
48			NATIVE_SERIAL_PRIME_IN,
49			NATIVE_SERIAL_PRIME_OUT,
50			NATIVE_SERIAL_CONTROL,
51			NATIVE_SERIAL_STATUS,
52			NATIVE_SERIAL_CLOSE,
53			NATIVE_GET_RESOURCE,
54			NATIVE_GET_1_RESOURCE,
55			NATIVE_GET_IND_RESOURCE,
56			NATIVE_GET_1_IND_RESOURCE,
57			NATIVE_R_GET_RESOURCE,
58			NATIVE_MAKE_EXECUTABLE,
59	gbeauche	1.4	NATIVE_CHECK_LOAD_INVOC,
60	gbeauche	1.15	NATIVE_NQD_SYNC_HOOK,
61			NATIVE_NQD_BITBLT_HOOK,
62			NATIVE_NQD_FILLRECT_HOOK,
63			NATIVE_NQD_UNKNOWN_HOOK,
64			NATIVE_NQD_BITBLT,
65			NATIVE_NQD_INVRECT,
66			NATIVE_NQD_FILLRECT,
67	gbeauche	1.14	NATIVE_NAMED_CHECK_LOAD_INVOC,
68			NATIVE_GET_NAMED_RESOURCE,
69			NATIVE_GET_1_NAMED_RESOURCE,
70	gbeauche	1.1	NATIVE_OP_MAX
71			};
72
73			// Initialize the thunks system
74			extern bool ThunksInit(void);
75
76	gbeauche	1.3	// Exit the thunks system
77			extern void ThunksExit(void);
78
79	gbeauche	1.1	// Return the fake PowerPC opcode to handle specified native code
80			#if EMULATED_PPC
81			extern uint32 NativeOpcode(int selector);
82			#endif
83
84			// Return the native function descriptor (TVECT)
85			extern uint32 NativeTVECT(int selector);
86
87			// Return the native function address
88			extern uint32 NativeFunction(int selector);
89
90	gbeauche	1.3	// Return the routine descriptor address of the native function
91			extern uint32 NativeRoutineDescriptor(int selector);
92
93	gbeauche	1.1
94			/*
95			* Helpers to share 32-bit addressable data with MacOS
96	gbeauche	1.11	*
97			* There are two distinct allocatable regions:
98			*
99			* - The Data region is used to share data between MacOS and
100			* SheepShaver. This is stack-like allocation since it is
101			* meant to only hold temporary data which dies at the end
102			* of the current function scope.
103			*
104			* - The Procedure region is used to hold permanent M68K or
105			* PowerPC code to assist native routine implementations.
106			*
107			* - The Procedure region grows up whereas the Data region
108			* grows down. They may intersect into the ZeroPage, which
109			* is a read-only page with all bits set to zero. In practise,
110			* the intersection is unlikely since the Procedure region is
111			* static and the Data region is meant to be small (< 256 KB).
112	gbeauche	1.1	*/
113
114			class SheepMem {
115			static uint32 align(uint32 size);
116			protected:
117	gbeauche	1.5	static uint32 page_size;
118	gbeauche	1.2	static uintptr zero_page;
119	gbeauche	1.1	static uintptr base;
120	gbeauche	1.10	static uintptr data;
121			static uintptr proc;
122			static const uint32 size = 0x80000; // 512 KB
123	gbeauche	1.1	public:
124			static bool Init(void);
125			static void Exit(void);
126	gbeauche	1.5	static uint32 PageSize();
127	gbeauche	1.9	static uint32 ZeroPage();
128			static uint32 Reserve(uint32 size);
129	gbeauche	1.1	static void Release(uint32 size);
130	gbeauche	1.10	static uint32 ReserveProc(uint32 size);
131	gbeauche	1.1	friend class SheepVar;
132			};
133
134			inline uint32 SheepMem::align(uint32 size)
135			{
136			// Align on 4 bytes boundaries
137			return (size + 3) & -4;
138	gbeauche	1.5	}
139
140			inline uint32 SheepMem::PageSize()
141			{
142			return page_size;
143	gbeauche	1.2	}
144
145	gbeauche	1.9	inline uint32 SheepMem::ZeroPage()
146	gbeauche	1.2	{
147			return zero_page;
148	gbeauche	1.1	}
149
150	gbeauche	1.9	inline uint32 SheepMem::Reserve(uint32 size)
151	gbeauche	1.1	{
152	gbeauche	1.10	data -= align(size);
153			assert(data >= proc);
154			return data;
155	gbeauche	1.1	}
156
157			inline void SheepMem::Release(uint32 size)
158			{
159	gbeauche	1.10	data += align(size);
160			}
161
162			inline uint32 SheepMem::ReserveProc(uint32 size)
163			{
164			uint32 mproc = proc;
165			proc += align(size);
166			assert(proc < data);
167			return mproc;
168			}
169
170			static inline uint32 SheepProc(const uint8 *proc, uint32 proc_size)
171			{
172			uint32 mac_proc = SheepMem::ReserveProc(proc_size);
173			Host2Mac_memcpy(mac_proc, proc, proc_size);
174			return mac_proc;
175	gbeauche	1.1	}
176
177	gbeauche	1.12	#define BUILD_SHEEPSHAVER_PROCEDURE(PROC) \
178			static uint32 PROC = 0; \
179			if (PROC == 0) \
180			PROC = SheepProc(PROC##_template, sizeof(PROC##_template))
181
182	gbeauche	1.1	class SheepVar
183			{
184	gbeauche	1.9	uint32 m_base;
185			uint32 m_size;
186	gbeauche	1.1	public:
187			SheepVar(uint32 requested_size);
188			~SheepVar() { SheepMem::Release(m_size); }
189	gbeauche	1.9	uint32 addr() const { return m_base; }
190	gbeauche	1.1	};
191
192			inline SheepVar::SheepVar(uint32 requested_size)
193			{
194			m_size = SheepMem::align(requested_size);
195			m_base = SheepMem::Reserve(m_size);
196			}
197
198			// TODO: optimize for 32-bit platforms
199
200	gbeauche	1.9	template< int requested_size >
201	gbeauche	1.1	struct SheepArray : public SheepVar
202			{
203	gbeauche	1.9	SheepArray() : SheepVar(requested_size) { }
204	gbeauche	1.1	};
205
206			struct SheepVar32 : public SheepVar
207			{
208			SheepVar32() : SheepVar(4) { }
209			SheepVar32(uint32 value) : SheepVar(4) { set_value(value); }
210			uint32 value() const { return ReadMacInt32(addr()); }
211			void set_value(uint32 v) { WriteMacInt32(addr(), v); }
212			};
213
214			struct SheepString : public SheepVar
215			{
216			SheepString(const char *str) : SheepVar(strlen(str) + 1)
217	gbeauche	1.9	{ if (str) strcpy(value(), str); else WriteMacInt8(addr(), 0); }
218	gbeauche	1.1	char *value() const
219	gbeauche	1.9	{ return (char *)Mac2HostAddr(addr()); }
220	gbeauche	1.1	};
221
222			#endif