rt-thread/components/libc/posix/libdl/dlclose.c

/*
 * Copyright (c) 2006-2024 RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2010-11-17     yi.qiu       first version
 */

#include <rtthread.h>
#include <rtm.h>

#include "dlmodule.h"

/**
 * @brief  close a dynamically loaded shared library.
 *
 * @param  handle the handle which identifies the shared library to be closed.
 * @return int it returns RT_TRUE on success.
 *
 * @note   This function is an API of POSIX standard, which is designed to decrease the reference count (nref) for a dynamically loaded module
 *         and destroy it if no references remain.
 */
int dlclose(void *handle)
{
    struct rt_dlmodule *module;

    RT_ASSERT(handle != RT_NULL);

    module = (struct rt_dlmodule *)handle;

    rt_enter_critical();
    module->nref--;
    if (module->nref <= 0)
    {
        rt_exit_critical();

        dlmodule_destroy(module);
    }
    else
    {
        rt_exit_critical();
    }

    return RT_TRUE;
}
RTM_EXPORT(dlclose)