nuttx/sched/pthread/pthread_mutexinit.c
makejian 3240540952 pthread/realtime: export interfaces about pthread ceiling priority
pthread_mutex_setprioceiling and pthread_mutex_getprioceiling refers
https://pubs.opengroup.org/onlinepubs/9699919799/functions/pthread_mutex_setprioceiling.html
Signed-off-by: makejian <makejian@xiaomi.com>
2024-09-10 01:26:31 +08:00

116 lines
3.3 KiB
C

/****************************************************************************
* sched/pthread/pthread_mutexinit.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.
*
****************************************************************************/
/****************************************************************************
* 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 mutex like a semaphore with initial count = 1 */
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, 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
}
#endif
return 0;
}