REALPATH(3C-SVR4)   RISC/os Reference Manual    REALPATH(3C-SVR4)



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.
















                        Printed 11/19/92                   Page 1