1. Computing & Technology
Linux / Unix Command: realpath
Command Library

NAME

realpath - return the canonicalized absolute pathname  

SYNOPSIS

#include <limits.h>
#include <stdlib.h>

char *realpath(const char *path, char *resolved_path);
 

DESCRIPTION

realpath expands all symbolic links and resolves references to '/./', '/../' and extra '/' characters in the null terminated string named by path and stores the canonicalized absolute pathname in the buffer of size PATH_MAX named by resolved_path. The resulting path will have no symbolic link, '/./' or '/../' components.  

RETURN VALUE

If there is no error, it returns a pointer to the resolved_path.

Otherwise it returns a NULL pointer, and the contents of the array resolved_path are undefined. The global variable errno is set to indicate the error.  

ERRORS

EACCES
Read or search permission was denied for a component of the path prefix.
EINVAL
Either path or resolved_path is NULL. (In libc5 this would just cause a segfault.)
EIO
An I/O error occurred while reading from the file system.
ELOOP
Too many symbolic links were encountered in translating the pathname.
ENAMETOOLONG
A component of a path name exceeded NAME_MAX characters, or an entire path name exceeded PATH_MAX characters.
ENOENT
The named file does not exist.
ENOTDIR
A component of the path prefix is not a directory.
 

SEE ALSO

readlink(2), getcwd(3), pathconf(3), sysconf(3)


Important: Use the man command (% man) to see how a command is used on your particular computer.

>> Linux/Unix Command Library

>> Shell Command Library

Discuss in my forum

©2012 About.com. All rights reserved.

A part of The New York Times Company.