Provided by:
manpages-es_1.55-10_all 
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'ON
La llamada al sistema open() se utiliza para convertir una ruta en un
descriptor de fichero (un pequeno entero no negativo que se utiliza en
las operaciones de E/S posteriores como en read, write, etc.). Cuando
la llamada tiene exito, el descriptor de fichero devuelto sera el
descriptor de fichero mas pequeno no abierto actualmente para el
proceso. Esta llamada crea un nuevo fichero abierto, no compartido con
ningun otro proceso. (Pero pueden aparecer ficheros abiertos
compartidos a traves de la llamada al sistema fork(2).) El nuevo
descriptor de fichero se configura para que permanezca abierto a traves
de funciones exec (vea fcntl(2)). El apuntador de lectura/escritura
del fichero se configura para que apunte al principio del fichero.
El parametro 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,
combinandose mediante el operador de bits OR (|), con cero o mas de
las siguientes macros:
O_CREAT
Si el fichero no existe, sera 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 fallara. En este contexto, un enlace simbolico
existe, sin tener en cuenta a donde apunte. O_EXCL no funciona
en sistemas de ficheros de red NFS, programas que confien en el
para efectuar tareas de bloqueo contendran una condicion de
concurso. La solucion para efectuar un bloqueo atomico de
fichero mediante un fichero de bloqueo es crear un fichero unico
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 exito. En caso contrario, use stat(2) en el fichero unico
para comprobar si su numero de enlaces se ha incrementado a 2,
en cuyo caso el bloqueo tambien tiene exito.
O_NOCTTY
Si camino se refiere a una terminal -- vea tty(4) -- no se
convertira 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) sera
truncado a longitud 0. Si el fichero es una FIFO o un fichero
de dispositivo de terminal, la opcion O_TRUNC es ignorada. En
otro caso el efecto de O_TRUNC es indefinido. (En muchas
versiones de Linux sera ignorado; en otras devolvera un error.)
O_APPEND
El fichero se abrira en modo de solo-anadir. Antes de cada
escritura, el apuntador del fichero es posicionado al final del
fichero, como se haria con lseek. O_APPEND puede conducir a
ficheros corruptos en sistemas de ficheros NFS si mas de un
proceso anade datos a un fichero a la vez. Esto es asi porque
NFS no admite anadir a un fichero, asi que el nucleo del cliente
ha de simularlo, lo que no puede hacerse sin una condicion de
carrera.
O_NONBLOCK u O_NDELAY
Cuando esto es posible, el fichero se abre en modo no
bloqueante. Ni el open ni ninguna operacion subsecuente sobre el
descriptor de fichero que es devuelto haran que el proceso que
hace la llamada espere. Para el manejo de FIFOs (tuberias
nombradas), vea tambien fifo(4).
O_SYNC El fichero se abre para E/S sincrona. Cualesquiera operaciones
de escritura write sobre el descriptor de fichero resultante
bloquearan el proceso que ha efectuado la llamada hasta que los
datos hayan sido fisicamente escritos en el dispositivo
subyacente. Vea no obstante m'as abajo la secci'on RESTRICCIONES.
O_NOFOLLOW
Si pathname es un enlace simbolico, entonces la apertura falla.
Esta es una extension de FreeBSD que fue anadida a Linux en la
version 2.1.126. Todavia se seguiran los enlaces simbolicos de
los componentes anteriores de la ruta. Los ficheros cabecera de
la version 2.0.100 y posteriores de glibc incluyen una
definicion de esta opcion; los n'ucleos anteriores al 2.1.126 lo
ignorar'an si se usa.
O_DIRECTORY
Si pathname no es un directorio, hara que la apertura falle.
Esta opcion es especifica de Linux y fue anadida en la version
2.1.126 del nucleo para evitar problemas de denegacion de
servicio al llamar a opendir(3) sobre una FIFO o dispositivo de
cinta, pero no se deberia usar fuera de la implementacion de
opendir.
O_DIRECT
Trata de minimizar los efectos de la cache de E/S a y desde el
fichero. En general esto empeorara el rendimiento, pero es util
en situaciones especiales, como cuando las aplicaciones poseen
su propia cache. La E/S del fichero se realiza directamente
a/desde buffers en el espacio de usuario. La E/S es sincrona,
es decir, cuando las llamadas al sistema read(2) o write(2)
finalizan, se garantiza que los datos han sido transferidos.
Los tamanos de la transferencia, y el alineamiento del buffer de
usuario y el desplazamiento del fichero deben ser todos
multiplos del tamano de bloque logico del sistema de ficheros.
Esta bandera esta soportada en varios sistemas tipo Unix; el
soporte para Linux fue anadido en la version 2.4.10 del nucleo.
Una interfaz semanticamente similar para los dispositivos de
bloque se describe en raw(8).
O_ASYNC
Genera una senal (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 caracteristica esta solo
disponible para terminales, pseudo-terminales, y conectores. Vea
fcntl(2) para mas detalles..
O_LARGEFILE
En sistemas de 32 bits que soportan el `sistema de ficheros
grandes' (Large Files System, LFS) permite abrir ficheros cuyos
tamanos no pueden ser representados en 31 bits.
Algunos de estos modificadores opcionales pueden alterarse mediante el
empleo de fcntl despues 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 mascara umask del proceso
de la forma habitual: los permisos del fichero creado son (modo &
~umask). Observe que este modo solo se aplica a futuros accesos del
fichero recien creado; la llamada open que crea un fichero de solo-
lectura puede devolver tambien un descriptor de fichero de
lectura/escritura.
Se proporcionan las siguientes constantes simbolicas para modo:
S_IRWXU
00700 el usuario (el propietario del fichero) tiene permisos de
lectura, escritura y ejecucion
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 ejecucion
S_IRWXG
00070 el grupo tiene permiso de lectura, escritura y ejecucion
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 ejecucion
S_IRWXO
00007 los otros tienen permiso de lectura, escritura y ejecucion
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 ejecucion
El argumento modo debe especificarse cuando O_CREAT esta en flags, y si
no esta, 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 asociacion 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 asi porque el cliente
hace el open comprobando los permisos, pero la asociacion de UID la
hace el servidor sobre las peticiones de lectura y escritura.
Si el fichero es recien 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 busqueda o paso
(ejecucion), o el fichero todavia no existe y el directorio
padre no tiene permiso de escritura.
ENAMETOOLONG
camino era demasiado largo.
ENOENT O_CREAT no esta activo y el fichero especificado no existe. O
bien, un componente directorio en camino no existe o es un
enlace simbolico 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 opcion O_DIRECTORY
y pathname no es un directorio.
ENXIO Se ha seleccionado O_NONBLOCK | O_WRONLY, el fichero indicado es
una FIFO y ningun 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. (Este es un fallo del
nucleo de Linux. En esta situacion se deberia devolver ENXIO.)
EROFS camino se refiere a un fichero de un sistema de ficheros de solo
lectura y se ha pedido un acceso de escritura.
ETXTBSY
camino se refiere a una imagen ejecutable que se esta ejecutando
ahora mismo y se pidio un acceso de escritura.
EFAULT camino apunta afuera de su espacio de direcciones accesible.
ELOOP Se han encontrado demasiados enlaces simbolicos al resolver
camino, o se ha especificado la opcion O_NOFOLLOW pero pathname
no es un enlace simbolico.
ENOSPC camino iba a ser creado pero el dispositivo que lo habria de
contener no tiene espacio para el nuevo fichero.
ENOMEM No hay disponible bastante memoria del nucleo.
EMFILE El proceso ya tiene abiertos todos los ficheros que puede.
ENFILE Se ha alcanzado el limite del numero 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 especificas 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 sincrona, correspondientes a las opciones O_SYNC,
O_DSYNC y O_RSYNC. Actualmente (2.1.130) todas ellas son sinonimas en
Linux.
V'EASE TAMBI'EN
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)