home | help
REALPATH(3)		     Library Functions Manual		     REALPATH(3)

NAME
     realpath -- returns the canonicalized absolute pathname

LIBRARY
     Standard C Library (libc, -lc)

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

     char *
     realpath(const char *pathname, char resolved_path[PATH_MAX]);

DESCRIPTION
     The  realpath()  function resolves all symbolic links, extra "/" characters
     and references to /./ and /../ in pathname, and copies  the  resulting  ab-
     solute   pathname	 into  the  memory  referenced	by  resolved_path.   The
     resolved_path argument must refer to a buffer capable of storing  at  least
     PATH_MAX characters.

     The  realpath()  function will resolve both absolute and relative paths and
     return the absolute pathname corresponding to pathname.  All but  the  last
     component of pathname must exist when realpath() is called.

RETURN VALUES
     The  realpath() function returns resolved_path on success.  If an error oc-
     curs, realpath() returns NULL,  and  resolved_path  contains  the	pathname
     which caused the problem.

ERRORS
     The  function  realpath()	may fail and set the external variable errno for
     any of the errors specified for the library functions lstat(2), readlink(2)
     and getcwd(3).

CAVEATS
     This implementation of realpath() differs slightly from the Solaris  imple-
     mentation.   The  4.4BSD version always returns absolute pathnames, whereas
     the Solaris implementation will, under certain circumstances, return a rel-
     ative resolved_path when given a relative pathname.

SEE ALSO
     getcwd(3)

HISTORY
     The realpath() function first appeared in 4.4BSD.

FreeBSD 5.2.1			February 16, 1994		     REALPATH(3)

home | help