tstHandleTable.cpp revision 8429669b672301e12d6ddab8bc9ce0618d930d2e
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync/* $Id$ */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync/** @file
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * IPRT Testcase - Handle Tables.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync/*
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * Copyright (C) 2008 Sun Microsystems, Inc.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync *
010ad423d45c61ef874fa1602d46459a798b54d2vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
010ad423d45c61ef874fa1602d46459a798b54d2vboxsync * available from http://www.virtualbox.org. This file is free software;
010ad423d45c61ef874fa1602d46459a798b54d2vboxsync * you can redistribute it and/or modify it under the terms of the GNU
010ad423d45c61ef874fa1602d46459a798b54d2vboxsync * General Public License (GPL) as published by the Free Software
010ad423d45c61ef874fa1602d46459a798b54d2vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
010ad423d45c61ef874fa1602d46459a798b54d2vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
010ad423d45c61ef874fa1602d46459a798b54d2vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync *
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * The contents of this file may alternatively be used under the terms
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * of the Common Development and Distribution License Version 1.0
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * VirtualBox OSE distribution, in which case the provisions of the
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * CDDL are applicable instead of those of the GPL.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync *
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * You may elect to license modified versions of this file under the
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * terms and conditions of either the GPL or the CDDL or both.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync *
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * additional information or have any questions.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync/*******************************************************************************
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync* Header Files *
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync*******************************************************************************/
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/handletable.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/stream.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/initterm.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/err.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/getopt.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/mem.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/alloca.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/thread.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync#include <iprt/string.h>
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync/*******************************************************************************
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync* Global Variables *
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync*******************************************************************************/
d0eec04539061d14a7e51f492aea90fa5394615fvboxsyncstatic unsigned g_cErrors;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsyncstatic DECLCALLBACK(void) tstHandleTableTest1Delete(RTHANDLETABLE hHandleTable, uint32_t h, void *pvObj, void *pvCtx, void *pvUser)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync{
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t *pcCalls = (uint32_t *)pvUser;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync (*pcCalls)++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync}
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsyncstatic DECLCALLBACK(int) tstHandleTableTest1Retain(RTHANDLETABLE hHandleTable, void *pvObj, void *pvCtx, void *pvUser)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync{
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t *pcCalls = (uint32_t *)pvUser;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync (*pcCalls)++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return VINF_SUCCESS;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync}
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsyncstatic int tstHandleTableTest1(uint32_t uBase, uint32_t cMax, uint32_t cDelta, uint32_t cUnitsPerDot, bool fCallbacks, uint32_t fFlags)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync{
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync const char *pszWithCtx = fFlags & RTHANDLETABLE_FLAGS_CONTEXT ? "WithCtx" : "";
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t cRetainerCalls = 0;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync int rc;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: TESTING RTHandleTableCreateEx(, 0");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_LOCKED) RTPrintf(" | LOCKED");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT) RTPrintf(" | CONTEXT");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf(", %#x, %#x,,)...\n", uBase, cMax);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTHANDLETABLE hHT;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync rc = RTHandleTableCreateEx(&hHT, fFlags, uBase, cMax,
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync fCallbacks ? tstHandleTableTest1Retain : NULL,
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync fCallbacks ? &cRetainerCalls : NULL);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (RT_FAILURE(rc))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE - RTHandleTableCreateEx failed, %Rrc!\n", rc);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return 1;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* fill it */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: TESTING RTHandleTableAlloc%s..", pszWithCtx); RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t i = uBase;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (;; i++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t h;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync rc = RTHandleTableAllocWithCtx(hHT, (void *)((uintptr_t)&i + (uintptr_t)i * 4), NULL, &h);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync rc = RTHandleTableAlloc(hHT, (void *)((uintptr_t)&i + (uintptr_t)i * 4), &h);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (RT_SUCCESS(rc))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (h != i)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - h=%d, expected %d!\n", __LINE__, h, i);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else if (rc == VERR_NO_MORE_HANDLES)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (i < cMax)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, expected > 65534!\n", __LINE__, i);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync break;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, rc=%Rrc!\n", __LINE__, i, rc);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (!(i % cUnitsPerDot))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf(".");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t const c = i;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf(" c=%#x\n", c);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fCallbacks && cRetainerCalls != 0)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - cRetainerCalls=%#x expected 0!\n", __LINE__, i, cRetainerCalls);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* look up all the entries */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: TESTING RTHandleTableLookup%s..", pszWithCtx); RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync cRetainerCalls = 0;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (i = uBase; i < c; i++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvExpect = (void *)((uintptr_t)&i + (uintptr_t)i * 4);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvObj;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableLookupWithCtx(hHT, i, NULL);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableLookup(hHT, i);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (!pvObj)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, RTHandleTableLookup%s failed!\n", __LINE__, i, pszWithCtx);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else if (pvObj != pvExpect)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, pvObj=%p expected %p\n", __LINE__, i, pvObj, pvExpect);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (!(i % cUnitsPerDot))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf(".");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\n");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fCallbacks && cRetainerCalls != c - uBase)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - cRetainerCalls=%#x expected %#x!\n", __LINE__, cRetainerCalls, c - uBase);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* remove all the entries (in order) */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: TESTING RTHandleTableFree%s..", pszWithCtx); RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync cRetainerCalls = 0;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (i = uBase; i < c; i++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvExpect = (void *)((uintptr_t)&i + (uintptr_t)i * 4);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvObj;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableFreeWithCtx(hHT, i, NULL);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableFree(hHT, i);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (!pvObj)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, RTHandleTableLookup%s failed!\n", __LINE__, i, pszWithCtx);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else if (pvObj != pvExpect)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, pvObj=%p expected %p\n", __LINE__, i, pvObj, pvExpect);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else if ( fFlags & RTHANDLETABLE_FLAGS_CONTEXT
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync ? RTHandleTableLookupWithCtx(hHT, i, NULL)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync : RTHandleTableLookup(hHT, i))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, RTHandleTableLookup%s succeeded after free!\n", __LINE__, i, pszWithCtx);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (!(i % cUnitsPerDot))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf(".");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\n");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fCallbacks && cRetainerCalls != c - uBase)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - cRetainerCalls=%#x expected %#x!\n", __LINE__, cRetainerCalls, c - uBase);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* do a mix of alloc, lookup and free where there is a constant of cDelta handles in the table. */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: TESTING Alloc,Lookup,Free mix [cDelta=%#x]..", cDelta); RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (i = uBase; i < c * 2; i++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* alloc */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t hExpect = ((i - uBase) % (c - uBase)) + uBase;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t h;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync rc = RTHandleTableAllocWithCtx(hHT, (void *)((uintptr_t)&i + (uintptr_t)hExpect * 4), NULL, &h);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync rc = RTHandleTableAlloc(hHT, (void *)((uintptr_t)&i + (uintptr_t)hExpect * 4), &h);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (RT_FAILURE(rc))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, RTHandleTableAlloc%s: rc=%Rrc!\n", __LINE__, i, pszWithCtx, rc);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else if (h != hExpect)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, RTHandleTableAlloc%s: h=%u hExpect=%u! - abort sub-test\n", __LINE__, i, pszWithCtx, h, hExpect);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync break;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (i >= cDelta + uBase)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* lookup */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (uint32_t j = i - cDelta; j <= i; j++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t hLookup = ((j - uBase) % (c - uBase)) + uBase;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvExpect = (void *)((uintptr_t)&i + (uintptr_t)hLookup * 4);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvObj;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableLookupWithCtx(hHT, hLookup, NULL);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableLookup(hHT, hLookup);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (pvObj != pvExpect)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, j=%d, RTHandleTableLookup%s(,%u,): pvObj=%p expected %p!\n",
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync __LINE__, i, j, pszWithCtx, hLookup, pvObj, pvExpect);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else if ( (fFlags & RTHANDLETABLE_FLAGS_CONTEXT)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync && RTHandleTableLookupWithCtx(hHT, hLookup, &i))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, j=%d, RTHandleTableLookupWithCtx: succeeded with bad context\n",
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync __LINE__, i, j, pvObj, pvExpect);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* free */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t hFree = ((i - uBase - cDelta) % (c - uBase)) + uBase;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvExpect = (void *)((uintptr_t)&i + (uintptr_t)hFree * 4);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvObj;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableFreeWithCtx(hHT, hFree, NULL);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync pvObj = RTHandleTableFree(hHT, hFree);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (pvObj != pvExpect)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, RTHandleTableFree%s: pvObj=%p expected %p!\n",
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync __LINE__, i, pszWithCtx, pvObj, pvExpect);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync else if (fFlags & RTHANDLETABLE_FLAGS_CONTEXT
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync ? RTHandleTableLookupWithCtx(hHT, hFree, NULL)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync || RTHandleTableFreeWithCtx(hHT, hFree, NULL)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync : RTHandleTableLookup(hHT, hFree)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync || RTHandleTableFree(hHT, hFree))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\ntstHandleTable: FAILURE (%d) - i=%d, RTHandleTableLookup/Free%s: succeeded after free\n",
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync __LINE__, i, pszWithCtx);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (!(i % (cUnitsPerDot * 2)))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf(".");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTStrmFlush(g_pStdOut);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("\n");
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /* finally, destroy the table (note that there are 128 entries in it). */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync cRetainerCalls = 0;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t cDeleteCalls = 0;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync rc = RTHandleTableDestroy(hHT,
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync fCallbacks ? tstHandleTableTest1Delete : NULL,
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync fCallbacks ? &cDeleteCalls : NULL);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (RT_FAILURE(rc))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - RTHandleTableDestroy failed, %Rrc!\n", __LINE__, rc);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync g_cErrors++;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return 0;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync}
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsynctypedef struct TSTHTTEST2ARGS
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync{
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /** The handle table. */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTHANDLETABLE hHT;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /** The thread handle. */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTTHREAD hThread;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /** Thread index. */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t iThread;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /** the max number of handles the thread should allocate. */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t cMax;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync} TSTHTTEST2ARGS, *PTSTHTTEST2ARGS;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsyncstatic DECLCALLBACK(int) tstHandleTableTest2Thread(RTTHREAD hThread, void *pvUser)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync{
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTHANDLETABLE const hHT = ((PTSTHTTEST2ARGS)pvUser)->hHT;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t const iThread = ((PTSTHTTEST2ARGS)pvUser)->iThread;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t const cMax = ((PTSTHTTEST2ARGS)pvUser)->cMax;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync uint32_t *pah = (uint32_t *)RTMemAllocZ(sizeof(uint32_t) * cMax);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (!pah)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - failed to allocate %zu bytes\n", __LINE__, sizeof(uint32_t) * cMax);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return VERR_NO_MEMORY;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /*
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * Allocate our quota.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (uint32_t i = 0; i < cMax; i++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync int rc = RTHandleTableAllocWithCtx(hHT, pvUser, hThread, &pah[i]);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (RT_FAILURE(rc))
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - t=%d i=%d: RTHandleTableAllocWithCtx failed, rc=%Rrc\n",
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync __LINE__, iThread, i, rc);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return rc;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /*
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * Look them up.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (uint32_t i = 0; i < cMax; i++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvObj = RTHandleTableLookupWithCtx(hHT, pah[i], hThread);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (pvObj != pvUser)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - t=%d i=%d: RTHandleTableLookupWithCtx failed, pvObj=%p\n",
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync __LINE__, iThread, i, pvObj);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return VERR_INTERNAL_ERROR;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /*
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * Free them all.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync for (uint32_t i = 0; i < cMax; i++)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync void *pvObj = RTHandleTableFreeWithCtx(hHT, pah[i], hThread);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync if (pvObj != pvUser)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync {
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: FAILURE (%d) - t=%d i=%d: RTHandleTableFreeWithCtx failed, pvObj=%p\n",
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync __LINE__, iThread, i, pvObj);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return VERR_INTERNAL_ERROR;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync }
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTMemFree(pah);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync return VINF_SUCCESS;
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync}
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync
d0eec04539061d14a7e51f492aea90fa5394615fvboxsyncstatic int tstHandleTableTest2(uint32_t uBase, uint32_t cMax, uint32_t cThreads)
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync{
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync /*
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync * Create the table.
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync */
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTPrintf("tstHandleTable: TESTING %u threads: uBase=%u, cMax=%u\n", cThreads, uBase, cMax);
d0eec04539061d14a7e51f492aea90fa5394615fvboxsync RTHANDLETABLE hHT;
int rc = RTHandleTableCreateEx(&hHT, RTHANDLETABLE_FLAGS_LOCKED | RTHANDLETABLE_FLAGS_CONTEXT, uBase, cMax, NULL, NULL);
if (RT_FAILURE(rc))
{
RTPrintf("tstHandleTable: FAILURE - RTHandleTableCreateEx failed, %Rrc!\n", rc);
return 1;
}
/// @todo there must be a race somewhere in the thread code, I keep hitting a duplicate insert id here...
// Or perhaps it just barcelona B2 bugs?
RTThreadSleep(50);
/*
* Spawn the threads.
*/
PTSTHTTEST2ARGS paThread = (PTSTHTTEST2ARGS)alloca(sizeof(*paThread) * cThreads);
for (uint32_t i = 0; i < cThreads; i++)
{
paThread[i].hHT = hHT;
paThread[i].hThread = NIL_RTTHREAD;
paThread[i].iThread = i;
paThread[i].cMax = cMax / cThreads;
}
for (uint32_t i = 0; i < cThreads; i++)
{
char szName[32];
RTStrPrintf(szName, sizeof(szName), "TEST2-%x/%x", i, cMax);
rc = RTThreadCreate(&paThread[i].hThread, tstHandleTableTest2Thread, &paThread[i], 0, RTTHREADTYPE_DEFAULT, RTTHREADFLAGS_WAITABLE, szName);
if (RT_FAILURE(rc))
{
RTPrintf("tstHandleTable: FAILURE - RTThreadCreate failed, %Rrc!\n", rc);
g_cErrors++;
break;
}
}
/*
* Wait for them to complete.
*/
uint32_t cRunning;
do /** @todo Remove when RTSemEventWait (linux) has been fixed. */
{
if (cRunning != cThreads)
RTThreadSleep(10);
cRunning = 0;
for (uint32_t i = 0; i < cThreads; i++)
if (paThread[i].hThread != NIL_RTTHREAD)
{
rc = RTThreadWait(paThread[i].hThread, RT_INDEFINITE_WAIT, NULL);
if (RT_SUCCESS(rc))
paThread[i].hThread = NIL_RTTHREAD;
else
cRunning++;
}
} while (cRunning);
/*
* Destroy the handle table.
*/
rc = RTHandleTableDestroy(hHT, NULL, NULL);
if (RT_FAILURE(rc))
{
RTPrintf("tstHandleTable: FAILURE (%d) - RTHandleTableDestroy failed, %Rrc!\n", __LINE__, rc);
g_cErrors++;
}
return 0;
}
int main(int argc, char **argv)
{
/*
* Init the runtime and parse the arguments.
*/
RTR3Init(false, 0);
static RTOPTIONDEF const s_aOptions[] =
{
{ "--base", 'b', RTGETOPT_REQ_UINT32 },
{ "--max", 'm', RTGETOPT_REQ_UINT32 },
{ "--threads", 't', RTGETOPT_REQ_UINT32 },
{ "--help", 'h', RTGETOPT_REQ_NOTHING },
{ "--?", '?', RTGETOPT_REQ_NOTHING },
};
uint32_t uBase = 0;
uint32_t cMax = 0;
uint32_t cThreads = 0;
int ch;
int iArg = 1;
RTOPTIONUNION Value;
while ((ch = RTGetOpt(argc,argv, &s_aOptions[0], RT_ELEMENTS(s_aOptions), &iArg, &Value)))
switch (ch)
{
case 'b':
uBase = Value.u32;
break;
case 'm':
cMax = Value.u32;
break;
case 't':
cThreads = Value.u32;
if (!cThreads)
cThreads = 1;
break;
case '?':
case 'h':
RTPrintf("syntax: tstHandleTable [-b <base>] [-m <max>] [-t <threads>]\n");
return 1;
default:
if (RT_SUCCESS(ch))
RTPrintf("tstHandleTable: invalid argument (%#x): %s\n", ch, Value.psz);
else
RTPrintf("tstHandleTable: invalid argument: %Rrc - \n", ch, Value.pDef->pszLong);
return 1;
}
if (iArg < argc)
{
RTPrintf("tstHandleTable: invalid argument: %s\n", argv[iArg]);
return 1;
}
/*
* If any argument was specified, run the requested test setup.
* Otherwise run a bunch of default tests.
*/
if (cThreads || cMax || uBase)
{
if (!cMax)
cMax = 65535;
if (!cThreads)
tstHandleTableTest1(uBase, cMax, 128, cMax / 32, false, RTHANDLETABLE_FLAGS_CONTEXT | RTHANDLETABLE_FLAGS_LOCKED);
else
tstHandleTableTest2(uBase, cMax, 128);
}
else
{
/*
* Do a simple warmup / smoke test first.
*/
#if 0
tstHandleTableTest1(1, 65534, 128, 2048, false, 0);
tstHandleTableTest1(1, 65534, 128, 2048, false, RTHANDLETABLE_FLAGS_CONTEXT);
tstHandleTableTest1(1, 65534, 63, 2048, false, RTHANDLETABLE_FLAGS_LOCKED);
tstHandleTableTest1(1, 65534, 63, 2048, false, RTHANDLETABLE_FLAGS_CONTEXT | RTHANDLETABLE_FLAGS_LOCKED);
/* Test that the retain and delete functions work. */
tstHandleTableTest1(1, 1024, 256, 256, true, RTHANDLETABLE_FLAGS_LOCKED);
tstHandleTableTest1(1, 1024, 256, 256, true, RTHANDLETABLE_FLAGS_CONTEXT | RTHANDLETABLE_FLAGS_LOCKED);
/* check that the base works. */
tstHandleTableTest1(0x7ffff000, 65534, 4, 2048, false, RTHANDLETABLE_FLAGS_CONTEXT | RTHANDLETABLE_FLAGS_LOCKED);
tstHandleTableTest1(0xeffff000, 65534, 4, 2048, false, RTHANDLETABLE_FLAGS_CONTEXT | RTHANDLETABLE_FLAGS_LOCKED);
tstHandleTableTest1(0, 4097, 4, 256, false, RTHANDLETABLE_FLAGS_CONTEXT | RTHANDLETABLE_FLAGS_LOCKED);
tstHandleTableTest1(0, 1024, 4, 128, false, RTHANDLETABLE_FLAGS_CONTEXT | RTHANDLETABLE_FLAGS_LOCKED);
/* For testing 1st level expansion / reallocation. */
tstHandleTableTest1(1, 1024*1024*8, 3, 150000, false, 0);
#endif
tstHandleTableTest1(1, 1024*1024*8, 3, 150000, false, RTHANDLETABLE_FLAGS_CONTEXT);
/*
* Threaded tests.
*/
tstHandleTableTest2(0x80000000, 32768, 2);
tstHandleTableTest2(0x00010000, 2048, 4);
tstHandleTableTest2(0x00010000, 3072, 8);
tstHandleTableTest2(0x00000000, 1024*1024*8, 3);
}
/*
* Summary.
*/
if (!g_cErrors)
RTPrintf("tstHandleTable: SUCCESS\n");
else
RTPrintf("tstHandleTable: FAILURE - %d errors\n", g_cErrors);
return !!g_cErrors;
}