walnux/sched/pthread/pthread_mutexinit.c
Jukka Laitinen b6f2729730 Integrate nxmutex support fully into nxsem
This puts the mutex support fully inside nxsem, allowing
locking the mutex and setting the holder with single atomic
operation.

This enables fast mutex locking from userspace, avoiding taking
critical_sections, which may be heavy in SMP and cleanup
of nxmutex library in the future.

Signed-off-by: Jukka Laitinen <jukka.laitinen@tii.ae>
2025-05-08 16:00:05 +08:00

127 lines
3.6 KiB
C

/****************************************************************************
* sched/pthread/pthread_mutexinit.c
*
* SPDX-License-Identifier: Apache-2.0
*
* 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.
*
****************************************************************************/
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
#include <stdint.h>
#include <pthread.h>
#include <errno.h>
#include <debug.h>
#include <nuttx/semaphore.h>
#include "pthread/pthread.h"
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: pthread_mutex_init
*
* Description:
* Create a mutex
*
* Input Parameters:
* mutex - A reference to the mutex to be initialized
* attr - Mutex attribute object to be used
*
* Returned Value:
* 0 if successful. Otherwise, an error code.
*
****************************************************************************/
int pthread_mutex_init(FAR pthread_mutex_t *mutex,
FAR const pthread_mutexattr_t *attr)
{
int status;
sinfo("mutex=%p attr=%p\n", mutex, attr);
if (!mutex)
{
return EINVAL;
}
/* Initialize the semaphore of type mutex */
status = mutex_init(&mutex->mutex);
if (status < 0)
{
return -status;
}
/* Were attributes specified? If so, use them */
#ifdef CONFIG_PTHREAD_MUTEX_TYPES
mutex->type = attr ? attr->type : PTHREAD_MUTEX_DEFAULT;
#endif
#ifndef CONFIG_PTHREAD_MUTEX_UNSAFE
mutex->flink = NULL;
# ifdef CONFIG_PTHREAD_MUTEX_BOTH
mutex->flags = attr && attr->robust == PTHREAD_MUTEX_ROBUST ?
_PTHREAD_MFLAGS_ROBUST : 0;
# else
mutex->flags = 0;
# endif
#endif
#if defined(CONFIG_PRIORITY_INHERITANCE) || defined(CONFIG_PRIORITY_PROTECT)
if (attr)
{
status = mutex_set_protocol(&mutex->mutex,
SEM_TYPE_MUTEX | attr->proto);
if (status < 0)
{
mutex_destroy(&mutex->mutex);
return -status;
}
# ifdef CONFIG_PRIORITY_PROTECT
if (attr->proto == PTHREAD_PRIO_PROTECT)
{
status = mutex_setprioceiling(&mutex->mutex, attr->ceiling, NULL);
if (status < 0)
{
mutex_destroy(&mutex->mutex);
return -status;
}
}
# endif
}
else
{
/* Set the default priority inheritance and protect flags according to
* config flags.
*/
mutex_set_protocol(&mutex->mutex,
SEM_TYPE_MUTEX | PTHREAD_MUTEX_DEFAULT_PRIO_FLAGS);
}
#endif
return 0;
}