Provided by: manpages-de-dev_0.10-1_all bug

BEZEICHNUNG

       truncate, ftruncate - kurzt eine Datei auf eine bestimmte Lange

       Diese  Handbuchseite ist eventuell veraltet. Im Zweifelsfall ziehen Sie
       die englischsprachige Handbuchseite zu Rate, indem Sie

              man -LC 2 truncate

       eingeben.

"UBERSICHT

       #include <unistd.h>

       int truncate(const char *path, off_t length);
       int ftruncate(int fd, off_t length);

BESCHREIBUNG

       Die Funktionen truncate  und  ftruncate  bewirken,  dass  die  regulare
       Datei,  die  durch path oder fd angegeben ist, auf eine GroBe von exakt
       length Bytes abgeschnitten wird.

       Wenn die Datei vorher groBer war, gehen uberschussige  Daten  verloren.
       Wenn  die  Datei  vorher  kleiner  war,  wird  sie  vergroBert  und die
       zusatzlichen Bytes werden als Nullen gelesen.

       Der Dateizeiger wird nicht verandert.

       Fur ftruncate muss die Datei zum Schreiben geoffnet sein, fur  truncate
       muss die Datei schreibbar sein.

R"UCKGABEWERT

       Bei   Erfolg   gibt  die  Funktion  0  zuruck.   Bei  Fehlern  wird  -1
       zuruckgegeben und errno entsprechend gesetzt.

FEHLER

       Fur truncate:

       EACCES Ein Teil des Pfades kann nicht gelesen  werden  oder  die  Datei
              kann vom Benutzer nicht beschrieben werden.

       EFAULT pfad liegt auBerhalb des Programmspeichers.

       EFBIG  Der  Parameter  length  ist  groBer als die maximale DateigroBe.
              (XSI)

       EINTR  Wahrend der Ausfuhrung wurde ein Signal empfangen.

       EINVAL Der Parameter length ist negativ oder groBer  als  die  maximale
              DateigroBe.

       EIO    Ein I/O Fehler ist beim aktualisieren der Inode aufgetreten.

       EISDIR pfad ist ein Verzeichnis, keine Datei.

       ELOOP  Zu viele Symbolische Links wurden im Pfad gefunden.

       ENAMETOOLONG
              Ein  Teil  des  Pfades  ist  groBer  als  255  Zeichen  oder der
              komplette Pfad uberschreitet eine GroBe von 1023 Zeichen.

       ENOENT Die angegebene Datei existiert nicht.

       ENOTDIR
              Ein Teil des Pfades ist kein Verzeichnis.

       EROFS  Die Datei befindet sich in einem read-only Dateisystem.

       ETXTBSY
              Die Datei ist eine Prozedur, die ausgefuhrt wird.

       Fur  ftruncate  gelten  die  gleichen  Fehlermeldungen.   Anstelle  von
       Dingen,  die mit path schieflaufen konnen, gibt es jetzt Dinge, die mit
       fd schiefgehen konnen:

       EBADF  fd ist kein gultiger Dateideskriptor.

       EINVAL oder EBADF
              fd ist nicht zum Schreiben geoffnet.

       EINVAL fd referenziert einen Socket, nicht eine Datei.

KONFORM ZU

       4.4BSD, SVr4 (diese Funktionsaufrufe traten zuerst  in  BSD  4.2  auf).
       POSIX  1003.1-1996  beschreibt ftruncate.  POSIX 1003.1-2001 beschreibt
       ebenfalls truncate als eine XSI-Erweiterung.

       SVr4 beschreibt zusatzlich die  Fehler  EMFILE,  EMULTIHP,  ENFILE  und
       ENOLINK fur truncate.  SVr4 dokumentiert fur ftruncate den zusatzlichen
       Fehler EAGAIN.

BERMERKUNGEN

       Die Beschreibung oben ist  fur  XSI-kompatible  Systeme  gedacht.   Fur
       nicht-XSI-kompatible  Systeme erlaubt der POSIX-Standard zwei Verhalten
       von ftruncate, wenn length groBer ist als die Dateilange (beachten Sie,
       dass  truncate  ist  fur  eine  derartige Umgebung nicht spezifiziert):
       entweder  wird  ein  Fehler  zuruckgeliefert  oder   die   Datei   wird
       vergroBert.  (Die meisten Unixe folgen den XSI-Anforderungen.)

SEE ALSO

       open(2).

                               8. September 2002                   TRUNCATE(2)