Provided by:
manpages-es_1.55-10_all 
NOMBRE
realpath - devuelve el nombre de camino absoluto en forma canonica
SINOPSIS
#include <limits.h>
#include <stdlib.h>
char *realpath(const char *camino, char *camino_resuelto);
DESCRIPCI'ON
realpath expande todos los enlaces simbolicos y resuelve referencias a
'/./', '/../' y los caracteres extra '/' en la cadena de caracteres
terminada en cero especificada por camino, y guarda el camino absoluto
en forma canonica en el bufer de tamano PATH_MAX al que apunte
camino_resuelto. El camino resultante no tendra enlaces simbolicos ni
componentes '/./' o '/../'.
VALOR DEVUELTO
Si no hay error, devuelve un puntero a camino_resuelto.
Si lo hay, devuelve un puntero NULL y el contenido del array
camino_resuelto queda indefinido. La variable global errno toma un
valor que indica el error.
ERRORES
EACCES Se ha denegado el permiso de lectura o busqueda para un
componente del prefijo del camino.
EINVAL O camino o camino_resuelto es NULL. (En libc5 esto simplemente
provocaria una violacion de segmento.)
EIO Se ha producido un error de E/S al leer del sistema de ficheros.
ELOOP Se han encontrado demasiandos enlaces simbolicos al traducir el
camino.
ENAMETOOLONG
Un componente del camino ha excedido NAME_MAX caracteres o un
camino completo ha excedido PATH_MAX caracteres
ENOENT El fichero especificado no existe.
ENOTDIR
Un componente del prefijo del camino no es un directorio.
FALLOS
Nunca use esta funcion. No funciona correctamente por cuestiones de
diseno, puesto que es imposible determinar un tamano adecuado para el
buffer de salida. Segun POSIX un buffer de tamano PATH_MAX es
suficiente, pero PATH_MAX no necesita ser una constante definida, y
puede tener que obtenerse usando pathconf(). Y preguntar a pathconf()
no ayuda mucho realmente, puesto que por una parte, POSIX advierte que
el resultado de pathconf() puede ser enorme e inapropiado para asignar
memoria. Y por otra parte pathconf() puede devolver -1 para indicar que
PATH_MAX no esta limitado.
Las implementaciones de libc4 y libc5 contienen un desbordamiento de
bufer (`buffer overflow') (solucionado en libc-5.4.13). Por tanto, los
programas con el bit SETUID activo como mount necesitan una version
privada.
HISTORIA
La funcion realpath aparecio por primera vez en BSD 4.4, aportada por
Jan-Simon Pendry. En Linux, esta funcion aparece en libc 4.5.21.
CONFORME A
En BSD 4.4 y Solaris el limite de la longitud del camino es MAXPATHLEN
(que se encuentra en <sys/param.h>). SUSv2 establece PATH_MAX y
NAME_MAX, como aparecen en <limits.h> o proporcionados por la funcion
pathconf(). Un fragmento tipico de codigo fuente seria
#ifdef PATH_MAX
path_max = PATH_MAX;
#else
path_max = pathconf (path, _PC_PATH_MAX);
if (path_max <= 0)
path_max = 4096;
#endif
(Vease la seccion FALLOS.)
Las versiones de BSD 4.4, Linux y SUSv2 siempre devuelven un nombre de
ruta absoluta. Solaris puede devolver un nombre de ruta relativa cuando
el argumento camino es relativo. El prototipo de realpath viene dado
en <unistd.h> en libc4 y libc5, y en <stdlib.h> en cualquier otro
sitio.
V'EASE TAMBI'EN
readlink(2), getcwd(3), pathconf(3), sysconf(3)
24 agosto 1999 REALPATH(3)