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 extern void call_thread_entry_point( LPTHREAD_START_ROUTINE entry, void *arg ) DECLSPEC_NORETURN;
  52
  53 /* debug helpers */
  54 extern LPCSTR debugstr_us( const UNICODE_STRING *str );
  55 extern LPCSTR debugstr_ObjectAttributes(const OBJECT_ATTRIBUTES *oa);
  56
  57 extern NTSTATUS NTDLL_queue_process_apc( HANDLE process, const apc_call_t *call, apc_result_t *result );
  58 extern NTSTATUS NTDLL_wait_for_multiple_objects( UINT count, const HANDLE *handles, UINT flags,
  59                                                  const LARGE_INTEGER *timeout, HANDLE signal_object );
  60
  61 /* init routines */
  62 extern NTSTATUS signal_alloc_thread( TEB **teb );
  63 extern void signal_free_thread( TEB *teb );
  64 extern void signal_init_thread( TEB *teb );
  65 extern void signal_init_process(void);
  66 extern void version_init( const WCHAR *appname );
  67 extern void debug_init(void);
  68 extern HANDLE thread_init(void);
  69 extern void actctx_init(void);
  70 extern void virtual_init(void);
  71 extern void virtual_init_threading(void);
  72 extern void fill_cpu_info(void);
  73 extern void heap_set_debug_flags( HANDLE handle );
  74
  75 /* server support */
  76 extern timeout_t server_start_time;
  77 extern unsigned int server_cpus;
  78 extern int is_wow64;
  79 extern void server_init_process(void);
  80 extern NTSTATUS server_init_process_done(void);
  81 extern size_t server_init_thread( void *entry_point );
  82 extern void DECLSPEC_NORETURN server_protocol_error( const char *err, ... );
  83 extern void DECLSPEC_NORETURN server_protocol_perror( const char *err );
  84 extern void DECLSPEC_NORETURN abort_thread( int status );
  85 extern void DECLSPEC_NORETURN terminate_thread( int status );
  86 extern void DECLSPEC_NORETURN exit_thread( int status );
  87 extern sigset_t server_block_set;
  88 extern void server_enter_uninterrupted_section( RTL_CRITICAL_SECTION *cs, sigset_t *sigset );
  89 extern void server_leave_uninterrupted_section( RTL_CRITICAL_SECTION *cs, sigset_t *sigset );
  90 extern int server_remove_fd_from_cache( HANDLE handle );
  91 extern int server_get_unix_fd( HANDLE handle, unsigned int access, int *unix_fd,
  92                                int *needs_close, enum server_fd_type *type, unsigned int *options );
  93 extern int server_pipe( int fd[2] );
  94
  95 /* security descriptors */
  96 NTSTATUS NTDLL_create_struct_sd(PSECURITY_DESCRIPTOR nt_sd, struct security_descriptor **server_sd,
  97                                 data_size_t *server_sd_len);
  98 void NTDLL_free_struct_sd(struct security_descriptor *server_sd);
  99
 100 /* module handling */
 101 extern NTSTATUS MODULE_DllThreadAttach( LPVOID lpReserved );
 102 extern FARPROC RELAY_GetProcAddress( HMODULE module, const IMAGE_EXPORT_DIRECTORY *exports,
 103                                      DWORD exp_size, FARPROC proc, DWORD ordinal, const WCHAR *user );
 104 extern FARPROC SNOOP_GetProcAddress( HMODULE hmod, const IMAGE_EXPORT_DIRECTORY *exports, DWORD exp_size,
 105                                      FARPROC origfun, DWORD ordinal, const WCHAR *user );
 106 extern void RELAY_SetupDLL( HMODULE hmod );
 107 extern void SNOOP_SetupDLL( HMODULE hmod );
 108 extern UNICODE_STRING windows_dir;
 109 extern UNICODE_STRING system_dir;
 110
 111 typedef LONG (WINAPI *PUNHANDLED_EXCEPTION_FILTER)(PEXCEPTION_POINTERS);
 112 extern PUNHANDLED_EXCEPTION_FILTER unhandled_exception_filter;
 113
 114 /* redefine these to make sure we don't reference kernel symbols */
 115 #define GetProcessHeap()       (NtCurrentTeb()->Peb->ProcessHeap)
 116 #define GetCurrentProcessId()  (HandleToULong(NtCurrentTeb()->ClientId.UniqueProcess))
 117 #define GetCurrentThreadId()   (HandleToULong(NtCurrentTeb()->ClientId.UniqueThread))
 118
 119 /* Device IO */
 120 extern NTSTATUS CDROM_DeviceIoControl(HANDLE hDevice,
 121                                       HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
 122                                       PVOID UserApcContext,
 123                                       PIO_STATUS_BLOCK piosb,
 124                                       ULONG IoControlCode,
 125                                       LPVOID lpInBuffer, DWORD nInBufferSize,
 126                                       LPVOID lpOutBuffer, DWORD nOutBufferSize);
 127 extern NTSTATUS COMM_DeviceIoControl(HANDLE hDevice,
 128                                      HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
 129                                      PVOID UserApcContext,
 130                                      PIO_STATUS_BLOCK piosb,
 131                                      ULONG IoControlCode,
 132                                      LPVOID lpInBuffer, DWORD nInBufferSize,
 133                                      LPVOID lpOutBuffer, DWORD nOutBufferSize);
 134 extern NTSTATUS TAPE_DeviceIoControl(HANDLE hDevice,
 135                                      HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
 136                                      PVOID UserApcContext,
 137                                      PIO_STATUS_BLOCK piosb,
 138                                      ULONG IoControlCode,
 139                                      LPVOID lpInBuffer, DWORD nInBufferSize,
 140                                      LPVOID lpOutBuffer, DWORD nOutBufferSize);
 141
 142 /* file I/O */
 143 struct stat;
 144 extern NTSTATUS FILE_GetNtStatus(void);
 145 extern NTSTATUS fill_stat_info( const struct stat *st, void *ptr, FILE_INFORMATION_CLASS class );
 146 extern NTSTATUS server_get_unix_name( HANDLE handle, ANSI_STRING *unix_name );
 147 extern void DIR_init_windows_dir( const WCHAR *windir, const WCHAR *sysdir );
 148 extern BOOL DIR_is_hidden_file( const UNICODE_STRING *name );
 149 extern NTSTATUS DIR_unmount_device( HANDLE handle );
 150 extern NTSTATUS DIR_get_unix_cwd( char **cwd );
 151 extern unsigned int DIR_get_drives_info( struct drive_info info[MAX_DOS_DRIVES] );
 152 extern NTSTATUS file_id_to_unix_file_name( const OBJECT_ATTRIBUTES *attr, ANSI_STRING *unix_name_ret );
 153 extern NTSTATUS nt_to_unix_file_name_attr( const OBJECT_ATTRIBUTES *attr, ANSI_STRING *unix_name_ret,
 154                                            UINT disposition );
 155
 156 /* virtual memory */
 157 extern void virtual_get_system_info( SYSTEM_BASIC_INFORMATION *info );
 158 extern NTSTATUS virtual_create_builtin_view( void *base );
 159 extern NTSTATUS virtual_alloc_thread_stack( TEB *teb, SIZE_T reserve_size, SIZE_T commit_size );
 160 extern void virtual_clear_thread_stack(void);
 161 extern BOOL virtual_handle_stack_fault( void *addr );
 162 extern NTSTATUS virtual_handle_fault( LPCVOID addr, DWORD err );
 163 extern BOOL virtual_check_buffer_for_read( const void *ptr, SIZE_T size );
 164 extern BOOL virtual_check_buffer_for_write( void *ptr, SIZE_T size );
 165 extern void VIRTUAL_SetForceExec( BOOL enable );
 166 extern void virtual_release_address_space( BOOL free_high_mem );
 167 extern struct _KUSER_SHARED_DATA *user_shared_data;
 168
 169 /* completion */
 170 extern NTSTATUS NTDLL_AddCompletion( HANDLE hFile, ULONG_PTR CompletionValue,
 171                                      NTSTATUS CompletionStatus, ULONG Information );
 172
 173 /* code pages */
 174 extern int ntdll_umbstowcs(DWORD flags, const char* src, int srclen, WCHAR* dst, int dstlen);
 175 extern int ntdll_wcstoumbs(DWORD flags, const WCHAR* src, int srclen, char* dst, int dstlen,
 176                            const char* defchar, int *used );
 177
 178 extern int CDECL NTDLL__vsnprintf( char *str, SIZE_T len, const char *format, __ms_va_list args );
 179 extern int CDECL NTDLL__vsnwprintf( WCHAR *str, SIZE_T len, const WCHAR *format, __ms_va_list args );
 180
 181 /* load order */
 182
 183 enum loadorder
 184 {
 185     LO_INVALID,
 186     LO_DISABLED,
 187     LO_NATIVE,
 188     LO_BUILTIN,
 189     LO_NATIVE_BUILTIN,  /* native then builtin */
 190     LO_BUILTIN_NATIVE,  /* builtin then native */
 191     LO_DEFAULT          /* nothing specified, use default strategy */
 192 };
 193
 194 extern enum loadorder get_load_order( const WCHAR *app_name, const WCHAR *path );
 195
 196 struct debug_info
 197 {
 198     char *str_pos;       /* current position in strings buffer */
 199     char *out_pos;       /* current position in output buffer */
 200     char  strings[1024]; /* buffer for temporary strings */
 201     char  output[1024];  /* current output line */
 202 };
 203
 204 /* thread private data, stored in NtCurrentTeb()->SystemReserved2 */
 205 struct ntdll_thread_data
 206 {
 207 #ifdef __i386__
 208     DWORD              dr0;           /* 1bc Debug registers */
 209     DWORD              dr1;           /* 1c0 */
 210     DWORD              dr2;           /* 1c4 */
 211     DWORD              dr3;           /* 1c8 */
 212     DWORD              dr6;           /* 1cc */
 213     DWORD              dr7;           /* 1d0 */
 214     DWORD              fs;            /* 1d4 TEB selector */
 215     DWORD              gs;            /* 1d8 libc selector; update winebuild if you move this! */
 216     void              *vm86_ptr;      /* 1dc data for vm86 mode */
 217 #else
 218     void              *exit_frame;    /*    /2e8 exit frame pointer */
 219 #endif
 220     struct debug_info *debug_info;    /* 1e0/2f0 info for debugstr functions */
 221     int                request_fd;    /* 1e4/2f8 fd for sending server requests */
 222     int                reply_fd;      /* 1e8/2fc fd for receiving server replies */
 223     int                wait_fd[2];    /* 1ec/300 fd for sleeping server requests */
 224     BOOL               wow64_redir;   /* 1f4/308 Wow64 filesystem redirection flag */
 225     pthread_t          pthread_id;    /* 1f8/310 pthread thread id */
 226 };
 227
 228 static inline struct ntdll_thread_data *ntdll_get_thread_data(void)
 229 {
 230     return (struct ntdll_thread_data *)NtCurrentTeb()->SpareBytes1;
 231 }
 232
 233 /* Register functions */
 234
 235 #ifdef __i386__
 236 #define DEFINE_REGS_ENTRYPOINT( name, args ) \
 237     __ASM_GLOBAL_FUNC( name, \
 238                        ".byte 0x68\n\t"  /* pushl $__regs_func */       \
 239                        ".long " __ASM_NAME("__regs_") #name "-.-11\n\t" \
 240                        ".byte 0x6a," #args "\n\t" /* pushl $args */     \
 241                        "call " __ASM_NAME("__wine_call_from_regs") "\n\t" \
 242                        "ret $(4*" #args ")" ) /* fake ret to make copy protections happy */
 243 #elif defined(__x86_64__)
 244 #define DEFINE_REGS_ENTRYPOINT( name, args ) \
 245     __ASM_GLOBAL_FUNC( name, \
 246                        "movq %rcx,8(%rsp)\n\t"  \
 247                        "movq %rdx,16(%rsp)\n\t" \
 248                        "movq $" #args ",%rcx\n\t" \
 249                        "leaq " __ASM_NAME("__regs_") #name "(%rip),%rdx\n\t" \
 250                        "call " __ASM_NAME("__wine_call_from_regs"))
 251 #endif
 252
 253 #endif