.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH REALPATH 1 "16 octobre 2011" Debian Debian
.SH NOM
realpath \- Renvoyer le nom de chemin absolu sous forme canonique
.SH SYNOPSIS
.if  !'po4a'hide' .B realpath
.if  !'po4a'hide' .if !'po4a'hide' .RB [ \-s | \-\-strip ]
.if  !'po4a'hide' .RB [ \-z | \-\-zero ]
\fIfichier\fP ...
.br
.if  !'po4a'hide' .B realpath
.if  !'po4a'hide' .BR  \-\-h | \-\-help
.br
.if  !'po4a'hide' .B realpath
.if  !'po4a'hide' .BR  \-\-v | \-\-version
.SH DESCRIPTION
\fBrealpath\fP convertit chaque \fIfichier\fP passé en argument en un nom de
chemin absolu, sans aucun lien symbolique ni aucune entrée spéciale de
répertoire comme \fB.\fP ou \fB..\fP (consultez \fBrealpath\fP(3) pour plus
d'informations).
.br
Chaque partie de chemin du \fIfichier\fP doit exister, sinon \fBrealpath\fP
échouera et un code de retour non nul sera renvoyé.
.br
Veuillez noter que la plupart de ces fonctionnalités sont fournies par
l'option \fB\-e\fP de la commande \fBreadlink\fP(1).
.PP
Lorsque l'option \fB\-s\fP est utilisée, \fBrealpath\fP supprime uniquement les
répertoires \fB.\fP et \fB..\fP, mais pas les liens symboliques de \fIfichier\fP. Si
le \fIfichier\fP donné en argument est relatif (par exemple s'il ne commence
pas par «\ \fI/\fP\ »), \fBrealpath\fP le fait précéder par le nom du répertoire
actuel tel qu'obtenu par l'appel système \fBgetcwd\fP avant de poursuivre.
.PP
Chaque nom de chemin converti est dirigé vers la sortie standard, un par
ligne.
.SH OPTIONS
.TP  5
.if  !'po4a'hide' .BR \-s ", "  \-\-strip
.\"
Enlever seulement les composants \fB.\fP et \fB..\fP, mais ne résout pas les liens
symboliques.
.TP  5
.if  !'po4a'hide' .BR \-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 \fB\-0\fP
de \fBxargs\fP(1).
.TP  5
.if  !'po4a'hide' .BR \-h ", " \-\-help
.\"
Afficher un résumé du manuel d'utilisation.
.TP  5
.if  !'po4a'hide' .BR \-v ", " \-\-version
Afficher le numéro de version de \fBrealpath\fP.
.SH EXEMPLES
.PP
Dans l'exemple suivant, supposons que \fI/usr/bin/X11\fP est un lien symbolique
pointant vers le répertoire \fI/usr/bin\fP.
.SS "Exemple 1"
Sans tenir compte du répertoire actuel,
.br
.RS 4
.nf
.if  !'po4a'hide' .BI "realpath " /../usr/bin/X11/./xterm
.fi
.RE
affiche
.RS 4
.nf
.if  !'po4a'hide' .I /usr/bin/xterm
.fi
.RE
mais
.RS 4
.nf
.if  !'po4a'hide' .BI "realpath \-s " /../usr/bin/X11/./xterm
.fi
.RE
renvoie
.RS 4
.nf
.if  !'po4a'hide' .I /usr/bin/X11/xterm
.fi
.RE

.SS "Exemple 2"
Lorsque le répertoire actuel est \fI/usr/bin/X11\fP (qui est toujours un lien
symbolique vers \fI/usr/bin\fP), la sortie de chaque
.br
.RS 4
.nf
.if  !'po4a'hide' .BI "realpath " ./xterm
.fi
.RE
et
.RS 4
.nf
.if  !'po4a'hide' .BI "realpath  \-s " ./xterm
.fi
.RE
sera
.RS 4
.nf
.if  !'po4a'hide' .I /usr/bin/xterm
.ne
.RE

.SS "Exemple 3"
À condition que le répertoire actuel soit
\fI/home/user\fP
(et que le répertoire existe avant et pendant l'exécution de \fBrealpath\fP),
la commande
.br
.RS 4
.nf
.if  !'po4a'hide' .BI "realpath " ../path/to/some/./non-existent/./directory/../or/../file
.fi
.RE
échouera en renvoyant l'erreur suivante
.RS 4
.nf
.if  !'po4a'hide' .I \&../path/to/some/./non-existent/./directory/../or/../file: No such file or directory
.fi
.RE
mais
.RS 4
.nf
.if  !'po4a'hide' .BI "realpath \-s " ../path/to/some/./non-existent/./directory/../or/../file
.fi
.RE
renverra
.RS 4
.nf
.if  !'po4a'hide' .I /home/path/to/some/non-existent/file
.fi
.RE
.SH "VALEUR RENVOYÉE"
\fBrealpath\fP renvoie un code de retour nul lorsque \fItous\fP les noms de chemin
ont été convertis avec succès.
.br
Au cas où une erreur se produirait (par exemple des répertoires manquants ou
indisponibles dans le chemin), \fBrealpath\fP écrit un message d'erreur sur la
sortie d'erreur standard et renvoie un code de retour non nul.
.RE
.SH "VOIR AUSSI"
.if  !'po4a'hide' .BR basename (1),
.if  !'po4a'hide' .BR dirname (1),
.if  !'po4a'hide' .BR readlink (1),
.if  !'po4a'hide' .BR chase (1),
.if  !'po4a'hide' .BR realpath (3)
.SH BOGUES
Espérons aucun :)
.br
Si vous en trouvez, veuillez les signaler grâce au système de signalisation
des bogues de Debian, consultez le fichier
\fI/usr/share/doc/debian/bug\-reporting.txt\fP du paquet doc\-debian ou la page
de manuel de \fBreportbug\fP(1).
.SH AUTEUR
Écrit à l'origine par Lars Wirzenius <\fIliw@iki.fi\fP>, en tant que
composant du paquet dwww. Désormais, Robert Luberda
<\fIrobert@debian.org\fP> en est le responsable et le développeur.
.PP
\fBrealpath\fP 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é.