Man Truncate en français
TRUNCATE(2)               Manuel du programmeur Linux              TRUNCATE(2)



 

NOM


       truncate, ftruncate - Tronquer un fichier a une longueur donnee.

 

SYNOPSIS


       #include 
       #include 

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

 

DESCRIPTION






       Les appels truncate() et ftruncate() tronquent le fichier reference par
       path ou par le descripteur fd a une longueur maximale de length octets.

       Si  le  fichier  etait plus long, les donnees supplementaires sont per-
       dues.  Si le fichier etait plus court, il est  etendu,  et  la  portion
       supplementaire est remplie d'octets nuls.

       Le pointeur de position n'est pas modifie.

       Si la taille est modifiee, les champs st_ctime et st_mtime (respective-
       ment horodatage du  dernier  changement  d'etat  et  horodatage  de  la
       derniere  modification ;  voir  stat(2)) du fichier sont mis a jour, et
       les bits Set-UID et Set-GID sont effaces.

       Avec ftruncate(), le fichier doit etre ouvert en ecriture ; avec  trun-
       cate(), il doit etre accessible en ecriture.

 

VALEUR RENVOYEE


       truncate()  et  ftruncate()  renvoient  0 s'ils reussissent et -1 s'ils
       echouent, auquel cas errno contient le code d'erreur.

 

ERREURS


       Pour truncate() :

       EACCES Le fichier n'est pas accessible en ecriture, ou  un  element  du
              chemin d'acces ne permet pas le parcours.  (Voir aussi path_res-
              olution(2).)

       EFAULT path pointe en dehors de l'espace d'adressage accessible.

       EFBIG  L'argument length depasse la taille maximum d'un fichier.

       EINTR  Un signal a ete capture durant l'execution.

       EINVAL L'argument length est negatif ou plus grand que la taille  maxi-
              male d'un fichier.

       EIO    Une erreur d'entree-sortie bas niveau s'est produite.

       EISDIR Le fichier est en realite un repertoire.

       ELOOP  Le  chemin  contient une reference circulaire (a travers un lien
              symbolique).

 

       ENAMETOOLONG


              Un composant du chemin depasse 255 caracteres ou le chemin  com-
              plet depasse 1023 caracteres.

       ENOENT Le fichier n'existe pas.

 

       ENOTDIR


              Un composant du chemin d'acces n'est pas un repertoire.

       EPERM  Le  systeme  de fichiers sous-jacent ne supporte pas l'extension
              d'un fichier au-dela de sa taille actuelle.

       EROFS  Le fichier se trouve sur  un  systeme  de  fichiers  en  lecture
              seule.

 

       ETXTBSY


              Le fichier est un programme actuellement en cours d'execution.

       Pour  ftruncate() les memes erreurs sont possibles, sauf qu'au lieu des
       problemes avec path, on peut en avoir avec fd :

       EBADF  L'argument fd n'est pas un descripteur valide.

       EBADF ou EINVAL
              L'argument fd n'est pas ouvert en ecriture.

       EINVAL L'argument fd n'est pas un descripteur de fichier normal.

 

CONFORMITE


       BSD 4.4, SVr4, POSIX.1-2001 (cette fonction est apparue dans BSD  4.2).

 

NOTES


       La  description ci-dessus est celle des systemes compatibles XSI.  Pour
       les systemes non compatibles, le standard POSIX autorise deux comporte-
       ments  pour  ftruncate()  quand  length  depasse la longueur du fichier
       (notez que truncate() n'est pas du tout specifiee dans un tel  environ-
       nement) :  soit renvoyer une erreur, soit etendre le fichier.  (La plu-
       part des Unix suivent le  comportement  XSI).   Comme  la  plupart  des
       implementations  Unix,  Linux  suit  les reclamations XSI lorsqu'il a a
       faire a des systemes de fichiers natifs.  Toutefois, certains  systemes
       de  fichiers  non  natifs  ne  permettent  pas d'utiliser truncate() et
       ftruncate() pour etendre un fichier au-dela de sa taille actuelle :  un
       exemple notable sous Linux est VFAT.

 

VOIR AUSSI


       open(2), path_resolution(2), stat(2)

 

TRADUCTION


       Ce   document   est  une  traduction  realisee  par  Christophe  Blaess
        le  15 octobre 1996  et  revisee  le
       14 aot 2006.

       L'equipe  de  traduction a fait le maximum pour realiser une adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est  toujours  consultable  via  la commande :  LANG=C man 2 truncate .
       N'hesitez pas a signaler a l'auteur ou au  traducteur,  selon  le  cas,
       toute erreur dans cette page de manuel.



Linux 2.6.7                      23 juin 2004                      TRUNCATE(2)