[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    realpath(3C) manual page Table of Contents

Name

realpath - returns the real file name

Synopsis


#include <stdlib.h>
#include <sys/param.h>

char *realpath(char *file_name, char *resolved_name);

MT-Level

MT-Safe

Description

realpath() resolves all links and references to ‘‘.’’ and ‘‘..’’ in file_name and stores it in resolved_name.

It can handle both relative and absolute path names. For absolute path names and the relative names whose resolved name cannot be expressed relatively (for example, ../../reldir), it returns the resolved absolute name. For the other relative path names, it returns the resolved relative name.

resolved_name must be big enough (MAXPATHLEN ) to contain the fully resolved path name.

Return Values

If there is no error, realpath() returns a pointer to the resolved_name. Otherwise it returns a null pointer and places the name of the offending file in resolved_name. The global variable errno is set to indicate the error.

See Also

getcwd(3C) , sysconf(3C)

Notes

realpath() operates on null-terminated strings.

One should have execute permission on all the directories in the given and the resolved path.

realpath() may fail to return to the current directory if an error occurs.

Table of Contents