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

/usr/bin/xterm

mais

realpath -s /../usr/bin/X11/./xterm

renvoie

/usr/bin/X11/xterm

Exemple 2

Lorsque le répertoire actuel 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 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.

AUTEUR

Écrit à l'origine par Lars Wirzenius <[email protected]>, en tant que composant du paquet dwww. Désormais, Robert Luberda <[email protected]> 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é.