.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
.\"                               1993 Michael Haardt, Ian Jackson.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Wed Jul 21 22:42:16 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Sun Aug 21 18:18:14 1994: Michael Haardt's NFS diffs were
.\"          applied by hand (faith@cs.unc.edu).
.\" Modified Sat Apr 13 16:25:28 1996 by Andries Brouwer (aeb@cwi.nl)
.\" Modified Mon May 13 00:53:52 1996: added symbolic constants
.\"          as sent by Thomas Koenig
.\" Modified Fri Dec 20 16:06:45 1996 by Michael Haardt: More NFS details
.\" Translated Mon Jul 21 1997 by Nicols Lichtmaier <nick@debian.org>
.\" Updated Apr 23 1998 by Nicols Lichtmaier <nick@debian.org>
.TH OPEN 2 "20 de diciembre de 1996" "Linux 2.0.32" "Manual del Programador Linux"
.SH NOMBRE
open, creat \- abre y posiblemente crea un fichero o perifrico
.SH SINOPSIS
.nf
.B #include <sys/types.h>
.B #include <sys/stat.h>
.B #include <fcntl.h>
.sp
.BI "int open(const char *" pathname ", int " flags );
.BI "int open(const char *" pathname ", int " flags ", mode_t " mode );
.BI "int creat(const char *" pathname ", mode_t " mode );
.fi
.SH DESCRIPCIN
.B open
intenta abrir un fichero y regresa un descriptor (un entero chico no
negativo para usar en
.BR read ", " write ", etc.)"

.I flags
es uno de
.BR O_RDONLY ", " O_WRONLY " u " O_RDWR
que solicita abrir el fichero como slo-lectura, slo-escritura o
lectura-escritura respectivamente.

.I flags
puede ser tambin el resultado de aplicar la funcin
.I o
bit-a-bit con uno o ms de los siguientes:
.TP
.B O_CREAT
Si el fichero no existe ser creado.
.TP
.B O_EXCL
Cuando se usa con
.BR O_CREAT ,
si el fichero ya existe se considera error y
.B open
fallar.
.B O_EXCL
no funciona en sistemas de ficheros NFS. Los programas que confen en esta
opcin para efectuar serializacin de recursos contendrn una `condicin
de carrera'. La solucin para efectuar reserva atmica de recursos usando
un fichero es crear uno de nombre nico en el mismo sistema de ficheros (p. ej.
incorporando nombre de la mquina y pid), usar
.BR link (2)
para crear un enlace al fichero y usar
.BR stat (2)
sobre el nmbre nico para verificar si su cuenta de enlaces ha aumentado a
2.  No use el valor regresado por la llamada \fBlink()\fP.
.TP
.B O_NOCTTY
Si
.I pathname
se refiere a una terminal \(em vase
.BR tty (4)
\(em no se convertir en la terminal controladora del proceso 
aunque el proceso no tenga una.
.TP
.B O_TRUNC
Si el fichero ya existe ser truncado.
.TP
.B O_APPEND
El fichero es abierto en modo slo-agregar. Inicialmente, y antes de cada
.BR write (escritura),
el puntero de fichero es posicionado en el final del fichero, como hecho con
.BR lseek .
.B O_APPEND
puede conducir a corrupcin de ficheros sobre NFS si ms de un proceso
agrega datos a la vez a un fichero.  Esto es porque NFS no soporta el
agregado a un archivo, por lo que el kernel cliente tiene que emularlo, cosa
que no puede ser hecha si entrar en una `condicin de carrera'.
.TP
.BR O_NONBLOCK " u " O_NDELAY
El fichero es abierto en modo de no-bloqueo. Ni el
.B open
mismo ni ninguna operacin posterior sobre el descriptor de fichero
regresado causar que el proceso que la llame deba esperar.
.TP
.B O_SYNC
El fichero es abierto para E/S sincrnica. Cualquier
The file is opened for synchronous I/O. Any
.B write
efectuado sobre el descriptor de fichero resultante bloqueara al proceso
hasta que los datos hayan sido fsicamente escritos en el hardware
subyacente.
.I Sin embargo vanse las RESTRICCIONES ms adelante.
.PP
Algunas de estas opciones pueden ser alteradas usando
.B fcntl
posteriormente a la apertura del fichero.

.I mode
especifica los permisos a usar si un nuevo fichero es creado. Es
modificado por el
.BR umask
del proceso de la manera usual: los permisos del archivo creado son
.BR "(mode & ~umask)" .
.PP
Las siguientes constantes simblicas se proveen para usar en
.IR mode :
.TP
.B S_IRWXU
00700 el usuario (del fichero) tiene permiso de lectura, escritura y ejecucin
.TP
.B S_IRUSR (S_IREAD)
00400 el usuario tiene permiso de lectura
.TP
.B S_IWUSR (S_IWRITE)
00200 el usuario tiene permiso de escritura
.TP
.B S_IXUSR (S_IEXEC)
00100 el usuario tiene permiso de ejecucin
.TP
.B S_IRWXG
00070 el grupo tiene permiso de lectura, escritura y ejecucin
.TP
.B S_IRGRP
00040 el grupo tiene permiso de lectura
.TP
.B S_IWGRP
00020 el grupo tiene permiso de escritura
.TP
.B S_IXGRP
00010 el grupo tiene permiso de ejecucin
.TP
.B S_IRWXO
00007 los dems (others) tienen permido de lectura, escritura y ejecucin
.TP
.B S_IROTH
00004 los dems tienen permiso de lectura
.TP
.B S_IWOTH
00002 los dems tienen permiso de escritura
.TP
.B S_IXOTH
00001 los dems tienen permiso de ejecucin
.PP
Siempre se debe especificar
.I mode
cuando
.B O_CREAT
est entre las opciones
.IR flags ,
y es ignorado si no es as.

.B creat
es equivalente a
.B open
con
.I flags
valiendo
.BR O_CREAT|O_WRONLY|O_TRUNC .
.SH "VALOR REGRESADO"
.BR open " y " creat
regresan el nuevo descriptor de fichero, o \-1 si ocurri un error (en cuyo
caso la variable
.I errno
es asignada apropiadamente).
Note que
.B open
puede abrir ficheros especiales de perifricos, pero
.B creat
no puede crearlos - use
.BR mknod (2)
en su lugar para ese fin.
.LP
Sobre sistemas de ficheros NFS con correspondiencia de UIDs activada,
puede pasar que \fBopen\fP regrese un descriptor de fichero pero, p. ej.,
los accesos con \fBread\fP(2) sean denegados con el error \fBEACCES\fP.
Esto es porque el cliente efecta \fBopen\fP verificando los permisos, pero
el sistema de correspondencia de UIDs es efectado por el servidor sobre los
pedidos de lectura y escritura.
.SH ERRORES
.TP
.B EEXIST
.I pathname
ya existe y
.BR O_CREAT " y " O_EXCL
fueron usados.
.TP
.B EISDIR
.I pathname
se refiere a un directorio y el acceso pedido involucraba escritura.
.TP
.B ETXTBSY
.I pathname
se refiere a un ejecutable que est siendo ejecutado actualmente, y se
solicit acceso de escritura.
.TP
.B EFAULT
.I pathname
apunta fuera de su espacio de direcciones accesible.
.TP
.B EACCES
No se permite el acceso pedido al ficherom o alguno de los directorios em
.IR pathname
no otorganaban permiso de ejecucin (bsqueda).
did not allow search (execute) permission.
.TP
.B ENAMETOOLONG
.I pathname
era demasiado largo.
.TP
.B ENOENT
Un componente directorio en
.I pathname
no existe o es un enlace simblico roto.
.TP
.B ENOTDIR
Un componente usado como directorio en
.I pathname
no es, de hecho, un directorio.
.TP
.B EMFILE
El proceso ya alcanz el mximo nmero posible de ficheros abiertos.
.TP
.B ENFILE
El sistema ya alcanz el mximo nmero posible de ficheros abiertos.
.TP
.B ENOMEM
Insuficiente memoria de kernel disponible.
.TP
.B EROFS
.I pathname
se refiere a un fichero en un sistema de archivos de slo-lectura y se pidi
acceso de escritura.
.TP
.B ELOOP
Se encontraron demasiados enlaces simblicos al intentar resolver
.IR pathname .
.TP
.B ENOSPC
.I pathname
iba a ser creado pero el perifrico conteniendo
.I pathname
no tiene espacio para el nuevo fichero.
.SH "CONFORMA CON
SVr4, SVID, POSIX, X/OPEN, BSD 4.3
.SH RESTRICIONES
Hay muchos sinsabores el protocolo NFS subyacente, afectando entre otras
opciones a
.BR O_SYNC " y " O_NDELAY .
.SH "VASE TAMBIN"
.BR read "(2), " write "(2), " fcntl "(2), " close (2),
.BR unlink "(2), " mknod "(2), " stat "(2), " umask (2),
.BR mount "(2), " socket "(2), " socket "(2), " fopen (3),
.BR link (2).