.\" Jean II - HPL - 2004-2007
.\" ifrename.8
.\"
.\" Traduction 2004/08/25 Maxime CHARPENNE (voir
.\" http://www.delafond.org/traducmanfr/)
.\" 1ère traduction        : version 27-pre25
.\" mise à jour 2007/08    : version 29-pre21
.\" mise à jour 2007/10    : version 30-pre1
.\" Mise à jour 2007/10/29 : version 30-pre3
.\"
.TH IFRENAME 8 "26 février 2007" "wireless-tools" "Manuel du programmeur Linux"
.\"
.\" NAME part
.\"
.SH NOM
ifrename \- renomme les interfaces réseau basées sur différents critères
statiques
.\"
.\" SYNOPSIS part
.\"
.SH SYNOPSIS
.B "ifrename [-c fichierconfig] [-p] [-d] [-u] [-v] [-V] [-D] [-C]"
.br
.B "ifrename [-c fichierconfig] [-i interface] [-n nouveaunom]"
.\"
.\" DESCRIPTION part
.\"
.SH DESCRIPTION
.B Ifrename
est un outil vous permettant d'assigner un nom cohérent à chacune de vos
interfaces réseau.
.PP
Par défaut, les noms d'interface sont dynamiques, et à chaque interface réseau
est assigné le premier nom disponible
.RI ( eth0 ", " eth1 "...)."
L'ordre dans lequel les interfaces réseau sont créées peut varier. Pour les
interfaces internes («\ built-in interfaces\ »), l'énumération du noyau au
démarrage peut varier. Pour les interfaces amovibles, l'utilisateur peut les
brancher dans n'importe quel ordre.
.PP
.B Ifrename
permet à l'utilisateur de décider quel nom une interface réseau aura.
.B Ifrename
peut utiliser différents
.I sélecteurs
.RI "(«\ " selectors "\ »)"
pour spécifier comment les noms d'interface correspondent aux interfaces réseau
du système, le plus commun des sélecteurs étant
.RI "l'" "adresse MAC"
de l'interface.
.PP
.B Ifrename
doit être lancé avant que les interfaces ne soient démarrées, raison pour
laquelle il est surtout utile dans divers scripts (init, hotplug), mais il est
rarement utilisé directement par l'utilisateur. Par défaut,
.B ifrename
renomme toutes les interfaces système présentes en utilisant les correspondances
définies dans
.IR /etc/iftab .
.\"
.\" PARAMETER part
.\"
.SH PARAMÈTRES
.TP
.BI "-c " fichierconfig
Fixe le fichier de configuration à utiliser (par défaut
.IR /etc/iftab ).
Le fichier de configuration définit la correspondance entre les sélecteurs et
les noms d'interface, et il est décrit dans
.IR iftab (5).
.br
Si
.I fichierconfig
est «\ -\ », la configuration est lue depuis stdin.
.TP
.B -p
Sonde (charge) les modules noyau avant de renommer les interfaces (NDT\ :
.RI "«\ " p "robe\ »"
en anglais). Par défaut,
.B ifrename
vérifie seulement les interfaces déjà chargées, et ne charge pas
automatiquement les modules noyau requis. Cette option autorise une intégration
en douceur dans les systèmes qui ne chargent pas les modules avant d'appeler
.BR ifrename .
.TP
.B -d
Active divers bidouillages spécifiques à la
.BR Debian .
Combiné avec
.BR -p ,
seuls les modules pour les interfaces spécifiées dans
.I /etc/network/interface
sont chargés.
.TP
.BI "-i " interface
Renomme seulement
.RI "l'" interface
spécifiée, par opposition à toutes les interfaces présentes sur le système. Le
nouveau nom de l'interface est affiché.
.TP
.BI "-n " nouveaunom
Si utilisé avec
.IR -i ,
spécifie le nouveau nom de l'interface. La liste des correspondances depuis le
fichier de configuration est ignorée, l'interface spécifié avec
.I -i
est directement renommée en
.IR nouveaunom .
Le nouveau nom peut être un joker («\ wildcard\ ») qui contient une seule '*'.
.br
Si utilisé sans
.IR -i ,
renomme les interfaces en utilisant seulement les correspondances qui les
renommeraient en
.IR nouveaunom .
Le nouveau nom ne peut pas être un joker. Cette utilisation de ifrename est
déconseillée car inefficace
.RI ( -n " sans " -i ).
Toutes les interfaces du système ont besoin d'être traitée à chaque invocation,
donc dans la plupart des cas il n'est pas plus rapide de simplement laisser
ifrename les renommer toutes (sans les deux
.IR -n " et " -i ).
.TP
.B -t
Active le support de l'absorption («\ takover\ ») de nom. Cela permet
d'échanger un nom d'interface entre deux interfaces ou plus.
.br
L'absorption permet à une interface de «\ voler\ » le nom d'une autre
interface. Cela fonctionne seulement avec le noyau 2.6.X et si l'autre
interface est désactivée. En conséquence, ce n'est pas compatible avec Hotplug.
L'autre interface se voit assigner un nom aléatoire, mais peut être renommée
plus tard avec
.BR ifrename .
.br
Le nombre d'absorptions est limité pour éviter les boucles circulaires, et donc
certaines situations d'échanges de noms complexes ne seront pas complètement
traitées.
.br
Dans tous les cas, l'échange de noms et l'utilisation de cette caractéristique
sont découragés, et vous êtes invités à choisir des noms uniques et sans
ambiguïté pour vos interfaces...
.TP
.B -u
Active le mode de sortie
.IR udev .
Cela permet une intégration propre de
.B ifrename
dans le framework
.IR udev ,
.BR udevd (8)
utilisera
.B ifrename
pour assigner les noms d'interfaces présents dans
.IR /etc/iftab .
Dans ce mode, la sortie de ifrename peut être analysée («\ parsed\ »)
directement par
.BR udevd (8)
en tant qu'une action IMPORT. Cela nécessite la version 107 ou plus de
.IR udev .
.TP
.B -D
Mode «\ dry-run\ ». Ifrename ne changera aucune interface et affichera seulement
les nouveaux noms d'interface, si applicable, et sortira.
.br
Dans le mode «\ dry-run\ », le nom joker d'interface est résolu. Le nouveau nom
d'interface est affiché, même s'il est identique à l'ancien.
.br
Faire aussi attention que certains sélecteurs peuvent seulement être lus par
root, (par exemple ceux basés sur
.BR ethtool ),
et ifrename échouera en silence s'il est lancé par un utilisateur normal. En
d'autres termes, le mode «\ dry-run\ » lancé par un utilisateur standard ne
donnera pas forcément le résultat attendu.
.TP
.B -V
Mode verbeux. Ifrename affichera  les résultats de l'analyse de son fichier de
configuration et de l'interrogation des séleceurs d'interfaces. Combiné avec
l'option
.RI "«\ " dry-run "\ »,"
c'est une bonne manière de déboguer des configurations
complexes ou des problèmes triviaux.
.TP
.B -C
Compte les interfaces qui correspondent. Affiche le nombre d'interfaces
qui correspondent et le retourne comme code retour de ifrename.
.br
Le nombre d'interfaces qui correspondent est le nombre d'interfaces du système
pour lesquelles un lien a été trouvé dans le fichier de config (qui est
différent du numéro de l'interface renommée).
.\"
.\" AUTHOR part
.\"
.SH AUTEUR
Jean Tourrilhes \- jt@hpl.hp.com
.\"
.\" TRADUCTION part
.\"
.SH TRADUCTION
Maxime CHARPENNE, octobre 2007 (wireless_tools.30-pre3).
.\"
.\" AVERTISSEMENT part
.\"
.SH AVERTISSEMENT SUR LA TRADUCTION
Il est possible que cette traduction soit imparfaite ou périmée. En cas de
doute, veuillez vous reporter au document original en langue anglaise fourni
avec le programme.
.\"
.\" FILES part
.\"
.SH FICHIERS
.I /etc/iftab
.\"
.\" SEE ALSO part
.\"
.SH VOIR AUSSI
.BR ifconfig (8),
.BR ip (8),
.BR iftab (5).