Provided by: manpages-es_1.55-10_all bug

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)