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

FreeBSD Manual Pages

  
 
  

home | help
REALPATH(3)		 BSD 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[MAXPATHLEN]);

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
     MAXPATHLEN	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 chdir(2), close(2),
     fchdir(2),	lstat(2), open(2), readlink(2) and getcwd(3).

CAVEATS
     This implementation of realpath() differs slightly	from the Solaris im-
     plementation.  The	4.4BSD version always returns absolute pathnames,
     whereas the Solaris implementation	will, under certain circumstances, re-
     turn a relative resolved_path when	given a	relative pathname.

SEE ALSO
     getcwd(3)

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

BSD			       February	16, 1994			   BSD

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

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

home | help