dlls/ntdll/rtl.c

   1 /*
   2  * NT basis DLL
   3  *
   4  * This file contains the Rtl* API functions. These should be implementable.
   5  *
   6  * Copyright 1996-1998 Marcus Meissner
   7  * Copyright 1999      Alex Korobka
   8  * Copyright 2003      Thomas Mertes
   9  * Crc32 code Copyright 1986 Gary S. Brown (Public domain)
  10  *
  11  * This library is free software; you can redistribute it and/or
  12  * modify it under the terms of the GNU Lesser General Public
  13  * License as published by the Free Software Foundation; either
  14  * version 2.1 of the License, or (at your option) any later version.
  15  *
  16  * This library is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19  * Lesser General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU Lesser General Public
  22  * License along with this library; if not, write to the Free Software
  23  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  24  */
  25
  26 #include "config.h"
  27 #include "wine/port.h"
  28
  29 #include <stdlib.h>
  30 #include <stdio.h>
  31 #include <string.h>
  32 #include "windef.h"
  33 #include "winerror.h"
  34 #include "winternl.h"
  35 #include "winreg.h"
  36 #include "wine/unicode.h"
  37 #include "wine/debug.h"
  38 #include "ntdll_misc.h"
  39
  40 WINE_DEFAULT_DEBUG_CHANNEL(ntdll);
  41
  42
  43 static RTL_CRITICAL_SECTION peb_lock = CRITICAL_SECTION_INIT("peb_lock");
  44
  45 /* CRC polynomial 0xedb88320 */
  46 static const DWORD CRC_table[256] =
  47 {
  48     0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419, 0x706af48f,
  49     0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4, 0xe0d5e91e, 0x97d2d988,
  50     0x09b64c2b, 0x7eb17cbd, 0xe7b82d07, 0x90bf1d91, 0x1db71064, 0x6ab020f2,
  51     0xf3b97148, 0x84be41de, 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7,
  52     0x136c9856, 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
  53     0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4, 0xa2677172,
  54     0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b, 0x35b5a8fa, 0x42b2986c,
  55     0xdbbbc9d6, 0xacbcf940, 0x32d86ce3, 0x45df5c75, 0xdcd60dcf, 0xabd13d59,
  56     0x26d930ac, 0x51de003a, 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423,
  57     0xcfba9599, 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
  58     0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190, 0x01db7106,
  59     0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f, 0x9fbfe4a5, 0xe8b8d433,
  60     0x7807c9a2, 0x0f00f934, 0x9609a88e, 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d,
  61     0x91646c97, 0xe6635c01, 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e,
  62     0x6c0695ed, 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
  63     0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3, 0xfbd44c65,
  64     0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2, 0x4adfa541, 0x3dd895d7,
  65     0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a, 0x346ed9fc, 0xad678846, 0xda60b8d0,
  66     0x44042d73, 0x33031de5, 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa,
  67     0xbe0b1010, 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
  68     0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17, 0x2eb40d81,
  69     0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6, 0x03b6e20c, 0x74b1d29a,
  70     0xead54739, 0x9dd277af, 0x04db2615, 0x73dc1683, 0xe3630b12, 0x94643b84,
  71     0x0d6d6a3e, 0x7a6a5aa8, 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1,
  72     0xf00f9344, 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
  73     0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a, 0x67dd4acc,
  74     0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5, 0xd6d6a3e8, 0xa1d1937e,
  75     0x38d8c2c4, 0x4fdff252, 0xd1bb67f1, 0xa6bc5767, 0x3fb506dd, 0x48b2364b,
  76     0xd80d2bda, 0xaf0a1b4c, 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55,
  77     0x316e8eef, 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
  78     0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe, 0xb2bd0b28,
  79     0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31, 0x2cd99e8b, 0x5bdeae1d,
  80     0x9b64c2b0, 0xec63f226, 0x756aa39c, 0x026d930a, 0x9c0906a9, 0xeb0e363f,
  81     0x72076785, 0x05005713, 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38,
  82     0x92d28e9b, 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
  83     0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1, 0x18b74777,
  84     0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c, 0x8f659eff, 0xf862ae69,
  85     0x616bffd3, 0x166ccf45, 0xa00ae278, 0xd70dd2ee, 0x4e048354, 0x3903b3c2,
  86     0xa7672661, 0xd06016f7, 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc,
  87     0x40df0b66, 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
  88     0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605, 0xcdd70693,
  89     0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8, 0x5d681b02, 0x2a6f2b94,
  90     0xb40bbe37, 0xc30c8ea1, 0x5a05df1b, 0x2d02ef8d
  91 };
  92
  93 /*
  94  *      resource functions
  95  */
  96
  97 /***********************************************************************
  98  *           RtlInitializeResource      (NTDLL.@)
  99  *
 100  * xxxResource() functions implement multiple-reader-single-writer lock.
 101  * The code is based on information published in WDJ January 1999 issue.
 102  */
 103 void WINAPI RtlInitializeResource(LPRTL_RWLOCK rwl)
 104 {
 105     if( rwl )
 106     {
 107         rwl->iNumberActive = 0;
 108         rwl->uExclusiveWaiters = 0;
 109         rwl->uSharedWaiters = 0;
 110         rwl->hOwningThreadId = 0;
 111         rwl->dwTimeoutBoost = 0; /* no info on this one, default value is 0 */
 112         RtlInitializeCriticalSection( &rwl->rtlCS );
 113         NtCreateSemaphore( &rwl->hExclusiveReleaseSemaphore, 0, NULL, 0, 65535 );
 114         NtCreateSemaphore( &rwl->hSharedReleaseSemaphore, 0, NULL, 0, 65535 );
 115     }
 116 }
 117
 118
 119 /***********************************************************************
 120  *           RtlDeleteResource          (NTDLL.@)
 121  */
 122 void WINAPI RtlDeleteResource(LPRTL_RWLOCK rwl)
 123 {
 124     if( rwl )
 125     {
 126         RtlEnterCriticalSection( &rwl->rtlCS );
 127         if( rwl->iNumberActive || rwl->uExclusiveWaiters || rwl->uSharedWaiters )
 128             MESSAGE("Deleting active MRSW lock (%p), expect failure\n", rwl );
 129         rwl->hOwningThreadId = 0;
 130         rwl->uExclusiveWaiters = rwl->uSharedWaiters = 0;
 131         rwl->iNumberActive = 0;
 132         NtClose( rwl->hExclusiveReleaseSemaphore );
 133         NtClose( rwl->hSharedReleaseSemaphore );
 134         RtlLeaveCriticalSection( &rwl->rtlCS );
 135         RtlDeleteCriticalSection( &rwl->rtlCS );
 136     }
 137 }
 138
 139
 140 /***********************************************************************
 141  *          RtlAcquireResourceExclusive (NTDLL.@)
 142  */
 143 BYTE WINAPI RtlAcquireResourceExclusive(LPRTL_RWLOCK rwl, BYTE fWait)
 144 {
 145     BYTE retVal = 0;
 146     if( !rwl ) return 0;
 147
 148 start:
 149     RtlEnterCriticalSection( &rwl->rtlCS );
 150     if( rwl->iNumberActive == 0 ) /* lock is free */
 151     {
 152         rwl->iNumberActive = -1;
 153         retVal = 1;
 154     }
 155     else if( rwl->iNumberActive < 0 ) /* exclusive lock in progress */
 156     {
 157          if( rwl->hOwningThreadId == (HANDLE)GetCurrentThreadId() )
 158          {
 159              retVal = 1;
 160              rwl->iNumberActive--;
 161              goto done;
 162          }
 163 wait:
 164          if( fWait )
 165          {
 166              rwl->uExclusiveWaiters++;
 167
 168              RtlLeaveCriticalSection( &rwl->rtlCS );
 169              if( NtWaitForSingleObject( rwl->hExclusiveReleaseSemaphore, FALSE, NULL ) == WAIT_FAILED )
 170                  goto done;
 171              goto start; /* restart the acquisition to avoid deadlocks */
 172          }
 173     }
 174     else  /* one or more shared locks are in progress */
 175          if( fWait )
 176              goto wait;
 177
 178     if( retVal == 1 )
 179         rwl->hOwningThreadId = (HANDLE)GetCurrentThreadId();
 180 done:
 181     RtlLeaveCriticalSection( &rwl->rtlCS );
 182     return retVal;
 183 }
 184
 185 /***********************************************************************
 186  *          RtlAcquireResourceShared    (NTDLL.@)
 187  */
 188 BYTE WINAPI RtlAcquireResourceShared(LPRTL_RWLOCK rwl, BYTE fWait)
 189 {
 190     DWORD dwWait = WAIT_FAILED;
 191     BYTE retVal = 0;
 192     if( !rwl ) return 0;
 193
 194 start:
 195     RtlEnterCriticalSection( &rwl->rtlCS );
 196     if( rwl->iNumberActive < 0 )
 197     {
 198         if( rwl->hOwningThreadId == (HANDLE)GetCurrentThreadId() )
 199         {
 200             rwl->iNumberActive--;
 201             retVal = 1;
 202             goto done;
 203         }
 204
 205         if( fWait )
 206         {
 207             rwl->uSharedWaiters++;
 208             RtlLeaveCriticalSection( &rwl->rtlCS );
 209             if( (dwWait = NtWaitForSingleObject( rwl->hSharedReleaseSemaphore, FALSE, NULL )) == WAIT_FAILED )
 210                 goto done;
 211             goto start;
 212         }
 213     }
 214     else
 215     {
 216         if( dwWait != WAIT_OBJECT_0 ) /* otherwise RtlReleaseResource() has already done it */
 217             rwl->iNumberActive++;
 218         retVal = 1;
 219     }
 220 done:
 221     RtlLeaveCriticalSection( &rwl->rtlCS );
 222     return retVal;
 223 }
 224
 225
 226 /***********************************************************************
 227  *           RtlReleaseResource         (NTDLL.@)
 228  */
 229 void WINAPI RtlReleaseResource(LPRTL_RWLOCK rwl)
 230 {
 231     RtlEnterCriticalSection( &rwl->rtlCS );
 232
 233     if( rwl->iNumberActive > 0 ) /* have one or more readers */
 234     {
 235         if( --rwl->iNumberActive == 0 )
 236         {
 237             if( rwl->uExclusiveWaiters )
 238             {
 239 wake_exclusive:
 240                 rwl->uExclusiveWaiters--;
 241                 NtReleaseSemaphore( rwl->hExclusiveReleaseSemaphore, 1, NULL );
 242             }
 243         }
 244     }
 245     else
 246     if( rwl->iNumberActive < 0 ) /* have a writer, possibly recursive */
 247     {
 248         if( ++rwl->iNumberActive == 0 )
 249         {
 250             rwl->hOwningThreadId = 0;
 251             if( rwl->uExclusiveWaiters )
 252                 goto wake_exclusive;
 253             else
 254                 if( rwl->uSharedWaiters )
 255                 {
 256                     UINT n = rwl->uSharedWaiters;
 257                     rwl->iNumberActive = rwl->uSharedWaiters; /* prevent new writers from joining until
 258                                                                * all queued readers have done their thing */
 259                     rwl->uSharedWaiters = 0;
 260                     NtReleaseSemaphore( rwl->hSharedReleaseSemaphore, n, NULL );
 261                 }
 262         }
 263     }
 264     RtlLeaveCriticalSection( &rwl->rtlCS );
 265 }
 266
 267
 268 /***********************************************************************
 269  *           RtlDumpResource            (NTDLL.@)
 270  */
 271 void WINAPI RtlDumpResource(LPRTL_RWLOCK rwl)
 272 {
 273     if( rwl )
 274     {
 275         MESSAGE("RtlDumpResource(%p):\n\tactive count = %i\n\twaiting readers = %i\n\twaiting writers = %i\n",
 276                 rwl, rwl->iNumberActive, rwl->uSharedWaiters, rwl->uExclusiveWaiters );
 277         if( rwl->iNumberActive )
 278             MESSAGE("\towner thread = %p\n", rwl->hOwningThreadId );
 279     }
 280 }
 281
 282 /*
 283  *      misc functions
 284  */
 285
 286 /******************************************************************************
 287  *      DbgPrint        [NTDLL.@]
 288  */
 289 void WINAPIV DbgPrint(LPCSTR fmt, ...)
 290 {
 291        char buf[512];
 292        va_list args;
 293
 294        va_start(args, fmt);
 295        vsprintf(buf,fmt, args);
 296        va_end(args);
 297
 298         MESSAGE("DbgPrint says: %s",buf);
 299         /* hmm, raise exception? */
 300 }
 301
 302 /******************************************************************************
 303  *  RtlAcquirePebLock           [NTDLL.@]
 304  */
 305 VOID WINAPI RtlAcquirePebLock(void)
 306 {
 307     RtlEnterCriticalSection( &peb_lock );
 308 }
 309
 310 /******************************************************************************
 311  *  RtlReleasePebLock           [NTDLL.@]
 312  */
 313 VOID WINAPI RtlReleasePebLock(void)
 314 {
 315     RtlLeaveCriticalSection( &peb_lock );
 316 }
 317
 318 /******************************************************************************
 319  *  RtlSetEnvironmentVariable           [NTDLL.@]
 320  */
 321 DWORD WINAPI RtlSetEnvironmentVariable(DWORD x1,PUNICODE_STRING key,PUNICODE_STRING val) {
 322         FIXME("(0x%08lx,%s,%s),stub!\n",x1,debugstr_w(key->Buffer),debugstr_w(val->Buffer));
 323         return 0;
 324 }
 325
 326 /******************************************************************************
 327  *  RtlNewSecurityObject                [NTDLL.@]
 328  */
 329 DWORD WINAPI RtlNewSecurityObject(DWORD x1,DWORD x2,DWORD x3,DWORD x4,DWORD x5,DWORD x6) {
 330         FIXME("(0x%08lx,0x%08lx,0x%08lx,0x%08lx,0x%08lx,0x%08lx),stub!\n",x1,x2,x3,x4,x5,x6);
 331         return 0;
 332 }
 333
 334 /******************************************************************************
 335  *  RtlDeleteSecurityObject             [NTDLL.@]
 336  */
 337 DWORD WINAPI RtlDeleteSecurityObject(DWORD x1) {
 338         FIXME("(0x%08lx),stub!\n",x1);
 339         return 0;
 340 }
 341
 342 /**************************************************************************
 343  *                 RtlNormalizeProcessParams            [NTDLL.@]
 344  */
 345 LPVOID WINAPI RtlNormalizeProcessParams(LPVOID x)
 346 {
 347     FIXME("(%p), stub\n",x);
 348     return x;
 349 }
 350
 351 /**************************************************************************
 352  *                 RtlGetNtProductType                  [NTDLL.@]
 353  */
 354 BOOLEAN WINAPI RtlGetNtProductType(LPDWORD type)
 355 {
 356     FIXME("(%p): stub\n", type);
 357     *type=3; /* dunno. 1 for client, 3 for server? */
 358     return 1;
 359 }
 360
 361 /**************************************************************************
 362  *                 _chkstk                              [NTDLL.@]
 363  *
 364  * Glorified "enter xxxx".
 365  */
 366 void WINAPI NTDLL_chkstk( CONTEXT86 *context )
 367 {
 368     context->Esp -= context->Eax;
 369 }
 370
 371 /**************************************************************************
 372  *                 _alloca_probe                        [NTDLL.@]
 373  *
 374  * Glorified "enter xxxx".
 375  */
 376 void WINAPI NTDLL_alloca_probe( CONTEXT86 *context )
 377 {
 378     context->Esp -= context->Eax;
 379 }
 380
 381 /**************************************************************************
 382  *                 RtlDosPathNameToNtPathName_U         [NTDLL.@]
 383  *
 384  * szwDosPath: a fully qualified DOS path name
 385  * ntpath:     pointer to a UNICODE_STRING to hold the converted
 386  *              path name
 387  *
 388  * FIXME: Should we not allocate the ntpath buffer under some
 389  *         circumstances?
 390  *        Are the conversions static? (always prepend '\??\' ?)
 391  *        Not really sure about the last two arguments.
 392  */
 393 BOOLEAN  WINAPI RtlDosPathNameToNtPathName_U(
 394         LPWSTR szwDosPath,PUNICODE_STRING ntpath,
 395         DWORD x2,DWORD x3)
 396 {
 397     ULONG length;
 398     UNICODE_STRING pathprefix;
 399     WCHAR szPrefix[] = { '\\', '?', '?', '\\', 0 };
 400
 401     FIXME("(%s,%p,%08lx,%08lx) partial stub\n",
 402         debugstr_w(szwDosPath),ntpath,x2,x3);
 403
 404     if ( !szwDosPath )
 405         return FALSE;
 406
 407     if ( !szwDosPath[0] )
 408         return FALSE;
 409
 410     if ( szwDosPath[1]!= ':' )
 411         return FALSE;
 412
 413     length = strlenW(szwDosPath) * sizeof (WCHAR) + sizeof szPrefix;
 414
 415     ntpath->Buffer = RtlAllocateHeap(ntdll_get_process_heap(), 0, length);
 416     ntpath->Length = 0;
 417     ntpath->MaximumLength = length;
 418
 419     if ( !ntpath->Buffer )
 420         return FALSE;
 421
 422     RtlInitUnicodeString( &pathprefix, szPrefix );
 423     RtlCopyUnicodeString( ntpath, &pathprefix );
 424     RtlAppendUnicodeToString( ntpath, szwDosPath );
 425
 426     return TRUE;
 427 }
 428
 429
 430 /******************************************************************************
 431  *  RtlCreateEnvironment                [NTDLL.@]
 432  */
 433 DWORD WINAPI RtlCreateEnvironment(DWORD x1,DWORD x2) {
 434         FIXME("(0x%08lx,0x%08lx),stub!\n",x1,x2);
 435         return 0;
 436 }
 437
 438
 439 /******************************************************************************
 440  *  RtlDestroyEnvironment               [NTDLL.@]
 441  */
 442 DWORD WINAPI RtlDestroyEnvironment(DWORD x) {
 443         FIXME("(0x%08lx),stub!\n",x);
 444         return 0;
 445 }
 446
 447 /******************************************************************************
 448  *  RtlQueryEnvironmentVariable_U               [NTDLL.@]
 449  */
 450 DWORD WINAPI RtlQueryEnvironmentVariable_U(DWORD x1,PUNICODE_STRING key,PUNICODE_STRING val) {
 451         FIXME("(0x%08lx,%s,%p),stub!\n",x1,debugstr_w(key->Buffer),val);
 452         return 0;
 453 }
 454
 455 /******************************************************************************
 456  *  RtlInitializeGenericTable           [NTDLL.@]
 457  */
 458 PVOID WINAPI RtlInitializeGenericTable(PVOID pTable, PVOID arg2, PVOID arg3, PVOID arg4, PVOID arg5)
 459 {
 460   FIXME("(%p,%p,%p,%p,%p) stub!\n", pTable, arg2, arg3, arg4, arg5);
 461   return NULL;
 462 }
 463
 464 /******************************************************************************
 465  *  RtlMoveMemory   [NTDLL.@]
 466  *
 467  * Move a block of memory that may overlap.
 468  *
 469  * PARAMS
 470  *  Destination [O] End destination for block
 471  *  Source      [O] Where to start copying from
 472  *  Length      [I] Number of bytes to copy
 473  *
 474  * RETURNS
 475  *  Nothing.
 476  */
 477 #undef RtlMoveMemory
 478 VOID WINAPI RtlMoveMemory( VOID *Destination, CONST VOID *Source, SIZE_T Length )
 479 {
 480     memmove(Destination, Source, Length);
 481 }
 482
 483 /******************************************************************************
 484  *  RtlFillMemory   [NTDLL.@]
 485  *
 486  * Set a block of memory with a value.
 487  *
 488  * PARAMS
 489  *  Destination [O] Block to fill
 490  *  Length      [I] Number of bytes to fill
 491  *  Fill        [I] Value to set
 492  *
 493  * RETURNS
 494  *  Nothing.
 495  */
 496 #undef RtlFillMemory
 497 VOID WINAPI RtlFillMemory( VOID *Destination, SIZE_T Length, BYTE Fill )
 498 {
 499     memset(Destination, Fill, Length);
 500 }
 501
 502 /******************************************************************************
 503  *  RtlZeroMemory   [NTDLL.@]
 504  *
 505  * Set a block of memory with 0's.
 506  *
 507  * PARAMS
 508  *  Destination [O] Block to fill
 509  *  Length      [I] Number of bytes to fill
 510  *
 511  * RETURNS
 512  *  Nothing.
 513  */
 514 #undef RtlZeroMemory
 515 VOID WINAPI RtlZeroMemory( VOID *Destination, SIZE_T Length )
 516 {
 517     memset(Destination, 0, Length);
 518 }
 519
 520 /******************************************************************************
 521  *  RtlCompareMemory   [NTDLL.@]
 522  *
 523  * Compare one block of memory with another
 524  *
 525  * PARAMS
 526  *  Source1 [I] Source block
 527  *  Source2 [I] Block to compare to Source1
 528  *  Length  [I] Number of bytes to fill
 529  *
 530  * RETURNS
 531  *  The length of the first byte at which Source1 and Source2 differ, or Length
 532  *  if they are the same.
 533  */
 534 SIZE_T WINAPI RtlCompareMemory( const VOID *Source1, const VOID *Source2, SIZE_T Length)
 535 {
 536     SIZE_T i;
 537     for(i=0; (i<Length) && (((LPBYTE)Source1)[i]==((LPBYTE)Source2)[i]); i++);
 538     return i;
 539 }
 540
 541 /******************************************************************************
 542  *  RtlCompareMemoryUlong   [NTDLL.@]
 543  *
 544  * Compare a block of memory with a value, a ULONG at a time
 545  *
 546  * PARAMS
 547  *  Source1 [I] Source block. This must be ULONG aligned
 548  *  Length  [I] Number of bytes to compare. This should be a multiple of 4
 549  *  dwVal   [I] Value to compare to
 550  *
 551  * RETURNS
 552  *  The byte position of the first byte at which Source1 is not dwVal.
 553  */
 554 SIZE_T WINAPI RtlCompareMemoryUlong(const ULONG *Source1, SIZE_T Length, ULONG dwVal)
 555 {
 556     SIZE_T i;
 557     for(i = 0; i < Length/sizeof(ULONG) && Source1[i] == dwVal; i++);
 558     return i * sizeof(ULONG);
 559 }
 560
 561 /******************************************************************************
 562  *  RtlAssert                           [NTDLL.@]
 563  *
 564  * Fail a debug assertion.
 565  *
 566  * RETURNS
 567  *  Nothing. This call does not return control to its caller.
 568  *
 569  * NOTES
 570  * Not implemented in non-debug versions.
 571  */
 572 void WINAPI RtlAssert(LPVOID x1,LPVOID x2,DWORD x3, DWORD x4)
 573 {
 574         FIXME("(%p,%p,0x%08lx,0x%08lx),stub\n",x1,x2,x3,x4);
 575 }
 576
 577 /******************************************************************************
 578  *  RtlGetNtVersionNumbers       [NTDLL.@]
 579  *
 580  * Get the version numbers of the run time library.
 581  *
 582  * PARAMS
 583  *  major [O] Destination for the Major version
 584  *  minor [O] Destination for the Minor version
 585  *  build [O] Destination for the Build version
 586  *
 587  * RETURNS
 588  *  Nothing.
 589  *
 590  * NOTES
 591  * Introduced in Windows XP (NT5.1)
 592  */
 593 void WINAPI RtlGetNtVersionNumbers(LPDWORD major, LPDWORD minor, LPDWORD build)
 594 {
 595         OSVERSIONINFOEXW versionInfo;
 596         versionInfo.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEXW);
 597         GetVersionExW((OSVERSIONINFOW*)&versionInfo);
 598
 599         if (major)
 600         {
 601                 /* msvcrt.dll as released with XP Home fails in DLLMain() if the
 602                  * major version is not 5. So, we should never set a version < 5 ...
 603                  * This makes sense since this call didn't exist before XP anyway.
 604                  */
 605                 *major = versionInfo.dwMajorVersion < 5 ? 5 : versionInfo.dwMajorVersion;
 606         }
 607
 608         if (minor)
 609         {
 610                 *minor = versionInfo.dwMinorVersion;
 611         }
 612
 613         if (build)
 614         {
 615                 /* FIXME: Does anybody know the real formula? */
 616                 *build = (0xF0000000 | versionInfo.dwBuildNumber);
 617         }
 618 }
 619
 620 /*************************************************************************
 621  * RtlFillMemoryUlong   [NTDLL.@]
 622  *
 623  * Fill memory with a 32 bit (dword) value.
 624  *
 625  * PARAMS
 626  *  lpDest  [I] Bitmap pointer
 627  *  ulCount [I] Number of dwords to write
 628  *  ulValue [I] Value to fill with
 629  *
 630  * RETURNS
 631  *  Nothing.
 632  */
 633 VOID WINAPI RtlFillMemoryUlong(ULONG* lpDest, ULONG ulCount, ULONG ulValue)
 634 {
 635   TRACE("(%p,%ld,%ld)\n", lpDest, ulCount, ulValue);
 636
 637   ulCount /= sizeof(ULONG);
 638   while(ulCount--)
 639     *lpDest++ = ulValue;
 640 }
 641
 642 /*************************************************************************
 643  * RtlGetLongestNtPathLength    [NTDLL.@]
 644  *
 645  * Get the longest allowed path length
 646  *
 647  * PARAMS
 648  *  None.
 649  *
 650  * RETURNS
 651  *  The longest allowed path length (277 characters under Win2k).
 652  */
 653 DWORD WINAPI RtlGetLongestNtPathLength(void)
 654 {
 655   TRACE("()\n");
 656   return 277;
 657 }
 658
 659 /*********************************************************************
 660  *                  RtlComputeCrc32   [NTDLL.@]
 661  *
 662  * Calculate the CRC32 checksum of a block of bytes
 663  *
 664  * PARAMS
 665  *  dwInitial [I] Initial CRC value
 666  *  pData     [I] Data block
 667  *  iLen      [I] Length of the byte block
 668  *
 669  * RETURNS
 670  *  The cumulative CRC32 of dwInitial and iLen bytes of the pData block.
 671  */
 672 DWORD WINAPI RtlComputeCrc32(DWORD dwInitial, PBYTE pData, INT iLen)
 673 {
 674   DWORD crc = ~dwInitial;
 675
 676   TRACE("(%ld,%p,%d)\n", dwInitial, pData, iLen);
 677
 678   while (iLen > 0)
 679   {
 680     crc = CRC_table[(crc ^ *pData) & 0xff] ^ (crc >> 8);
 681     pData++;
 682     iLen--;
 683   }
 684   return ~crc;
 685 }
 686
 687
 688 /*************************************************************************
 689  * RtlUlonglongByteSwap    [NTDLL.@]
 690  *
 691  * Swap the bytes of an unsigned long long value.
 692  *
 693  * PARAMS
 694  *  i [I] Value to swap bytes of
 695  *
 696  * RETURNS
 697  *  The value with its bytes swapped.
 698  */
 699 ULONGLONG __cdecl RtlUlonglongByteSwap(ULONGLONG i)
 700 {
 701   return ((ULONGLONG)RtlUlongByteSwap(i) << 32) | RtlUlongByteSwap(i>>32);
 702 }
 703
 704 /*************************************************************************
 705  * RtlUlongByteSwap    [NTDLL.@]
 706  *
 707  * Swap the bytes of an unsigned int value.
 708  *
 709  * NOTES
 710  *  ix86 version takes argument in %ecx. Other systems use the inline version.
 711  */
 712 #ifdef __i386__
 713 __ASM_GLOBAL_FUNC(NTDLL_RtlUlongByteSwap,
 714                   "movl %ecx,%eax\n\t"
 715                   "bswap %eax\n\t"
 716                   "ret");
 717 #endif
 718
 719 /*************************************************************************
 720  * RtlUshortByteSwap    [NTDLL.@]
 721  *
 722  * Swap the bytes of an unsigned short value.
 723  *
 724  * NOTES
 725  *  i386 version takes argument in %cx. Other systems use the inline version.
 726  */
 727 #ifdef __i386__
 728 __ASM_GLOBAL_FUNC(NTDLL_RtlUshortByteSwap,
 729                   "movb %ch,%al\n\t"
 730                   "movb %cl,%ah\n\t"
 731                   "ret");
 732 #endif
 733
 734
 735 /*************************************************************************
 736  * RtlUniform   [NTDLL.@]
 737  *
 738  * Generates an uniform random number
 739  *
 740  * PARAMS
 741  *  seed [O] The seed of the Random function
 742  *
 743  * RETURNS
 744  *  It returns a random number uniformly distributed over [0..MAXLONG-1].
 745  *
 746  * NOTES
 747  *  Generates an uniform random number using D.H. Lehmer's 1948 algorithm.
 748  *  In our case the algorithm is:
 749  *
 750  *  result = (*seed * 0x7fffffed + 0x7fffffc3) % MAXLONG;
 751  *
 752  *  *seed = result;
 753  *
 754  * DIFFERENCES
 755  *  The native documentation states that the random number is
 756  *  uniformly distributed over [0..MAXLONG]. In reality the native
 757  *  function and our function return a random number uniformly
 758  *  distributed over [0..MAXLONG-1].
 759  */
 760 ULONG WINAPI RtlUniform (PULONG seed)
 761 {
 762     ULONG result;
 763
 764    /*
 765     * Instead of the algorithm stated above, we use the algorithm
 766     * below, which is totally equivalent (see the tests), but does
 767     * not use a division and therefore is faster.
 768     */
 769     result = *seed * 0xffffffed + 0x7fffffc3;
 770     if (result == 0xffffffff || result == 0x7ffffffe) {
 771         result = (result + 2) & MAXLONG;
 772     } else if (result == 0x7fffffff) {
 773         result = 0;
 774     } else if ((result & 0x80000000) == 0) {
 775         result = result + (~result & 1);
 776     } else {
 777         result = (result + (result & 1)) & MAXLONG;
 778     } /* if */
 779     *seed = result;
 780     return result;
 781 }
 782
 783
 784 /*************************************************************************
 785  * RtlRandom   [NTDLL.@]
 786  *
 787  * Generates a random number
 788  *
 789  * PARAMS
 790  *  seed [O] The seed of the Random function
 791  *
 792  * RETURNS
 793  *  It returns a random number distributed over [0..MAXLONG-1].
 794  */
 795 ULONG WINAPI RtlRandom (PULONG seed)
 796 {
 797     static ULONG saved_value[128] =
 798     { /*   0 */ 0x4c8bc0aa, 0x4c022957, 0x2232827a, 0x2f1e7626, 0x7f8bdafb, 0x5c37d02a, 0x0ab48f72, 0x2f0c4ffa,
 799       /*   8 */ 0x290e1954, 0x6b635f23, 0x5d3885c0, 0x74b49ff8, 0x5155fa54, 0x6214ad3f, 0x111e9c29, 0x242a3a09,
 800       /*  16 */ 0x75932ae1, 0x40ac432e, 0x54f7ba7a, 0x585ccbd5, 0x6df5c727, 0x0374dad1, 0x7112b3f1, 0x735fc311,
 801       /*  24 */ 0x404331a9, 0x74d97781, 0x64495118, 0x323e04be, 0x5974b425, 0x4862e393, 0x62389c1d, 0x28a68b82,
 802       /*  32 */ 0x0f95da37, 0x7a50bbc6, 0x09b0091c, 0x22cdb7b4, 0x4faaed26, 0x66417ccd, 0x189e4bfa, 0x1ce4e8dd,
 803       /*  40 */ 0x5274c742, 0x3bdcf4dc, 0x2d94e907, 0x32eac016, 0x26d33ca3, 0x60415a8a, 0x31f57880, 0x68c8aa52,
 804       /*  48 */ 0x23eb16da, 0x6204f4a1, 0x373927c1, 0x0d24eb7c, 0x06dd7379, 0x2b3be507, 0x0f9c55b1, 0x2c7925eb,
 805       /*  56 */ 0x36d67c9a, 0x42f831d9, 0x5e3961cb, 0x65d637a8, 0x24bb3820, 0x4d08e33d, 0x2188754f, 0x147e409e,
 806       /*  64 */ 0x6a9620a0, 0x62e26657, 0x7bd8ce81, 0x11da0abb, 0x5f9e7b50, 0x23e444b6, 0x25920c78, 0x5fc894f0,
 807       /*  72 */ 0x5e338cbb, 0x404237fd, 0x1d60f80f, 0x320a1743, 0x76013d2b, 0x070294ee, 0x695e243b, 0x56b177fd,
 808       /*  80 */ 0x752492e1, 0x6decd52f, 0x125f5219, 0x139d2e78, 0x1898d11e, 0x2f7ee785, 0x4db405d8, 0x1a028a35,
 809       /*  88 */ 0x63f6f323, 0x1f6d0078, 0x307cfd67, 0x3f32a78a, 0x6980796c, 0x462b3d83, 0x34b639f2, 0x53fce379,
 810       /*  96 */ 0x74ba50f4, 0x1abc2c4b, 0x5eeaeb8d, 0x335a7a0d, 0x3973dd20, 0x0462d66b, 0x159813ff, 0x1e4643fd,
 811       /* 104 */ 0x06bc5c62, 0x3115e3fc, 0x09101613, 0x47af2515, 0x4f11ec54, 0x78b99911, 0x3db8dd44, 0x1ec10b9b,
 812       /* 112 */ 0x5b5506ca, 0x773ce092, 0x567be81a, 0x5475b975, 0x7a2cde1a, 0x494536f5, 0x34737bb4, 0x76d9750b,
 813       /* 120 */ 0x2a1f6232, 0x2e49644d, 0x7dddcbe7, 0x500cebdb, 0x619dab9e, 0x48c626fe, 0x1cda3193, 0x52dabe9d };
 814     ULONG rand;
 815     int pos;
 816     ULONG result;
 817
 818     rand = (*seed * 0x7fffffed + 0x7fffffc3) % 0x7fffffff;
 819     *seed = (rand * 0x7fffffed + 0x7fffffc3) % 0x7fffffff;
 820     pos = *seed & 0x7f;
 821     result = saved_value[pos];
 822     saved_value[pos] = rand;
 823     return(result);
 824 }
 825
 826
 827 /*************************************************************************
 828  * RtlAreAllAccessesGranted   [NTDLL.@]
 829  *
 830  * Check if all desired accesses are granted
 831  *
 832  * RETURNS
 833  *  TRUE: All desired accesses are granted
 834  *  FALSE: Otherwise
 835  */
 836 BOOLEAN WINAPI RtlAreAllAccessesGranted(
 837     ACCESS_MASK GrantedAccess,
 838     ACCESS_MASK DesiredAccess)
 839 {
 840     return (GrantedAccess & DesiredAccess) == DesiredAccess;
 841 }
 842
 843
 844 /*************************************************************************
 845  * RtlAreAnyAccessesGranted   [NTDLL.@]
 846  *
 847  * Check if at least one of the desired accesses is granted
 848  *
 849  * RETURNS
 850  *  TRUE: At least one of the desired accesses is granted
 851  *  FALSE: Otherwise
 852  */
 853 BOOLEAN WINAPI RtlAreAnyAccessesGranted(
 854     ACCESS_MASK GrantedAccess,
 855     ACCESS_MASK DesiredAccess)
 856 {
 857     return (GrantedAccess & DesiredAccess) != 0;
 858 }
 859
 860
 861 /*************************************************************************
 862  * RtlMapGenericMask   [NTDLL.@]
 863  *
 864  * Determine the nongeneric access rights specified by an access mask
 865  *
 866  * RETURNS
 867  *  Nothing.
 868  */
 869 void WINAPI RtlMapGenericMask(
 870     PACCESS_MASK AccessMask,
 871     const GENERIC_MAPPING *GenericMapping)
 872 {
 873     if (*AccessMask & GENERIC_READ) {
 874         *AccessMask |= GenericMapping->GenericRead;
 875     } /* if */
 876
 877     if (*AccessMask & GENERIC_WRITE) {
 878         *AccessMask |= GenericMapping->GenericWrite;
 879     } /* if */
 880
 881     if (*AccessMask & GENERIC_EXECUTE) {
 882         *AccessMask |= GenericMapping->GenericExecute;
 883     } /* if */
 884
 885     if (*AccessMask & GENERIC_ALL) {
 886         *AccessMask |= GenericMapping->GenericAll;
 887     } /* if */
 888
 889     *AccessMask &= 0x0FFFFFFF;
 890 }
 891
 892
 893 /*************************************************************************
 894  * RtlCopyLuid   [NTDLL.@]
 895  *
 896  * Copies the LuidSrc to LuidDest.
 897  *
 898  * RETURNS
 899  *  Nothing.
 900  */
 901 void WINAPI RtlCopyLuid (PLUID LuidDest, const LUID *LuidSrc)
 902 {
 903     *LuidDest = *LuidSrc;
 904 }
 905
 906
 907 /*************************************************************************
 908  * RtlEqualLuid   [NTDLL.@]
 909  *
 910  * Compares two local unique ID's.
 911  *
 912  * RETURNS
 913  *  TRUE: The two LUID's are equal.
 914  *  FALSE: Otherwise
 915  */
 916 BOOLEAN WINAPI RtlEqualLuid (const LUID *Luid1, const LUID *Luid2)
 917 {
 918   return (Luid1->LowPart ==  Luid2->LowPart && Luid1->HighPart == Luid2->HighPart);
 919 }
 920
 921
 922 /*************************************************************************
 923  * RtlCopyLuidAndAttributesArray   [NTDLL.@]
 924  *
 925  * Copies an array of LUID's and attributes.
 926  *
 927  * RETURNS
 928  *  Nothing.
 929  */
 930 void WINAPI RtlCopyLuidAndAttributesArray(
 931     ULONG Count,
 932     const LUID_AND_ATTRIBUTES *Src,
 933     PLUID_AND_ATTRIBUTES Dest)
 934 {
 935     ULONG i;
 936
 937     for (i = 0; i < Count; i++) Dest[i] = Src[i];
 938 }