.\" 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).
.\" 
.\" Traduction  10/10/1996 Christophe BLAESS (ccb@club-internet.fr)
.\" Mise a jour 25/01/97
.\" Mise a Jour 8/04/97
.\" mj 10/12/1997 (LDP man-pages 1.18)
.\" mj 18/05/1999 (LDP man-pages 1.23)
.TH OPEN 2 "18 Mai 1999" "Linux" "Manuel du programmeur Linux"
.SH NOM
open, creat \- Ouvrir ou crer ventuellement un fichier.
.SH SYNOPSIS
.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 DESCRIPTION
.B open
essaye d'ouvrir un fichier et retourne un descripteur de fichier
(petit entier non ngatif  utiliser avec 
.BR read ", " write ", etc...)"

.I flags
est l'un des lments
.BR O_RDONLY ", " O_WRONLY " ou " O_RDWR
qui rclament respectivement l'ouverture du fichier en lecture seule, 
criture seule, ou lecture/criture.

.I flags
peut aussi tre un
.I OU binaire
( | ) avec un ou plusieurs des lments suivants :
.TP
.B O_CREAT
Crer le fichier s'il n'existe pas.
.TP
.B O_EXCL
En conjonction avec
.BR O_CREAT ,
dclenchera une erreur si le fichier existe, et
.B open
chouera.
.B O_EXCL
ne fonctionne pas sur les systmes de fichiers NFS. Les programmes qui
ont besoin de cette fonctionnalit pour verrouiller des tches risquent
de rencontrer une concurrence critique (race condition). La solution consiste  crer un 
fichier unique sur le mme systme de fichiers (par exemple avec le pid et
le nom de l'hte), utiliser
.BR link (2)
pour crer un lien sur un fichier de verrouillage et d'utiliser
.BR stat (2)
sur ce fichier unique pour vrifier si le nombre de liens a augment
jusqu' 2. Ne pas utiliser la valeur de retour de \fBlink()\fP.
.TP
.B O_NOCTTY
Si
.I pathname
correspond  un priphrique de terminal \(em voir
.BR tty (4)
\(em, il ne deviendra pas le terminal contrlant le processus
mme si celui\-ci n'est attach  aucun autre terminal.
.TP
.B O_TRUNC
Si le fichier existe il sera tronqu.
.TP
.B O_APPEND
Le fichier est ouvert en mode "ajout". Initialement, et avant
chaque
.BR write ,
la tte de lecture/criture est place  la fin du fichier
comme avec
.BR lseek .
Il y a un risque d'endommager le fichier lorsque
.B O_APPEND
est utilis, sur un systme de fichiers NFS, si plusieurs processus
tentent d'ajouter des donnes simultanment au mme fichier.
Ceci est d au fait que NFS ne supporte pas l'opration d'ajout de donnes
dans un fichier, aussi le noyau client est oblig de la simuler, avec un
risque de concurrence des tches.
.TP
.BR O_NONBLOCK " ou " O_NDELAY
Le fichier est ouvert en mode "non-bloquant". Ni la fonction
.B open
ni aucune autre opration ultrieure sur ce fichier
ne laissera le processus appelant en attente.
.TP
.B O_SYNC
Le fichier est ouvert en criture synchronise. Chaque appel 
.BR write 
sur le fichier bloquera le processus appelant jusqu' ce que les
donnes aient t crites physiquement sur le support matriel
(voir la section RESTRICTIONS plus bas).
.TP
.B O_NOFOLLOW
Si
.I pathname
est un lien symbolique, l'ouverture choue. Ceci est une extension
FreeBSD, qui fut ajoute  Linux dans la version 2.1.126.
Les liens symboliques se trouvant dans le chemin d'accs proprement
dit seront suivis normalement. Les en-tte de glibc 2.0.100 et 
suivant contiennent une dfinition de cet attribut.
\fI Les noyaux antrieurs au 2.1.126 ignorent simplement cet attribut
si vous l'utilisez\fP.
.TP
.B O_DIRECTORY
Si
.I pathname
n'est pas un rpertoire, l'ouverture choue. Cet attribut est spcifique
 Linux et fut ajout dans la version 2.1.126 du noyau, pour viter
des problmes de dysfonctionnement si \fIopendir\fP(3) est invoqu
sur une FIFO ou un priphrique de bande. Cet attribut ne devrait
jamais tre utilis ailleurs que dans l'implmentation de \fBopendir\fP.
.TP
.B O_LARGEFILE
Sur les systmes 32 bits qui supportent les Systmes de Fichiers Larges,
autoriser quand mme l'ouverture des fichiers dont la taille ne peut
pas tre reprsente sur 31 bits. Le noyau Linux n'offre pas encore
de support pour cette option (du moins jusqu'au 2.1.130), mais la
dfinition de l'attribut est prsente et les interfaces LFS sont prsentes
dans les versions de test de glibc 2.1.
.PP
Certains de ces attributs optionnels peuvent tre modifis
par la suite avec la fonction
.BR fcntl .

.I mode
indique les permissions  utiliser si un nouveau fichier est cr.
Cette valeur est modifie par le
.BR umask
du processus : la vritable valeur utilise est
.BR "(mode & ~umask)" .
.PP
Les constantes symboliques suivantes sont disponibles pour
.IR mode :
.TP
.B S_IRWXU
00700 L'utilisateur (propritaire du fichier) a les 
autorisations de lecture, criture, excution.
.TP
.B S_IRUSR (S_IREAD)
00400 L'utilisateur a l'autorisation de lecture.
.TP
.B S_IWUSR (S_IWRITE)
00200 L'utilisateur a l'autorisation d'criture.
.TP
.B S_IXUSR (S_IEXEC)
00100 L'utilisateur a l'autorisation d'excution.
.TP
.B S_IRWXG
00070 Le groupe a les autorisations de lecture, criture, excution.
.TP
.B S_IRGRP
00040 Le groupe a l'autorisation de lecture.
.TP
.B S_IWGRP
00020 Le groupe a l'autorisation d'criture.
.TP
.B S_IXGRP
00010 Le groupe a l'autorisation d'excution.
.TP
.B S_IRWXO
00007 Tout le monde a les autorisations de lecture, criture, excution.
.TP
.B S_IROTH
00004 Tout le monde a l'autorisation de lecture.
.TP
.B S_IWOTH
00002 Tout le monde a l'autorisation d'criture.
.TP
.B S_IXOTH
00001 Tout le monde a l'autorisation d'excution.
.PP
Le
.I mode
devrait toujours tre indiqu quand 
.B O_CREAT
est dans les attributs
.IR flags ,
(il est ignor dans les autres cas).

.B creat
est quivalent  
.B open
avec l'attribut
.I flags
gal 
.BR "O_CREAT | O_WRONLY | O_TRUNC" .
.SH "VALEUR RENVOYE"
.BR open " et " creat
renvoient le nouveau descripteur de fichier s'ils russissent, 
ou \-1 s'ils chouent, auquel cas
.I errno
contient le code d'erreur.
Notez que
.B open
peut ouvrir des fichiers spciaux mais
.B creat
ne peut pas en crer,
il faut utiliser
.BR mknod (2)
 la place.
.LP
Sur les systmes de fichiers NFS, o la correspondance d'UID est active,
\fBopen\fP peut renvoyer un descripteur de fichier alors qu'une requte
\fBread\fP(2) par exemple sera refuse avec le code d'erreur \fBEACCES\fP.
En effet, c'est le client qui effectu \fBopen\fP en vrifiant les
autorisations d'accs, mais la correspondance d'UID est calcule par
le serveur au moment des requtes de lecture ou d'criture.
.SH ERREURS
.TP
.B EEXIST
.I pathname
existe dj et
.BR O_CREAT " et " O_EXCL
ont t indiqus.
.TP
.B EISDIR
On a demand une criture alors que
.I pathname
correspond  un rpertoire.
.TP
.B EACCES
L'accs demand au fichier est interdit, ou l'un des rpertoires
du chemin
.IR pathname
ne permet pas de consultation, ou le fichier n'existe pas mais
le rpertoire parent ne permet pas l'criture.
.TP
.B ENAMETOOLONG
.IR pathname " est trop long."
.TP
.B ENOENT
Un rpertoire du chemin d'accs
.I pathname
n'existe pas o est un lien symbolique pointant nulle part.
.TP
.B ENOTDIR
Un lment du chemin d'acces
.I pathname
n'est pas un rpertoire, ou l'attribut \fBO_DIRECTORY\fP est
utilis et
.I pathname
n'est pas un rpertoire.
.TP
.B ENXIO
O_NONBLOCK | O_WRONLY est indiqu, le fichier est une FIFO et le
processus n'a pas de fichier ouvert en lecture.
Ou le fichier est un noeud spcial et il n'y a pas de priphrique
correspondant.
.TP
.B ENODEV
.I pathname
correspond  un fichier spcial et il n'y a pas de priphrique correspondant.
.TP
.B EROFS
Un accs en criture est demand alors que
.I pathname
rside sur un systme de fichiers en lecture seule.
.TP
.B ETXTBSY
On a demand une criture alors que
.I pathname
correspond  un fichier excutable actuellement utilis.
.TP
.B EFAULT
.IR pathname " pointe en dehors de l'espace d'adressage accessible"
.TP
.B ELOOP
.I pathname
contient une rfrence circulaire ( travers un lien symbolique), ou
l'attribut \fBO_NOFOLLOW\fP est indiqu et
.I pathname
est un lien symbolique.
.TP
.B ENOSPC
.I pathname
devrait tre cr mais le priphrique concern n'a plus assez de
place pour un nouveau fichier.
.TP
.B ENOMEM
Pas assez de mmoire pour le noyau
.TP
.B EMFILE
Le processus a dj ouvert le nombre maximal de fichiers.
.TP
.B ENFILE
La limite du nombre total de fichiers ouverts sur le systme est
atteinte.
.SH "CONFORMIT"
SVr4, SVID, POSIX, X/OPEN, BSD 4.3
.SH RESTRICTIONS
Plusieurs problmes se posent avec le protocole NFS, concernant
entre autres
.BR O_SYNC ", et " O_NDELAY " .

POSIX fournit trois variantes diffrentes des entres/sorties
synchronises correspondant aux attributs \fBO_SYNC\fR, 
\fBO_DSYNC\fR et \fBO_RSYNC\fR. 
Actuellement (2.1.130) elles sont toutes quivalentes sous Linux.

.SH "VOIR AUSSI"
.BR read (2),
.BR write (2),
.BR fcntl (2),
.BR close (2),
.BR unlink (2),
.BR mknod (2),
.BR stat (2),
.BR umask (2),
.BR mount (2),
.BR socket (2),
.BR socket (2),
.BR fopen (3),
.BR link (2).

.SH TRADUCTION
Christophe Blaess, 1997.