Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

realpath(3) [netbsd man page]

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 * restrict pathname, char * restrict resolvedname); DESCRIPTION
The realpath() function resolves all symbolic links, extra ``/'' characters and references to /./ and /../ in pathname, and copies the resulting absolute pathname into the memory referenced by resolvedname. The resolvedname 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. RETURN VALUES
If resolvednamed is NULL, it will be allocated and the returned pointer can be deallocated using free(3). The realpath() function returns resolvedname on success. If an error occurs, realpath() returns NULL, and resolvedname was not allocated by realpath, it will contain 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), malloc(3), open(2), readlink(2) and getcwd(3). SEE ALSO
getcwd(3) STANDARDS
realpath() first appeared in X/Open Portability Guide Issue 4, Version 2 (``XPG4.2'') and is part of IEEE Std 1003.1-2001 (``POSIX.1''). HISTORY
The realpath() function call first appeared in 4.4BSD. In NetBSD 7.0 the function was updated to accept a NULL pointer for the resolvedname argument. BUGS
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 resolvedname when given a relative pathname. BSD
June 21, 2012 BSD

Check Out this Related Man Page

REALPATH(3)								 1							       REALPATH(3)

realpath - Returns canonicalized absolute pathname

SYNOPSIS
string realpath (string $path) DESCRIPTION
realpath(3) expands all symbolic links and resolves references to '/./', '/../' and extra '/' characters in the input $path and returns the canonicalized absolute pathname. PARAMETERS
o $path - The path being checked. Note Whilst a path must be supplied, the value can be blank or NULL In these cases, the value is interpreted as the current directory. RETURN VALUES
Returns the canonicalized absolute pathname on success. The resulting path will have no symbolic link, '/./' or '/../' components. realpath(3) returns FALSE on failure, e.g. if the file does not exist. Note The running script must have executable permissions on all directories in the hierarchy, otherwise realpath(3) will return FALSE. Note Because PHP's integer type is signed and many platforms use 32bit integers, some filesystem functions may return unexpected results for files which are larger than 2GB. CHANGELOG
+--------+---------------------------------------------------+ |Version | | | | | | | Description | | | | +--------+---------------------------------------------------+ | 5.3.0 | | | | | | | Prior to this release, if only the last $path | | | component did not exist, realpath(3) would not | | | fail on *BSD systems. realpath(3) now fails in | | | this case. | | | | | 5.2.1 | | | | | | | Prior to this version, realpath(3) returned | | | FALSE if $path is an empty string or NULL. | | | | +--------+---------------------------------------------------+ EXAMPLES
Example #1 realpath(3) example <?php chdir('/var/www/'); echo realpath('./../../etc/passwd'); ?> The above example will output: /etc/passwd Example #2 realpath(3) on Windows On windows realpath(3) will change unix style paths to windows style. <?php echo realpath('/windows/system32'); ?> The above example will output: C:WINDOWSSystem32 SEE ALSO
basename(3), dirname(3), pathinfo(3). PHP Documentation Group REALPATH(3)
Man Page