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, sans aucun lien symbolique ni aucune entrée
spéciale de répertoire comme
. ou
.. (consultez
realpath(3) pour plus d'informations).
Chaque partie de chemin du
fichier doit exister, sinon
realpath
échouera et un code de retour non nul sera renvoyé.
Veuillez noter que la plupart de ces fonctionnalités sont fournies par
l'option
-e 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
fichier. Si le
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 actuel 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 le
caractère NULL 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
- Afficher un résumé du manuel d'utilisation.
- -v, --version
- Afficher 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 actuel,
realpath /../usr/bin/X11/./xterm
affiche
mais
realpath -s /../usr/bin/X11/./xterm
renvoie
Exemple 2¶
Lorsque le répertoire actuel est
/usr/bin/X11 (qui est toujours un
lien symbolique vers
/usr/bin), la sortie de chaque
et
sera
Exemple 3¶
À condition que le répertoire actuel 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 renvoyant 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
renverra
/home/path/to/some/non-existent/file
VALEUR RENVOYÉE¶
realpath renvoie un code de retour nul lorsque
tous les noms de
chemin ont été convertis avec succès.
Au cas où une erreur se produirait (par exemple des répertoires
manquants ou indisponibles dans le chemin),
realpath écrit un
message d'erreur sur la sortie d'erreur standard et renvoie un code de retour
non nul.
VOIR AUSSI¶
basename(1),
dirname(1),
readlink(1),
chase(1),
realpath(3)
BOGUES¶
Espérons 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 que composant du paquet dwww. Désormais, Robert Luberda <
robert@debian.org> en est le responsable et le développeur.
realpath est sous licence GNU GPL (General Public Licence). Bien qu'il
ait été écrit pour Debian, le porter sur d'autres systèmes
est vivement encouragé.