Flashnux

GNU/Linux man pages

Livre :
Expressions régulières,
Syntaxe et mise en oeuvre :

ISBN : 978-2-7460-9712-4
EAN : 9782746097124
(Editions ENI)

realpath(1)


REALPATH

REALPATH

NOM
SYNOPSIS
DESCRIPTION
OPTIONS
EXEMPLES
VALEUR RENVOYÉE
VOIR AUSSI
BOGUES
AUTEUR

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 &agrave; l’origine par Lars Wirzenius <liw@iki.fi>, en tant qu’un des composants du paquet dwww. D&eacute;sormais Robert Luberda <robert@debian.org> en est le responsable et le d&eacute;veloppe.

realpath est sous licence GNU GPL (General Public Licence). Bien qu’il ait &eacute;t&eacute; &eacute;crit pour Debian, le porter sur d’autre syst&egrave;me est vivement encourag&eacute;.



realpath(1)