realpath(3C)                                                      realpath(3C)


NAME
     realpath - returns the real file name

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

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

DESCRIPTION
     realpath resolves all links, symbolic 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.

     resolved_name should point to a buffer (MAXPATHLEN) bytes in length to
     contain the fully resolved path name.

SEE ALSO
     getcwd(3C).

DIAGNOSTICS
     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.

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.


                                                                        Page 1