/**************************************************************************** * 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 #include #include #include #include #include #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; }