realpath(3C)    UNIX System V(C Programming Language Utilities)    realpath(3C)


NAME
      realpath - returns the real file name

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

      char *realpath (char * filename, char * resolvedname);

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.

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.

















10/89                                                                    Page 1