realpath.3x (2010 09)

r
realpath(3X) realpath(3X)
NAME
realpath - resolve pathname
SYNOPSIS
#include <stdlib.h>
char *realpath(const char *
file_name__restrict fP
, char *resolved_name__restrict
);
DESCRIPTION
The realpath() function derives, from the pathname pointed to by file_name , an absolute pathname
that names the same file, whose resolution does not involve
., .., or symbolic links. The generated path-
name is stored, up to a maximum of
{PATH_MAX} bytes, in the buffer pointed to by resolved_name.
RETURN VALUE
On successful completion,
realpath() returns a pointer to the resolved name. Otherwise,
real-
path() returns a null pointer and sets errno to indicate the error, and the contents of the buffer pointed
to by resolved_name are undefined.
ERRORS
The
realpath() function will fail if:
[EACCES] Read or search permission was denied for a component of file_name .
[EINVAL] Either the file_name or resolved_name argument is a null pointer.
[EIO] An error occurred while reading from the file system.
[ELOOP] Too many symbolic links were encountered in resolving path .
[ENAMETOOLONG] The file_name argument is longer than
{PATH_MAX} or a pathname com-
ponent is longer than
{NAME_MAX}.
[ENOENT] A component of file_name does not name an existing file or file_name points
to an empty string.
[ENOTDIR] A component of the path prefix is not a directory.
The
realpath() function may fail if:
[ENAMETOOLONG] Pathname resolution of a symbolic link produced an intermediate result
whose length exceeds
{PATH_MAX}.
[ENOMEM] Insufficient storage space is available.
SEE ALSO
sysconf(2), getcwd(3C), thread_safety(5), glossary(9), <stdlib.h>.
CHANGE HISTORY
First released in Issue 4, Version 2.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1