Logo Search packages:      
Sourcecode: virtualbox-ose version File versions  Download package

RTDECL ( void   )  const

The 1st part of an assert message.

Parameters:
pszExpr Expression. Can be NULL.
uLine Location line number.
pszFile Location file name.
pszFunction Location function name.
Weak version of RTAssertMsg1 that can be overridden locally in a module to modify, redirect or otherwise mess with the assertion output.

The 2nd (optional) part of an assert message.

Parameters:
pszFormat Printf like format string.
... Arguments to that string.
Weak version of RTAssertMsg2 that forwards to RTAssertMsg2WeakV.

There is not need to override this, check out RTAssertMsg2WeakV instead!

The 2nd (optional) part of an assert message.

Parameters:
pszFormat Printf like format string.
va Arguments to that string.
Weak version of RTAssertMsg2V that can be overridden locally in a module to modify, redirect or otherwise mess with the assertion output.

Additional information which should be appended to the 2nd part of an assertion message.

Parameters:
pszFormat Printf like format string.
... Arguments to that string.
Weak version of RTAssertMsg2Add that forwards to RTAssertMsg2AddWeakV.

There is not need to override this, check out RTAssertMsg2AddWeakV instead!

Additional information which should be appended to the 2nd part of an assertion message.

Parameters:
pszFormat Printf like format string.
va Arguments to that string.
Weak version of RTAssertMsg2AddV that can be overridden locally in a module to modify, redirect or otherwise mess with the assertion output.

Free a line number structure previously allocated by a RTDbg method.

Parameters:
pLine The line number to free. NULL is ignored.
Dumps the hypervisor heap.

Parameters:
Heap The heap handle.
pfnPrintf Printf like function that groks IPRT formatting.
Frees memory allocated from a simple heap.

Parameters:
hHeap The heap handle. This is optional and will only be used for strict assertions.
pv The heap block returned by RTHeapOffset
Dumps the hypervisor heap.

Parameters:
hHeap The heap handle.
pfnPrintf Printf like function that groks IPRT formatting.
Initialize a lock validator record.

Use RTLockValidatorRecExclDelete to deinitialize it.

Parameters:
pRec The record.
hClass The class (no reference consumed). If NIL, the no lock order validation will be performed on this lock.
uSubClass The sub-class. This is used to define lock order inside the same class. If you don't know, then pass RTLOCKVAL_SUB_CLASS_NONE.
hLock The lock handle.
fEnabled Pass false to explicitly disable lock validation, otherwise true.
pszNameFmt Name format string for the lock validator, optional (NULL). Max length is 32 bytes.
va Format string arguments.
Uninitialize a lock validator record previously initialized by RTLockRecValidatorInit.

Parameters:
pRec The record. Must be valid.
Deinitialize and destroy a record created by RTLockValidatorRecExclCreate.

Parameters:
ppRec Pointer to the record pointer. Will be set to NULL.
Record the specified thread as lock owner and increment the write lock count.

This function is typically called after acquiring the lock. It accounts for recursions so it can be used instead of RTLockValidatorRecExclRecursion. Use RTLockValidatorRecExclReleaseOwner to reverse the effect.

Parameters:
pRec The validator record.
hThreadSelf The handle of the calling thread. If not known, pass NIL_RTTHREAD and we'll figure it out.
pSrcPos The source position of the lock operation.
fFirstRecursion Set if it is the first recursion, clear if not sure.
Clear the lock ownership and decrement the write lock count.

This is only for special cases where we wish to drop lock validation recording. See RTLockValidatorRecExclCheckAndRelease.

Parameters:
pRec The validator record.
Initialize a lock validator record for a shared lock.

Use RTLockValidatorRecSharedDelete to deinitialize it.

Parameters:
pRec The shared lock record.
hClass The class (no reference consumed). If NIL, the no lock order validation will be performed on this lock.
uSubClass The sub-class. This is used to define lock order inside the same class. If you don't know, then pass RTLOCKVAL_SUB_CLASS_NONE.
hLock The lock handle.
fSignaller Set if event semaphore signaller logic should be applied to this record, clear if read-write semaphore logic should be used.
fEnabled Pass false to explicitly disable lock validation, otherwise true.
pszNameFmt Name format string for the lock validator, optional (NULL). Max length is 32 bytes.
... Format string arguments.
Initialize a lock validator record for a shared lock.

Use RTLockValidatorRecSharedDelete to deinitialize it.

Parameters:
pRec The shared lock record.
hClass The class (no reference consumed). If NIL, the no lock order validation will be performed on this lock.
uSubClass The sub-class. This is used to define lock order inside the same class. If you don't know, then pass RTLOCKVAL_SUB_CLASS_NONE.
hLock The lock handle.
fSignaller Set if event semaphore signaller logic should be applied to this record, clear if read-write semaphore logic should be used.
fEnabled Pass false to explicitly disable lock validation, otherwise true.
pszNameFmt Name format string for the lock validator, optional (NULL). Max length is 32 bytes.
va Format string arguments.
Uninitialize a lock validator record previously initialized by RTLockValidatorRecSharedInit.

Parameters:
pRec The shared lock record. Must be valid.
Removes all current owners and makes hThread the only owner.

Parameters:
pRec The validator record.
hThread The thread handle of the owner. NIL_RTTHREAD is an alias for the current thread.
pSrcPos The source position of the lock operation.
Adds an owner to a shared locking record.

Takes recursion into account. This function is typically called after acquiring the lock in shared mode.

Parameters:
pRec The validator record.
hThread The thread handle of the owner. NIL_RTTHREAD is an alias for the current thread.
pSrcPos The source position of the lock operation.
Removes an owner from a shared locking record.

Takes recursion into account. This function is typically called before releaseing the lock.

Parameters:
pRec The validator record.
hThread The thread handle of the owner. NIL_RTTHREAD is an alias for the current thread.
Works the THREADINT::cWriteLocks member, mostly internal.

Parameters:
Thread The current thread.
Works the THREADINT::cReadLocks member.

Parameters:
Thread The current thread.
Write to a logger instance, defaulting to the release one.

This function will check whether the instance, group and flags makes up a logging kind which is currently enabled before writing anything to the log.

Parameters:
pLogger Pointer to logger instance. If NULL the default release instance is attempted.
fFlags The logging flags.
iGroup The group. The value ~0U is reserved for compatability with RTLogLogger[V] and is only for internal usage!
pszFormat Format string.
args Format arguments.
printf like function for writing to the default release log.

Parameters:
pszFormat Printf like format string.
... Optional arguments as specified in pszFormat.
Remarks:
The API doesn't support formatting of floating point numbers at the moment.
vprintf like function for writing to the default release log.

Parameters:
pszFormat Printf like format string.
args Optional arguments as specified in pszFormat.
Remarks:
The API doesn't support formatting of floating point numbers at the moment.
Flushes a RC logger instance to a R3 logger.

Returns:
iprt status code.
Parameters:
pLogger The R3 logger instance to flush pLoggerRC to. If NULL the default logger is used.
pLoggerRC The RC logger instance to flush.
Flushes the buffer in one logger instance onto another logger.

Returns:
iprt status code.
Parameters:
pSrcLogger The logger instance to flush.
pDstLogger The logger instance to flush onto. If NULL the default logger will be used.
Flushes the specified logger.

Parameters:
pLogger The logger instance to flush. If NULL the default instance is used. The default instance will not be initialized by this call.
Write to a logger instance.

Parameters:
pLogger Pointer to logger instance.
pvCallerRet Ignored.
pszFormat Format string.
... Format arguments.
Write to a logger instance.

Parameters:
pLogger Pointer to logger instance.
pszFormat Format string.
args Format arguments.
Write to a logger instance.

This function will check whether the instance, group and flags makes up a logging kind which is currently enabled before writing anything to the log.

Parameters:
pLogger Pointer to logger instance. If NULL the default logger instance will be attempted.
fFlags The logging flags.
iGroup The group. The value ~0U is reserved for compatability with RTLogLogger[V] and is only for internal usage!
pszFormat Format string.
... Format arguments.
Remarks:
This is a worker function of LogIt.
Write to a logger instance.

This function will check whether the instance, group and flags makes up a logging kind which is currently enabled before writing anything to the log.

Parameters:
pLogger Pointer to logger instance. If NULL the default logger instance will be attempted.
fFlags The logging flags.
iGroup The group. The value ~0U is reserved for compatability with RTLogLogger[V] and is only for internal usage!
pszFormat Format string.
args Format arguments.
printf like function for writing to the default log.

Parameters:
pszFormat Printf like format string.
... Optional arguments as specified in pszFormat.
Remarks:
The API doesn't support formatting of floating point numbers at the moment.
vprintf like function for writing to the default log.

Parameters:
pszFormat Printf like format string.
args Optional arguments as specified in pszFormat.
Remarks:
The API doesn't support formatting of floating point numbers at the moment.
Write log buffer to COM port.

Parameters:
pach Pointer to the buffer to write.
cb Number of bytes to write.
Write log buffer to a debugger (RTLOGDEST_DEBUGGER).

Parameters:
pach What to write.
cb How much to write.
Remarks:
When linking statically, this function can be replaced by defining your own.
Write log buffer to a user defined output stream (RTLOGDEST_USER).

Parameters:
pach What to write.
cb How much to write.
Remarks:
When linking statically, this function can be replaced by defining your own.
Write log buffer to stdout (RTLOGDEST_STDOUT).

Parameters:
pach What to write.
cb How much to write.
Remarks:
When linking statically, this function can be replaced by defining your own.
Write log buffer to stdout (RTLOGDEST_STDERR).

Parameters:
pach What to write.
cb How much to write.
Remarks:
When linking statically, this function can be replaced by defining your own.
Initialize MD5 context.

Parameters:
pCtx Pointer to the MD5 context to initialize.
Feed data into the MD5 computation.

Parameters:
pCtx Pointer to the MD5 context.
pvBuf Pointer to data.
cbBuf Length of data (in bytes).
Compute the MD5 hash of the data.

Parameters:
pabDigest Where to store the hash. (What's passed is a pointer to the caller's buffer.)
pCtx Pointer to the MD5 context.
Frees memory.

Parameters:
pv Pointer to memory block.
Free executable/read/write memory allocated by RTMemExecAlloc().

Parameters:
pv Pointer to memory block.
Free a memory block allocated with RTMemPageAlloc() or RTMemPageAllocZ().

Parameters:
pv Pointer to the block as it was returned by the allocation function. NULL will be ignored.
cb The allocation size. Will be rounded up to page size. Ignored if pv is NULL.
Same as RTMemTmpFree() except that it's for fenced memory.

Parameters:
pv Pointer to memory block.
Free memory allocated by any of the RTMemEf* allocators.

Parameters:
pv Pointer to memory block.
Fenced drop-in replacement for RTMemTmpFree.

Fenced drop-in replacement for RTMemFree.

Strips the extension from a path.

Parameters:
pszPath Path which extension should be stripped.
Fills a buffer with random bytes.

Parameters:
hRand Handle to the random number generator.
pv Where to store the random bytes.
cb Number of bytes to generate.
To add more signalling threads.

First call RTSemEventSetSignaller then add further threads with this.

Parameters:
hEventSem The event semaphore.
hThread The thread that will signal it. NIL_RTTHREAD is not accepted.
To remove a signalling thread.

Reverts work done by RTSemEventAddSignaller and RTSemEventSetSignaller.

Parameters:
hEventSem The event semaphore.
hThread A previously added thread.
Sets the signaller thread to one specific thread.

This is only used for validating usage and deadlock detection. When used after calls to RTSemEventAddSignaller, the specified thread will be the only signalling thread.

Parameters:
hEventMultiSem The multiple release event semaphore.
hThread The thread that will signal it. Pass NIL_RTTHREAD to indicate that there is no special signalling thread.
To add more signalling threads.

First call RTSemEventSetSignaller then add further threads with this.

Parameters:
hEventMultiSem The multiple release event semaphore.
hThread The thread that will signal it. NIL_RTTHREAD is not accepted.
To remove a signalling thread.

Reverts work done by RTSemEventAddSignaller and RTSemEventSetSignaller.

Parameters:
hEventMultiSem The multiple release event semaphore.
hThread A previously added thread.
Resets the internal buffer position of the S/G buffer to the beginning.

Returns:
nothing.
Parameters:
pSgBuf The S/G buffer to reset.
Clones a given S/G buffer.

Returns:
nothing.
Parameters:
pSgBufNew The new S/G buffer to clone to.
pSgBufOld The source S/G buffer to clone from.
Note:
This is only a shallow copy. Both S/G buffers will point to the same segment array.
Initializes the SHA-1 context.

Parameters:
pCtx Pointer to the SHA-1 context.
Feed data into the SHA-1 computation.

Parameters:
pCtx Pointer to the SHA-1 context.
pvBuf Pointer to the data.
cbBuf The length of the data (in bytes).
Compute the SHA-1 hash of the data.

Parameters:
pCtx Pointer to the SHA-1 context.
pabDigest Where to store the hash. (What is passed is a pointer to the caller's buffer.)
Compute the SHA-256 hash of the data.

Parameters:
pvBuf Pointer to the data.
cbBuf The amount of data (in bytes).
pabDigest Where to store the hash. (What is passed is a pointer to the caller's buffer.)
Initializes the SHA-256 context.

Parameters:
pCtx Pointer to the SHA-256 context.
Feed data into the SHA-256 computation.

Parameters:
pCtx Pointer to the SHA-256 context.
pvBuf Pointer to the data.
cbBuf The length of the data (in bytes).
Compute the SHA-256 hash of the data.

Parameters:
pCtx Pointer to the SHA-256 context.
pabDigest Where to store the hash. (What is passed is a pointer to the caller's buffer.)
Compute the SHA-512 hash of the data.

Parameters:
pvBuf Pointer to the data.
cbBuf The amount of data (in bytes).
pabDigest Where to store the hash. (What is passed is a pointer to the caller's buffer.)
Initializes the SHA-512 context.

Parameters:
pCtx Pointer to the SHA-512 context.
Feed data into the SHA-512 computation.

Parameters:
pCtx Pointer to the SHA-512 context.
pvBuf Pointer to the data.
cbBuf The length of the data (in bytes).
Compute the SHA-512 hash of the data.

Parameters:
pCtx Pointer to the SHA-512 context.
pabDigest Where to store the hash. (What is passed is a pointer to the caller's buffer.)
Same as RTSortShell but speciallized for an array containing element pointers.

Parameters:
papvArray The array to sort.
cElements The number of elements in the array.
pfnCmp Callback function comparing two elements.
pvUser User argument for the callback.
Releases the spinlock.

Parameters:
Spinlock The spinlock to acquire.
pTmp The state to restore. (This better be the same as for the RTSpinlockAcquire() call!)
Acquires the spinlock.

Parameters:
Spinlock The spinlock to acquire.
pTmp Where to save the state.
Free a UTF-16 string allocated by RTStrToUtf16(), RTStrToUtf16Ex(), RTLatin1ToUtf16(), RTLatin1ToUtf16Ex(), RTUtf16Dup() or RTUtf16DupEx().

Returns:
iprt status code.
Parameters:
pwszString The UTF-16 string to free. NULL is accepted.
Free memory related to an virtual machine

Parameters:
pv Pointer to memory block.
Free a memory block allocated with RTMemPageAlloc() or RTMemPageAllocZ().

Parameters:
pv Pointer to the block as it was returned by the allocation function. NULL will be ignored.

Definition at line 53 of file sha1.cpp.

{
    SHA1_Init(&pCtx->Private);
}


Generated by  Doxygen 1.6.0   Back to index