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

FreeBSD Manual Pages

  
 
  

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	11.1		       February	16, 1994		  FreeBSD 11.1

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

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

home | help