Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] realpath - Renvoie le chemin d'accès absolu. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <sys/param.h>[/b] [b]#include <stdlib.h>[/b] [b][i]char realpath (char path , char resolved_path[] ); [/i][/b] [size=18] [b]Description[/b] [/size] [b]realpath[/b] développe tous les liens symboliques, et résout les références à [b]'/./' , '/../' [/b] ainsi que les caractères [i]'/' [/i] supplémentaires dans la chaîne, terminée par un caractere nul, pointée par [i]path[/i] et stocke le résultat dans le buffer de taille [b]MAXPATHLEN[/b] pointé par [b]resolved_path .[/b] Le chemin résultant ne traversera plus de liens symboliques, et ne contiendra plus d'éléments [i]'/./'[/i] ou [b]'/../' .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] S'il n'y a pas d'erreur, [b]realpath()[/b] renvoie un pointeur sur [b]resolved_path .[/b] Sinon elle renvoie NULL, et [i]resolved_path [/i] contient le chemin d'accès absolu vers l'élément de [i]path [/i] qui ne peut pas être résolu, et [i]errno [/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EACCES[/b] [table][row][col]    [/col][col]La permission de recherche n'est pas accordée pour un composant du chemin d'accès.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Soit [i]path[/i] soit [i]resolv_path[/i] est NULL (Dans la libc5 cela déclenchait une faute de segmentation).[/col][/row][/table] [b]EIO[/b] [table][row][col]    [/col][col]Une erreur d'entrée/sortie s'est produite sur le système de fichiers.[/col][/row][/table] [b]ELOOP[/b] [table][row][col]    [/col][col]Trop de liens symboliques rencontrés.[/col][/row][/table] [b]ENAMETOOLONG[/b] [table][row][col]    [/col][col]Un élément du chemin d'accès dépasse [b]NAME_MAX[/b] caractères de long, ou le chemin d'accès complet dépasse [b]PATH_MAX[/b] caractères.[/col][/row][/table] [b]ENOENT[/b] [table][row][col]    [/col][col]Le fichier indiqué n'existe pas.[/col][/row][/table] [b]ENOTDIR[/b] [table][row][col]    [/col][col]Un élément du chemin d'accès n'est pas un répertoire.[/col][/row][/table] [size=18] [b]Bugs[/b] [/size] N'utilisez jamais cette fonction. Son design est erroné cae elle ne permet pas de connaître la taille nécessaire pour le buffer de sortie. D'après POSIX un buffer de taille PATH_MAX suffit, mais PATH_MAX n'est pas nécessaire une constante définie et peut être obtenue avec [b]pathconf() .[/b] En outre, interroger [i]pathconf()[/i] n'aide pas vraiment, car d'une part POSIX prévient que les résultats de [i]pathconf()[/i] peuvent être immenses et inappropriés pour allouer de la mémoire et d'autre part [i]pathconf()[/i] peut renvoyer -1 indiquant que PATH_MAX est illimité.     Les implémentations dans les libc4 et libc5 contenaient un débordement de buffer (corrigé dans la libc-5.4.13). Ainsi, les programmes Set-UID, comme mount ont besoin d'une version privée de cette routine. [size=18] [b]Historique[/b] [/size] La fonction [b]realpath[/b] est apparue dans BSD 4.4, due à Jan-Simon Pendry. Sous Linux, cette fonction est apparue dans la libc 4.5.21. [size=18] [b]Conformité[/b] [/size] Dans BSD 4.4 et Solaris la limite de longueur du chemin est MAXPATHLEN (dans <sys/param.h>). SUSv2 conseille PATH_MAX et NAME_MAX, dans <limits.h> ou fournis par [b]pathconf() .[/b] Un fragmen de code typique serait    [table][row][col]    [/col][col] .nf #ifdef PATH_MAX path_max = PATH_MAX; #else path_max = pathconf (path, _PC_PATH_MAX); if (path_max <= 0) path_max = 4096; #endif .fi[/col][/row][/table] (Mais voir quand même la section BOGUES plus haut).     Les versions BSD 4.4, Linux et SUSv2 renvoient toujous un chemin absolu. Solaris peut renvoyer un chemin relatif si l'argument [i]path[/i] est relatif. Le prototype de [b]realpath[/b] est donné dans <unistd.h> dans les libc4 et libc5, mais dans <stdlib.h> partout ailleurs. [size=18] [b]Voir aussi[/b] [/size] [b]readlink (2),[/b] [b]getcwd (3),[/b] [b]pathconf (3),[/b] [b]sysconf (3)[/b] Christophe Blaess, 1996-2003.
Fichier