r3/win/semmutex-win.cpp

	semmutex-win.cpp revision 5964f60ed7fb52a3c4becbe83c9429f9b2f119c2
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/* $Id$ */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/** @file
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * IPRT - Mutex Semaphores, Windows.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Copyright (C) 2006-2009 Sun Microsystems, Inc.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * available from http://www.virtualbox.org. This file is free software;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * you can redistribute it and/or modify it under the terms of the GNU
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * General Public License (GPL) as published by the Free Software
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * The contents of this file may alternatively be used under the terms
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * of the Common Development and Distribution License Version 1.0
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * VirtualBox OSE distribution, in which case the provisions of the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * CDDL are applicable instead of those of the GPL.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * You may elect to license modified versions of this file under the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * terms and conditions of either the GPL or the CDDL or both.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * additional information or have any questions.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*******************************************************************************
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*   Header Files                                                               *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*******************************************************************************/
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#define LOG_GROUP RTLOGGROUP_SEMAPHORE
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <Windows.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/semaphore.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/thread.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/assert.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/err.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include "internal/strict.h"
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*******************************************************************************
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*   Defined Constants And Macros                                               *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*******************************************************************************/
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/** Converts semaphore to win32 handle. */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#define SEM2HND(Sem) ((HANDLE)(uintptr_t)Sem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/* Undefine debug mappings. */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#undef RTSemMutexRequest
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#undef RTSemMutexRequestNoResume
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemMutexCreate(PRTSEMMUTEX pMutexSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Create the semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    HANDLE hmtx = CreateMutex(NULL, FALSE, NULL);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    if (hmtx)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    {
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        *pMutexSem = (RTSEMMUTEX)(void *)hmtx;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        return VINF_SUCCESS;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    }
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    return RTErrConvertFromWin32(GetLastError());
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemMutexDestroy(RTSEMMUTEX MutexSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Close semaphore handle.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    if (CloseHandle(SEM2HND(MutexSem)))
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        return VINF_SUCCESS;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    AssertMsgFailed(("Destroy MutexSem %p failed, lasterr=%d\n", MutexSem, GetLastError()));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    return RTErrConvertFromWin32(GetLastError());
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemMutexRequestNoResume(RTSEMMUTEX MutexSem, unsigned cMillies)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Lock mutex semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    int rc = WaitForSingleObjectEx(SEM2HND(MutexSem), cMillies == RT_INDEFINITE_WAIT ? INFINITE : cMillies, TRUE);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    switch (rc)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    {
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_OBJECT_0:
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        {
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#ifdef RTSEMMUTEX_STRICT
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            RTTHREAD Thread = RTThreadSelf();
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            if (Thread != NIL_RTTHREAD)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync                RTThreadWriteLockInc(Thread);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#endif
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            return VINF_SUCCESS;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        }
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_TIMEOUT:          return VERR_TIMEOUT;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_IO_COMPLETION:    return VERR_INTERRUPTED;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_ABANDONED:        return VERR_SEM_OWNER_DIED;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        default:
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        {
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            AssertMsgFailed(("Wait on MutexSem %p failed, rc=%d lasterr=%d\n", MutexSem, rc, GetLastError()));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            int rc2 = RTErrConvertFromWin32(GetLastError());
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            if (rc2 != 0)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync                return rc2;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            AssertMsgFailed(("WaitForSingleObject(event) -> rc=%d while converted lasterr=%d\n", rc, rc2));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            return VERR_INTERNAL_ERROR;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        }
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    }
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemMutexRequestNoResumeDebug(RTSEMMUTEX MutexSem, unsigned cMillies, RTHCUINTPTR uId, RT_SRC_POS_DECL)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    return RTSemMutexRequestNoResume(MutexSem, cMillies);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemMutexRelease(RTSEMMUTEX MutexSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Unlock mutex semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#ifdef RTSEMMUTEX_STRICT
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    RTTHREAD Thread = RTThreadSelf();
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    if (Thread != NIL_RTTHREAD)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        RTThreadWriteLockDec(Thread);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#endif
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    if (ReleaseMutex(SEM2HND(MutexSem)))
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        return VINF_SUCCESS;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#ifdef RTSEMMUTEX_STRICT
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    if (Thread != NIL_RTTHREAD)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        RTThreadWriteLockInc(Thread);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#endif
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    AssertMsgFailed(("Release MutexSem %p failed, lasterr=%d\n", MutexSem, GetLastError()));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    return RTErrConvertFromWin32(GetLastError());
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync