realpath

REALPATH(3)              Manual del Progamador de Linux              REALPATH(3)



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.

CONFORME A
       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)



                                 24 agosto 1999                      REALPATH(3)