realpath

Autres langues

Langue: fr

Version: 29 mars 2009 (debian - 07/07/09)

Autres sections - même nom

Section: 1 (Commandes utilisateur)

NOM

realpath - renvoyer le nom de chemin absolu sous forme canonique

SYNOPSIS

realpath [-s|--strip] [-z|--zero] fichier ...
realpath --h|--help
realpath --v|--version

DESCRIPTION

realpath convertit chaque fichier passé en argument en un nom de chemin absolu, formé d'aucun lien symbolique ni aucune entrée de répertoire spéciale comme . ou ... (Voir realpath(3) pour plus d'informations.)
Veuillez noter que la plupart de ces fonctionnalités sont fournies par l'option `-f' de la commande readlink(1).

Lorsque l'option -s est utilisée, realpath supprime uniquement les répertoires . et .., mais pas les liens symboliques de nom_de_fichier. Si le nom_de_fichier donné en argument est relatif (par exemple s'il ne commence pas par « / »), realpath le fait précéder par le nom du répertoire courant tel qu'obtenu par l'appel système getcwd avant de poursuivre.

Chaque nom de chemin converti est dirigé vers la sortie standard, un par ligne.

OPTIONS

-s, --strip
Enlever seulement les composants . et .., mais ne résout pas les liens symboliques.
-z, --zero
Séparer les noms de fichiers en sortie par un espace vide au lieu d'un saut à la ligne, de ce fait la sortie peut être utilisée avec l'option `-0' de xargs(1).
-h, --help
Affiche un résumé du manuel d'utilisation.
-v, --version
Affiche le numéro de version de realpath.

EXEMPLES

Dans l'exemple suivant, supposons que /usr/bin/X11 est un lien symbolique pointant vers le répertoire /usr/bin.

Exemple 1

Sans tenir compte du répertoire courant
 realpath /../usr/bin/X11/./xterm
 
affiche
 /usr/bin/xterm
 
mais
 realpath -s /../usr/bin/X11/./xterm
 
retourne
 /usr/bin/X11/xterm
 

Exemple 2

Lorsque le répertoire courant est /usr/bin/X11 (qui est toujours un lien symbolique vers /usr/bin), la sortie de chaque
 realpath ./xterm
 
et
 realpath  -s ./xterm
 
sera
 /usr/bin/xterm
 
 

Exemple 3

À condition que le répertoire courant soit /home/user (et que le répertoire existe avant et pendant l'exécution de realpath), la commande
 realpath ../path/to/some/./non-existent/./directory/../or/../file
 
échouera en retournant l'erreur suivante
 ../path/to/some/./non-existent/./directory/../or/../file: No such file or directory
 
mais
 realpath -s ../path/to/some/./non-existent/./directory/../or/../file
 
retournera
 /home/path/to/some/non-existent/file
 

VALEUR RENVOYÉE

realpath renvoie un code de fin d'exécution égal à zéro lorsque tous les noms de chemin ont été convertis avec succès.
Dans le cas où une erreur se produirait (par exemple des répertoires manquants ou indisponibles dans le chemin), realpath écrit un message d'erreur sur « stderr » et renvoie une valeur de sortie non nulle.

VOIR AUSSI

basename(1), dirname(1), readlink(1), realpath(3)

BOGUES

Avec espoir, aucun :)
Si vous en trouvez, veuillez les signaler grâce au système de signalisation des bogues de Debian, consultez le fichier /usr/share/doc/debian/bug-reporting.txt du paquet doc-debian ou la page de manuel de reportbug(1).

AUTEUR

Écrit à l'origine par Lars Wirzenius <liw@iki.fi>, en tant qu'un des composants du paquet dwww. Désormais Robert Luberda <robert@debian.org> en est le responsable et le développe.

realpath est sous licence GNU GPL (General Public Licence). Bien qu'il ait été écrit pour Debian, le porter sur d'autre système est vivement encouragé.