riched32/tests: Change the test to facilitate adding a broken().
[wine] / dlls / ntdll / ntdll_misc.h
1 /*
2  * Copyright 2000 Juergen Schmied
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
17  */
18
19 #ifndef __WINE_NTDLL_MISC_H
20 #define __WINE_NTDLL_MISC_H
21
22 #include <stdarg.h>
23 #include <signal.h>
24 #include <sys/types.h>
25 #include <pthread.h>
26
27 #include "windef.h"
28 #include "winnt.h"
29 #include "winternl.h"
30 #include "wine/server.h"
31
32 #define MAX_NT_PATH_LENGTH 277
33
34 #define MAX_DOS_DRIVES 26
35
36 struct drive_info
37 {
38     dev_t dev;
39     ino_t ino;
40 };
41
42 /* exceptions */
43 extern void wait_suspend( CONTEXT *context );
44 extern NTSTATUS send_debug_event( EXCEPTION_RECORD *rec, int first_chance, CONTEXT *context );
45 extern LONG call_vectored_handlers( EXCEPTION_RECORD *rec, CONTEXT *context );
46 extern void raise_status( NTSTATUS status, EXCEPTION_RECORD *rec ) DECLSPEC_NORETURN;
47 extern void set_cpu_context( const CONTEXT *context );
48 extern void copy_context( CONTEXT *to, const CONTEXT *from, DWORD flags );
49 extern NTSTATUS context_to_server( context_t *to, const CONTEXT *from );
50 extern NTSTATUS context_from_server( CONTEXT *to, const context_t *from );
51
52 /* debug helpers */
53 extern LPCSTR debugstr_us( const UNICODE_STRING *str );
54 extern LPCSTR debugstr_ObjectAttributes(const OBJECT_ATTRIBUTES *oa);
55
56 extern NTSTATUS NTDLL_queue_process_apc( HANDLE process, const apc_call_t *call, apc_result_t *result );
57 extern NTSTATUS NTDLL_wait_for_multiple_objects( UINT count, const HANDLE *handles, UINT flags,
58                                                  const LARGE_INTEGER *timeout, HANDLE signal_object );
59
60 /* init routines */
61 extern void signal_init_thread( TEB *teb );
62 extern void signal_init_process(void);
63 extern size_t get_signal_stack_total_size(void);
64 extern void version_init( const WCHAR *appname );
65 extern void debug_init(void);
66 extern HANDLE thread_init(void);
67 extern void actctx_init(void);
68 extern void virtual_init(void);
69 extern void virtual_init_threading(void);
70
71 /* server support */
72 extern timeout_t server_start_time;
73 extern unsigned int server_cpus;
74 extern void server_init_process(void);
75 extern NTSTATUS server_init_process_done(void);
76 extern size_t server_init_thread( void *entry_point );
77 extern void DECLSPEC_NORETURN server_protocol_error( const char *err, ... );
78 extern void DECLSPEC_NORETURN server_protocol_perror( const char *err );
79 extern void DECLSPEC_NORETURN abort_thread( int status );
80 extern sigset_t server_block_set;
81 extern void server_enter_uninterrupted_section( RTL_CRITICAL_SECTION *cs, sigset_t *sigset );
82 extern void server_leave_uninterrupted_section( RTL_CRITICAL_SECTION *cs, sigset_t *sigset );
83 extern int server_remove_fd_from_cache( HANDLE handle );
84 extern int server_get_unix_fd( HANDLE handle, unsigned int access, int *unix_fd,
85                                int *needs_close, enum server_fd_type *type, unsigned int *options );
86
87 /* security descriptors */
88 NTSTATUS NTDLL_create_struct_sd(PSECURITY_DESCRIPTOR nt_sd, struct security_descriptor **server_sd,
89                                 data_size_t *server_sd_len);
90 void NTDLL_free_struct_sd(struct security_descriptor *server_sd);
91
92 /* module handling */
93 extern NTSTATUS MODULE_DllThreadAttach( LPVOID lpReserved );
94 extern FARPROC RELAY_GetProcAddress( HMODULE module, const IMAGE_EXPORT_DIRECTORY *exports,
95                                      DWORD exp_size, FARPROC proc, DWORD ordinal, const WCHAR *user );
96 extern FARPROC SNOOP_GetProcAddress( HMODULE hmod, const IMAGE_EXPORT_DIRECTORY *exports, DWORD exp_size,
97                                      FARPROC origfun, DWORD ordinal, const WCHAR *user );
98 extern void RELAY_SetupDLL( HMODULE hmod );
99 extern void SNOOP_SetupDLL( HMODULE hmod );
100 extern UNICODE_STRING windows_dir;
101 extern UNICODE_STRING system_dir;
102
103 typedef LONG (WINAPI *PUNHANDLED_EXCEPTION_FILTER)(PEXCEPTION_POINTERS);
104 extern PUNHANDLED_EXCEPTION_FILTER unhandled_exception_filter;
105
106 /* redefine these to make sure we don't reference kernel symbols */
107 #define GetProcessHeap()       (NtCurrentTeb()->Peb->ProcessHeap)
108 #define GetCurrentProcessId()  (HandleToULong(NtCurrentTeb()->ClientId.UniqueProcess))
109 #define GetCurrentThreadId()   (HandleToULong(NtCurrentTeb()->ClientId.UniqueThread))
110
111 /* Device IO */
112 extern NTSTATUS CDROM_DeviceIoControl(HANDLE hDevice, 
113                                       HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
114                                       PVOID UserApcContext, 
115                                       PIO_STATUS_BLOCK piosb, 
116                                       ULONG IoControlCode,
117                                       LPVOID lpInBuffer, DWORD nInBufferSize,
118                                       LPVOID lpOutBuffer, DWORD nOutBufferSize);
119 extern NTSTATUS COMM_DeviceIoControl(HANDLE hDevice, 
120                                      HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
121                                      PVOID UserApcContext, 
122                                      PIO_STATUS_BLOCK piosb, 
123                                      ULONG IoControlCode,
124                                      LPVOID lpInBuffer, DWORD nInBufferSize,
125                                      LPVOID lpOutBuffer, DWORD nOutBufferSize);
126 extern NTSTATUS TAPE_DeviceIoControl(HANDLE hDevice, 
127                                      HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
128                                      PVOID UserApcContext, 
129                                      PIO_STATUS_BLOCK piosb, 
130                                      ULONG IoControlCode,
131                                      LPVOID lpInBuffer, DWORD nInBufferSize,
132                                      LPVOID lpOutBuffer, DWORD nOutBufferSize);
133
134 /* file I/O */
135 extern NTSTATUS FILE_GetNtStatus(void);
136 extern BOOL DIR_is_hidden_file( const UNICODE_STRING *name );
137 extern NTSTATUS DIR_unmount_device( HANDLE handle );
138 extern NTSTATUS DIR_get_unix_cwd( char **cwd );
139 extern unsigned int DIR_get_drives_info( struct drive_info info[MAX_DOS_DRIVES] );
140
141 /* virtual memory */
142 extern void virtual_get_system_info( SYSTEM_BASIC_INFORMATION *info );
143 extern NTSTATUS virtual_create_system_view( void *base, SIZE_T size, DWORD vprot );
144 extern NTSTATUS virtual_alloc_thread_stack( TEB *teb, SIZE_T reserve_size, SIZE_T commit_size );
145 extern void virtual_clear_thread_stack(void);
146 extern BOOL virtual_handle_stack_fault( void *addr );
147 extern NTSTATUS virtual_handle_fault( LPCVOID addr, DWORD err );
148 extern BOOL virtual_check_buffer_for_read( const void *ptr, SIZE_T size );
149 extern BOOL virtual_check_buffer_for_write( void *ptr, SIZE_T size );
150 extern void VIRTUAL_SetForceExec( BOOL enable );
151 extern void VIRTUAL_UseLargeAddressSpace(void);
152 extern struct _KUSER_SHARED_DATA *user_shared_data;
153
154 /* completion */
155 extern NTSTATUS NTDLL_AddCompletion( HANDLE hFile, ULONG_PTR CompletionValue,
156                                      NTSTATUS CompletionStatus, ULONG Information );
157
158 /* code pages */
159 extern int ntdll_umbstowcs(DWORD flags, const char* src, int srclen, WCHAR* dst, int dstlen);
160 extern int ntdll_wcstoumbs(DWORD flags, const WCHAR* src, int srclen, char* dst, int dstlen,
161                            const char* defchar, int *used );
162
163 extern int CDECL NTDLL__vsnprintf( char *str, SIZE_T len, const char *format, __ms_va_list args );
164 extern int CDECL NTDLL__vsnwprintf( WCHAR *str, SIZE_T len, const WCHAR *format, __ms_va_list args );
165
166 /* load order */
167
168 enum loadorder
169 {
170     LO_INVALID,
171     LO_DISABLED,
172     LO_NATIVE,
173     LO_BUILTIN,
174     LO_NATIVE_BUILTIN,  /* native then builtin */
175     LO_BUILTIN_NATIVE,  /* builtin then native */
176     LO_DEFAULT          /* nothing specified, use default strategy */
177 };
178
179 extern enum loadorder get_load_order( const WCHAR *app_name, const WCHAR *path );
180
181 struct debug_info
182 {
183     char *str_pos;       /* current position in strings buffer */
184     char *out_pos;       /* current position in output buffer */
185     char  strings[1024]; /* buffer for temporary strings */
186     char  output[1024];  /* current output line */
187 };
188
189 /* thread private data, stored in NtCurrentTeb()->SystemReserved2 */
190 struct ntdll_thread_data
191 {
192     DWORD              fs;            /* 1d4/300 TEB selector */
193     DWORD              gs;            /* 1d8/304 libc selector; update winebuild if you move this! */
194     struct debug_info *debug_info;    /* 1dc/308 info for debugstr functions */
195     int                request_fd;    /* 1e0/310 fd for sending server requests */
196     int                reply_fd;      /* 1e4/314 fd for receiving server replies */
197     int                wait_fd[2];    /* 1e8/318 fd for sleeping server requests */
198     void              *vm86_ptr;      /* 1f0/320 data for vm86 mode */
199     pthread_t          pthread_id;    /* 1f4/328 pthread thread id */
200 };
201
202 static inline struct ntdll_thread_data *ntdll_get_thread_data(void)
203 {
204     return (struct ntdll_thread_data *)NtCurrentTeb()->SystemReserved2;
205 }
206
207 /* thread debug_registers, stored in NtCurrentTeb()->SpareBytes1 */
208 struct ntdll_thread_regs
209 {
210     DWORD dr0;
211     DWORD dr1;
212     DWORD dr2;
213     DWORD dr3;
214     DWORD dr6;
215     DWORD dr7;
216 };
217
218 static inline struct ntdll_thread_regs *ntdll_get_thread_regs(void)
219 {
220     return (struct ntdll_thread_regs *)NtCurrentTeb()->SpareBytes1;
221 }
222
223 /* Register functions */
224
225 #ifdef __i386__
226 #define DEFINE_REGS_ENTRYPOINT( name, args ) \
227     __ASM_GLOBAL_FUNC( name, \
228                        ".byte 0x68\n\t"  /* pushl $__regs_func */       \
229                        ".long " __ASM_NAME("__regs_") #name "-.-11\n\t" \
230                        ".byte 0x6a," #args "\n\t" /* pushl $args */     \
231                        "call " __ASM_NAME("__wine_call_from_32_regs"))
232 #elif defined(__x86_64__)
233 #define DEFINE_REGS_ENTRYPOINT( name, args ) \
234     __ASM_GLOBAL_FUNC( name, \
235                        "movq %rcx,8(%rsp)\n\t"  \
236                        "movq %rdx,16(%rsp)\n\t" \
237                        "movq $" #args ",%rcx\n\t" \
238                        "leaq " __ASM_NAME("__regs_") #name "(%rip),%rdx\n\t" \
239                        "call " __ASM_NAME("__wine_call_from_regs"))
240 #endif
241
242 #endif