realpath(3C)							  realpath(3C)

NAME    [Toc]    [Back]

     realpath -	returns	the real file name

SYNOPSIS    [Toc]    [Back]

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

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     getcwd(3C).

DIAGNOSTICS    [Toc]    [Back]

     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    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111