Section courante

A propos

Section administrative du site

FCNTL

 Fonction de contrôle
C pour Unix fcntl.h

Syntaxe

int fcntl(int fildes, int cmd, ...);

Paramètres

Nom Description
fildes Ce paramètre permet d'indiquer le descripteur de fichier à modifier. Il est obtenu via open, socket, pipe, ou d'autres appels système retournant un descripteur de fichier valide.
cmd Ce paramètre permet d'indiquer l'action à effectuer sur fildes. Il existe plusieurs commandes disponibles (voir plus bas).
... Selon la valeur de cmd, un paramètre supplémentaire peut être requis. Il peut s'agir d'un entier (int), d'une structure (struct flock pour le verrouillage de fichiers),...

Retour

En cas de réussite, la valeur renvoyée dépendra de cmd comme suit :

Constante Description
F_DUPFD Un nouveau descripteur de fichier.
F_DUPFD_CLOEXEC Un nouveau descripteur de fichier.
F_GETFD Valeur des indicateurs définis dans <fcntl.h>. La valeur renvoyée ne doit pas être négative.
F_SETFD Valeur différente de -1.
F_GETFL Valeur des indicateurs d'état et des modes d'accès du fichier. La valeur renvoyée n'est pas négative.
F_SETFL Valeur différente de -1.
F_GETLK Valeur différente de -1.
F_SETLK Valeur différente de -1.
F_SETLKW Valeur différente de -1.
F_GETOWN Valeur du processus ou du groupe de processus propriétaire du socket ; cette valeur ne sera pas -1.
F_SETOWN Valeur différente de -1.

Sinon, la valeur -1 sera renvoyée et errno sera défini pour indiquer l'erreur.

Description

Cette fonction permet d'effectuer des opérations de contrôle sur un descripteur de fichier.

Remarques

Erreurs

La fonction fcntl() échouera si :

Constante Description
EACCES ou EAGAIN Le paramètre cmd est F_SETLK ; le type de verrou (l_type) est un verrou partagé (F_RDLCK) ou exclusif (F_WRLCK) et le segment de fichier à verrouiller est déjà verrouillé de manière exclusive par un autre processus, ou le type est un verrou exclusif et une partie du segment de fichier à verrouiller est déjà verrouillée de manière partagée ou exclusive par un autre processus.
EBADF Le paramètre fildes n'est pas un descripteur de fichier ouvert valide, ou le paramètre cmd est F_SETLK ou F_SETLKW, le type de verrou, l_type, est un verrou partagé (F_RDLCK) et fildes n'est pas un descripteur de fichier ouvert en lecture, ou le type de verrou, l_type, est un verrou exclusif (F_WRLCK) et fildes n'est pas un descripteur de fichier ouvert en écriture.
EINTR Le paramètre cmd est F_SETLKW et la fonction a été interrompue par un signal.
EINVAL Le paramètre cmd est invalide, ou le paramètre cmd est F_DUPFD ou F_DUPFD_CLOEXEC et arg est négatif ou supérieur ou égal à {OPEN_MAX}, ou le paramètre cmd est F_GETLK, F_SETLK ou F_SETLKW et les données pointées par arg ne sont pas valides, ou fildes fait référence à un fichier qui ne prend pas en charge le verrouillage.
EMFILE Le paramètre cmd est F_DUPFD ou F_DUPFD_CLOEXEC et tous les descripteurs de fichiers disponibles pour le processus sont actuellement ouverts, ou aucun descripteur de fichier supérieur ou égal à arg n'est disponible.
ENOLCK Le paramètre cmd est F_SETLK ou F_SETLKW et la satisfaction de la requête de verrouillage ou de déverrouillage entraînerait un nombre de régions verrouillées dans le système dépassant la limite imposée par le système.
EOVERFLOW L'une des valeurs à renvoyer ne peut pas être représentée correctement.
EOVERFLOW Le paramètre cmd est F_GETLK, F_SETLK ou F_SETLKW et le plus petit ou, si l_len est différent de zéro, le plus grand décalage d'un octet du segment demandé ne peut pas être représenté correctement dans un objet de type off_t.
ESRCH Le paramètre cmd est F_SETOWN et aucun processus ou groupe de processus correspondant à celui spécifié par arg n'est trouvé.

La fonction fcntl() peut échouer si :

Constante Description
EDEADLK Le paramètre cmd est F_SETLKW, le verrou est bloqué par un verrou d'un autre processus et la mise en veille du processus appelant en attendant que ce verrou soit libéré provoquerait un blocage.
EINVAL Le paramètre cmd est F_SETOWN et sa valeur n'est pas valide comme identifiant de processus ou de groupe de processus.
EPERM Le paramètre cmd est F_SETOWN et le processus appelant n'a pas l'autorisation d'envoyer un signal SIGURG à un processus spécifié par arg.

Exemples

L'exemple suivant montre comment placer un verrou sur les octets 100 à 109 d'un fichier, puis le supprimer ultérieurement. F_SETLK permet d'effectuer une requête de verrouillage non bloquante afin que le processus n'ait pas à attendre si un verrou incompatible est détenu par un autre processus ; il peut alors effectuer une autre action.

  1. #include <stdlib.h>
  2. #include <unistd.h>
  3. #include <fcntl.h>
  4. #include <errno.h>
  5. #include <stdio.h>
  6.  
  7. int main(int argc, char *argv[]) {
  8.     int fd;
  9.     struct flock fl;
  10.  
  11.  
  12.     fd = open("testfile", O_RDWR);
  13.     if (fd == -1)
  14.         /* Erreur de descripteur */;
  15.  
  16.  
  17.     /* Effectuez une demande non bloquante pour placer un verrou en écriture sur les octets 100 à 109 du fichier de test */
  18.  
  19.     fl.l_type = F_WRLCK;
  20.     fl.l_whence = SEEK_SET;
  21.     fl.l_start = 100;
  22.     fl.l_len = 10;
  23.  
  24.  
  25.     if (fcntl(fd, F_SETLK, &fl) == -1) {
  26.         if (errno == EACCES || errno == EAGAIN) {
  27.             printf("Déjà verrouillé par un autre processus\n");
  28.  
  29.  
  30.             /* Nous ne pouvons pas obtenir le verrou pour le moment */
  31.  
  32.  
  33.         } else {
  34.             /* Gérer les erreurs inattendues */;
  35.         }
  36.     } else { /* Le verrouillage a été accordé... */
  37.  
  38.  
  39.         /* Effectuer des entrées/sorties sur les octets 100 à 109 du fichier */
  40.  
  41.  
  42.         /* Déverrouiller les octets verrouillés */
  43.  
  44.         fl.l_type = F_UNLCK;
  45.         fl.l_whence = SEEK_SET;
  46.         fl.l_start = 100;
  47.         fl.l_len = 10;
  48.         if (fcntl(fd, F_SETLK, &fl) == -1)
  49.             /* Erreur de descripteur */;
  50.     }
  51.     exit(EXIT_SUCCESS);
  52. } /* main */

L'exemple suivant montre comment définir l'indicateur de fermeture à l'exécution pour le descripteur de fichier fd :

  1. #include <unistd.h>
  2. #include <fcntl.h>
  3. ...
  4. int flags;
  5.  
  6.  
  7. flags = fcntl(fd, F_GETFD);
  8. if (flags == -1)
  9.     /* Erreur de descripteur */;
  10. flags |= FD_CLOEXEC;
  11. if (fcntl(fd, F_SETFD, flags) == -1)
  12.     /* Erreur de descripteur */;

Voir également

alarm, close, exec, kill, open, sigaction



Dernière mise à jour : Vendredi, le 5 Juin 2020