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 #if defined(__i386__) || defined(__x86_64__)
  37 static const UINT_PTR page_size = 0x1000;
  38 #else
  39 extern UINT_PTR page_size DECLSPEC_HIDDEN;
  40 #endif
  41
  42 struct drive_info
  43 {
  44     dev_t dev;
  45     ino_t ino;
  46 };
  47
  48 extern NTSTATUS close_handle( HANDLE ) DECLSPEC_HIDDEN;
  49 extern ULONG_PTR get_system_affinity_mask(void) DECLSPEC_HIDDEN;
  50
  51 /* exceptions */
  52 extern void wait_suspend( CONTEXT *context ) DECLSPEC_HIDDEN;
  53 extern NTSTATUS send_debug_event( EXCEPTION_RECORD *rec, int first_chance, CONTEXT *context ) DECLSPEC_HIDDEN;
  54 extern LONG call_vectored_handlers( EXCEPTION_RECORD *rec, CONTEXT *context ) DECLSPEC_HIDDEN;
  55 extern void raise_status( NTSTATUS status, EXCEPTION_RECORD *rec ) DECLSPEC_NORETURN DECLSPEC_HIDDEN;
  56 extern NTSTATUS context_to_server( context_t *to, const CONTEXT *from ) DECLSPEC_HIDDEN;
  57 extern NTSTATUS context_from_server( CONTEXT *to, const context_t *from ) DECLSPEC_HIDDEN;
  58 extern NTSTATUS set_thread_context( HANDLE handle, const CONTEXT *context, BOOL *self ) DECLSPEC_HIDDEN;
  59 extern NTSTATUS get_thread_context( HANDLE handle, CONTEXT *context, BOOL *self ) DECLSPEC_HIDDEN;
  60 extern void call_thread_entry_point( LPTHREAD_START_ROUTINE entry, void *arg ) DECLSPEC_NORETURN DECLSPEC_HIDDEN;
  61
  62 /* debug helpers */
  63 extern LPCSTR debugstr_us( const UNICODE_STRING *str ) DECLSPEC_HIDDEN;
  64 extern LPCSTR debugstr_ObjectAttributes(const OBJECT_ATTRIBUTES *oa) DECLSPEC_HIDDEN;
  65
  66 /* init routines */
  67 extern NTSTATUS signal_alloc_thread( TEB **teb ) DECLSPEC_HIDDEN;
  68 extern void signal_free_thread( TEB *teb ) DECLSPEC_HIDDEN;
  69 extern void signal_init_thread( TEB *teb ) DECLSPEC_HIDDEN;
  70 extern void signal_init_process( CONTEXT *context, LPTHREAD_START_ROUTINE entry ) DECLSPEC_HIDDEN;
  71 extern void version_init( const WCHAR *appname ) DECLSPEC_HIDDEN;
  72 extern void debug_init(void) DECLSPEC_HIDDEN;
  73 extern HANDLE thread_init(void) DECLSPEC_HIDDEN;
  74 extern void actctx_init(void) DECLSPEC_HIDDEN;
  75 extern void virtual_init(void) DECLSPEC_HIDDEN;
  76 extern void virtual_init_threading(void) DECLSPEC_HIDDEN;
  77 extern void fill_cpu_info(void) DECLSPEC_HIDDEN;
  78 extern void heap_set_debug_flags( HANDLE handle ) DECLSPEC_HIDDEN;
  79
  80 /* server support */
  81 extern timeout_t server_start_time DECLSPEC_HIDDEN;
  82 extern unsigned int server_cpus DECLSPEC_HIDDEN;
  83 extern BOOL is_wow64 DECLSPEC_HIDDEN;
  84 extern void server_init_process(void) DECLSPEC_HIDDEN;
  85 extern NTSTATUS server_init_process_done( CONTEXT *context ) DECLSPEC_HIDDEN;
  86 extern size_t server_init_thread( void *entry_point ) DECLSPEC_HIDDEN;
  87 extern void DECLSPEC_NORETURN abort_thread( int status ) DECLSPEC_HIDDEN;
  88 extern void DECLSPEC_NORETURN terminate_thread( int status ) DECLSPEC_HIDDEN;
  89 extern void DECLSPEC_NORETURN exit_thread( int status ) DECLSPEC_HIDDEN;
  90 extern sigset_t server_block_set DECLSPEC_HIDDEN;
  91 extern unsigned int server_call_unlocked( void *req_ptr ) DECLSPEC_HIDDEN;
  92 extern void server_enter_uninterrupted_section( RTL_CRITICAL_SECTION *cs, sigset_t *sigset ) DECLSPEC_HIDDEN;
  93 extern void server_leave_uninterrupted_section( RTL_CRITICAL_SECTION *cs, sigset_t *sigset ) DECLSPEC_HIDDEN;
  94 extern unsigned int server_select( const select_op_t *select_op, data_size_t size,
  95                                    UINT flags, const LARGE_INTEGER *timeout ) DECLSPEC_HIDDEN;
  96 extern unsigned int server_queue_process_apc( HANDLE process, const apc_call_t *call, apc_result_t *result ) DECLSPEC_HIDDEN;
  97 extern int server_remove_fd_from_cache( HANDLE handle ) DECLSPEC_HIDDEN;
  98 extern int server_get_unix_fd( HANDLE handle, unsigned int access, int *unix_fd,
  99                                int *needs_close, enum server_fd_type *type, unsigned int *options ) DECLSPEC_HIDDEN;
 100 extern int server_pipe( int fd[2] ) DECLSPEC_HIDDEN;
 101 extern NTSTATUS alloc_object_attributes( const OBJECT_ATTRIBUTES *attr, struct object_attributes **ret,
 102                                          data_size_t *ret_len ) DECLSPEC_HIDDEN;
 103 extern NTSTATUS validate_open_object_attributes( const OBJECT_ATTRIBUTES *attr ) DECLSPEC_HIDDEN;
 104
 105 /* module handling */
 106 extern LIST_ENTRY tls_links DECLSPEC_HIDDEN;
 107 extern NTSTATUS MODULE_DllThreadAttach( LPVOID lpReserved ) DECLSPEC_HIDDEN;
 108 extern FARPROC RELAY_GetProcAddress( HMODULE module, const IMAGE_EXPORT_DIRECTORY *exports,
 109                                      DWORD exp_size, FARPROC proc, DWORD ordinal, const WCHAR *user ) DECLSPEC_HIDDEN;
 110 extern FARPROC SNOOP_GetProcAddress( HMODULE hmod, const IMAGE_EXPORT_DIRECTORY *exports, DWORD exp_size,
 111                                      FARPROC origfun, DWORD ordinal, const WCHAR *user ) DECLSPEC_HIDDEN;
 112 extern void RELAY_SetupDLL( HMODULE hmod ) DECLSPEC_HIDDEN;
 113 extern void SNOOP_SetupDLL( HMODULE hmod ) DECLSPEC_HIDDEN;
 114 extern UNICODE_STRING system_dir DECLSPEC_HIDDEN;
 115
 116 typedef LONG (WINAPI *PUNHANDLED_EXCEPTION_FILTER)(PEXCEPTION_POINTERS);
 117 extern PUNHANDLED_EXCEPTION_FILTER unhandled_exception_filter DECLSPEC_HIDDEN;
 118 extern LPTHREAD_START_ROUTINE kernel32_start_process DECLSPEC_HIDDEN;
 119
 120 /* redefine these to make sure we don't reference kernel symbols */
 121 #define GetProcessHeap()       (NtCurrentTeb()->Peb->ProcessHeap)
 122 #define GetCurrentProcessId()  (HandleToULong(NtCurrentTeb()->ClientId.UniqueProcess))
 123 #define GetCurrentThreadId()   (HandleToULong(NtCurrentTeb()->ClientId.UniqueThread))
 124
 125 /* Device IO */
 126 extern NTSTATUS CDROM_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) DECLSPEC_HIDDEN;
 133 extern NTSTATUS COMM_DeviceIoControl(HANDLE hDevice,
 134                                      HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
 135                                      PVOID UserApcContext,
 136                                      PIO_STATUS_BLOCK piosb,
 137                                      ULONG IoControlCode,
 138                                      LPVOID lpInBuffer, DWORD nInBufferSize,
 139                                      LPVOID lpOutBuffer, DWORD nOutBufferSize) DECLSPEC_HIDDEN;
 140 extern NTSTATUS TAPE_DeviceIoControl(HANDLE hDevice,
 141                                      HANDLE hEvent, PIO_APC_ROUTINE UserApcRoutine,
 142                                      PVOID UserApcContext,
 143                                      PIO_STATUS_BLOCK piosb,
 144                                      ULONG IoControlCode,
 145                                      LPVOID lpInBuffer, DWORD nInBufferSize,
 146                                      LPVOID lpOutBuffer, DWORD nOutBufferSize) DECLSPEC_HIDDEN;
 147 extern NTSTATUS COMM_FlushBuffersFile( int fd ) DECLSPEC_HIDDEN;
 148
 149 /* file I/O */
 150 struct stat;
 151 extern NTSTATUS FILE_GetNtStatus(void) DECLSPEC_HIDDEN;
 152 extern int get_file_info( const char *path, struct stat *st, ULONG *attr ) DECLSPEC_HIDDEN;
 153 extern NTSTATUS fill_file_info( const struct stat *st, ULONG attr, void *ptr,
 154                                 FILE_INFORMATION_CLASS class ) DECLSPEC_HIDDEN;
 155 extern NTSTATUS server_get_unix_name( HANDLE handle, ANSI_STRING *unix_name ) DECLSPEC_HIDDEN;
 156 extern void DIR_init_windows_dir( const WCHAR *windir, const WCHAR *sysdir ) DECLSPEC_HIDDEN;
 157 extern BOOL DIR_is_hidden_file( const UNICODE_STRING *name ) DECLSPEC_HIDDEN;
 158 extern NTSTATUS DIR_unmount_device( HANDLE handle ) DECLSPEC_HIDDEN;
 159 extern NTSTATUS DIR_get_unix_cwd( char **cwd ) DECLSPEC_HIDDEN;
 160 extern unsigned int DIR_get_drives_info( struct drive_info info[MAX_DOS_DRIVES] ) DECLSPEC_HIDDEN;
 161 extern NTSTATUS file_id_to_unix_file_name( const OBJECT_ATTRIBUTES *attr, ANSI_STRING *unix_name_ret ) DECLSPEC_HIDDEN;
 162 extern NTSTATUS nt_to_unix_file_name_attr( const OBJECT_ATTRIBUTES *attr, ANSI_STRING *unix_name_ret,
 163                                            UINT disposition ) DECLSPEC_HIDDEN;
 164
 165 /* virtual memory */
 166 extern void virtual_get_system_info( SYSTEM_BASIC_INFORMATION *info ) DECLSPEC_HIDDEN;
 167 extern NTSTATUS virtual_create_builtin_view( void *base ) DECLSPEC_HIDDEN;
 168 extern NTSTATUS virtual_alloc_thread_stack( TEB *teb, SIZE_T reserve_size, SIZE_T commit_size ) DECLSPEC_HIDDEN;
 169 extern void virtual_clear_thread_stack(void) DECLSPEC_HIDDEN;
 170 extern BOOL virtual_handle_stack_fault( void *addr ) DECLSPEC_HIDDEN;
 171 extern BOOL virtual_is_valid_code_address( const void *addr, SIZE_T size ) DECLSPEC_HIDDEN;
 172 extern NTSTATUS virtual_handle_fault( LPCVOID addr, DWORD err, BOOL on_signal_stack ) DECLSPEC_HIDDEN;
 173 extern unsigned int virtual_locked_server_call( void *req_ptr ) DECLSPEC_HIDDEN;
 174 extern ssize_t virtual_locked_read( int fd, void *addr, size_t size ) DECLSPEC_HIDDEN;
 175 extern ssize_t virtual_locked_pread( int fd, void *addr, size_t size, off_t offset ) DECLSPEC_HIDDEN;
 176 extern BOOL virtual_check_buffer_for_read( const void *ptr, SIZE_T size ) DECLSPEC_HIDDEN;
 177 extern BOOL virtual_check_buffer_for_write( void *ptr, SIZE_T size ) DECLSPEC_HIDDEN;
 178 extern SIZE_T virtual_uninterrupted_read_memory( const void *addr, void *buffer, SIZE_T size ) DECLSPEC_HIDDEN;
 179 extern NTSTATUS virtual_uninterrupted_write_memory( void *addr, const void *buffer, SIZE_T size ) DECLSPEC_HIDDEN;
 180 extern void VIRTUAL_SetForceExec( BOOL enable ) DECLSPEC_HIDDEN;
 181 extern void virtual_release_address_space(void) DECLSPEC_HIDDEN;
 182 extern void virtual_set_large_address_space(void) DECLSPEC_HIDDEN;
 183 extern struct _KUSER_SHARED_DATA *user_shared_data DECLSPEC_HIDDEN;
 184
 185 /* completion */
 186 extern NTSTATUS NTDLL_AddCompletion( HANDLE hFile, ULONG_PTR CompletionValue,
 187                                      NTSTATUS CompletionStatus, ULONG Information ) DECLSPEC_HIDDEN;
 188
 189 /* code pages */
 190 extern int ntdll_umbstowcs(DWORD flags, const char* src, int srclen, WCHAR* dst, int dstlen) DECLSPEC_HIDDEN;
 191 extern int ntdll_wcstoumbs(DWORD flags, const WCHAR* src, int srclen, char* dst, int dstlen,
 192                            const char* defchar, int *used ) DECLSPEC_HIDDEN;
 193
 194 extern int CDECL NTDLL__vsnprintf( char *str, SIZE_T len, const char *format, __ms_va_list args ) DECLSPEC_HIDDEN;
 195 extern int CDECL NTDLL__vsnwprintf( WCHAR *str, SIZE_T len, const WCHAR *format, __ms_va_list args ) DECLSPEC_HIDDEN;
 196
 197 /* load order */
 198
 199 enum loadorder
 200 {
 201     LO_INVALID,
 202     LO_DISABLED,
 203     LO_NATIVE,
 204     LO_BUILTIN,
 205     LO_NATIVE_BUILTIN,  /* native then builtin */
 206     LO_BUILTIN_NATIVE,  /* builtin then native */
 207     LO_DEFAULT          /* nothing specified, use default strategy */
 208 };
 209
 210 extern enum loadorder get_load_order( const WCHAR *app_name, const WCHAR *path ) DECLSPEC_HIDDEN;
 211
 212 struct debug_info
 213 {
 214     char *str_pos;       /* current position in strings buffer */
 215     char *out_pos;       /* current position in output buffer */
 216     char  strings[1024]; /* buffer for temporary strings */
 217     char  output[1024];  /* current output line */
 218 };
 219
 220 /* thread private data, stored in NtCurrentTeb()->GdiTebBatch */
 221 struct ntdll_thread_data
 222 {
 223 #ifdef __i386__
 224     WINE_VM86_TEB_INFO __vm86;        /* FIXME: placeholder for vm86 data from struct x86_thread_data */
 225 #endif
 226     struct debug_info *debug_info;    /* info for debugstr functions */
 227     int                request_fd;    /* fd for sending server requests */
 228     int                reply_fd;      /* fd for receiving server replies */
 229     int                wait_fd[2];    /* fd for sleeping server requests */
 230     BOOL               wow64_redir;   /* Wow64 filesystem redirection flag */
 231     pthread_t          pthread_id;    /* pthread thread id */
 232 };
 233
 234 C_ASSERT( sizeof(struct ntdll_thread_data) <= sizeof(((TEB *)0)->GdiTebBatch) );
 235 #ifdef __i386__
 236 C_ASSERT( offsetof( TEB, GdiTebBatch ) + offsetof( struct ntdll_thread_data, __vm86 ) == 0x1fc );
 237 #endif
 238
 239 static inline struct ntdll_thread_data *ntdll_get_thread_data(void)
 240 {
 241     return (struct ntdll_thread_data *)&NtCurrentTeb()->GdiTebBatch;
 242 }
 243
 244 extern mode_t FILE_umask DECLSPEC_HIDDEN;
 245 extern HANDLE keyed_event DECLSPEC_HIDDEN;
 246
 247 #define HASH_STRING_ALGORITHM_DEFAULT  0
 248 #define HASH_STRING_ALGORITHM_X65599   1
 249 #define HASH_STRING_ALGORITHM_INVALID  0xffffffff
 250
 251 NTSTATUS WINAPI RtlHashUnicodeString(PCUNICODE_STRING,BOOLEAN,ULONG,ULONG*);
 252
 253 #endif