OPEN(2)

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
open intenta abrir un fichero y devolver un descriptor de fichero (un entero pequeño, no negativo, de uso en read, write, etc.). 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. flags puede también ser la combinación, con el operador de bits OR (|), de uno o más de las siguientes macros:

O_CREAT
    Si el fichero no existe, será creado.

O_EXCL
    Cuando se combina con O_CREAT, es un error que el fichero ya exista, y open fallará. 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), utilizar link(2) para hacer un enlace al fichero de bloqueo y emplear stat(2) en el fichero único para comprobar si su número de enlaces se ha incrementado a 2. No hay que usar el valor devuelto por la llamada link().

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, será truncado.

O_APPEND
    El fichero se abrirá en modo de añadir. Inicialmente, y 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 concurso.

O_NONBLOCK u O_NDELAY
    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.

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.

Algunos de estos modificadores opcionales pueden alterarse mediante el empleo de fcntl tras que el fichero haya sido abierto. El argumento modo especifica los permisos a emplear si se crea un nuevo fichero. Es modificado por la máscara umask del proceso de la forma habitual: los permisos del fichero creado son (modo & ~umask).

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 siempre 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.

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.

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.

EACCES
    El acceso pedido al fichero no es permitido, o uno de los directorios en camino no tenía permiso de búsqueda o paso (ejecución).

ENAMETOOLONG
    camino era demasiado largo.

ENOENT
    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.

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.

ENOMEM
    No hay disponible bastante memoria del núcleo.

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

ELOOP
    camino contiene una referencia a un enlace simbólico circular, esto es, un enlace simbólico cuya expansión contiene una referencia a sí mismo.

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

CONFORME CON
SVr4, SVID, POSIX, X/OPEN, BSD 4.3

RESTRICCIONES
Hay muchas impropiedades en el protocolo subyacente a NFS, afectando entre otros a O_SYNC y a O_NDELAY.

CONSULTE TAMBIÉN
read(2), write(2), fcntl(2), close(2), unlink(2), mknod(2), stat(2), umask(2), mount(2), socket(2), socket(2), fopen(3), link(2).