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)