Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] truncate, ftruncate - Tronquer un fichier à une longueur donnée. [size=18] [b]Résumé[/b] [/size] [b]#include <unistd.h>[/b] [b][/b] [b]#include <sys/types.h>[/b] [b][i]int truncate(const char * path , off_t length );[/i][/b] [b][/b] [b][i]int ftruncate(int fd , off_t length );[/i][/b] [size=18] [b]Description[/b] [/size] Les appels [b]truncate[/b] et [b]ftruncate[/b] tronquent le fichier référencé par [i]path[/i] ou par le descripteur [i]fd[/i] à une longueur maximale de [i]length[/i] octets.     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 de zéros.     Le pointeur de position n'est pas modifié.     Si la taille est modifiée, les champs ctime et mtime du fichier sont mis à jour, et les bits Set-UID et Set-GID sont effacés.     Avec [b]ftruncate ,[/b] le fichier doit être ouvert en écriture ; avec .BT truncate , il doit être accessible en écriture. [size=18] [b]Valeur renvoyée[/b] [/size] [b]truncate ,[/b] et [b]ftruncate[/b] renvoient 0 s'ils réussissent et -1 s'ils échouent, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] Pour [b]truncate :[/b] [b]EACCES[/b] [table][row][col]    [/col][col]Le fichier n'est pas accessible en écriture, ou un élément du chemin d'accès ne permet pas le parcours.[/col][/row][/table] [b]EFAULT[/b] [i]Path[/i] [table][row][col]    [/col][col]pointe en dehors de l'espace d'adressage accessible.[/col][/row][/table] [b]EFBIG[/b] [table][row][col]    [/col][col]L'argument [i]length[/i] dépasse la taille maximum d'un fichier.[/col][/row][/table] [b]EINTR[/b] [table][row][col]    [/col][col]Un signal a été capturé durant l'exécution.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]L'argument [i]length[/i] est négatif ou plus grand que la taille maximale d'un fichier.[/col][/row][/table] [b]EIO[/b] [table][row][col]    [/col][col]Une erreur d'entrée/sortie bas niveau s'est produite.[/col][/row][/table] [b]EISDIR[/b] [table][row][col]    [/col][col]Le fichier est en réalité un répertoire[/col][/row][/table] [b]ELOOP[/b] [table][row][col]    [/col][col]Le chemin contient une référence circulaire (à travers un lien symbolique)[/col][/row][/table] [b]ENAMETOOLONG[/b] [table][row][col]    [/col][col]Un composant du chemin dépasse 255 caractères ou le chemin complet dépasse 1023 caractères.[/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Le fichier n'existe pas[/col][/row][/table] [b]ENOTDIR[/b] [table][row][col]    [/col][col]un composant du chemin d'accès n'est pas un répertoire[/col][/row][/table] [b]EROFS[/b] [table][row][col]    [/col][col]Le fichier se trouve sur un système de fichiers en lecture seule.[/col][/row][/table] [b]ETXTBSY[/b] [table][row][col]    [/col][col]Le fichier est un programme actuellement en cours d'exécution.[/col][/row][/table] Pour [b]ftruncate[/b] les mêmes erreurs sont possibles, sauf qu'au lieu des problèmes avec [b]path ,[/b] on peut en avoir avec [b]fd :[/b] [b]EBADF[/b] [table][row][col]    [/col][col]L'argument [i]fd[/i] n'est pas un descripteur valide.[/col][/row][/table] [b]EBADF ou EINVAL[/b] [table][row][col]    [/col][col]L'argument [i]fd[/i] n'est pas ouvert en écriture.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]L'argument [i]fd[/i] n'est pas un descripteur de fichier normal.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] BSD 4.4, SVr4 (cette fonction est apparue dans BSD 4.2). POSIX 1003.1-1996 décrit [b]ftruncate .[/b] POSIX 1003.1-2001 décrit aussi [b]truncate ,[/b] en tant qu'extension XSI.     SVr4 mentionne des conditions d'erreurs supplémentaires pour [b]truncate[/b] EMFILE, EMULTIHOP, ENFILE, ENOLINK. La version SVr4 de [b]ftruncate[/b] dispose de l'erreur supplémentaire EAGAIN. [size=18] [b]Notes[/b] [/size] La description ci-dessus est celle des systèmes compatibles XSI. Pour les systèmes non compatiables,le standard POSIX autorise deux comportements pour [b]ftruncate[/b] quand [i]length[/i] dépasse la longueur du fichier (notez que [b]truncate[/b] n'est pas du tout spécifié dans un tel environnement) : soit renvoyer une erreur, soit étendre le fichier. (La plupart des Unix suivent le comportement XSI). [size=18] [b]Voir aussi[/b] [/size] [b]open (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier