nuttx/libs/libc/unistd/lib_readlinkat.c
zhengyu16 ebfe22bfb9 fs: rename PSEUDOFS_SOFTLINKS to FS_LINKS
The link support is no longer limited to the pseudo file system and now
covers both soft (symbolic) links and hard links across the VFS.  Rename
the configuration option PSEUDOFS_SOFTLINKS to the more accurate FS_LINKS
and update all references in the source, headers, Kconfig, documentation
and board defconfigs accordingly.

This is a configuration rename; any out-of-tree defconfig that still
selects PSEUDOFS_SOFTLINKS must be updated to FS_LINKS.

Signed-off-by: zhengyu16 <zhengyu16@xiaomi.com>
2026-08-27 01:12:33 +08:00

96 lines
3.3 KiB
C

/****************************************************************************
* libs/libc/unistd/lib_readlinkat.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 <errno.h>
#include <unistd.h>
#include "libc.h"
#ifdef CONFIG_FS_LINKS
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: readlinkat
*
* Description:
* The readlinkat() system call operates in exactly the same way as
* readlink(), except for the differences described here.
*
* If the pathname given in pathname is relative, then it is interpreted
* relative to the directory referred to by the file descriptor dirfd
* (rather than relative to the current working directory of the calling
* process)
*
* If pathname is relative and dirfd is the special value AT_FDCWD, then
* pathname is interpreted relative to the current working directory of
* the calling process (like readlink()).
*
* If pathname is absolute, then dirfd is ignored.
*
* Input Parameters:
* dirfd - The file descriptor of directory.
* path - The full path to the symbolic link
* buf - The user-provided buffer in which to return the path to the
* link target.
* bufsize - The size of 'buf'
*
* Returned Value:
* Upon successful completion, readlinkat() will return the count of bytes
* placed in the buffer. Otherwise, it will return a value of -1, leave the
* buffer unchanged, and set errno to indicate the error.
*
****************************************************************************/
ssize_t readlinkat(int dirfd, FAR const char *path, FAR char *buf,
size_t bufsize)
{
FAR char *fullpath;
int ret;
fullpath = lib_get_pathbuffer();
if (fullpath == NULL)
{
set_errno(ENOMEM);
return ERROR;
}
ret = lib_getfullpath(dirfd, path, fullpath, PATH_MAX);
if (ret < 0)
{
lib_put_pathbuffer(fullpath);
set_errno(-ret);
return ERROR;
}
ret = readlink(fullpath, buf, bufsize);
lib_put_pathbuffer(fullpath);
return ret;
}
#endif /* CONFIG_FS_LINKS */