2008-01-30 22:59:12 +01:00
|
|
|
/****************************************************************************
|
2014-08-08 22:21:48 +02:00
|
|
|
* sched/pthread/pthread_mutexinit.c
|
2007-02-18 00:21:28 +01:00
|
|
|
*
|
2017-03-26 21:37:05 +02:00
|
|
|
* Copyright (C) 2007-2009, 2011, 2016-2017 Gregory Nutt. All rights reserved.
|
2012-07-14 21:30:31 +02:00
|
|
|
* Author: Gregory Nutt <gnutt@nuttx.org>
|
2007-02-18 00:21:28 +01:00
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
*
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in
|
|
|
|
* the documentation and/or other materials provided with the
|
|
|
|
* distribution.
|
2008-01-30 22:59:12 +01:00
|
|
|
* 3. Neither the name NuttX nor the names of its contributors may be
|
2007-02-18 00:21:28 +01:00
|
|
|
* used to endorse or promote products derived from this software
|
|
|
|
* without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*
|
2008-01-30 22:59:12 +01:00
|
|
|
****************************************************************************/
|
2007-02-18 00:21:28 +01:00
|
|
|
|
2008-01-30 22:59:12 +01:00
|
|
|
/****************************************************************************
|
2007-02-18 00:21:28 +01:00
|
|
|
* Included Files
|
2008-01-30 22:59:12 +01:00
|
|
|
****************************************************************************/
|
2007-02-18 00:21:28 +01:00
|
|
|
|
2009-12-14 19:39:29 +01:00
|
|
|
#include <nuttx/config.h>
|
|
|
|
|
|
|
|
#include <stdint.h>
|
2007-02-18 00:21:28 +01:00
|
|
|
#include <pthread.h>
|
|
|
|
#include <errno.h>
|
|
|
|
#include <debug.h>
|
2009-12-14 19:39:29 +01:00
|
|
|
|
2016-11-02 21:43:03 +01:00
|
|
|
#include <nuttx/semaphore.h>
|
|
|
|
|
2014-08-08 20:55:02 +02:00
|
|
|
#include "pthread/pthread.h"
|
2007-02-18 00:21:28 +01:00
|
|
|
|
2008-01-30 22:59:12 +01:00
|
|
|
/****************************************************************************
|
2007-02-18 00:21:28 +01:00
|
|
|
* Public Functions
|
2008-01-30 22:59:12 +01:00
|
|
|
****************************************************************************/
|
2007-02-18 00:21:28 +01:00
|
|
|
|
2008-01-30 22:59:12 +01:00
|
|
|
/****************************************************************************
|
2012-07-14 21:30:31 +02:00
|
|
|
* Name: pthread_mutex_init
|
2007-02-18 00:21:28 +01:00
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Create a mutex
|
|
|
|
*
|
|
|
|
* Parameters:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
* Return Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
*
|
2008-01-30 22:59:12 +01:00
|
|
|
****************************************************************************/
|
2007-02-18 00:21:28 +01:00
|
|
|
|
2016-11-02 16:05:18 +01:00
|
|
|
int pthread_mutex_init(FAR pthread_mutex_t *mutex,
|
|
|
|
FAR const pthread_mutexattr_t *attr)
|
2007-02-18 00:21:28 +01:00
|
|
|
{
|
|
|
|
int pshared = 0;
|
2017-03-27 17:08:14 +02:00
|
|
|
#ifdef CONFIG_PTHREAD_MUTEX_TYPES
|
2016-11-02 16:05:18 +01:00
|
|
|
uint8_t type = PTHREAD_MUTEX_DEFAULT;
|
2008-05-31 19:13:08 +02:00
|
|
|
#endif
|
2016-11-02 16:05:18 +01:00
|
|
|
#ifdef CONFIG_PRIORITY_INHERITANCE
|
|
|
|
uint8_t proto = PTHREAD_PRIO_INHERIT;
|
2017-03-27 02:37:24 +02:00
|
|
|
#endif
|
|
|
|
#ifndef CONFIG_PTHREAD_MUTEX_UNSAFE
|
|
|
|
#ifdef CONFIG_PTHREAD_MUTEX_DEFAULT_UNSAFE
|
|
|
|
uint8_t robust = PTHREAD_MUTEX_STALLED;
|
|
|
|
#else
|
|
|
|
uint8_t robust = PTHREAD_MUTEX_ROBUST;
|
|
|
|
#endif
|
2016-11-02 16:05:18 +01:00
|
|
|
#endif
|
|
|
|
int ret = OK;
|
2007-02-18 00:21:28 +01:00
|
|
|
int status;
|
|
|
|
|
2016-06-12 00:42:42 +02:00
|
|
|
sinfo("mutex=0x%p attr=0x%p\n", mutex, attr);
|
2007-02-18 00:21:28 +01:00
|
|
|
|
|
|
|
if (!mutex)
|
|
|
|
{
|
|
|
|
ret = EINVAL;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
/* Were attributes specified? If so, use them */
|
|
|
|
|
|
|
|
if (attr)
|
|
|
|
{
|
|
|
|
pshared = attr->pshared;
|
2016-11-02 16:05:18 +01:00
|
|
|
#ifdef CONFIG_PRIORITY_INHERITANCE
|
|
|
|
proto = attr->proto;
|
|
|
|
#endif
|
2017-03-27 17:08:14 +02:00
|
|
|
#ifdef CONFIG_PTHREAD_MUTEX_TYPES
|
2008-05-31 19:13:08 +02:00
|
|
|
type = attr->type;
|
2017-03-27 02:37:24 +02:00
|
|
|
#endif
|
|
|
|
#ifdef CONFIG_PTHREAD_MUTEX_BOTH
|
|
|
|
robust = attr->robust;
|
2008-05-31 19:13:08 +02:00
|
|
|
#endif
|
2007-02-18 00:21:28 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/* Indicate that the semaphore is not held by any thread. */
|
|
|
|
|
2015-06-16 16:27:38 +02:00
|
|
|
mutex->pid = -1;
|
2007-02-18 00:21:28 +01:00
|
|
|
|
|
|
|
/* Initialize the mutex like a semaphore with initial count = 1 */
|
|
|
|
|
2015-10-08 03:59:14 +02:00
|
|
|
status = sem_init((FAR sem_t *)&mutex->sem, pshared, 1);
|
2007-02-18 00:21:28 +01:00
|
|
|
if (status != OK)
|
|
|
|
{
|
2016-11-02 16:05:18 +01:00
|
|
|
ret = get_errno();
|
|
|
|
}
|
|
|
|
|
|
|
|
#ifdef CONFIG_PRIORITY_INHERITANCE
|
|
|
|
/* Initialize the semaphore protocol */
|
|
|
|
|
|
|
|
status = sem_setprotocol((FAR sem_t *)&mutex->sem, proto);
|
|
|
|
if (status != OK)
|
|
|
|
{
|
|
|
|
ret = get_errno();
|
2007-02-18 00:21:28 +01:00
|
|
|
}
|
2016-11-02 16:05:18 +01:00
|
|
|
#endif
|
2017-03-27 01:37:28 +02:00
|
|
|
|
|
|
|
#ifndef CONFIG_PTHREAD_MUTEX_UNSAFE
|
2017-03-26 21:37:05 +02:00
|
|
|
/* Initial internal fields of the mutex */
|
|
|
|
|
|
|
|
mutex->flink = NULL;
|
2017-03-27 02:37:24 +02:00
|
|
|
mutex->flags = (robust == PTHREAD_MUTEX_ROBUST ? _PTHREAD_MFLAGS_ROBUST : 0);
|
2017-03-27 01:37:28 +02:00
|
|
|
#endif
|
2007-02-18 00:21:28 +01:00
|
|
|
|
2017-03-27 17:08:14 +02:00
|
|
|
#ifdef CONFIG_PTHREAD_MUTEX_TYPES
|
2011-01-19 22:17:37 +01:00
|
|
|
/* Set up attributes unique to the mutex type */
|
2008-05-31 19:13:08 +02:00
|
|
|
|
2011-01-19 22:17:37 +01:00
|
|
|
mutex->type = type;
|
|
|
|
mutex->nlocks = 0;
|
2008-05-31 19:13:08 +02:00
|
|
|
#endif
|
2011-01-19 22:17:37 +01:00
|
|
|
}
|
2008-05-31 19:13:08 +02:00
|
|
|
|
2016-06-12 00:42:42 +02:00
|
|
|
sinfo("Returning %d\n", ret);
|
2007-02-18 00:21:28 +01:00
|
|
|
return ret;
|
|
|
|
}
|