NOMBRE¶
realpath - devuelve el nombre de camino absoluto en forma canónica
SINOPSIS¶
#include <limits.h>
#include <stdlib.h>
char *realpath(const char *camino, char *camino_resuelto);
DESCRIPCIÓN¶
realpath expande todos los enlaces simbólicos 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 canónica en el búfer de tamaño
PATH_MAX al que apunte
camino_resuelto. El camino resultante no
tendrá enlaces simbólicos 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 búsqueda para
un componente del prefijo del camino.
- EINVAL
- O camino o camino_resuelto es NULL. (En libc5
esto simplemente provocaría una violación de segmento.)
- EIO
- Se ha producido un error de E/S al leer del sistema de
ficheros.
- ELOOP
- Se han encontrado demasiandos enlaces simbólicos 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 función. No funciona correctamente por cuestiones de
diseño, puesto que es imposible determinar un tamaño adecuado para
el buffer de salida. Según POSIX un buffer de tamaño 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 está limitado.
Las implementaciones de libc4 y libc5 contienen un desbordamiento de búfer
(`buffer overflow') (solucionado en libc-5.4.13). Por tanto, los programas con
el bit SETUID activo como mount necesitan una versión privada.
HISTORIA¶
La función
realpath apareció por primera vez en BSD 4.4,
aportada por Jan-Simon Pendry. En Linux, esta función aparece en libc
4.5.21.
En BSD 4.4 y Solaris el límite 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 función
pathconf(). Un fragmento típico de código fuente sería
#ifdef PATH_MAX
path_max = PATH_MAX;
#else
path_max = pathconf (path, _PC_PATH_MAX);
if (path_max <= 0)
path_max = 4096;
#endif
(Véase la sección 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ÉASE TAMBIÉN¶
readlink(2),
getcwd(3),
pathconf(3),
sysconf(3)