Release 20030408.
[wine/gsoc-2012-control.git] / dlls / ntdll / rtl.c
blob77ad84c810ac76894d7220f7fd675bc24cc6663a
1 /*
2 * NT basis DLL
4 * This file contains the Rtl* API functions. These should be implementable.
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)
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.
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.
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
26 #include "config.h"
27 #include "wine/port.h"
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"
40 WINE_DEFAULT_DEBUG_CHANNEL(ntdll);
43 static RTL_CRITICAL_SECTION peb_lock = CRITICAL_SECTION_INIT("peb_lock");
45 /* CRC polynomial 0xedb88320 */
46 static const DWORD CRC_table[256] =
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
94 * resource functions
97 /***********************************************************************
98 * RtlInitializeResource (NTDLL.@)
100 * xxxResource() functions implement multiple-reader-single-writer lock.
101 * The code is based on information published in WDJ January 1999 issue.
103 void WINAPI RtlInitializeResource(LPRTL_RWLOCK rwl)
105 if( rwl )
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 );
119 /***********************************************************************
120 * RtlDeleteResource (NTDLL.@)
122 void WINAPI RtlDeleteResource(LPRTL_RWLOCK rwl)
124 if( rwl )
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 );
140 /***********************************************************************
141 * RtlAcquireResourceExclusive (NTDLL.@)
143 BYTE WINAPI RtlAcquireResourceExclusive(LPRTL_RWLOCK rwl, BYTE fWait)
145 BYTE retVal = 0;
146 if( !rwl ) return 0;
148 start:
149 RtlEnterCriticalSection( &rwl->rtlCS );
150 if( rwl->iNumberActive == 0 ) /* lock is free */
152 rwl->iNumberActive = -1;
153 retVal = 1;
155 else if( rwl->iNumberActive < 0 ) /* exclusive lock in progress */
157 if( rwl->hOwningThreadId == (HANDLE)GetCurrentThreadId() )
159 retVal = 1;
160 rwl->iNumberActive--;
161 goto done;
163 wait:
164 if( fWait )
166 rwl->uExclusiveWaiters++;
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 */
174 else /* one or more shared locks are in progress */
175 if( fWait )
176 goto wait;
178 if( retVal == 1 )
179 rwl->hOwningThreadId = (HANDLE)GetCurrentThreadId();
180 done:
181 RtlLeaveCriticalSection( &rwl->rtlCS );
182 return retVal;
185 /***********************************************************************
186 * RtlAcquireResourceShared (NTDLL.@)
188 BYTE WINAPI RtlAcquireResourceShared(LPRTL_RWLOCK rwl, BYTE fWait)
190 DWORD dwWait = WAIT_FAILED;
191 BYTE retVal = 0;
192 if( !rwl ) return 0;
194 start:
195 RtlEnterCriticalSection( &rwl->rtlCS );
196 if( rwl->iNumberActive < 0 )
198 if( rwl->hOwningThreadId == (HANDLE)GetCurrentThreadId() )
200 rwl->iNumberActive--;
201 retVal = 1;
202 goto done;
205 if( fWait )
207 rwl->uSharedWaiters++;
208 RtlLeaveCriticalSection( &rwl->rtlCS );
209 if( (dwWait = NtWaitForSingleObject( rwl->hSharedReleaseSemaphore, FALSE, NULL )) == WAIT_FAILED )
210 goto done;
211 goto start;
214 else
216 if( dwWait != WAIT_OBJECT_0 ) /* otherwise RtlReleaseResource() has already done it */
217 rwl->iNumberActive++;
218 retVal = 1;
220 done:
221 RtlLeaveCriticalSection( &rwl->rtlCS );
222 return retVal;
226 /***********************************************************************
227 * RtlReleaseResource (NTDLL.@)
229 void WINAPI RtlReleaseResource(LPRTL_RWLOCK rwl)
231 RtlEnterCriticalSection( &rwl->rtlCS );
233 if( rwl->iNumberActive > 0 ) /* have one or more readers */
235 if( --rwl->iNumberActive == 0 )
237 if( rwl->uExclusiveWaiters )
239 wake_exclusive:
240 rwl->uExclusiveWaiters--;
241 NtReleaseSemaphore( rwl->hExclusiveReleaseSemaphore, 1, NULL );
245 else
246 if( rwl->iNumberActive < 0 ) /* have a writer, possibly recursive */
248 if( ++rwl->iNumberActive == 0 )
250 rwl->hOwningThreadId = 0;
251 if( rwl->uExclusiveWaiters )
252 goto wake_exclusive;
253 else
254 if( rwl->uSharedWaiters )
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 );
264 RtlLeaveCriticalSection( &rwl->rtlCS );
268 /***********************************************************************
269 * RtlDumpResource (NTDLL.@)
271 void WINAPI RtlDumpResource(LPRTL_RWLOCK rwl)
273 if( rwl )
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 );
283 * misc functions
286 /******************************************************************************
287 * DbgPrint [NTDLL.@]
289 void WINAPIV DbgPrint(LPCSTR fmt, ...)
291 char buf[512];
292 va_list args;
294 va_start(args, fmt);
295 vsprintf(buf,fmt, args);
296 va_end(args);
298 MESSAGE("DbgPrint says: %s",buf);
299 /* hmm, raise exception? */
302 /******************************************************************************
303 * RtlAcquirePebLock [NTDLL.@]
305 VOID WINAPI RtlAcquirePebLock(void)
307 RtlEnterCriticalSection( &peb_lock );
310 /******************************************************************************
311 * RtlReleasePebLock [NTDLL.@]
313 VOID WINAPI RtlReleasePebLock(void)
315 RtlLeaveCriticalSection( &peb_lock );
318 /******************************************************************************
319 * RtlSetEnvironmentVariable [NTDLL.@]
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;
326 /******************************************************************************
327 * RtlNewSecurityObject [NTDLL.@]
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;
334 /******************************************************************************
335 * RtlDeleteSecurityObject [NTDLL.@]
337 DWORD WINAPI RtlDeleteSecurityObject(DWORD x1) {
338 FIXME("(0x%08lx),stub!\n",x1);
339 return 0;
342 /**************************************************************************
343 * RtlNormalizeProcessParams [NTDLL.@]
345 LPVOID WINAPI RtlNormalizeProcessParams(LPVOID x)
347 FIXME("(%p), stub\n",x);
348 return x;
351 /**************************************************************************
352 * RtlGetNtProductType [NTDLL.@]
354 BOOLEAN WINAPI RtlGetNtProductType(LPDWORD type)
356 FIXME("(%p): stub\n", type);
357 *type=3; /* dunno. 1 for client, 3 for server? */
358 return 1;
361 /**************************************************************************
362 * _chkstk [NTDLL.@]
364 * Glorified "enter xxxx".
366 void WINAPI NTDLL_chkstk( CONTEXT86 *context )
368 context->Esp -= context->Eax;
371 /**************************************************************************
372 * _alloca_probe [NTDLL.@]
374 * Glorified "enter xxxx".
376 void WINAPI NTDLL_alloca_probe( CONTEXT86 *context )
378 context->Esp -= context->Eax;
381 /**************************************************************************
382 * RtlDosPathNameToNtPathName_U [NTDLL.@]
384 * szwDosPath: a fully qualified DOS path name
385 * ntpath: pointer to a UNICODE_STRING to hold the converted
386 * path name
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.
393 BOOLEAN WINAPI RtlDosPathNameToNtPathName_U(
394 LPWSTR szwDosPath,PUNICODE_STRING ntpath,
395 DWORD x2,DWORD x3)
397 ULONG length;
398 UNICODE_STRING pathprefix;
399 WCHAR szPrefix[] = { '\\', '?', '?', '\\', 0 };
401 FIXME("(%s,%p,%08lx,%08lx) partial stub\n",
402 debugstr_w(szwDosPath),ntpath,x2,x3);
404 if ( !szwDosPath )
405 return FALSE;
407 if ( !szwDosPath[0] )
408 return FALSE;
410 if ( szwDosPath[1]!= ':' )
411 return FALSE;
413 length = strlenW(szwDosPath) * sizeof (WCHAR) + sizeof szPrefix;
415 ntpath->Buffer = RtlAllocateHeap(ntdll_get_process_heap(), 0, length);
416 ntpath->Length = 0;
417 ntpath->MaximumLength = length;
419 if ( !ntpath->Buffer )
420 return FALSE;
422 RtlInitUnicodeString( &pathprefix, szPrefix );
423 RtlCopyUnicodeString( ntpath, &pathprefix );
424 RtlAppendUnicodeToString( ntpath, szwDosPath );
426 return TRUE;
430 /******************************************************************************
431 * RtlCreateEnvironment [NTDLL.@]
433 DWORD WINAPI RtlCreateEnvironment(DWORD x1,DWORD x2) {
434 FIXME("(0x%08lx,0x%08lx),stub!\n",x1,x2);
435 return 0;
439 /******************************************************************************
440 * RtlDestroyEnvironment [NTDLL.@]
442 DWORD WINAPI RtlDestroyEnvironment(DWORD x) {
443 FIXME("(0x%08lx),stub!\n",x);
444 return 0;
447 /******************************************************************************
448 * RtlQueryEnvironmentVariable_U [NTDLL.@]
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;
455 /******************************************************************************
456 * RtlInitializeGenericTable [NTDLL.@]
458 PVOID WINAPI RtlInitializeGenericTable(PVOID pTable, PVOID arg2, PVOID arg3, PVOID arg4, PVOID arg5)
460 FIXME("(%p,%p,%p,%p,%p) stub!\n", pTable, arg2, arg3, arg4, arg5);
461 return NULL;
464 /******************************************************************************
465 * RtlMoveMemory [NTDLL.@]
467 * Move a block of memory that may overlap.
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
474 * RETURNS
475 * Nothing.
477 #undef RtlMoveMemory
478 VOID WINAPI RtlMoveMemory( VOID *Destination, CONST VOID *Source, SIZE_T Length )
480 memmove(Destination, Source, Length);
483 /******************************************************************************
484 * RtlFillMemory [NTDLL.@]
486 * Set a block of memory with a value.
488 * PARAMS
489 * Destination [O] Block to fill
490 * Length [I] Number of bytes to fill
491 * Fill [I] Value to set
493 * RETURNS
494 * Nothing.
496 #undef RtlFillMemory
497 VOID WINAPI RtlFillMemory( VOID *Destination, SIZE_T Length, BYTE Fill )
499 memset(Destination, Fill, Length);
502 /******************************************************************************
503 * RtlZeroMemory [NTDLL.@]
505 * Set a block of memory with 0's.
507 * PARAMS
508 * Destination [O] Block to fill
509 * Length [I] Number of bytes to fill
511 * RETURNS
512 * Nothing.
514 #undef RtlZeroMemory
515 VOID WINAPI RtlZeroMemory( VOID *Destination, SIZE_T Length )
517 memset(Destination, 0, Length);
520 /******************************************************************************
521 * RtlCompareMemory [NTDLL.@]
523 * Compare one block of memory with another
525 * PARAMS
526 * Source1 [I] Source block
527 * Source2 [I] Block to compare to Source1
528 * Length [I] Number of bytes to fill
530 * RETURNS
531 * The length of the first byte at which Source1 and Source2 differ, or Length
532 * if they are the same.
534 SIZE_T WINAPI RtlCompareMemory( const VOID *Source1, const VOID *Source2, SIZE_T Length)
536 SIZE_T i;
537 for(i=0; (i<Length) && (((LPBYTE)Source1)[i]==((LPBYTE)Source2)[i]); i++);
538 return i;
541 /******************************************************************************
542 * RtlCompareMemoryUlong [NTDLL.@]
544 * Compare a block of memory with a value, a ULONG at a time
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
551 * RETURNS
552 * The byte position of the first byte at which Source1 is not dwVal.
554 SIZE_T WINAPI RtlCompareMemoryUlong(const ULONG *Source1, SIZE_T Length, ULONG dwVal)
556 SIZE_T i;
557 for(i = 0; i < Length/sizeof(ULONG) && Source1[i] == dwVal; i++);
558 return i * sizeof(ULONG);
561 /******************************************************************************
562 * RtlAssert [NTDLL.@]
564 * Fail a debug assertion.
566 * RETURNS
567 * Nothing. This call does not return control to its caller.
569 * NOTES
570 * Not implemented in non-debug versions.
572 void WINAPI RtlAssert(LPVOID x1,LPVOID x2,DWORD x3, DWORD x4)
574 FIXME("(%p,%p,0x%08lx,0x%08lx),stub\n",x1,x2,x3,x4);
577 /******************************************************************************
578 * RtlGetNtVersionNumbers [NTDLL.@]
580 * Get the version numbers of the run time library.
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
587 * RETURNS
588 * Nothing.
590 * NOTES
591 * Introduced in Windows XP (NT5.1)
593 void WINAPI RtlGetNtVersionNumbers(LPDWORD major, LPDWORD minor, LPDWORD build)
595 OSVERSIONINFOEXW versionInfo;
596 versionInfo.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEXW);
597 GetVersionExW((OSVERSIONINFOW*)&versionInfo);
599 if (major)
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.
605 *major = versionInfo.dwMajorVersion < 5 ? 5 : versionInfo.dwMajorVersion;
608 if (minor)
610 *minor = versionInfo.dwMinorVersion;
613 if (build)
615 /* FIXME: Does anybody know the real formula? */
616 *build = (0xF0000000 | versionInfo.dwBuildNumber);
620 /*************************************************************************
621 * RtlFillMemoryUlong [NTDLL.@]
623 * Fill memory with a 32 bit (dword) value.
625 * PARAMS
626 * lpDest [I] Bitmap pointer
627 * ulCount [I] Number of dwords to write
628 * ulValue [I] Value to fill with
630 * RETURNS
631 * Nothing.
633 VOID WINAPI RtlFillMemoryUlong(ULONG* lpDest, ULONG ulCount, ULONG ulValue)
635 TRACE("(%p,%ld,%ld)\n", lpDest, ulCount, ulValue);
637 ulCount /= sizeof(ULONG);
638 while(ulCount--)
639 *lpDest++ = ulValue;
642 /*************************************************************************
643 * RtlGetLongestNtPathLength [NTDLL.@]
645 * Get the longest allowed path length
647 * PARAMS
648 * None.
650 * RETURNS
651 * The longest allowed path length (277 characters under Win2k).
653 DWORD WINAPI RtlGetLongestNtPathLength(void)
655 TRACE("()\n");
656 return 277;
659 /*********************************************************************
660 * RtlComputeCrc32 [NTDLL.@]
662 * Calculate the CRC32 checksum of a block of bytes
664 * PARAMS
665 * dwInitial [I] Initial CRC value
666 * pData [I] Data block
667 * iLen [I] Length of the byte block
669 * RETURNS
670 * The cumulative CRC32 of dwInitial and iLen bytes of the pData block.
672 DWORD WINAPI RtlComputeCrc32(DWORD dwInitial, PBYTE pData, INT iLen)
674 DWORD crc = ~dwInitial;
676 TRACE("(%ld,%p,%d)\n", dwInitial, pData, iLen);
678 while (iLen > 0)
680 crc = CRC_table[(crc ^ *pData) & 0xff] ^ (crc >> 8);
681 pData++;
682 iLen--;
684 return ~crc;
688 /*************************************************************************
689 * RtlUlonglongByteSwap [NTDLL.@]
691 * Swap the bytes of an unsigned long long value.
693 * PARAMS
694 * i [I] Value to swap bytes of
696 * RETURNS
697 * The value with its bytes swapped.
699 ULONGLONG __cdecl RtlUlonglongByteSwap(ULONGLONG i)
701 return ((ULONGLONG)RtlUlongByteSwap(i) << 32) | RtlUlongByteSwap(i>>32);
704 /*************************************************************************
705 * RtlUlongByteSwap [NTDLL.@]
707 * Swap the bytes of an unsigned int value.
709 * NOTES
710 * ix86 version takes argument in %ecx. Other systems use the inline version.
712 #ifdef __i386__
713 __ASM_GLOBAL_FUNC(NTDLL_RtlUlongByteSwap,
714 "movl %ecx,%eax\n\t"
715 "bswap %eax\n\t"
716 "ret");
717 #endif
719 /*************************************************************************
720 * RtlUshortByteSwap [NTDLL.@]
722 * Swap the bytes of an unsigned short value.
724 * NOTES
725 * i386 version takes argument in %cx. Other systems use the inline version.
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
735 /*************************************************************************
736 * RtlUniform [NTDLL.@]
738 * Generates an uniform random number
740 * PARAMS
741 * seed [O] The seed of the Random function
743 * RETURNS
744 * It returns a random number uniformly distributed over [0..MAXLONG-1].
746 * NOTES
747 * Generates an uniform random number using D.H. Lehmer's 1948 algorithm.
748 * In our case the algorithm is:
750 * result = (*seed * 0x7fffffed + 0x7fffffc3) % MAXLONG;
752 * *seed = result;
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].
760 ULONG WINAPI RtlUniform (PULONG seed)
762 ULONG result;
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.
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;
784 /*************************************************************************
785 * RtlRandom [NTDLL.@]
787 * Generates a random number
789 * PARAMS
790 * seed [O] The seed of the Random function
792 * RETURNS
793 * It returns a random number distributed over [0..MAXLONG-1].
795 ULONG WINAPI RtlRandom (PULONG seed)
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;
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);
827 /*************************************************************************
828 * RtlAreAllAccessesGranted [NTDLL.@]
830 * Check if all desired accesses are granted
832 * RETURNS
833 * TRUE: All desired accesses are granted
834 * FALSE: Otherwise
836 BOOLEAN WINAPI RtlAreAllAccessesGranted(
837 ACCESS_MASK GrantedAccess,
838 ACCESS_MASK DesiredAccess)
840 return (GrantedAccess & DesiredAccess) == DesiredAccess;
844 /*************************************************************************
845 * RtlAreAnyAccessesGranted [NTDLL.@]
847 * Check if at least one of the desired accesses is granted
849 * RETURNS
850 * TRUE: At least one of the desired accesses is granted
851 * FALSE: Otherwise
853 BOOLEAN WINAPI RtlAreAnyAccessesGranted(
854 ACCESS_MASK GrantedAccess,
855 ACCESS_MASK DesiredAccess)
857 return (GrantedAccess & DesiredAccess) != 0;
861 /*************************************************************************
862 * RtlMapGenericMask [NTDLL.@]
864 * Determine the nongeneric access rights specified by an access mask
866 * RETURNS
867 * Nothing.
869 void WINAPI RtlMapGenericMask(
870 PACCESS_MASK AccessMask,
871 const GENERIC_MAPPING *GenericMapping)
873 if (*AccessMask & GENERIC_READ) {
874 *AccessMask |= GenericMapping->GenericRead;
875 } /* if */
877 if (*AccessMask & GENERIC_WRITE) {
878 *AccessMask |= GenericMapping->GenericWrite;
879 } /* if */
881 if (*AccessMask & GENERIC_EXECUTE) {
882 *AccessMask |= GenericMapping->GenericExecute;
883 } /* if */
885 if (*AccessMask & GENERIC_ALL) {
886 *AccessMask |= GenericMapping->GenericAll;
887 } /* if */
889 *AccessMask &= 0x0FFFFFFF;
893 /*************************************************************************
894 * RtlCopyLuid [NTDLL.@]
896 * Copies the LuidSrc to LuidDest.
898 * RETURNS
899 * Nothing.
901 void WINAPI RtlCopyLuid (PLUID LuidDest, const LUID *LuidSrc)
903 *LuidDest = *LuidSrc;
907 /*************************************************************************
908 * RtlEqualLuid [NTDLL.@]
910 * Compares two local unique ID's.
912 * RETURNS
913 * TRUE: The two LUID's are equal.
914 * FALSE: Otherwise
916 BOOLEAN WINAPI RtlEqualLuid (const LUID *Luid1, const LUID *Luid2)
918 return (Luid1->LowPart == Luid2->LowPart && Luid1->HighPart == Luid2->HighPart);
922 /*************************************************************************
923 * RtlCopyLuidAndAttributesArray [NTDLL.@]
925 * Copies an array of LUID's and attributes.
927 * RETURNS
928 * Nothing.
930 void WINAPI RtlCopyLuidAndAttributesArray(
931 ULONG Count,
932 const LUID_AND_ATTRIBUTES *Src,
933 PLUID_AND_ATTRIBUTES Dest)
935 ULONG i;
937 for (i = 0; i < Count; i++) Dest[i] = Src[i];