ifup - activer une interface réseau
ifdown - désactiver une interface réseau
ifquery - analyser la configuration de l'interface
SYNOPSIS
ifup [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifup -h|--help
ifup -V|--version
ifdown [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifquery [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS] IFACE...
ifquery -l|--list [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
[-a|IFACE...]
ifquery --state [--state-dir=DIR] [--allow CLASS] [-a|IFACE...]
DESCRIPTION
Les commandes ifup et ifdown peuvent être utilisées pour configurer (ou, respectivement, déconfigurer) les interfaces réseau en fonction des définitions d'interface dans le fichier /etc/network/interfaces. La commande ifquery peut être utilisée pour analyser la configuration des interfaces.
OPTIONS
Un résumé des options est inclus ci-dessous.
-a, --all
Si utilisé avec ifup, affecte toutes les interfaces marquées comme automatiques. Les interfaces sont activées dans l'ordre dans lequel elles sont définies dans /etc/network/interfaces. Combiné avec --allow, agit sur toutes les interfaces d'une classe spécifiée. Si utilisé avec ifdown, affecte toutes les interfaces définies. Les interfaces sont désactivées dans l'ordre dans lequel elles sont actuellement répertoriées dans le fichier d'état. Seules les interfaces définies dans /etc/network/interfaces seront désactivées.
-f, --force
Force la configuration ou la déconfiguration de l'interface.
--ignore-errors
Si l'une des commandes ou des scripts échoue, continuer.
-h, --help
Affiche un résumé des options.
--allow=CLASS
Autorise uniquement les interfaces répertoriées dans une ligne allow-CLASS dans /etc/network/interfaces à être traitées.
-i FILE, --interfaces=FILE
Lit les définitions d'interface à partir de FILE au lieu de /etc/network/interfaces.
--state-dir=DIR
Conserve l'état de l'interface dans DIR au lieu de /run/network.
-X PATTERN, --exclude=PATTERN
Exclut les interfaces de la liste des interfaces à traiter par le PATTERN. PATTERN utilise une syntaxe de glob standard du shell. Si des caractères génériques du shell ne sont pas utilisés, il doit correspondre exactement au nom de l'interface. Cette option peut être spécifiée plusieurs fois, ce qui entraîne l'exclusion de plus d'un motif.
-o OPTION=VALUE
Définit OPTION sur VALUE comme s'il était dans /etc/network/interfaces.
-n, --no-act
Ne configure aucune interface et n'exécute aucune commande "up" ou "down".
--no-mappings
N'exécute aucun mappage. Voir interfaces(5) pour plus d'informations sur la fonctionnalité de mappage.
--no-scripts
N'exécute aucun script dans /etc/network/if-*.d/
--no-loopback
Désactive la gestion spéciale de l'interface de bouclage. Par défaut, l'interface de bouclage (lo sur Linux) est prédéfinie en interne comme une interface automatique, elle est donc activée automatiquement lors de l'utilisation de ifup -a. Si l'appareil de bouclage est redéfini par l'utilisateur, l'interface est configurée une seule fois de toute façon. Cependant, si une autre interface est également définie comme boucle, elle est configurée comme d'habitude. La spécification de cette option désactive ce comportement, de sorte que l'interface de bouclage ne sera pas configurée automatiquement.
-V, --version
Affiche les informations de copyright et de version.
-v, --verbose
Affiche les commandes au fur et à mesure de leur exécution.
-l, --list
Pour ifquery, liste toutes les interfaces qui correspondent à la classe spécifiée. Si aucune classe n'est spécifiée, affiche toutes les interfaces répertoriées comme automatiques.
--state
Pour ifquery, affiche l'état des interfaces. Si aucune interface n'est spécifiée, liste toutes les interfaces qui ont été activées, ainsi que les interfaces logiques qui leur sont affectées, et se termine avec un code de retour indiquant le succès. Si une ou plusieurs interfaces sont spécifiées, affiche l'état de ces interfaces uniquement ; un code de retour de succès est renvoyé si toutes les interfaces données en arguments sont activées. Sinon, 0 est renvoyé.
EXEMPLES
ifup -a
Active toutes les interfaces définies avec le mot clé « auto » dans /etc/network/interfaces
ifup eth0
Active l'interface eth0
ifup eth0=home
Active l'interface eth0 en tant qu'interface logique « home »
ifdown -a
Désactive toutes les interfaces qui sont actuellement activées.
ifquery -l
Affiche les noms de toutes les interfaces spécifiées avec le mot clé « auto ».
ifquery -l --allow=hotplug
Affiche les noms de toutes les interfaces spécifiées avec le mot clé « allow-hotplug ».
ifquery eth0
Affiche les options de l'interface telles que spécifiées dans la configuration ifupdown. Chaque paire clé-valeur est affichée sur une ligne distincte en utilisant « : » comme séparateur.
NOTES
ifup, ifdown et ifquery sont en réalité le même programme appelé avec des noms différents.
Le programme ne configure pas directement les interfaces réseau ; il exécute des utilitaires de bas niveau tels que ip pour effectuer le travail.
Lors de l'invocation, ifdown vérifie si ifup est toujours en cours d'exécution. Dans ce cas, un signal SIGTERM est envoyé à ifup.
Pendant la désactivation de l'interface, ifdown ignore les erreurs de la même manière que si l'option --ignore-errors avait été spécifiée.
FICHIERS
/etc/network/interfaces
définitions des interfaces réseau. Voir interfaces(5) pour plus d'informations.
/run/network/ifstate
état actuel des interfaces réseau
CONCURRENCE
Ifupdown utilise un verrouillage par interface pour garantir que les appels concurrents à ifup et ifdown sur la même interface sont exécutés en série. Cependant, les appels à des interfaces différentes pourront être exécutés en parallèle.
CODE DE RETOUR
Pour ifup et ifdown, le code de retour sera 0 si toutes les interfaces données ont été (dés)configurées avec succès, 1 s'il y a eu une erreur. Le résultat de ces commandes est idempotent ; l'exécution de ifup sur une interface qui est déjà active renverra un code de retour de 0, et de même, l'exécution de ifdown sur une interface qui n'est pas active renverra également un code de retour de 0.
ifquery renverra normalement un code de retour de 0 si une interface avec une section iface correspondante est trouvée, et 1 si aucune section correspondante n'est trouvée. ifquery --state renverra également un code de retour de 1 si l'interface donnée était connue mais n'était pas active.
BUGS/LIMITATIONS CONNUES
Le programme conserve un historique de l'état (actif ou inactif) des interfaces réseau. Dans des circonstances exceptionnelles, cet historique peut devenir incohérent avec l'état réel des interfaces. Par exemple, une interface qui a été activée à l'aide de ifup et qui a ensuite été désactivée à l'aide de ifconfig sera toujours enregistrée comme étant active. Pour corriger cela, vous pouvez utiliser l'option --force pour forcer ifup ou ifdown à exécuter les commandes de configuration ou de désactivation, même si cela contredit l'état actuel de l'interface tel qu'il est perçu.
Le fichier /run/network/ifstate doit être accessible en écriture pour que ifup ou ifdown fonctionnent correctement. Si cet emplacement n'est pas accessible en écriture (par exemple, parce que le système de fichiers racine est monté en lecture seule pour la récupération du système), alors /run/network/ifstate doit être transformé en un lien symbolique vers un emplacement accessible en écriture. Si cela n'est pas possible, vous pouvez utiliser l'option --force pour exécuter les commandes de configuration ou de désactivation sans mettre à jour le fichier.
Notez que le programme ne s'exécute pas automatiquement : ifup seul n'active pas les interfaces qui apparaissent en raison de l'installation de matériel, et ifdown seul n'inactive pas les interfaces qui disparaissent en raison du retrait de matériel. Pour automatiser la configuration des interfaces réseau, vous devez installer d'autres paquets tels que udev(7) ou ifplugd(8).
AUTEURS
La suite ifupdown a été créée par Anthony Towns <_>, et est actuellement maintenue par
Santiago Ruano Rincón <_> et Josue Ortega <_>.
De nombreuses autres personnes ont contribué au développement de ifupdown au fil du temps, consultez /usr/share/doc/ifupdown/changelog.Debian.gz pour l'historique complet.