.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1980, 1991 Regents of the University of California. .\" and Copyright (c) 2011, Michael Kerrisk .\" All rights reserved. .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\" @(#)lseek.2 6.5 (Berkeley) 3/10/91 .\" .\" Modified 1993-07-23 by Rik Faith .\" Modified 1995-06-10 by Andries Brouwer .\" Modified 1996-10-31 by Eric S. Raymond .\" Modified 1998-01-17 by Michael Haardt .\" .\" Modified 2001-09-24 by Michael Haardt .\" Modified 2003-08-21 by Andries Brouwer .\" 2011-09-18, mtk, Added SEEK_DATA + SEEK_HOLE .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH lseek 2 "2 mei 2024" "Linux man\-pages 6.8" .SH NAAM lseek \- herplaats lees/schrijf bestand\-positie .SH BIBLIOTHEEK Standard C bibliotheek (\fIlibc\fP, \fI\-lc\fP) .SH SAMENVATTING .nf \fB#include \fP .P \fBoff_t lseek(int \fP\fIbi\fP\fB, off_t \fP\fIpositie\fP\fB, int \fP\fIvanaf\fP\fB);\fP .fi .SH BESCHRIJVING De \fBlseek\fP() functie herplaatst de positie van de bestandindicator \fIbi\fP naar het argument \fIpositie\fP volgens de aanwijzing \fIvanaf\fP als volgt: .TP \fBSEEK_SET\fP De positie wordt naar \fIpositie\fP bytes gezet. .TP \fBSEEK_CUR\fP De positie wordt naar de huidige plaats plus \fIpositie\fP bytes gezet. .TP \fBSEEK_END\fP De positie wordt naar de lengte van het bestand plus \fIpositie\fP bytes gezet. .P De \fBlseek\fP functie staat toe de bestand positie te zetten ná het einde van het bestand (dit verandert niet de grootte van het bestand). Als later gegevens op deze positie worden geschreven, geven navolgende lees opdrachten in het gat ge\-Nulde (\(aq\e0\(aq) bytes terug (totdat er daadwerkelijk gegevens in het gat worden geschreven). .SS "Zoeken bestand data en gaten" Vanaf Linux 3.1 ondersteund Linux de volgende additionele waarden voor \fIvanaf\fP: .TP \fBSEEK_DATA\fP Pas de bestandsplaats aan de volgende locatie in het bestand groter dan of gelijk aan \fIpositie\fP die data bevat. Als \fIpositie\fP naar data wijst, zet dan de bestandsplaats op \fIpositie\fP. .TP \fBSEEK_HOLE\fP Pas de bestandsplaats aan naar het volgende gat in het bestand groter dan of gelijk aan \fIpositie\fP. Als \fIpositie\fP naar het midden van een gat wijst, dan wordt de plaats gezet op \fIpositie\fP gezet. Als er geen gat is voorbij \fIpositie\fP, dan wordt de plaats gezet op het einde van het bestand (m.a.w. er is een impliciet gat aan het einde van elk bestand). .P In beide bovenstaande gevallen faalt \fBlseek\fP() als \fIpositie\fP voorbij het einde van het bestand wijst. .P Deze operaties staan applicaties toe om gaten in dun toegekende bestanden in kaart te brengen. Dit kan nuttig zijn voor applicaties zoals backup gereedschap, die ruimte kunnen sparen bij het aanmaken van backups en gaten kunnen bewaren, mits ze een mechanisme hebben om gaten de ontdekken. .P .\" https://lkml.org/lkml/2011/4/22/79 .\" http://lwn.net/Articles/440255/ .\" http://blogs.oracle.com/bonwick/entry/seek_hole_and_seek_data Binnen de doelen van deze operaties bedoelen we met een gat een serie van nullen die (normaliter) niet zijn toegekend in de onderliggende bestandsopslag. Het is echter zo dat een bestandssysteem niet verplicht is gaten te rapporteren, daarom zijn deze operaties geen gegarandeerd mechanisme om de aan een bestand toegekende opslag ruimte in kaart te brengen. (Bovendien hoeft een serie van nullen die daadwerkelijk is geschreven naar de onderliggende opslag niet gerapporteerd te worden als een gat.) In de meest eenvoudige implementatie kan een bestandssysteem de operatie ondersteunen door te zorgen dat \fBSEEK_HOLE\fP altijd de afstand naar het einde van het bestand teruggeeft, en te zorgen dat \fBSEEK_DATA\fP altijd \fIpositie\fP teruggeeft (m.a.w. zelfs als de locatie aangewezen door \fIpositie\fP een gat is, kan het beschouwd worden te bestaan uit data die een serie van nullen is). .P De \fB_GNU_SOURCE\fP test macro moet zijn gedefinieerd om de definities te verkrijgen van \fBSEEK_DATA\fP en \fBSEEK_HOLE\fP uit \fI\fP. .P De \fBSEEK_HOLE\fP en \fBSEEK_DATA\fP operaties worden ondersteund door de volgende bestandssystemen: .IP \[bu] 3 Btrfs (sinds Linux 3.1) .IP \[bu] .\" commit 93862d5e1ab875664c6cc95254fc365028a48bb1 OCFS (sinds Linux 3.2) .IP \[bu] XFS (sinds Linux 3.5) .IP \[bu] ext4 (sinds Linux 3.8) .IP \[bu] \fBtmpfs\fP(5) (sinds Linux 3.8) .IP \[bu] .\" commit 1c6dcbe5ceff81c2cf8d929646af675cd59fe7c0 .\" commit 24bab491220faa446d945624086d838af41d616c NFS (sinds Linux 3.18) .IP \[bu] .\" commit 0b5da8db145bfd44266ac964a2636a0cf8d7c286 FUSE (sinds Linux 4.5) .IP \[bu] .\" commit 3a27411cb4bc3ce31db228e3569ad01b462a4310 GFS2 (sinds Linux 4.15) .SH "EIND WAARDE" Bij geslaagde afronding geeft \fBlseek\fP de opgeleverde plaats zoals gemeten in bytes van het begin van het bestand, terug. Anders wordt een waarde van \fI(off_t)\ \-1\fP teruggegeven, en \fIerrno\fP wordt gezet om de fout duidelijk te maken. .SH FOUTEN .TP \fBEBADF\fP \fIbi\fP is niet een open bestandindicator.. .TP \fBEINVAL\fP .\" Some systems may allow negative offsets for character devices .\" and/or for remote filesystems. \fIVanaf\fP is niet geldig. Of: de resulterende bestand plaats zou negatief zijn, of voorbij het einde van een doorzoekbaar apparaat. .TP \fBENXIO\fP \fIwhence\fP is \fBSEEK_DATA\fP of \fBSEEK_HOLE\fP, en \fIpositie\fP is voorbij het einde van het bestand, of \fIwhence\fP is \fBSEEK_DATA\fP en \fIpositie\fP is in een gat aan het einde van het bestand. .TP \fBEOVERFLOW\fP .\" HP-UX 11 says EINVAL for this case (but POSIX.1 says EOVERFLOW) De resulterende bestand plaats kan niet gerepresenteerd worden in een \fIoff_t\fP. .TP \fBESPIPE\fP \fIbi\fP hoort bij een pijp, een socket, of een FIFO. .SH VERSIES .\" Other systems return the number of written characters, .\" using SEEK_SET to set the counter. (Of written characters.) Op Linux: het gebruik van \fBlseek\fP() zal op een terminal apparaat falen met de fout\fBESPIPE\fP. .SH "VOLDOET AAN" POSIX.1\-2008. .SH GESCHIEDENIS POSIX.1\-2001, SVr4, 4.3BSD. .P .\" FIXME . Review http://austingroupbugs.net/view.php?id=415 in the future \fBSEEK_DATA\fP en \fBSEEK_HOLE\fP zijn niet\-standaard uitbreidingen ook aanwezig inSolaris, FreeBSD, en DragonFly BSD; zij zijn voorgesteld voor opname in de volgende POSIX revisie (Issue 8). .SH OPMERKINGEN Zie \fBopen\fP(2) voor een discussie over de relatie tussen bestandsbeschrijvingen, open bestandsbeschrijvingen en bestanden. .P Als de \fBO_APPEND\fP bestand status vlag is gezet op de open bestandsbeschrijving, dan zal \fBwrite\fP(2) \fIaltijd\fP de bestandsafstand naar het einde van het bestand verplaatsen, onafhankelijk van het gebruik van \fBlseek\fP(). .P Sommige apparaten zijn niet in status tot zoeken, en POSIX bepaald nietwelke apparaten het moeten \fBlseek\fP() ondersteunen. .SH "ZIE OOK" \fBdup\fP(2), \fBfallocate\fP(2), \fBfork\fP(2), \fBopen\fP(2), \fBfseek\fP(3), \fBlseek64\fP(3), \fBposix_fallocate\fP(3) .PP .SH VERTALING De Nederlandse vertaling van deze handleiding is geschreven door Jos Boersema , Mario Blättermann en Luc Castermans . .PP Deze vertaling is vrije documentatie; lees de .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE of later over de Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID. .PP Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar .MT debian-l10n-dutch@lists.debian.org .ME .