locks/win32/thread_mutex.c

/* Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#include "apr.h"
#include "apr_private.h"
#include "apr_general.h"
#include "apr_strings.h"
#include "apr_arch_thread_mutex.h"
#include "apr_thread_mutex.h"
#include "apr_portable.h"
#include "apr_arch_misc.h"

static apr_status_t thread_mutex_cleanup(void *data)
{
    apr_thread_mutex_t *lock = data;

    if (lock->type == thread_mutex_critical_section) {
        lock->type = -1;
        DeleteCriticalSection(&lock->section);
    }
    else {
        if (!CloseHandle(lock->handle)) {
            return apr_get_os_error();
        }
    }
    return APR_SUCCESS;
}

APR_DECLARE(apr_status_t) apr_thread_mutex_create(apr_thread_mutex_t **mutex,
                                                  unsigned int flags,
                                                  apr_pool_t *pool)
{
    (*mutex) = (apr_thread_mutex_t *)apr_palloc(pool, sizeof(**mutex));

    (*mutex)->pool = pool;

    if (flags & APR_THREAD_MUTEX_UNNESTED) {
        /* Use semaphore for unnested mutex.
         */
        (*mutex)->type = thread_mutex_unnested_semaphore;
        (*mutex)->handle = CreateSemaphore(NULL, 1, 1, NULL);
    }
    else if (flags & APR_THREAD_MUTEX_TIMED) {
        (*mutex)->type = thread_mutex_nested_mutex;
        (*mutex)->handle = CreateMutex(NULL, FALSE, NULL);
    }
    else {
        /* Critical Sections are terrific, performance-wise, on NT.
         */
        InitializeCriticalSection(&(*mutex)->section);
        (*mutex)->type = thread_mutex_critical_section;
        (*mutex)->handle = NULL;
    }

    apr_pool_cleanup_register((*mutex)->pool, (*mutex), thread_mutex_cleanup,
                              apr_pool_cleanup_null);
    return APR_SUCCESS;
}

APR_DECLARE(apr_status_t) apr_thread_mutex_lock(apr_thread_mutex_t *mutex)
{
    if (mutex->type == thread_mutex_critical_section) {
        EnterCriticalSection(&mutex->section);
        return APR_SUCCESS;
    }
    else {
        DWORD rv = WaitForSingleObject(mutex->handle, INFINITE);
        if (rv == WAIT_OBJECT_0 || rv == WAIT_ABANDONED) {
            return APR_SUCCESS;
        }
        else if (rv == WAIT_TIMEOUT) {
            return APR_EBUSY;
        }
        else {
            return apr_get_os_error();
        }
    }
}

APR_DECLARE(apr_status_t) apr_thread_mutex_trylock(apr_thread_mutex_t *mutex)
{
    if (mutex->type == thread_mutex_critical_section) {
        if (!TryEnterCriticalSection(&mutex->section)) {
            return APR_EBUSY;
        }
        return APR_SUCCESS;
    }
    else {
        DWORD rv = WaitForSingleObject(mutex->handle, 0);
        if (rv == WAIT_OBJECT_0 || rv == WAIT_ABANDONED) {
            return APR_SUCCESS;
        }
        else if (rv == WAIT_TIMEOUT) {
            return APR_EBUSY;
        }
        else {
            return apr_get_os_error();
        }
    }
}

APR_DECLARE(apr_status_t) apr_thread_mutex_timedlock(apr_thread_mutex_t *mutex,
                                                 apr_interval_time_t timeout)
{
    if (mutex->type != thread_mutex_critical_section) {
        DWORD rv;

        rv = apr_wait_for_single_object(mutex->handle, timeout);

        if (rv == WAIT_OBJECT_0 || rv == WAIT_ABANDONED) {
            return APR_SUCCESS;
        }
        else if (rv == WAIT_TIMEOUT) {
            return APR_TIMEUP;
        }
        else {
            return apr_get_os_error();
        }
    }

    return APR_ENOTIMPL;
}

APR_DECLARE(apr_status_t) apr_thread_mutex_unlock(apr_thread_mutex_t *mutex)
{
    if (mutex->type == thread_mutex_critical_section) {
        LeaveCriticalSection(&mutex->section);
    }
    else if (mutex->type == thread_mutex_unnested_semaphore) {
        if (!ReleaseSemaphore(mutex->handle, 1, NULL)) {
            return apr_get_os_error();
        }
    }
    else if (mutex->type == thread_mutex_nested_mutex) {
        if (!ReleaseMutex(mutex->handle)) {
            return apr_get_os_error();
        }
    }
    return APR_SUCCESS;
}

APR_DECLARE(apr_status_t) apr_thread_mutex_destroy(apr_thread_mutex_t *mutex)
{
    return apr_pool_cleanup_run(mutex->pool, mutex, thread_mutex_cleanup);
}

APR_POOL_IMPLEMENT_ACCESSOR(thread_mutex)