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

Exigences de macros de test de fonctionalités pour la glibc (voir feature_test_macros(7)) :

getdtablesize() : _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L  

Si le fichier était plus long, les données supplémentaires sont perdues. Si le fichier était plus court, il est étendu, et la portion supplémentaire est remplie d'octets nuls.

Le pointeur de position n'est pas modifié.

Si la taille est modifiée, les champs st_ctime et st_mtime (respectivement horodatage du dernier changement d'état et horodatage de la dernière modification ; voir stat(2)) du fichier sont mis à jour, et les bits Set-UID et Set-GID sont effacés.

Avec ftruncate(), le fichier doit être ouvert en écriture ; avec truncate(), il doit être accessible en écriture.  

EACCES

Le fichier n'est pas accessible en écriture, ou un élément du chemin d'accès ne permet pas le parcours. (Voir aussi path_resolution(7).)

EFAULT

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

EFBIG

L'argument length dépasse la taille maximum d'un fichier.

EINTR

Un signal a été capturé durant l'exécution.

EINVAL

L'argument length est négatif ou plus grand que la taille maximale d'un fichier.

EIO

Une erreur d'entrée-sortie bas niveau s'est produite.

EISDIR

Le fichier est en réalité un répertoire.

ELOOP

Le chemin contient une référence circulaire (à travers un lien symbolique).

ENAMETOOLONG

Un composant du chemin dépasse 255 caractères ou le chemin complet dépasse 1023 caractères.

ENOENT

Le fichier n'existe pas.

ENOTDIR

Un composant du chemin d'accès n'est pas un répertoire.

EPERM

Le système de fichiers sous-jacent ne supporte pas l'extension d'un fichier au-delà de sa taille actuelle.

EROFS

Le fichier se trouve sur un système de fichiers en lecture seule.

ETXTBSY

Le fichier est un programme actuellement en cours d'exécution.

Pour ftruncate() les mêmes erreurs sont possibles, sauf qu'au lieu des problèmes 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 écriture.

EINVAL

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

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 15 octobre 1996 et révisée le 22 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 truncate ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

VALEUR RENVOYÉE

ERREURS

CONFORMITÉ

NOTES

VOIR AUSSI

TRADUCTION