Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] rename - Changer le nom ou l'emplacement d'un fichier. [size=18] [b]Résumé[/b] [/size] [b]#include <stdio.h>[/b] [b][i]int rename(const char * oldpath , const char * newpath );[/i][/b] [size=18] [b]Description[/b] [/size] [b]rename[/b] renomme un fichier, en le déplaçant vers un autre répertoire si besoin est. Tous les autres liens matériels (créés avec [b]link )[/b] restent inchangés. Si [i]newpath[/i] existe déjà, il sera écrasé (avec quelques restrictions, voir le paragraphe ERREURS), de manière à ce qu'à aucun moment, un autre processus tentant d'accéder à [i]newpath[/i] ne le voit absent. Si l'opération échoue pour une raison quelconque, [b]rename[/b] garantit la présence d'une instance de [i]newpath[/i] en place. Néanmoins, pendant un écrasement, il se trouve un court instant pendant lequel à la fois [i]oldpath[/i] et [i]newpath[/i] font référence au fichier. Si [i]oldpath[/i] correspond à un lien symbolique, le lien est renommé; si [i]newpath[/i] correspond à un lien symbolique, le lien est écrasé. [size=18] [b]Valeur renvoyée[/b] [/size] [b]rename[/b] renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EISDIR[/b] [i]newpath[/i] [table][row][col]    [/col][col]est un répertoire existant mais [i]oldpath[/i] n'est pas un répertoire[/col][/row][/table] [b]EXDEV[/b] [b]oldpath et newpath[/b] [table][row][col]    [/col][col]ne sont pas sur le même système de fichiers.[/col][/row][/table] [b]ENOTEMPTY ou EEXIST[/b] [b]newpath[/b] [table][row][col]    [/col][col]est un répertoire non vide (contient autre chose que "." et "..").[/col][/row][/table] [b]EBUSY[/b] [table][row][col]    [/col][col]Le renommage a échoué car [b]oldpath ou newpath[/b] est un répertoire utilisé par un processus (peut-être comme répertoire de travail, ou comme répertoire racine, ou ouvert en lecture), ou il est utilisé par le système (comme point de montage par exemple). Le système a donc considéré qu'il y avait une erreur. (Notez qu'il n'est pas indispensable de renvoyer EBUSY dans un tel cas - rien n'empêche d'effectuer le renommage malgré tout - mais il est permis de retourner EBUSY si le système n'arrive pas à gérer une telle situation).[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Une partie du nouveau chemin contient en préfixe l'ancien chemin, ou plus généralement, un répertoire ne peut pas être déplacé dans ses propres sous-répertoires.[/col][/row][/table] [b]EMLINK[/b] [i]oldpath[/i] [table][row][col]    [/col][col]a déjà un nombre maximal de liens, ou bien c'est un répertoire, et le répertoire contenant [i]newpath[/i] a le nombre maximal de liens.[/col][/row][/table] [b]ENOTDIR[/b] [table][row][col]    [/col][col]Un élément utilisé dans [b]oldpath ou newpath[/b] n'est pas un répertoire, ou [i]oldpath[/i] est un répertoire et [i]newpath[/i] existe mais n'est pas un répertoire.[/col][/row][/table] [b]EFAULT[/b] [b]oldpath ou newpath pointent en dehors de l'espace d'adressage accessible.[/b][/col][/row][/table] [b]EACCES[/b] [table][row][col]    [/col][col]Les droits d'écriture dans le répertoire contenant [b]oldpath ou newpath[/b] ne sont pas autorisés pour l'UID effectif du processus, ou bien un des répertoires de [b]oldpath ou newpath[/b] ne permet pas le parcours, ou encore [i]oldpath[/i] était un répertoire et ne permet pas l'écriture (nécessaire pour mettre à jour les entrées [b]`.' et `..'[/b] ).[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]Le répertoire contenant [i]oldpath[/i] a son Sticky-bit positionné, et l'UID effectif du processus n'est ni celui de Root, ni celui du fichier à déplacer, ni celui du répertoire le contenant, ou alors le système de fichiers contenant [b]pathname[/b] ne permet pas le renommage de fichiers.[/col][/row][/table] [b]ENAMETOOLONG[/b] [b]oldpath ou newpath est trop long.[/b][/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Un répertoire contenu dans [b]oldpath ou newpath[/b] n'existe pas, ou est un lien symbolique pointant nulle part.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire pour le noyau.[/col][/row][/table] [b]EROFS[/b] [table][row][col]    [/col][col]Le fichier est sur un système de fichiers en lecture seule.[/col][/row][/table] [b]ELOOP[/b] [b]oldpath ou newpath[/b] [table][row][col]    [/col][col]contient une référence circulaire (à travers un lien symbolique).[/col][/row][/table] [b]ENOSPC[/b] [table][row][col]    [/col][col]Le périphérique contenant le fichier n'a pas de place pour une nouvelle entrée de répertoire.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] POSIX, BSD 4.3, ANSI C [size=18] [b]Bugs[/b] [/size] Sur les systèmes de fichiers NFS, ce n'est pas parce que l'opération a échoué que le fichier n'a pas été renommé. Si le serveur effectue le déplacement, et s'effondre, la RPC transmise qui sera traitée lorsque le serveur sera à nouveau en état va indiquer un échec. L'application doit supporter ce genre de problème. Voir [b]link (2)[/b] pour un cas similaire. [size=18] [b]Voir aussi[/b] [/size] [b]link (2),[/b] [b]unlink (2),[/b] [b]symlink (2),[/b] [b]mv (1),[/b] [b]link (8).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier