Files
threadx/utility/rtos_compatibility_layers/posix/px_mx_destroy.c
2021-07-28 07:24:02 +00:00

101 lines
5.3 KiB
C

/**************************************************************************/
/* */
/* Copyright (c) Microsoft Corporation. All rights reserved. */
/* */
/* This software is licensed under the Microsoft Software License */
/* Terms for Microsoft Azure RTOS. Full text of the license can be */
/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
/* and in the root directory of this software. */
/* */
/**************************************************************************/
/**************************************************************************/
/**************************************************************************/
/** */
/** POSIX wrapper for THREADX */
/** */
/** */
/** */
/**************************************************************************/
/**************************************************************************/
/* Include necessary system files. */
#include "tx_api.h" /* Threadx API */
#include "pthread.h" /* Posix API */
#include "px_int.h" /* Posix helper functions */
/**************************************************************************/
/* */
/* FUNCTION RELEASE */
/* */
/* pthread_mutex_destroy PORTABLE C */
/* 6.1.7 */
/* AUTHOR */
/* */
/* William E. Lamie, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This function shall destroy the mutex object referenced by mutex; */
/* the mutex object becomes,in effect, uninitialized.A destroyed mutex */
/* object can be reinitialized using pthread_mutex_init() */
/* It shall be safe to destroy an initialized mutex that is unlocked. */
/* Attempting to destroy a locked mutex results in undefined behavior. */
/* */
/* INPUT */
/* */
/* mutex Address of the mutex */
/* */
/* OUTPUT */
/* */
/* 0 If successful */
/* Value In case of any error */
/* */
/* CALLS */
/* */
/* tx_mutex_delete ThreadX Mutex service */
/* */
/* CALLED BY */
/* */
/* Application Code */
/* */
/* RELEASE HISTORY */
/* */
/* DATE NAME DESCRIPTION */
/* */
/* 06-02-2021 William E. Lamie Initial Version 6.1.7 */
/* */
/**************************************************************************/
INT pthread_mutex_destroy(pthread_mutex_t *mutex)
{
TX_INTERRUPT_SAVE_AREA
TX_MUTEX *mutex_ptr;
INT status,retval;
/* Disable interrupts. */
TX_DISABLE
mutex_ptr = (TX_MUTEX*) mutex;
status = tx_mutex_delete(mutex_ptr);
if (status == TX_SUCCESS)
{
mutex->in_use = TX_FALSE;
retval = OK;
}
else
{
posix_errno = EINVAL;
posix_set_pthread_errno(EINVAL);
retval = EINVAL;
}
TX_RESTORE
return(retval);
}