realpath(3C)        (C Programming Language Utilities)         realpath(3C)


   NAME
         realpath - returns the real file name

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

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

   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 (e.g.  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 VALUE
         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).

   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.















   7/91                                                                 Page 1