trusty (2) open.2.gz

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

NOMBRE

       open, creat - abren y posiblemente crean un fichero o dispositivo

SINOPSIS

       #include <sys/types.h>
       #include <sys/stat.h>
       #include <fcntl.h>

       int open(const char *camino, int flags);
       int open(const char *camino, int flags, mode_t modo);
       int creat(const char *camino, mode_t modo);

DESCRIPCIÓN

       La  llamada  al sistema open() se utiliza para convertir una ruta en un descriptor de fichero (un pequeño
       entero no negativo que se utiliza en las operaciones de E/S  posteriores  como  en  read,  write,  etc.).
       Cuando  la  llamada  tiene  éxito,  el  descriptor  de fichero devuelto será el descriptor de fichero más
       pequeño no abierto actualmente para  el  proceso.   Esta  llamada  crea  un  nuevo  fichero  abierto,  no
       compartido  con  ningún  otro proceso. (Pero pueden aparecer ficheros abiertos compartidos a través de la
       llamada al sistema fork(2).)  El nuevo descriptor de fichero se configura para que permanezca  abierto  a
       través de funciones exec (vea fcntl(2)).  El apuntador de lectura/escritura del fichero se configura para
       que apunte al principio del fichero.

       El parámetro flags es uno de O_RDONLY, O_WRONLY u O_RDWR que, respectivamente, piden que la apertura  del
       fichero  sea  solamente  para lectura, solamente para escritura, o para lectura y escritura, combinándose
       mediante el operador de bits OR (|),  con cero o más de las siguientes macros:

       O_CREAT
              Si el fichero no existe, será creado.  El propietario (identificador de usuario)  del  fichero  se
              fija  al  identificador de usuario efectivo del proceso.  La propiedad del grupo (identificador de
              grupo) se fija bien al identificador de grupo efectivo del proceso  o  bien  al  identificador  de
              grupo del directorio padre (dependiendo del tipo de sistema de ficheros y las opciones de montaje,
              y el modo del directorio padre, vea, p.e. las opciones de montaje bsdgroups y sysvgroups sobre  el
              sistema de ficheros ext2, tal como se describen en mount(8)).

       O_EXCL Cuando  se  combina  con  O_CREAT,  es  un error que el fichero ya exista, y open fallará. En este
              contexto, un enlace simbólico existe, sin tener en cuenta a donde apunte.  O_EXCL no  funciona  en
              sistemas  de  ficheros  de  red  NFS,  programas que confíen en él para efectuar tareas de bloqueo
              contendrán una condición de concurso. La solución para efectuar  un  bloqueo  atómico  de  fichero
              mediante  un  fichero  de  bloqueo  es crear un fichero único en el mismo sistema de ficheros (por
              ejemplo, incorporando el nombre del ordenador y el PID) y utilizar link(2) para hacer un enlace al
              fichero  de  bloqueo. Si link() devuelve 0, el bloqueo tiene éxito. En caso contrario, use stat(2)
              en el fichero único para comprobar si su número de enlaces se ha incrementado a 2, en cuyo caso el
              bloqueo también tiene éxito.

       O_NOCTTY
              Si  camino  se  refiere a una terminal — vea tty(4) — no se convertirá en la terminal controladora
              del proceso ni en el caso de que el proceso no tenga ninguna.

       O_TRUNC
              Si el fichero ya existe y es un fichero regular y el modo de apertura permite escribir  (p.e.,  es
              O_RDWR  o  O_WRONLY)  será  truncado  a  longitud  0.   Si  el fichero es una FIFO o un fichero de
              dispositivo de terminal, la opción O_TRUNC es ignorada. En otro  caso  el  efecto  de  O_TRUNC  es
              indefinido.  (En muchas versiones de Linux será ignorado; en otras devolverá un error.)

       O_APPEND
              El  fichero se abrirá en modo de sólo-añadir. Antes de cada escritura, el apuntador del fichero es
              posicionado al final del fichero, como se haría con lseek.  O_APPEND  puede  conducir  a  ficheros
              corruptos en sistemas de ficheros NFS si más de un proceso añade datos a un fichero a la vez. Esto
              es así porque NFS no admite añadir a un fichero, así que el núcleo del cliente ha de simularlo, lo
              que no puede hacerse sin una condición de carrera.

       O_NONBLOCK u O_NDELAY
              Cuando  ésto es posible, el fichero se abre en modo no bloqueante. Ni el open ni ninguna operación
              subsecuente sobre el descriptor de fichero  que es devuelto harán  que  el  proceso  que  hace  la
              llamada espere.  Para el manejo de FIFOs (tuberías nombradas), vea también fifo(4).

       O_SYNC El  fichero  se  abre  para  E/S  síncrona.  Cualesquiera  operaciones de escritura write sobre el
              descriptor de fichero resultante bloquearán el proceso que ha efectuado la llamada hasta  que  los
              datos  hayan sido físicamente escritos en el dispositivo subyacente.  Vea no obstante más abajo la
              sección RESTRICCIONES.

       O_NOFOLLOW
              Si pathname es un enlace simbólico, entonces la apertura falla. Ésta es una extensión  de  FreeBSD
              que  fue añadida a Linux en la versión 2.1.126.  Todavía se seguirán los enlaces simbólicos de los
              componentes anteriores de la ruta. Los ficheros cabecera de la versión 2.0.100  y  posteriores  de
              glibc incluyen una definición de esta opción; los núcleos anteriores al 2.1.126 lo ignorarán si se
              usa.

       O_DIRECTORY
              Si pathname no es un directorio, hará que la apertura falle. Esta opción es específica de Linux  y
              fue  añadida  en  la versión 2.1.126 del núcleo para evitar problemas de denegación de servicio al
              llamar a opendir(3) sobre una FIFO o dispositivo de cinta, pero no se debería  usar  fuera  de  la
              implementación de opendir.

       O_DIRECT
              Trata de minimizar los efectos de la caché de E/S a y desde el fichero.  En general ésto empeorará
              el rendimiento, pero es útil en situaciones especiales, como cuando  las  aplicaciones  poseen  su
              propia  caché.   La  E/S  del  fichero  se  realiza  directamente a/desde buffers en el espacio de
              usuario.  La E/S es síncrona, es  decir,  cuando  las  llamadas  al  sistema  read(2)  o  write(2)
              finalizan,  se  garantiza que los datos han sido transferidos.  Los tamaños de la transferencia, y
              el alineamiento del buffer de usuario y el desplazamiento del fichero deben  ser  todos  múltiplos
              del tamaño de bloque lógico del sistema de ficheros.
              Esta  bandera está soportada en varios sistemas tipo Unix; el soporte para Linux fue añadido en la
              versión 2.4.10 del núcleo.
              Una interfaz semánticamente similar para los dispositivos de bloque se describe en raw(8).

       O_ASYNC
              Genera una señal (SIGIO por defecto, pero se puede cambiar mediante fcntl(2)) cuando la entrada  o
              la salida se hace posible en este descriptor de fichero.  Esta característica está sólo disponible
              para terminales, pseudo-terminales, y conectores. Vea fcntl(2) para más detalles..

       O_LARGEFILE
              En sistemas de 32 bits que soportan el `sistema de ficheros grandes'  (Large  Files  System,  LFS)
              permite abrir ficheros cuyos tamaños no pueden ser representados en 31 bits.

       Algunos  de estos modificadores opcionales pueden alterarse mediante el empleo de fcntl después de que el
       fichero haya sido abierto.

       El argumento modo especifica los permisos a emplear  en  caso  de  que  se  cree  un  nuevo  fichero.  Es
       modificado  por  la  máscara  umask del proceso de la forma habitual: los permisos del fichero creado son
       (modo & ~umask).  Observe que este modo sólo se aplica a futuros accesos del fichero  recién  creado;  la
       llamada  open  que  crea  un  fichero  de solo-lectura puede devolver también un descriptor de fichero de
       lectura/escritura.

       Se proporcionan las siguientes constantes simbólicas para modo:

       S_IRWXU
              00700 el usuario (el propietario del fichero) tiene permisos de lectura, escritura y ejecución

       S_IRUSR (S_IREAD)
              00400 el usuario tiene permiso de lectura

       S_IWUSR (S_IWRITE)
              00200 el usuario tiene permiso de escritura

       S_IXUSR (S_IEXEC)
              00100 el usuario tiene permiso de ejecución

       S_IRWXG
              00070 el grupo tiene permiso de lectura, escritura y ejecución

       S_IRGRP
              00040 el grupo tiene permiso de lectura

       S_IWGRP
              00020 el grupo tiene permiso de escritura

       S_IXGRP
              00010 el grupo tiene permiso de ejecución

       S_IRWXO
              00007 los otros tienen permiso de lectura, escritura y ejecución

       S_IROTH
              00004 los otros tienen permiso de lectura

       S_IWOTH
              00002 los otros tienen permiso de escritura

       S_IXOTH
              00001 los otros tienen permiso de ejecución

       El argumento modo debe especificarse cuando O_CREAT está en flags, y si no está, no es tenido en cuenta.

       creat equivale a open con flags igual a O_CREAT|O_WRONLY|O_TRUNC.

VALOR DEVUELTO

       open y creat devuelven el nuevo descriptor de fichero, o -1 si ha ocurrido un error (en cuyo caso, se  da
       un  valor  apropiado  a  errno).   Observe que open pueden abrir ficheros especiales de dispositivo, pero
       creat no puede crearlos; emplee mknod(2) en su lugar.

       En sistemas de ficheros NFS con asociación de UIDs habilitada,  open  puede  devolver  un  descriptor  de
       fichero  pero  p.  ej.  llamadas  a  read(2) pueden denegarse con el error EACCES.  Esto es así porque el
       cliente hace el open comprobando los permisos, pero la asociación de UID la hace el  servidor  sobre  las
       peticiones de lectura y escritura.

       Si  el  fichero es recién creado, sus campos atime, ctime, mtime se rellenan con la hora actual, al igual
       que los campos ctime y mtime del directorio padre.  En otro caso, si el fichero es modificado a causa  de
       la bandera O_TRUNC, sus campos ctime y mtime se rellenan con la hora actual.

ERRORES

       EEXIST camino ya existe y se usaron O_CREAT y O_EXCL.

       EISDIR camino  se  refiere  a  un  directorio  y el acceso pedido implicaba escribir (esto es, O_WRONLY o
              O_RDWR estaban activos).

       EACCES El acceso pedido al fichero no es permitido, o uno de los directorios en camino no  tiene  permiso
              de  búsqueda  o  paso  (ejecución),  o el fichero todavía no existe y el directorio padre no tiene
              permiso de escritura.

       ENAMETOOLONG
              camino era demasiado largo.

       ENOENT O_CREAT no está activo y el fichero especificado no existe.  O bien,  un componente directorio  en
              camino no existe o es un enlace simbólico colgante (que apunta a un fichero inexistente).

       ENOTDIR
              Un  componente  de  camino  empleado  como  un  directorio  no es, de hecho, un directorio o se ha
              especificado la opción O_DIRECTORY y pathname no es un directorio.

       ENXIO  Se ha seleccionado O_NONBLOCK | O_WRONLY, el fichero indicado es una FIFO y ningún  proceso  tiene
              el  fichero  abierto para lectura.  O el fichero es un fichero especial de dispositivo y no existe
              el dispositivo correspondiente.

       ENODEV pathname  se  refiere  a  un  fichero  especial  de  dispositivo  y  no  existe   el   dispositivo
              correspondiente.  (Éste  es  un  fallo  del núcleo de Linux. En esta situación se debería devolver
              ENXIO.)

       EROFS  camino se refiere a un fichero de un sistema de ficheros de sólo lectura y se ha pedido un  acceso
              de escritura.

       ETXTBSY
              camino  se refiere a una imagen ejecutable que se está ejecutando ahora mismo y se pidió un acceso
              de escritura.

       EFAULT camino apunta afuera de su espacio de direcciones accesible.

       ELOOP  Se han encontrado demasiados enláces simbólicos al resolver camino, o se ha especificado la opción
              O_NOFOLLOW pero pathname no es un enlace simbólico.

       ENOSPC camino  iba  a  ser  creado pero el dispositivo que lo habría de contener no tiene espacio para el
              nuevo fichero.

       ENOMEM No hay disponible bastante memoria del núcleo.

       EMFILE El proceso ya tiene abiertos todos los ficheros que puede.

       ENFILE Se ha alcanzado el límite del número total de ficheros abiertos en el sistema.

CONFORME A

       SVr4, SVID, POSIX, X/OPEN, BSD 4.3 Las banderas O_NOFOLLOW y O_DIRECTORY son específicas de Linux.   Para
       obtener sus definiciones es necesario definir la macro _GNU_SOURCE.

RESTRICCIONES

       Hay  muchas  impropiedades en el protocolo subyacente a NFS, afectando entre otros a O_SYNC y a O_NDELAY.
       POSIX proporciona tres variantes diferentes de E/S síncrona,  correspondientes  a  las  opciones  O_SYNC,
       O_DSYNC y O_RSYNC.  Actualmente (2.1.130) todas ellas son sinónimas en Linux.

VÉASE TAMBIÉN

       read(2),  write(2),  fcntl(2),  close(2),  link(2),  mknod(2),  mount(2),  stat(2),  umask(2), unlink(2),
       socket(2), fopen(3), fifo(4)