Release 1.4-rc1.
[wine/multimedia.git] / tools / winebuild / build.h
blob05adf31175bbf3bcace315d4f94dedfb6ddf3873
1 /*
2 * Copyright 1993 Robert J. Amstadt
3 * Copyright 1995 Martin von Loewis
4 * Copyright 1995, 1996, 1997 Alexandre Julliard
5 * Copyright 1997 Eric Youngdale
6 * Copyright 1999 Ulrich Weigand
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 #ifndef __WINE_BUILD_H
24 #define __WINE_BUILD_H
26 #ifndef __WINE_CONFIG_H
27 # error You must include config.h to use this header
28 #endif
30 #include <stdio.h>
31 #include <stdlib.h>
32 #include <string.h>
34 #ifndef max
35 #define max(a,b) (((a) > (b)) ? (a) : (b))
36 #endif
37 #ifndef min
38 #define min(a,b) (((a) < (b)) ? (a) : (b))
39 #endif
41 typedef enum
43 TYPE_VARIABLE, /* variable */
44 TYPE_PASCAL, /* pascal function (Win16) */
45 TYPE_ABS, /* absolute value (Win16) */
46 TYPE_STUB, /* unimplemented stub */
47 TYPE_STDCALL, /* stdcall function (Win32) */
48 TYPE_CDECL, /* cdecl function (Win32) */
49 TYPE_VARARGS, /* varargs function (Win32) */
50 TYPE_THISCALL, /* thiscall function (Win32 on i386) */
51 TYPE_EXTERN, /* external symbol (Win32) */
52 TYPE_NBTYPES
53 } ORD_TYPE;
55 typedef enum
57 SPEC_WIN16,
58 SPEC_WIN32
59 } SPEC_TYPE;
61 enum arg_type
63 ARG_WORD, /* 16-bit word */
64 ARG_SWORD, /* 16-bit signed word */
65 ARG_SEGPTR, /* segmented pointer */
66 ARG_SEGSTR, /* segmented pointer to Ansi string */
67 ARG_LONG, /* long */
68 ARG_PTR, /* pointer */
69 ARG_STR, /* pointer to Ansi string */
70 ARG_WSTR, /* pointer to Unicode string */
71 ARG_INT64, /* 64-bit integer */
72 ARG_INT128, /* 128-bit integer */
73 ARG_FLOAT, /* 32-bit float */
74 ARG_DOUBLE, /* 64-bit float */
75 ARG_MAXARG = ARG_DOUBLE
78 #define MAX_ARGUMENTS 32
80 typedef struct
82 int n_values;
83 int *values;
84 } ORD_VARIABLE;
86 typedef struct
88 int nb_args;
89 enum arg_type args[MAX_ARGUMENTS];
90 } ORD_FUNCTION;
92 typedef struct
94 unsigned short value;
95 } ORD_ABS;
97 typedef struct
99 ORD_TYPE type;
100 int ordinal;
101 int lineno;
102 int flags;
103 char *name; /* public name of this function */
104 char *link_name; /* name of the C symbol to link to */
105 char *export_name; /* name exported under for noname exports */
106 union
108 ORD_VARIABLE var;
109 ORD_FUNCTION func;
110 ORD_ABS abs;
111 } u;
112 } ORDDEF;
114 typedef struct
116 char *src_name; /* file name of the source spec file */
117 char *file_name; /* file name of the dll */
118 char *dll_name; /* internal name of the dll */
119 char *init_func; /* initialization routine */
120 char *main_module; /* main Win32 module for Win16 specs */
121 SPEC_TYPE type; /* type of dll (Win16/Win32) */
122 int base; /* ordinal base */
123 int limit; /* ordinal limit */
124 int stack_size; /* exe stack size */
125 int heap_size; /* exe heap size */
126 int nb_entry_points; /* number of used entry points */
127 int alloc_entry_points; /* number of allocated entry points */
128 int nb_names; /* number of entry points with names */
129 unsigned int nb_resources; /* number of resources */
130 int characteristics; /* characteristics for the PE header */
131 int dll_characteristics;/* DLL characteristics for the PE header */
132 int subsystem; /* subsystem id */
133 int subsystem_major; /* subsystem version major number */
134 int subsystem_minor; /* subsystem version minor number */
135 ORDDEF *entry_points; /* dll entry points */
136 ORDDEF **names; /* array of entry point names (points into entry_points) */
137 ORDDEF **ordinals; /* array of dll ordinals (points into entry_points) */
138 struct resource *resources; /* array of dll resources (format differs between Win16/Win32) */
139 } DLLSPEC;
141 enum target_cpu
143 CPU_x86, CPU_x86_64, CPU_SPARC, CPU_POWERPC, CPU_ARM, CPU_LAST = CPU_ARM
146 enum target_platform
148 PLATFORM_UNSPECIFIED,
149 PLATFORM_APPLE,
150 PLATFORM_FREEBSD,
151 PLATFORM_SOLARIS,
152 PLATFORM_WINDOWS
155 extern char *target_alias;
156 extern enum target_cpu target_cpu;
157 extern enum target_platform target_platform;
159 struct strarray
161 const char **str;
162 unsigned int count;
163 unsigned int max;
166 /* entry point flags */
167 #define FLAG_NORELAY 0x01 /* don't use relay debugging for this function */
168 #define FLAG_NONAME 0x02 /* don't export function by name */
169 #define FLAG_RET16 0x04 /* function returns a 16-bit value */
170 #define FLAG_RET64 0x08 /* function returns a 64-bit value */
171 #define FLAG_REGISTER 0x10 /* use register calling convention */
172 #define FLAG_PRIVATE 0x20 /* function is private (cannot be imported) */
173 #define FLAG_ORDINAL 0x40 /* function should be imported by ordinal */
175 #define FLAG_FORWARD 0x100 /* function is a forwarded name */
176 #define FLAG_EXT_LINK 0x200 /* function links to an external symbol */
177 #define FLAG_EXPORT32 0x400 /* 32-bit export in 16-bit spec file */
179 #define FLAG_CPU(cpu) (0x01000 << (cpu))
180 #define FLAG_CPU_MASK (FLAG_CPU(CPU_LAST + 1) - FLAG_CPU(0))
181 #define FLAG_CPU_WIN64 (FLAG_CPU(CPU_x86_64))
182 #define FLAG_CPU_WIN32 (FLAG_CPU_MASK & ~FLAG_CPU_WIN64)
184 #define MAX_ORDINALS 65535
186 /* some Windows constants */
188 #define IMAGE_FILE_RELOCS_STRIPPED 0x0001 /* No relocation info */
189 #define IMAGE_FILE_EXECUTABLE_IMAGE 0x0002
190 #define IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004
191 #define IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008
192 #define IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010
193 #define IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020
194 #define IMAGE_FILE_16BIT_MACHINE 0x0040
195 #define IMAGE_FILE_BYTES_REVERSED_LO 0x0080
196 #define IMAGE_FILE_32BIT_MACHINE 0x0100
197 #define IMAGE_FILE_DEBUG_STRIPPED 0x0200
198 #define IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400
199 #define IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800
200 #define IMAGE_FILE_SYSTEM 0x1000
201 #define IMAGE_FILE_DLL 0x2000
202 #define IMAGE_FILE_UP_SYSTEM_ONLY 0x4000
203 #define IMAGE_FILE_BYTES_REVERSED_HI 0x8000
205 #define IMAGE_DLLCHARACTERISTICS_NX_COMPAT 0x0100
207 #define IMAGE_SUBSYSTEM_NATIVE 1
208 #define IMAGE_SUBSYSTEM_WINDOWS_GUI 2
209 #define IMAGE_SUBSYSTEM_WINDOWS_CUI 3
210 #define IMAGE_SUBSYSTEM_WINDOWS_CE_GUI 9
212 /* global functions */
214 #ifndef __GNUC__
215 #define __attribute__(X)
216 #endif
218 #ifndef DECLSPEC_NORETURN
219 # if defined(_MSC_VER) && (_MSC_VER >= 1200) && !defined(MIDL_PASS)
220 # define DECLSPEC_NORETURN __declspec(noreturn)
221 # else
222 # define DECLSPEC_NORETURN __attribute__((noreturn))
223 # endif
224 #endif
226 extern void *xmalloc (size_t size);
227 extern void *xrealloc (void *ptr, size_t size);
228 extern char *xstrdup( const char *str );
229 extern char *strupper(char *s);
230 extern int strendswith(const char* str, const char* end);
231 extern char *strmake(const char* fmt, ...) __attribute__((__format__ (__printf__, 1, 2 )));
232 extern struct strarray *strarray_init(void);
233 extern void strarray_add( struct strarray *array, ... );
234 extern void strarray_addv( struct strarray *array, char * const *argv );
235 extern void strarray_free( struct strarray *array );
236 extern DECLSPEC_NORETURN void fatal_error( const char *msg, ... )
237 __attribute__ ((__format__ (__printf__, 1, 2)));
238 extern DECLSPEC_NORETURN void fatal_perror( const char *msg, ... )
239 __attribute__ ((__format__ (__printf__, 1, 2)));
240 extern void error( const char *msg, ... )
241 __attribute__ ((__format__ (__printf__, 1, 2)));
242 extern void warning( const char *msg, ... )
243 __attribute__ ((__format__ (__printf__, 1, 2)));
244 extern int output( const char *format, ... )
245 __attribute__ ((__format__ (__printf__, 1, 2)));
246 extern void output_cfi( const char *format, ... )
247 __attribute__ ((__format__ (__printf__, 1, 2)));
248 extern void spawn( struct strarray *array );
249 extern char *find_tool( const char *name, const char * const *names );
250 extern struct strarray *get_as_command(void);
251 extern struct strarray *get_ld_command(void);
252 extern const char *get_nm_command(void);
253 extern char *get_temp_file_name( const char *prefix, const char *suffix );
254 extern void output_standard_file_header(void);
255 extern FILE *open_input_file( const char *srcdir, const char *name );
256 extern void close_input_file( FILE *file );
257 extern void dump_bytes( const void *buffer, unsigned int size );
258 extern int remove_stdcall_decoration( char *name );
259 extern void assemble_file( const char *src_file, const char *obj_file );
260 extern DLLSPEC *alloc_dll_spec(void);
261 extern void free_dll_spec( DLLSPEC *spec );
262 extern const char *make_c_identifier( const char *str );
263 extern const char *get_stub_name( const ORDDEF *odp, const DLLSPEC *spec );
264 extern enum target_cpu get_cpu_from_name( const char *name );
265 extern unsigned int get_alignment(unsigned int align);
266 extern unsigned int get_page_size(void);
267 extern unsigned int get_ptr_size(void);
268 extern unsigned int get_args_size( const ORDDEF *odp );
269 extern const char *asm_name( const char *func );
270 extern const char *func_declaration( const char *func );
271 extern const char *asm_globl( const char *func );
272 extern const char *get_asm_ptr_keyword(void);
273 extern const char *get_asm_string_keyword(void);
274 extern const char *get_asm_short_keyword(void);
275 extern const char *get_asm_rodata_section(void);
276 extern const char *get_asm_string_section(void);
277 extern void output_function_size( const char *name );
278 extern void output_gnu_stack_note(void);
280 extern void add_import_dll( const char *name, const char *filename );
281 extern void add_delayed_import( const char *name );
282 extern void add_extra_ld_symbol( const char *name );
283 extern void read_undef_symbols( DLLSPEC *spec, char **argv );
284 extern void resolve_imports( DLLSPEC *spec );
285 extern int is_undefined( const char *name );
286 extern int has_imports(void);
287 extern int has_relays( DLLSPEC *spec );
288 extern void output_get_pc_thunk(void);
289 extern void output_module( DLLSPEC *spec );
290 extern void output_stubs( DLLSPEC *spec );
291 extern void output_imports( DLLSPEC *spec );
292 extern void output_import_lib( DLLSPEC *spec, char **argv );
293 extern void output_exports( DLLSPEC *spec );
294 extern int load_res32_file( const char *name, DLLSPEC *spec );
295 extern void output_resources( DLLSPEC *spec );
296 extern void output_bin_resources( DLLSPEC *spec, unsigned int start_rva );
297 extern void output_fake_module( DLLSPEC *spec );
298 extern void output_def_file( DLLSPEC *spec, int include_private );
299 extern void load_res16_file( const char *name, DLLSPEC *spec );
300 extern void output_res16_data( DLLSPEC *spec );
301 extern void output_bin_res16_data( DLLSPEC *spec );
302 extern void output_res16_directory( DLLSPEC *spec );
303 extern void output_bin_res16_directory( DLLSPEC *spec, unsigned int data_offset );
304 extern void output_spec16_file( DLLSPEC *spec );
305 extern void output_fake_module16( DLLSPEC *spec16 );
306 extern void output_res_o_file( DLLSPEC *spec );
307 extern void output_asm_relays(void);
308 extern void output_asm_relays16(void);
310 extern void BuildSpec32File( DLLSPEC *spec );
312 extern void add_16bit_exports( DLLSPEC *spec32, DLLSPEC *spec16 );
313 extern int parse_spec_file( FILE *file, DLLSPEC *spec );
314 extern int parse_def_file( FILE *file, DLLSPEC *spec );
316 /* buffer management */
318 extern int byte_swapped;
319 extern const char *input_buffer_filename;
320 extern const unsigned char *input_buffer;
321 extern size_t input_buffer_pos;
322 extern size_t input_buffer_size;
323 extern unsigned char *output_buffer;
324 extern size_t output_buffer_pos;
325 extern size_t output_buffer_size;
327 extern void init_input_buffer( const char *file );
328 extern void init_output_buffer(void);
329 extern void flush_output_buffer(void);
330 extern unsigned char get_byte(void);
331 extern unsigned short get_word(void);
332 extern unsigned int get_dword(void);
333 extern void put_data( const void *data, size_t size );
334 extern void put_byte( unsigned char val );
335 extern void put_word( unsigned short val );
336 extern void put_dword( unsigned int val );
337 extern void put_qword( unsigned int val );
338 extern void put_pword( unsigned int val );
339 extern void align_output( unsigned int align );
341 /* global variables */
343 extern int current_line;
344 extern int UsePIC;
345 extern int nb_lib_paths;
346 extern int nb_errors;
347 extern int display_warnings;
348 extern int kill_at;
349 extern int verbose;
350 extern int save_temps;
351 extern int link_ext_symbols;
352 extern int force_pointer_size;
353 extern int unwind_tables;
355 extern char *input_file_name;
356 extern char *spec_file_name;
357 extern FILE *output_file;
358 extern const char *output_file_name;
359 extern char **lib_path;
361 extern char *as_command;
362 extern char *ld_command;
363 extern char *nm_command;
364 extern char *cpu_option;
366 #endif /* __WINE_BUILD_H */