NAME

realpath − Resolves pathname

SYNOPSIS

#include <stdlib.h>

char ∗realpath(
        const char ∗file_name,
        char ∗resolved_name);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

realpath():  POSIX.1, XPG4−UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags. 

DESCRIPTION

The realpath() function derives, from the file pointed to by file_name, an absolute pathname that names the same file, whose resolution does not involve ".", "..", or symbolic links.  The generated pathname is stored, up to a maximum of PATH_MAX bytes, in the buffer pointed to by resolved_name. 

RETURN VALUES

Upon successful completion, the realpath() function returns a pointer to the resolved name.  Otherwise,  realpath() 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

If the realpath() function fails, errno may be set to one of the following values:

[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 component 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. 

[ENOMEM]Insufficient storage space available. 

[ENOTDIR]A component of either path prefix is not a directory. 

RELATED INFORMATION

Functions: getcwd(3), sysconf(3)

Standards: standards(5)