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