.\" Copyright (c) 1983, 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#)truncate.2 6.9 (Berkeley) 3/10/91 .\" .\" Modified Sat Jul 24 12:46:33 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Tue Oct 22 22:36:33 1996 by Eric S. Raymond .\" Modified Mon Dec 21 13:37:05 1998 by Andries Brouwer (aeb@cwi.nl) .\" Translated into German by Dennis Stampfer .\" .TH TRUNCATE 2 "8. September 2002" "" "Systemaufrufe" .SH BEZEICHNUNG truncate, ftruncate \- kürzt eine Datei auf eine bestimmte Länge .SH "ÜBERSICHT" .B #include .sp .BI "int truncate(const char *" path ", off_t " length ); .br .BI "int ftruncate(int " fd ", off_t " length ); .SH BESCHREIBUNG Die Funktionen .B truncate und .B ftruncate bewirken, dass die reguläre Datei, die durch .I path oder .I fd angegeben ist, auf eine Größe von exakt .I length Bytes abgeschnitten wird. .LP Wenn die Datei vorher größer war, gehen überschüssige Daten verloren. Wenn die Datei vorher kleiner war, wird sie vergrößert und die zusätzlichen Bytes werden als Nullen gelesen. .LP Der Dateizeiger wird nicht verändert. .LP Für .B ftruncate muss die Datei zum Schreiben geöffnet sein, für .B truncate muss die Datei schreibbar sein. .SH RÜCKGABEWERT Bei Erfolg gibt die Funktion 0 zurück. Bei Fehlern wird \-1 zurückgegeben und .I errno entsprechend gesetzt. .SH FEHLER Für .BR truncate : .TP .B EACCES Ein Teil des Pfades kann nicht gelesen werden oder die Datei kann vom Benutzer nicht beschrieben werden. .TP .B EFAULT .I pfad liegt außerhalb des Programmspeichers. .TP .B EFBIG Der Parameter .I length ist größer als die maximale Dateigröße. (XSI) .TP .B EINTR Während der Ausführung wurde ein Signal empfangen. .TP .B EINVAL Der Parameter .I length ist negativ oder größer als die maximale Dateigröße. .TP .B EIO Ein I/O Fehler ist beim aktualisieren der Inode aufgetreten. .TP .B EISDIR .I pfad ist ein Verzeichnis, keine Datei. .TP .B ELOOP Zu viele Symbolische Links wurden im Pfad gefunden. .TP .B ENAMETOOLONG Ein Teil des Pfades ist größer als 255 Zeichen oder der komplette Pfad überschreitet eine Größe von 1023 Zeichen. .TP .B ENOENT Die angegebene Datei existiert nicht. .TP .B ENOTDIR Ein Teil des Pfades ist kein Verzeichnis. .TP .B EROFS Die Datei befindet sich in einem read-only Dateisystem. .TP .B ETXTBSY Die Datei ist eine Prozedur, die ausgeführt wird. .PP Für .BR ftruncate gelten die gleichen Fehlermeldungen. Anstelle von Dingen, die mit .B path schieflaufen können, gibt es jetzt Dinge, die mit .B fd schiefgehen können: .TP .B EBADF .I fd ist kein gültiger Dateideskriptor. .TP .BR EINVAL " oder " EBADF .I fd ist nicht zum Schreiben geöffnet. .TP .B EINVAL .I fd referenziert einen Socket, nicht eine Datei. .SH "KONFORM ZU" 4.4BSD, SVr4 (diese Funktionsaufrufe traten zuerst in BSD 4.2 auf). POSIX 1003.1-1996 beschreibt .BR ftruncate . POSIX 1003.1-2001 beschreibt ebenfalls .IR truncate als eine XSI-Erweiterung. .LP SVr4 beschreibt zusätzlich die Fehler EMFILE, EMULTIHP, ENFILE und ENOLINK für .BR truncate . SVr4 dokumentiert für .B ftruncate den zusätzlichen Fehler EAGAIN. .SH BERMERKUNGEN Die Beschreibung oben ist für XSI-kompatible Systeme gedacht. Für nicht-XSI-kompatible Systeme erlaubt der POSIX-Standard zwei Verhalten von .BR ftruncate , wenn .I length größer ist als die Dateilänge (beachten Sie, dass .B truncate ist für eine derartige Umgebung nicht spezifiziert): entweder wird ein Fehler zurückgeliefert oder die Datei wird vergrößert. (Die meisten Unixe folgen den XSI-Anforderungen.) .\" At the very least: OSF/1, Solaris 7, and FreeBSD conform, mtk, Jan 2002 .SH "SEE ALSO" .BR open (2).