.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1997 Nicolás Lichtmaier .\" Created Thu Aug 7 00:44:00 ART 1997 .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Added section stuff, aeb, 2002-04-22. .\" Corrected include file, drepper, 2003-06-15. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH lockf 3 "5 février 2023" "Pages du manuel de Linux 6.03" .SH NOM lockf \- Poser, examiner ou supprimer un verrou POSIX sur un fichier ouvert .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBint lockf(int \fP\fIfd\fP\fB, int \fP\fIcmd\fP\fB, off_t \fP\fIlen\fP\fB);\fP .fi .PP .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBlockf\fP()\ : .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED _XOPEN_SOURCE >= 500 || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH DESCRIPTION Apply, test, or remove a POSIX lock on a section of an open file. The file is specified by \fIfd\fP, a file descriptor open for writing, the action by \fIcmd\fP, and the section consists of byte positions \fIpos\fP..\fIpos\fP+\fIlen\fP\-1 if \fIlen\fP is positive, and \fIpos\fP\-\fIlen\fP..\fIpos\fP\-1 if \fIlen\fP is negative, where \fIpos\fP is the current file position, and if \fIlen\fP is zero, the section extends from the current file position to infinity, encompassing the present and future end\-of\-file positions. In all cases, the section may extend past current end\-of\-file. .PP On Linux, \fBlockf\fP() is just an interface on top of \fBfcntl\fP(2) locking. Many other systems implement \fBlockf\fP() in this way, but note that POSIX.1 leaves the relationship between \fBlockf\fP() and \fBfcntl\fP(2) locks unspecified. A portable application should probably avoid mixing calls to these interfaces. .PP Les opérations valides sont les suivantes\ : .TP \fBF_LOCK\fP Poser un verrou exclusif sur la section indiquée du fichier. Si (une partie de) la section est déjà verrouillée, l'appel bloque jusqu'à la suppression du verrou précédent. Si la section recouvre un verrou existant (du même processus), les deux sont regroupés. Les verrouillages sont libérés lorsque le processus ferme un descripteur du fichier. Un processus fils n'hérite pas du verrou. .TP \fBF_TLOCK\fP Comme \fBF_LOCK\fP mais l'appel n'est pas bloquant, il renvoie une erreur si le fichier est déjà verrouillé. .TP \fBF_ULOCK\fP Déverrouiller la section indiquée du fichier. Ceci peut conduire une section verrouillée à être découpée en deux sections. .TP \fBF_TEST\fP Vérifier s'il y a un verrou\ : l'appel renvoie 0 si la section indiquée est libre ou verrouillée par le processus appelant, et \-1 avec \fBEAGAIN\fP (\fBEACCES\fP sur d'autres systèmes) dans \fIerrno\fP si un autre processus possède le verrou. .SH "VALEUR RENVOYÉE" En cas de succès, zéro est renvoyé. En cas d'erreur, \fB\-1\fP est renvoyé et \fIerrno\fP est définie pour préciser l'erreur. .SH ERREURS .TP \fBEACCES\fP ou \fBEAGAIN\fP Le fichier est verrouillé et \fBF_TLOCK\fP ou \fBF_TEST\fP étaient indiqués, ou encore l'opération est impossible car le fichier est projetée dans la mémoire d'un autre processus. .TP \fBEBADF\fP \fIfd\fP n'est pas un descripteur de fichier ouvert, ou \fIcmd\fP vaut \fBF_LOCK\fP ou \fBF_TLOCK\fP et \fIfd\fP n'est pas un descripteur de fichier en écriture. .TP \fBEDEADLK\fP L'opération \fBF_LOCK\fP demandée amènerait à un cas d’interblocage. .TP \fBEINTR\fP Durant l'attente pour acquérir le verrou, l'appel a été interrompu par un signal capturé par un gestionnaire\ ; consultez \fBsignal\fP(7). .TP \fBEINVAL\fP Une opération invalide a été réclamée sur \fIcmd\fP. .TP \fBENOLCK\fP La table des verrous est pleine. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .ad l .nh .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ \fBlockf\fP() T} Sécurité des threads MT\-Safe .TE .hy .ad .sp 1 .SH STANDARDS POSIX.1\-2001, POSIX.1\-2008, SVr4. .SH "VOIR AUSSI" \fBfcntl\fP(2), \fBflock\fP(2) .PP \fIlocks.txt\fP et \fImandatory\-locking.txt\fP dans le répertoire \fIDocumentation/filesystems\fP des sources du noyau Linux. (Sur d'anciens noyaux, ces fichiers se trouvent dans le répertoire \fIDocumentation\fP et \fImandatory\-locking.txt\fP est appelé \fImandatory.txt\fP.) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier et David Prévot . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .