Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
REALPATH(3)	       FreeBSD 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	``/'' charac-
     ters and references to /./	and /../ in pathname, and copies the resulting
     absolute 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
     occurs, 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
     implementation.  The 4.4BSD version always	returns	absolute pathnames,
     whereas the Solaris implementation	will, under certain circumstances,
     return a relative resolved_path when given	a relative pathname.

SEE ALSO
     getcwd(3)

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

FreeBSD	9.3		       February	16, 1994		   FreeBSD 9.3

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | CAVEATS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=realpath&sektion=3&manpath=FreeBSD+7.1-RELEASE>

home | help